로딩중입니다
adPOPcornオファーウォール:Unity Android
8/12/2015 10:14:35 AM

adPOPcornオファーウォール


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

[adPOPCornのご案内]


注意事項
  1. adPOPcornのAdd-onを連携する前に、IGAW基本連携を完了してください。「IGAW基本連携 : Unity Android
  2. adPOPCornの連携のためにIgawAdpopcorn~*_thirdparty.jar ファイルをUnityプロジェクトに追加する必要があります。「SDKインストール:Unity



AndroidManifest.xml

adPOPcornの連携のため、Android Manifestファイルを修正します。
基本連携で設定した App key、Hash Key、Permission以外に追加Permission、ワードサーバータイプ必須アクティビティを追加します。


Permissionの追加

<manifest></manifest> で以下のようなPermissionを追加します。

GET_ACCOUNT Permissionは、同じ広告に対するアビューズをGoogleアカウント情報で防ぐために必ず追加してください。

<uses-permission android:name="android.permission.GET_ACCOUNTS"/>

GET_ACCOUNT Permissionは、adPOPcorn 4.0.5 ver.以上から必要となります。


リワードサーバータイプの設定
<application></application> 次のように、(*)リワードサーバーの連携方法を設定します。自体サーバーを利用する際は、「server」で設定します。
<meta-data android:name="igaworks_reward_server_type" android:value="server"/>

(*)リワードサーバーの連携方法
IGAWリワードサーバーで渡すリワード情報を受信する方法を設定します。デベロッパー様にてポストバックサーバーを構築していただき、ポストバックを受信することをお勧めします。
自体サーバーの場合、セキュリティの管理及びCS処理などの維持管理に便利です。
自体サーバーの構築が難しい場合は、IGAWリワードサーバーを利用して、クライアントよりポストバックの受信も可能です。
この場合、igaworks_reward_server_typeclientで設定して、追加APIの連携が必要となります。

IGAWリワードサーバーの連携 : クライアント方式


必須アクティビティの追加
<application></application> タグの中に、必須Activityを追加します。オファーウォールが正常に起動するために必ず追加してください。
<activity android:name="com.igaworks.adpopcorn.activity.ApOfferWallActivity_NT"
          android:theme="@android:style/Theme.Translucent.NoTitleBar"/>

<activity android:name="com.igaworks.adpopcorn.activity.ApCSActivity_NT"
          android:theme="@android:style/Theme.NoTitleBar" />

<activity android:name="com.igaworks.adpopcorn.activity.ApVideoAdActivity"
          android:theme="@android:style/Theme.NoTitleBar"
          android:screenOrientation="landscape"/>

+ リワード広告プラットフォーム「adPOPcorn」をご利用しますか?
adPOPcorn広告プラットフォームでCPI(起動型)以上のキャンペーン実施をご希望の場合は、Googleインストールレシーバーを登録してください。

IGAWorks Googleインストールレシーバー登録ガイド



adPOPcorn API

基本連携を完了すると、adPOPcorn APIを利用できます。以下のAPIを利用して、adPOPcornオファーウォールを表示するための連携を進めます。


ユーザー識別値の入力

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

ユーザー識別値はユーザーがオファーウォールをオープンする前に設定してください。


注意事項

  1. 1名のユーザーごとにユニークな識別値で設定してください。可変値を利用してはいけません。
  2. 個人情報(メールアドレス、名前、電話番号、識別できるユーザーIDなど)を含んではいけません。
  3. 日本語、記号、スペースなどが含まれている場合、必ずURL Encording処理を行ってください。
  4. openOfferwall APIを呼び出す前に設定してください。
上記の注意事項を確認し、ユーザー識別値を入力します。
IgaworksUnityPluginAOS.Common.setUserId("player1001");


オファーウォールの表示

openOfferWall APIを呼び出し、オファーウォールを表示します。
オファーウォールにアクセスするためのボタンやバナー、イメージなどのクリックイベントで呼び出しします。

public class MySampleScene : MonoBehavior {         
    Rect openOfferwallBtn = new Rect(100, 100, 200, 200);

    void OnGUI() {
        //ユーザーがオファーウォールに入るボタンをクリックした時、オファーウォールを表示します。  
        if (GUI.Button(openOfferwallBtn, "Free Coin")) {
            IgaworksUnityPluginAOS.Adpopcorn.openOfferwall();
        }
    }
} 


オプション : デバイス画面

横画面のアプリの場合、デバイスの上下回転に対応するためにsetSensorLandscapeEnable APIを利用して設定します。

// true:回転モード,  false:固定モード  IgaworksUnityPluginAOS.Adpopcorn.setSensorLandscapeEnable(true);


オプション : イベントデリゲート

オファーウォール終了に関するイベントリスナーを提供します。オファーウォール終了時に、ご希望のアクションを定義して利用することができます。
デリデートの実装及び利用例は、以下を参考にしてください。
public class MySampleScene : MonoBehavior {      
	void Start () {          
		//オファーウォール終了イベントデリゲートの登録          
		IgaworksUnityPluginAOS.OnClosedOfferwallPage = mOnClosedOfferwallPage;      
	}        
	//オファーウォール終了イベントデリゲートの実装      
	void mOnClosedOfferwallPage () {
		Debug.Log("ウォール終了");      
	}  
}



adPOPcornオファーウォールスタイル API

adPOPcornオファーウォールの色とスタイルを変更することができます。 setOfferwall~* APIを呼び出してスタイルを変更します。
// オファーウォール全体のテーマカラーコードの指定
// IgaworksUnityPluginAOS.Adpopcorn.setOfferwallThemeColor(string color)
IgaworksUnityPluginAOS.Adpopcorn.setOfferwallThemeColor("ff9d261c");

// オファーウォール全体のフォントカラーコードの指定
// IgaworksUnityPluginAOS.Adpopcorn.setOfferwallTextThemeColor(string color)
IgaworksUnityPluginAOS.Adpopcorn.setOfferwallTextThemeColor("ff9d261c");

// オファーウォールリワードボックスカラーコードの指定
// IgaworksUnityPluginAOS.Adpopcorn.setOfferwallRewardThemeColor(string color)
IgaworksUnityPluginAOS.Adpopcorn.setOfferwallRewardThemeColor("ff9d261c");

// オファーウォールリワードボックスカラーコードの指定
// IgaworksUnityPluginAOS.Adpopcorn.setOfferwallRewardCheckThemeColor(string color)
IgaworksUnityPluginAOS.Adpopcorn.setOfferwallRewardCheckThemeColor("ff9d261c");



リワードサーバーの連携及び検収

アプリでオファーウォールを表示するための連携が完了しました。
これより、以下のガイドを参考の上、キャンペーンを完了したユーザーにリワードを付与するためのリワードサーバーの連携を進めてください。
IGAWリワードサーバー連携:adPOPcorn

リワードサーバー連携を完了した後、テスト広告を通じて広告の参加・リワードの付与が正常に行われるか確認し、検収の申し込みを行ってください。
adPOPcornオファーウォールをご利用いただくためには、必ず検収が必要となります。
adPOPcorn管理画面の検収の申し込みでAPKファイルをご送付いただくか、担当者まで検収をお申し込みください。1~2営業日以内に検収結果をご連絡致します。

検収に関するお問い合わせ : QA@igaworks.com / bizdev-jp@igaworks.com