adPOPcornオファーウォール
adPOPcornは、アプリ内にオファーウォールを表示して、ユーザーが広告に参加完了した件数に対してデベロッパー様に追加収益をご提供するサービスです。
adPOPcornに関する詳細は、以下のガイドをご確認ください。
[adPOPCornのご案内]
注意事項
- adPOPcornのAdd-onを連携する前に、IGAW基本連携を完了してください。「IGAW基本連携 : Unity Android」
- 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_typeをclientで設定して、追加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名のユーザーごとにユニークな識別値で設定してください。可変値を利用してはいけません。
- 個人情報(メールアドレス、名前、電話番号、識別できるユーザーIDなど)を含んではいけません。
- 日本語、記号、スペースなどが含まれている場合、必ずURL Encording処理を行ってください。
- 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