로딩중입니다
adPOPcornオファーウォール:Unity iOS
6/12/2015 3:02:30 PM

adPOPcornオファーウォール


adPOPcornは、アプリ内でオファーウォールを表示して、ユーザーが広告に
参加完了した件数に対してデベロッパー様に追加収益をご提供するサービスです。
adPOPcornに関する詳細は、以下のガイドをご確認ください。
adPOPcornのご案内

注意事項
  1. adPOPcornのAdd-onを連携する前に、IGAW基本連携を完了してください。IGAW基本連携:Unity iOS
  2. 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)」


    ユーザー識別値の入力

    ユーザー識別値は、キャンペーンを完了したユーザーを識別してリワードを付与するために利用する情報です。

    注意事項
    1. ユーザーごとにユニークな識別値を設定してください。可変値は利用しないでください。
    2. 個人情報(メールアドレス、名前、電話番号、識別できるユーザーIDなど)を含んではいけません。
    3. 日本語、記号、スペースなどが含まれている場合、必ずURL Encording処理を行ってください。
    4. 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