manuallatest製品マニュアル / AppLovinデータ統合ソリューション
AppLovinデータ統合ソリューション
最終更新日：2023-07-05
1. 統合プランの紹介
ヒント
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
本記事では、AppLovinのデータをAgentic Engine（以下、AEシステム）にコールバックする方法を説明します。本プランは次に対応しています：
タイトルをクリックすると、プランの該当する章に移動できます
| 統合方法 | データ粒度 | 統合タイプ | 対象データ |
|---|---|---|---|
| Impression-Level User Revenue API | ユーザーデータ | クライアントSDK | 収益データ、表示データ |
| MAX S2S Impression Revenue API | ユーザーデータ | プッシュ型 | 収益データ、表示データ |
| User Revenue API（表示レベル） | ユーザーデータ | プル型 | 収益データ、表示データ |
| 集約指標 | プル型 | コストデータ、収益データ、表示データ、クリックデータ、コンバージョンデータ | |
| Revenue Reporting API | 集約指標 | プル型 | 収益データ、表示データ |
| 集約指標 | プル型 | コストデータ、表示データ、クリックデータ、コンバージョンデータ |
2. Impression-Level User Revenue API（クライアントSDKによる送信）
インターフェースの基本情報
| インターフェース名 | APIタイプ | 製品化 | データ粒度 | アトリビューションデータ | コストデータ | 収益データ | インプレッション | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|---|
| Impression-Level User Revenue API | クライアントSDK | いいえ | ユーザーレベル | はい | はい |
AppLovin SDKバージョン10.3.0以降では、AppLovin SDKのImpression-Level User Revenue APIで、表示レベルのユーザー収益データを取得できます。さらにAE SDKでデータを送信して収益データをAEシステムに直接転送することで、収益データをリアルタイムに送信できます。
収益データを取得するには、MaxAdRevenueListenerを作成してonAdRevenuePaid()メソッドをオーバーライドし、このメソッド内で収益データの取得とAE SDKによるデータ送信を実装したうえで、最後にこのリスナーをsetRevenueListener()に渡す必要があります。以下のコードサンプルは、onAdRevenuePaid()メソッドをオーバーライドして収益データを取得し、AE SDKでAEサーバーにアップロードする方法を示しています：
サンプルコード1：
注記
統合しているAE SDKのバージョンが2.8.0~2.8.1の場合は、この方法の使用をお勧めします
統合しているAE SDKのバージョンが2.8.2以上の場合、この方法を使用するにはサードパーティデータプラグインもインストールする必要があります
詳しくはAndroid SDKのサードパーティデータとiOS SDKのサードパーティデータを参照してください
void onAdRevenuePaid(final MaxAd ad){
instance.enableThirdPartySharing(TDThirdPartyShareType.TD_APPLOVIN_USER,ad)
}
この方法の仕組みは、内部でMaxAdのパラメータを自動的に解析し、appLovin_sdk_ad_revenueイベントを送信するというものです
サンプルコード2：
void onAdRevenuePaid(final MaxAd ad)
{
JSONObject properties = new JSONObject();
try {
properties.put("revenue",ad.getRevenue());
properties.put("countryCode",AppLovinSdk.getInstance(context).getConfiguration().getCountryCode());
properties.put("networkName", ad.getNetworkName());
properties.put("adUnitId", ad.getAdUnitId());
properties.put("adFormat", ad.getFormat());
properties.put("placement", ad.getPlacement());
}catch(JSONException e){
}
instance.track("appLovin_sdk_ad_revenue", properties);
}
3. MAX S2S Impression Revenue API
インターフェースの基本情報
| インターフェース名 | APIタイプ | 製品化 | データ粒度 | アトリビューションデータ | コストデータ | 収益データ | インプレッション | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|---|
| MAX S2S Impression Revenue API | コールバック | いいえ | ユーザーレベル | はい | はい |
AppLovinは、MAX S2S Impression Revenue APIによってデータをコールバックする方法を提供しています。マネタイズ広告が表示されるたびに、AppLovinは表示単位の収益データを、設定されたコールバックリンクにコールバックします。
3.1 AppLovinクライアントSDKの設定
コールバックデータをAEプロジェクトのデータと関連付けるには、AppLovin SDKでAEシステムのゲストIDをAppLovinのユーザーカスタム識別IDとして渡す必要があります。以下はAndroidとiOS（Swift）のコードサンプルです：
- Androidのサンプル
// AEのゲストIDを取得（AEの#distinct_idに対応）
String ta_distinct_id = ThinkingAnalyticsSDK.sharedInstance(context, TA_APP_ID).getDistinctId();
AppLovinSdk.getInstance(context).setUserIdentifier(ta_distinct_id);
- iOSのサンプル
ALSdk.shared()!.userIdentifier = ThinkingAnalyticsSDK.sharedInstance()!.getDistinctId()
3.2 コールバックアドレスの設定
次に、コールバックアドレスを設定します。コールバックデータで受け取れるフィールドを「マクロ」と呼びます。デフォルトでは、すべてのフィールドを取得します（つまりすべてのマクロを設定します）。次の表は、MAX S2S Impression Revenue APIが対応しているすべてのマクロです。実際の必要に応じて、取得するフィールドを調整できます：
| マクロ | 必須／任意 | 説明 | サンプル |
|---|---|---|---|
| {AD_UNIT_ID} | MAX広告ID | 9ad0816ac071552a | |
| {AD_UNIT_NAME} | MAX広告名 | My%20App%20Banners | |
| {AD_UNIT_TEST_NAME} | 広告テストグループの名前 | Control | |
| {ALL_REVENUE} | はい | 推定収益。FB Bidding時の収益を含む | 0.0121, 5.74466e-05 |
| {CC} | 2文字のCountry Code | gb | |
| {CUSTOM_DATA} | SDKで設定したカスタムデータ | gb | |
| {EVENT_ID} | イベントの一意のID | 8dc948013d71f04264b8e5c1c61933154b226e08 | |
| {EVENT_TOKEN} | イベントToken（イベントの一意のIDから生成） | e000949f6d851c1f34adae08e6ef1076ba43cf31 | |
| {EVENT_TOKEN_ALL} | グローバルイベントToken（イベントの一意のIDとすべてのリクエストパラメータマクロから生成） | eba615583ed59bc679a495ec58439f4b82b5460d822348eff6be5f218702a97a | |
| {FORMAT} | 広告タイプ | reward, banner, inter | |
| {IDFA} | iOSのIDFAまたはAndroidのGoogle Advertising ID | 860635ea-65bc-eaed-d355-1b5283b30b94 | |
| {IDFV} | IDFV | 4CD1C3C4-3FD7-00F5-1635-7BC6D9387E60 | |
| {IP} | ユーザーのIPアドレス | 162.1.1.1, fe80%3A%3A1ff%3Afe23%3A4567%3A890a%0A | |
| {NETWORK} | 広告を表示したAd Network | 値は（MAX Mediation Documentation (applovin.com)）を参照してください。APPLOVIN_NETWORK | |
| {NETWORK_PLACEMENT} | Ad Networkの内部Placement名 | ca-app-pub-12345678%2F0987654321 | |
| {PACKAGE_NAME} | パッケージ名。AndroidのApp Package NameとiOSのBundle ID (iOS) | com.test.app | |
| {PLACEMENT} | SDKでカスタマイズしたPlacement名 | Launch%20Screen | |
| {PLATFORM} | プラットフォーム | android, ios | |
| {PRECISION} | 収益データの精度。データのソースによって異なります：
| exact | |
| {REVENUE} | はい | 推定収益。FB Biddingの場合、この値は0です | 0.0121, 5.74466e-05 |
| {TS} | はい | 広告の露出時間 | 1546300800 |
| {USER_ID} | はい | SDKで設定したユーザーID。AEプロジェクトのゲストIDに対応します | 7634657898 |
| {WATERFALL_NAME} | 広告Waterfallの名前 | LAT |
次に、ThinkingAIの担当者からコールバックアドレスが送られますので、AppLovinの担当者に連絡してこのコールバックリンクを設定してもらってください。
3.3 データの格納ルール
デフォルトでは、コールバックデータはイベントとしてAEプロジェクトに書き込まれます。1件のコールバックデータ（つまり1回の表示）が1件のイベントデータとして書き込まれます：
- データ内の{USER_ID}をデータのゲストIDとして使用します。このフィールドはAEプロジェクトのゲストIDに対応している必要があります
- データ内の{TS}フィールド、つまり広告の表示時間を、イベントの#event_timeとして使用します
- データのイベント名は applovin_max_s2s_impression_revenue です
- コールバックリンクで設定したその他のフィールドはすべて格納されます
その後、イベント名がapplovin_max_s2s_impression_revenueのイベントに基づいて、AEシステムで分析を行えます。
3.4 データ統合設定情報テンプレート
以上のドキュメントを読んだら、次の情報テンプレートに記入し、ThinkingAIの担当カスタマーサクセスマネージャーに送信することをお勧めします：
データインターフェース：AppLovin MAX S2S Impression Revenue API
---------
会社名：XXX
AEプロジェクト環境：（SAAS/プライベートデプロイ）
AEプロジェクト名：XXX
AEプロジェクトAPP ID: XXX
データ受信URL push_url: XXX
---------
コールバックマクロの設定
必要なフィールド：{AD_UNIT_ID}，{AD_UNIT_NAME}，{AD_UNIT_TEST_NAME}，{ALL_REVENUE}，{CC}，{CUSTOM_DATA}，{EVENT_ID}，{EVENT_TOKEN}，{EVENT_TOKEN_ALL}，{FORMAT}，{IDFA}，{IDFV}，{IP}，{NETWORK}，{NETWORK_PLACEMENT}，{PACKAGE_NAME}，{PLACEMENT}，{PLATFORM}，{PRECISION}，{REVENUE}，{TS}，{USER_ID}，{WATERFALL_NAME}
4. User Revenue API（表示レベル）
インターフェースの基本情報
| インターフェース名 | APIタイプ | 製品化 | データ粒度 | アトリビューションデータ | コストデータ | 収益データ | インプレッション | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|---|
| User Revenue API（表示レベル） | プル型 | いいえ | ユーザーレベル | はい | はい |
AppLovinは、SDKとコールバックリンクのほかに、データ取得インターフェースであるUser Revenue APIも提供しており、ユーザー単位または表示単位の広告収益データの取得に対応しています。
ヒント
現在、AEは表示レベルのデータの取得にのみ対応しています（非集計。1件のデータが1回の広告表示に対応します）
4.1 AppLovinクライアントSDKの設定
方法1（自動関連付け）：
注記
統合しているAE SDKのバージョンが2.8.0~2.8.1の場合は、この方法の使用をお勧めします
統合しているAE SDKのバージョンが2.8.2以上の場合、この方法を使用するにはサードパーティデータプラグインもインストールする必要があります
詳しくはAndroid SDKのサードパーティデータとiOS SDKのサードパーティデータを参照してください
// AE SDKを初期化
ThinkingAnalyticsSDK instance = ThinkingAnalyticsSDK.sharedInstance(this, TA_APP_ID, TA_SERVER_URL);
// AppLovinSdkのID関連付けを有効化
instance.enableThirdPartySharing(TDThirdPartyShareType.TD_APPLOVIN_IMPRESSION);
// AppLovinSdk SDKを初期化
この方法の仕組みは、内部でAppLovinSdk SDKのsetUserIdentifier()メソッドを自動的に呼び出し、AEプロジェクトのゲストIDを渡すというものです。
方法2（手動関連付け）：
APIで取得したデータをAEプロジェクトのデータと関連付けるには、AppLovin SDKでAEシステムのゲストIDをAppLovinのユーザーカスタム識別IDとして渡す必要があります。以下はAndroidとiOS（Swift）のコードサンプルです：
- Androidのサンプル
// AEのゲストIDを取得（AEの#distinct_idに対応）
String ta_distinct_id = ThinkingAnalyticsSDK.sharedInstance(context, TA_APP_ID).getDistinctId();
AppLovinSdk.getInstance(context).setUserIdentifier(ta_distinct_id);
- iOSのサンプル
ALSdk.shared()!.userIdentifier = ThinkingAnalyticsSDK.sharedInstance()!.getDistinctId()
4.2 インターフェースのパラメータ
-
API Key：
- レポートの取得に使用するAPI Key（つまりReport Key）を提供する必要があります。AppLovin管理画面の「Keys」タブで取得できます
-
プラットフォーム：
- 取得するデータのプラットフォーム、つまりAndroidかiOSかを個別に指定する必要があります
-
App：
- どのAppのデータを取得するかを指定する必要があります。AndroidとiOSでは、対応するパッケージ名またはアプリストアIDを渡す必要があります。これらの情報をThinkingAIの担当者に提供してください
-
時間：
- 日単位のデータを取得します
- UTCの各日の8時に、前日（UTC）のデータを取得できます。たとえば、UTCの2019-01-01のデータは、UTC時間2019-01-02 08:00:00以降に取得できます
4.3 データの格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます。1件のデータ（つまり1回の表示）が1件のイベントデータとして書き込まれます：
- データ内のuser_idをデータのゲストIDとして使用します。このフィールドはAEプロジェクトのゲストIDに対応している必要があります
- データ内のdateフィールド、つまり広告の表示時間をイベントの#event_timeとして使用します
- データのイベント名は applovin_ad_revenue_impression_level です
- その他のフィールドはすべて格納されます。返されるすべてのデータのフィールドの意味は次のとおりです：
| フィールド | 説明 | サンプル |
|---|---|---|
| Ad Format | 広告タイプ | INTER, BANNER, REWARD |
| Ad Placement | SDKでカスタマイズしたPlacement名 | Launch%20Screen |
| Ad Unit ID | MAX広告ID | 9ad0816ac071552a |
| Ad Unit Name | MAX広告名 | Control |
| Country | 2文字のCountry Code | gb |
| Custom Data | SDKで設定したカスタムデータ | gb |
| Date | 広告の露出時間 | 2019-07-29 15:53:07.39 |
| Device Type | デバイスタイプ | PHONE, TABLET |
| IDFA | iOSのIDFAまたはAndroidのGoogle Advertising ID | 860635ea-65bc-eaed-d355-1b5283b30b94 |
| IDFV | IDFV | 4CD1C3C4-3FD7-00F5-1635-7BC6D9387E60 |
| Network | 広告を表示したAd Network | 値は（MAX Mediation Documentation (applovin.com)）を参照してください。APPLOVIN_NETWORK |
| Placement | Ad NetworkのPlacement名 | MY_NATIVE_PLACEMENT |
| Revenue | 推定収益。FB Biddingの値を含む | 0.0121, 5.74466e-05 |
| User ID | SDKで設定したユーザーID。AEプロジェクトのゲストIDに対応します | 7634657898 |
| Waterfall | 広告Waterfallの名前 | LAT |
4.4 データ統合設定情報テンプレート
以上のドキュメントを読んだら、次の情報テンプレートに記入し、ThinkingAIの担当カスタマーサクセスマネージャーに送信することをお勧めします：
インターフェース：User Revenue API（表示レベル）
--------
会社名：XXX
AEプロジェクト環境：（SAAS/プライベートデプロイ）
AEプロジェクト名：XXX
AEプロジェクトAPP ID: XXX
データ受信URL push_url: XXX
---------
AppLovin api_key（つまりReport Key）：XXX
アプリストアのApp ID：XXX（Androidはcom.で始まり、iOSはidで始まります）
--------
API設定
履歴データの取得時間範囲：yyyy/mm/dd - yyyy/mm/dd
定期取得：毎日X時に前日のデータを取得（北京時間16:00以降、つまりUTC時間8:00以降をお勧めします）
5. Basic Reporting API
インターフェースの基本情報
| インターフェース名 | APIタイプ | 製品化 | データ粒度 | アトリビューションデータ | コストデータ | 収益データ | インプレッション | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|---|
| Basic Reporting API | プル型 | いいえ | 集計データ | はい | はい | はい | はい | はい |
ユーザー粒度の収益データのほかに、AppLovinは集約指標のAPI、つまりBasic Reporting APIも提供しています。
5.1 レポートタイプ
Basic Reporting APIは、広告主レポート（advertiser）とパブリッシャーレポート（publisher）という、まったく異なる2種類のレポートを提供しています。以下の各節では、この2種類のレポートをそれぞれ紹介します：
5.2 広告主レポート（advertiser）
5.2.1 インターフェースのパラメータ
- API Key：
- レポートの取得に使用するAPI Key（つまりReport Key）を提供する必要があります。AppLovin管理画面の「Keys」タブで取得できます
- 時間：
- UTCの日単位でデータを取得します。取得できるのは直近45日間のデータのみです
- フィルター：
- 指標タイプのフィールドでのフィルタリングに対応しています。たとえば、クリック数が500を超えるデータを抽出できます。SQLのhavingロジックに似ています
5.2.2 対象フィールド
以下は広告主レポートが返すフィールドです。実際の必要に応じて、返すフィールドを選択できます
| フィールド名 | デフォルトかどうか | 意味 |
|---|---|---|
| day | はい | レポートの日付 |
| impressions | はい | 露出数 |
| clicks | はい | クリック数 |
| ctr | はい | クリック率 |
| conversions | はい | コンバージョン数（つまりインストール数） |
| conversion_rate | はい | コンバージョン率（インストール数 / クリック数） |
| average_cpa | はい | 平均CPA（インストール） |
| average_cpc | はい | 平均CPC |
| ad | はい | 広告名 |
| country | はい | 英字2文字のCountry Code |
| campaign | はい | Campaign名 |
| app_id_external | はい | ハッシュ化されたアプリID |
| external_placement_id | エンコードされたアプリID | |
| traffic_source | はい | トラフィックソース。値はAppLovinまたはその他のexchangeチャンネル名です |
| ad_type | はい | 広告タイプ。値の例：GRAPHIC, VIDEO, REWARD, またはPLAY |
| cost | はい | 広告コスト |
| sales | はい | アプリ内課金の回数（Revenueコールバックの設定が必要） |
| first_purchase | 初回アプリ内課金のユーザー数（Revenueコールバックの設定が必要） | |
| size | はい | 広告サイズ。値の例：INTER, BANNER, MREC, LEADER, またはNATIVE |
| device_type | はい | デバイスタイプ。値の例：phone, tabletまたはother |
| platform | はい | デバイスプラットフォーム。値の例：android, ios, fireos, tvos |
| campaign_package_name | はい | プロモーションするAppのパッケージ名。Androidではpackage name、iOSではBundle IDです |
| campaign_store_id | プロモーションするAppのアプリストアID。Androidではpackage name、iOSではiTunes IDの数字部分です | |
| campaign_id_external | はい | Campaignの一意の識別子 |
| campaign_ad_type | はい | User Acquisition Campaignの場合、この値はuaです。Retargeting Campaignの場合、この値はrtです |
| application | プロモーションするApp名 |
5.2.3 格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
- Basic Reporting APIは集計データのため、固定値をユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐付けられていると考えてください
- データ内のdayフィールド、つまりデータの日付を、集計データの#event_timeとして設定します
- データのイベント名は applovin_advertiser です
- その他のフィールドはすべて格納されます
5.3 パブリッシャーレポート（publisher）
5.3.1 インターフェースのパラメータ
- API Key：
- レポートの取得に使用するAPI Key（つまりReport Key）を提供する必要があります。AppLovin管理画面の「Keys」タブで取得できます
- 時間：
- UTCの日単位でデータを取得します。取得できるのは直近45日間のデータのみです
- フィルター：
- 指標タイプのフィールドでのフィルタリングに対応しています。たとえば、クリック数が500を超えるデータを抽出できます。SQLのhavingロジックに似ています
5.3.2 対象フィールド
以下はパブリッシャーレポートが返すフィールドです。実際の必要に応じて、返すフィールドを選択できます
| フィールド名 | デフォルトかどうか | 意味 |
|---|---|---|
| day | はい | レポートの日付 |
| hour | はい | レポートの時間の値（直近30日間を取得する場合にのみこのフィールドが存在します） |
| impressions | はい | 露出数 |
| clicks | はい | クリック数 |
| ctr | はい | クリック率 |
| revenue | はい | マネタイズの総収益 |
| ecpm | はい | ECPM |
| country | はい | 英字2文字のCountry Code |
| ad_type | はい | 広告タイプ。値の例：GRAPHIC, PLAY, VIDEO, REWARD, またはMRAID |
| size | はい | 広告サイズ。値の例：INTER, BANNER, MREC, LEADER, またはNATIVE |
| device_type | はい | デバイスタイプ。値の例：phone, tabletまたはother |
| platform | はい | デバイスプラットフォーム。値の例：android, ios, fireos, tvos |
| application | はい | App名 |
| package_name | はい | プロモーションするAppのパッケージ名。Androidではpackage name、iOSではBundle IDです |
| store_id | プロモーションするAppのアプリストアID。Androidではpackage name、iOSではiTunes IDの数字部分で、取得できない場合はBundle IDとなります | |
| placement | はい | Placement名 |
| application_is_hidden | はい | そのAppがAppLovinのダッシュボードで非表示になっているかどうか |
| zone | はい | Zone名（アカウントでZonesが有効になっている場合のみ） |
| zone_id | はい | Zone ID（アカウントでZonesが有効になっている場合のみ） |
| bidding_integration | 統合の入札方式（値の例：MAXまたはAdmob Open Bidding） |
5.3.3 格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
- Basic Reporting APIは集計データのため、固定値をユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐付けられていると考えてください
- データ内のdayフィールド、つまりデータの日付を、集計データの#event_timeとして設定します
- データのイベント名は applovin_publisher です
- その他のフィールドはすべて格納されます
5.4 データ統合設定情報テンプレート
以上のドキュメントを読んだら、次の情報テンプレートに記入し、ThinkingAIの担当カスタマーサクセスマネージャーに送信することをお勧めします：
インターフェース：Basic Reporting API
--------
会社名：XXX
AEプロジェクト環境：（SAAS/プライベートデプロイ）
AEプロジェクト名：XXX
AEプロジェクトAPP ID: XXX
データ受信URL push_url: XXX
---------
AppLovin api_key（つまりReport Key）：XXX
取得するデータタイプ：[広告主/パブリッシャー]
取得するフィールド：XXX，XXX
履歴データの取得時間範囲：yyyy/mm/dd - yyyy/mm/dd（直近45日間のデータのみ取得できます）
定期取得：毎日X時に前日のデータを取得
5.5 データ検証
AEシステム管理画面の「データ管理」-「イベント管理」ページ、または「SQL IDE」ページで、次のイベントが格納されているかを検索できます：
- 広告主レポートのデータ：applovin_advertiser
- パブリッシャーレポートのデータ：applovin_publisher
6. Revenue Reporting API
インターフェースの基本情報
| インターフェース名 | APIタイプ | 製品化 | データ粒度 | アトリビューションデータ | コストデータ | 収益データ | インプレッション | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|---|
| Revenue Reporting API | プル型 | いいえ | 集計データ | はい | はい |
AppLovinは、Maxのマネタイズに特化した集約指標のAPI、つまりRevenue Reporting APIも提供しています。
6.1 インターフェースのパラメータ
- API Key：
- レポートの取得に使用するAPI Key（つまりReport Key）を提供する必要があります。AppLovin管理画面の「Keys」タブで取得できます
- 時間：
- UTCの日単位でデータを取得します。取得できるのは直近45日間のデータのみです
- フィルター：
- 指標タイプのフィールドでのフィルタリングに対応しています。たとえば、クリック数が500を超えるデータを抽出できます。SQLのhavingロジックに似ています
6.2 対象フィールド
以下はレポートが返すフィールドです。実際の必要に応じて、返すフィールドを選択できます
| フィールド | デフォルトかどうか | 説明 | サンプル |
|---|---|---|---|
| ad_format | はい | 広告タイプ | INTER, BANNER, REWARD |
| ad_unit_waterfall_name | はい | 広告Waterfallの名前 | LAT |
| application | はい | アプリ名 | My App |
| attempts | はい | Ad Networkの広告取得試行数（グループ化の取得フィールドにnetworkまたはnetwork_placementが存在する場合のみ使用可能。max_placementが存在する場合は使用不可） | 41734 |
| country | はい | 2文字のCountry Code | gb |
| custom_network_name | はい | カスタマイズした広告Ad Network名 | Custom Network |
| day | はい | 広告が露出した日付 | 2019-07-29 |
| device_type | はい | デバイスタイプ | PHONE, TABLET |
| ecpm | はい | 推定eCPM（米ドル） | 8.47 |
| estimated_revenue | はい | 推定総収益（米ドル） | 245.12 |
fill_rate | はい | 広告フィル率 = 広告レスポンス数 / 取得試行数（グループ化の取得フィールドにnetworkまたはnetwork_placementが存在する場合のみ使用可能。max_placementが存在する場合は使用不可） | .8512 |
has_idfa | はい | ユーザーの広告IDを取得できるかどうか。ユーザーがLATを有効にしている場合、またはGDPR適用地域でデータトラッキングをオフにしている場合、この値は0になり、それ以外の場合は1になります | 1 |
| hour | はい | レポートの時間の値（直近30日間を取得する場合にのみこのフィールドが存在します） | 20:00 |
| impressions | はい | 広告露出数 | 28942 |
| max_ad_unit | はい | MAX広告名 | My%20App%20Banners |
| max_ad_unit_id | はい | MAX広告ID | 9ad0816ac071552a |
| max_ad_unit_test | はい | 広告テストグループの名前 | Control |
| max_placement | SDKでカスタマイズしたPlacement名 | Launch%20Screen | |
| network | はい | 広告を表示したAd Network | 値は（MAX Mediation Documentation (applovin.com)）を参照してください。APPLOVIN_NETWORK |
| network_placement | はい | Ad NetworkのPlacement名 | MY_NATIVE_PLACEMENT |
| package_name | はい | パッケージ名。AndroidのApp Package NameとiOSのBundle ID (iOS) | com.test.app |
| platform | はい | プラットフォーム | android, ios |
| requests | 広告リクエスト数（network、network_placement、max_placementが存在する場合は使用不可） | 45651 | |
| responses | はい | 広告レスポンス数（グループ化の取得フィールドにnetworkまたはnetwork_placementが存在する場合のみ使用可能。max_placementが存在する場合は使用不可） | 39841 |
| store_id | プロモーションするAppのアプリストアID。Androidではpackage name、iOSではiTunes IDの数字部分です | 1207472156 |
6.3 格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
- Revenue Reporting APIは集計データのため、固定値をユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐付けられていると考えてください
- hourフィールドが存在しない場合（つまり30日より前のデータ）は、データ内のdayフィールド、つまりデータの日付を集計データの#event_timeとして設定します。hourが存在する場合は、dayとhourのフィールドを連結して集計データの#event_timeとします
- データのイベント名は applovin_maxreport です
- その他のフィールドはすべて格納されます
6.4 データ統合設定情報テンプレート
以上のドキュメントを読んだら、次の情報テンプレートに記入し、ThinkingAIの担当カスタマーサクセスマネージャーに送信することをお勧めします：
インターフェース：Revenue Reporting API
--------
会社名：XXX
AEプロジェクト環境：（SAAS/プライベートデプロイ）
AEプロジェクト名：XXX
AEプロジェクトAPP ID: XXX
データ受信URL push_url: XXX
---------
AppLovin api_key（つまりReport Key）：XXX
履歴データの取得時間範囲：yyyy/mm/dd - yyyy/mm/dd（直近45日間のデータのみ取得できます）
取得するフィールド：XXX，XXX
定期取得：毎日X時に前日のデータを取得
7. Probabilistic Report
インターフェースの基本情報
| インターフェース名 | APIタイプ | 製品化 | データ粒度 | アトリビューションデータ | コストデータ | 収益データ | インプレッション | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|---|
| Probabilistic Report | プル型 | いいえ | 集計データ | はい | はい | はい | はい |
Probabilistic ReportはBasic Reporting APIに似ていますが、主な違いは次のとおりです：
- 広告主レポートのデータにのみ対応しており、パブリッシャーレポートには対応していません
- インストールとコストに関連する指標は、すべて推定インストールデータに基づいています
7.1 インターフェースのパラメータ
- API Key：
- レポートの取得に使用するAPI Key（つまりReport Key）を提供する必要があります。AppLovin管理画面の「Keys」タブで取得できます
- 時間：
- UTCの日単位でデータを取得します。取得できるのは直近45日間のデータのみです
- フィルター：
- 指標タイプのフィールドでのフィルタリングに対応しています。たとえば、クリック数が500を超えるデータを抽出できます。SQLのhavingロジックに似ています
7.2 対象フィールド
以下は広告主レポートが返すフィールドです。実際の必要に応じて、返すフィールドを選択できます
| フィールド名 | デフォルトかどうか | 意味 |
|---|---|---|
| day | はい | レポートの日付 |
| impressions | はい | 露出数 |
| clicks | はい | クリック数 |
| ctr | はい | クリック率 |
| conversions | はい | コンバージョン数（つまりインストール数） |
| conversion_rate | はい | コンバージョン率（インストール数 / クリック数） |
| average_cpa | はい | 平均CPA（インストール） |
| average_cpc | はい | 平均CPC |
| ad | はい | 広告名 |
| country | はい | 英字2文字のCountry Code |
| campaign | はい | Campaign名 |
| app_id_external | はい | ハッシュ化されたアプリID |
| external_placement_id | エンコードされたアプリID | |
| traffic_source | はい | トラフィックソース。値はAppLovinまたはその他のexchangeチャンネル名です |
| ad_type | はい | 広告タイプ。値の例：GRAPHIC, VIDEO, REWARD, またはPLAY |
| cost | はい | 広告コスト |
| sales | はい | アプリ内課金の回数（Revenueコールバックの設定が必要） |
| first_purchase | 初回アプリ内課金のユーザー数（Revenueコールバックの設定が必要） | |
| size | はい | 広告サイズ。値の例：INTER, BANNER, MREC, LEADER, またはNATIVE |
| device_type | はい | デバイスタイプ。値の例：phone, tabletまたはother |
| platform | はい | デバイスプラットフォーム。値の例：android, ios, fireos, tvos |
| campaign_package_name | はい | プロモーションするAppのパッケージ名。Androidではpackage name、iOSではBundle IDです |
| campaign_store_id | プロモーションするAppのアプリストアID。Androidではpackage name、iOSではiTunes IDの数字部分です | |
| campaign_id_external | はい | Campaignの一意の識別子 |
| campaign_ad_type | はい | User Acquisition Campaignの場合、この値はuaです。Retargeting Campaignの場合、この値はrtです |
| application | プロモーションするApp名 |
7.3 格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
- Probabilistic Reportは集計データのため、固定値をユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐付けられていると考えてください
- データ内のdayフィールド、つまりデータの日付を、集計データの#event_timeとして設定します
- データのイベント名は applovin_prob_advertiser です
- その他のフィールドはすべて格納されます
7.4 データ統合設定情報テンプレート
以上のドキュメントを読んだら、次の情報テンプレートに記入し、ThinkingAIの担当カスタマーサクセスマネージャーに送信することをお勧めします：
インターフェース：Probabilistic Report
--------
会社名：XXX
AEプロジェクト環境：（SAAS/プライベートデプロイ）
AEプロジェクト名：XXX
AEプロジェクトAPP ID: XXX
データ受信URL push_url: XXX
---------
AppLovin api_key（つまりReport Key）：XXX
取得するフィールド：XXX，XXX（入力しない場合はデフォルトのフィールドを使用します）
履歴データの取得時間範囲：yyyy/mm/dd - yyyy/mm/dd（直近45日間のデータのみ取得できます）
定期取得：毎日X時に前日のデータを取得
このページは役に立ちましたか？