adPOPcornオファーウォール
adPOPcornは、アプリ内でオファーウォールを表示して、ユーザーが広告に
参加完了した件数に対してデベロッパー様に追加収益をご提供するサービスです。
adPOPcornに関する詳細は、以下のガイドをご確認ください。
「adPOPcornのご案内」
注意事項
- adPOPcornのAdd-onを連携する前に、IGAW基本連携を完了してください。「IGAW基本連携:Unity iOS」
- adPOPcorn連携のために、Igaworks_unity_ios~*.unitypackage ファイルをUnityプロジェクトに追加する必要があります。「SDKインストール:Unity」
adPOPcornオファーウォールAPI
リワードサーバータイプの設定
以下のように ( * )リワードサーバーの連携方法を設定します。
IgaworksCorePluginIOS.SetUseIgaworksRewardServer(false);
//true : IGAWorksリワードサーバーの利用
//false : 自体サーバー利用
( * )リワードサーバーの連携方法
IGAWリワードサーバーで渡すリワード情報を受信する方法を設定します。
デベロッパー様にて直接サーバーを構築していただき、コールバック(Call back)を受信することをお勧めします。自体サーバーの場合、セキュリティ管理とCS処理などの維持管理に便利です。
自体サーバーの構築が難しい場合は、IGAWリワードサーバーを利用してクライアントからコールバックの受信が可能です。この設定はuseIgaworksRewardServerパラメーターを利用して設定します。
「IGAWリワードサーバーの連携:クライアント方式(Unity iOS)」
ユーザー識別値の入力
ユーザー識別値は、キャンペーンを完了したユーザーを識別してリワードを付与するために利用する情報です。
注意事項
- ユーザーごとにユニークな識別値を設定してください。可変値は利用しないでください。
- 個人情報(メールアドレス、名前、電話番号、識別できるユーザーIDなど)を含んではいけません。
- 日本語、記号、スペースなどが含まれている場合、必ずURL Encording処理を行ってください。
- AdPopcornOpenOfferWallWithViewController APIを呼び出す前に設定してください。
上記の注意事項を確認し、ユーザー識別値を入力します。
IgaworksADPluginIOS.IgaworksADSetUserId("player1001");
オファーウォールの表示
AdPopcornOpenOfferWallWithViewController APIを呼び出し、オファーウォールを表示します。
オファーウォールにアクセスするためのボタンやバナー、イメージなどのクリックイベントで呼び出します。
public class MySampleScene : MonoBehaviour {
Rect openOfferwallBtn= new Rect(100,100,200,200);
void OnGUI() {
//ユーザーがオファーウォール表示ボタンをクリックした時、オファーウォールを表示します。
if(GUI.Button (openOfferwallBtn, "Free Coin")) {
IgaworksADPluginIOS.AdPopcornOpenOfferWallWithViewController (false, null);
}
}
}
オファーウォールアクションデリデート
オファーウォールアクションに関するデリデートを提供します。デリゲートを利用するためには
IgaworksADSetCallbackHandler APIを利用して、デリゲートハンドラーを登録してください。
提供するオファーウォールアクションデリゲートは以下の通りです。
- offerWallWillOpen : オファーウォールを表示する前に呼び出します。
- offerWallOpened : オファーウォールを表示した後に呼び出します。
- offerWallWillClose : オファーウォールを閉じる前に呼び出します。
- offerWallClosed : オファーウォールを閉じた後に呼び出します。
public class MySampleScene : MonoBehaviour {
// Use this for initialization
void Start () {
//デリゲートハンドラーの登録
IgaworksADPluginIOS.IgaworksADSetCallbackHandler("MySampleScene");
// デリゲートの登録
IgaworksADPluginIOS.offerWallWillOpen += HandleofferWallWillOpen;
IgaworksADPluginIOS.offerWallOpened += HandleofferWallOpened;
IgaworksADPluginIOS.offerWallWillClose += HandleofferWallWillClose;
IgaworksADPluginIOS.offerWallClosed += HandleofferWallClosed;
}
// デリゲートの実装
void HandleofferWallWillOpen(){}
void HandleofferWallOpened(){}
void HandleofferWallWillClose(){}
void HandleofferWallClosed(){}
}
adPOPcornオファーウォールスタイル API
adPOPcornオファーウォールのカラースタイルを変更することができます。スタイル変更APIはAdPopcornStyleSetAdPopcornThemeColor APIを利用して変更してください。
IgaworksADPluginIOSであらかじめ設定されたpresetを利用するか、直接設定することもできます。
public class MySampleScene : MonoBehavior {
void changeOfferWallColorTheme () {
// オファーウォール全体テーマカラーの変更
IgaworksADPluginIOS.AdPopcornStyleSetAdPopcornThemeColor = IgaworksADPluginIOS.AdPopcornThemeBlueC
olor;
// オファーウォールタイトルテキストの修正
IgaworksADPluginIOS.AdPopcornStyleSetAdPopcornOfferWallTitle ("Free Coin");
// オファーウォールテキストテーマカラーの変更
IgaworksADPluginIOS.AdPopcornStyleSetAdPopcornTextThemeColor = IgaworksADPluginIOS.AdPopcornThemeRedColor;
}
}
リワードサーバーの連携及び検収
アプリでオファーウォールを表示するための連携が完了しました。
これより、以下のガイドを参考の上、キャンペーンを完了したユーザーに実際にリワードを付与するための
リワードサーバーの連携を進めてください。
「IGAWリワードサーバー連携ガイド」
リワードサーバーの連携を完了した後、
テスト広告を通じて広告の参加・リワード付与が正常に行われるか確認し、検収の申込みを行ってください。
adPOPcornオファーウォールをご利用いただくためには、必ず検収が必要となります。
adPOPcorn管理画面の検収の申し込みでAPKファイルをご送付いただくか、担当者まで検収をお申し込みください。1~2営業日以内に検収結果をご連絡致します。
検収に関するお問い合わせ : QA@igaworks.com / bizdev-jp@igaworks.com