OPPOマーケティングプラットフォーム統合プラン
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| ゲーム明細データ | API | 集約指標 | ✅ | ✅ | ✅ | ✅ | ✅ |
現在、AEはOPPOマーケティングプラットフォームのゲーム明細データの統合に対応しており、広告クリエイティブ階層のコスト、クリック、表示などの集約指標データを取得できます
統合の流れ
- OPPOマーケティング管理画面にログインし、APIキーを取得して、必要な認証情報を収集します
- AE管理画面にログインし、サードパーティ統合モジュールでOPPO統合プランを追加して、関連する設定を完了します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. 認証情報の取得
OPPOマーケティングプラットフォームのデータを統合する前に、データの取得に必要な基本情報を取得する必要があります。広告データを取得したいOPPOアカウントでOPPOマーケティングプラットフォームにログインし、「ツールボックス」-「アカウント補助」-「APIキー取得」をクリックして「APIキー」ページに移動します。まだキーを申請していない場合は、「キーを取得」ボタンをクリックしてキーを生成します：
キーを生成したら、広告主ID、API-ID、API-KEYの3つの情報を控えておく必要があります。これらの情報は後で統合プランを作成する際に使用しますので、大切に保管してください。
2. プランの設定
OPPO管理画面から認証情報を取得したら、AEシステムにログインし、「サードパーティ統合」モジュールで新しいプランの設定を完了できます。下図はOPPOゲーム明細データの設定画面です。この章の内容に従ってプランを作成してください：
2.1 認証情報の設定
「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップに前の手順で取得した情報を入力します：
APP IDとAPP Keyには、それぞれOPPO管理画面のAPI-IDとAPI-KEYを入力します。Account IDには広告主IDを入力します
2.2 定期取得
「定期取得」モジュールで、AEシステムがOPPOゲーム明細データを定期的に取得する方針を設定できます。毎日の特定の時刻に一定期間のデータを取得するよう選択できます。取得したデータもデータ量に計上されるため、定期取得で長すぎる期間のデータを取得しないことをお勧めします
2.3 格納設定
データをイベントとして書き込むかどうかを制御できます。オフにすると、データはイベントテーブルに書き込まれなくなるため、この設定はオフにしないでください。
2.4 統合構成
最後に、統合構成モジュールでデータ取得の詳細設定を制御できます。データの時間集計粒度、取得する指標フィールドとディメンション、格納後のイベント名などが含まれます。
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 意味 |
|---|---|---|
| sink_event | event_name | 格納後のイベント名。カスタマイズ可能 |
| transfer | fields_whitelist | 格納するフィールドのリストで、カスタマイズできます。OPPOゲーム明細データは返されるフィールドが多いため、このフィールドで格納するフィールドを絞り込んでいます。格納するフィールドを調整する場合は、以下を参照してください |
以下は、OPPOゲーム明細データが返すフィールドのリストです。一部のフィールドは格納されません。格納するフィールドを調整する場合は、フィールド名をtransfer.fields_whitelistに記述してください：
| 名前 | 格納の有無 | フィールド名と備考 |
|---|---|---|
| fdate | はい | データの日付（例：20210614） |
| app_id | はい | アプリID |
| app_name | はい | アプリ名 |
| owner_id | はい | 広告主ID |
| owner_name | はい | 広告主名 |
| group_id | はい | 広告グループID |
| group_name | はい | 広告グループ名 |
| plan_id | はい | キャンペーンID |
| plan_name | はい | キャンペーン名 |
| ad_id | はい | 広告ID |
| ad_name | はい | 広告名 |
| extension_type | はい | プロモーション目標：1 リンクプロモーション、2 アプリプロモーション、3 クイックアプリ、7 WeChatミニプログラムプロモーション、8 ライブ配信プロモーション |
| global_spec_id | はい | 統一規格ID |
| extension_flow | はい | プロモーショントラフィック：0 デフォルト値（意味なし）、1 全トラフィックシーン、2 自社トラフィック、3 アドネットワークトラフィック |
| flow_scene | はい | トラフィックシーン：0 デフォルト値（意味なし）、1 全トラフィックプロモーション、2 厳選プロモーション、3 インストール特典、4 必須アプリ、5 検索、6 インフィード、7 バナー、8 スプラッシュ、9 インタースティシャル、10 ネイティブ、11 リワード動画、12 アドネットワーク（制限なし）、13 表示最適化 |
| total_pay | はい | 総課金額（フェン） |
| ad_new_ssoid | はい | 登録者数 |
| ad_new_pay_ssoid | はい | 新規課金ユーザー数 |
| ad_new_pay | はい | 初日課金額（単位：フェン） |
| down_cnt | はい | ダウンロード数（検索＆配信：課金対象ダウンロード、インフィードとアドネットワーク：総ダウンロード） |
| expose_nums | はい | 露出数 |
| click_nums | はい | クリック数 |
| click_rate | はい | クリック率（小数） |
| down_rate | はい | ダウンロード率（小数） |
| register_rate | はい | 登録率（小数） |
| register_price | はい | 登録コスト |
| new_pay_price | はい | 課金コスト |
| active_nums | はい | アクティベーション数（広告経由のダウンロードで直近180日以内にアクティベーションしたユーザー） |
| active_rate | はい | アクティベーション率（小数） |
| new_pay_rate | はい | 課金コンバージョン率（小数） |
| ad_price | はい | 広告の実際の課金額（単位：フェン） |
| new_user_ltv1 | ゲーム課金LTV1（単位：フェン） | |
| new_user_ltv3 | ゲーム課金LTV3（単位：フェン） | |
| new_user_ltv7 | ゲーム課金LTV7（単位：フェン） | |
| new_user_ltv30 | ゲーム課金LTV30（単位：フェン） | |
| buy_user_income0 | はい | 初日広告収益（単位：フェン） |
| inter_buy_roi1 | 広告収益化ROI1 | |
| inter_buy_roi3 | 広告収益化ROI3 | |
| inter_buy_roi7 | 広告収益化ROI7 | |
| inter_buy_roi30 | 広告収益化ROI30 | |
| new_user_roi1 | ゲーム課金ROI1 | |
| new_user_roi3 | ゲーム課金ROI3 | |
| new_user_roi7 | ゲーム課金ROI7 | |
| new_user_roi30 | ゲーム課金ROI30 | |
| ecpm | はい | |
| click_price | はい | 平均クリック単価（単位：フェン） |
| down_price | はい | ダウンロードコスト（単位：フェン） |
| active_price | はい | アクティベーションコスト（単位：フェン） |
| inter_buy_ltv1 | 広告収益化LTV1（単位：フェン） | |
| inter_buy_ltv3 | 広告収益化LTV3（単位：フェン） | |
| inter_buy_ltv7 | 広告収益化LTV7（単位：フェン） | |
| inter_buy_ltv30 | 広告収益化LTV30（単位：フェン） | |
| 10per_total_pay | 1:9分配の課金額（単位：フェン） | |
| 50per_total_pay | 5:5分配の課金額（単位：フェン） | |
| pay_retention1 | 翌日継続数（課金） | |
| pay_retention3 | 3日継続数 | |
| pay_retention7 | 7日継続数 | |
| pay_retention14 | 14日継続数 | |
| pay_retention30 | 30日継続数 | |
| pay_retention1_rate | 翌日継続率 | |
| pay_retention3_rate | 3日継続率 | |
| pay_retention7_rate | 7日継続率 | |
| pay_retention14_rate | 14日継続率 | |
| pay_retention30_rate | 30日継続率 | |
| activate_nums | はい | 起動ユーザー数 |
| cash_retention1 | 翌日継続数（収益化） | |
| cash_retention3 | 3日継続数（収益化） | |
| cash_retention7 | 7日継続数（収益化） | |
| cash_retention1_rate | 翌日継続率（収益化） | |
| cash_retention3_rate | 3日継続率（収益化） | |
| cash_retention7_rate | 7日継続率（収益化） | |
| buy_user_income_active | はい | 購入トラフィックの広告収益（単位：フェン） |
| buy_user_income_active_roi | はい | 広告収益化アクティブROI |
| game_app_act_nums | はい | ゲームの主要アクション数 |
| game_app_act_price | はい | ゲームの主要アクションコスト（単位：フェン） |
| pay_nums | はい | 課金回数 |
| pay_per_price | はい | 1回あたりの課金コスト（単位：フェン） |
2.5 格納ルール
- ゲーム明細データは集約データのため、固定値をユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐づいていると考えてください
- データ内のfdateフィールド、つまりデータの集約時間を、イベントの#event_timeとして使用します
- デフォルトのイベント名：oppo_game_offline_data
- transfer.fields_whitelist内のフィールドはすべて格納されます
2.6 標準化フィールド
AEシステムは以下のフィールドを標準化処理します：
| 元フィールド | 標準化フィールド | 意味 |
|---|---|---|
| owner_id | te_ads_object.ad_account_id | 広告アカウントID |
| plan_id | te_ads_object.campaign_id | 広告キャンペーンID |
| plan_name | te_ads_object.campaign_name | 広告キャンペーン名 |
| group_id | te_ads_object.ad_group_id | 広告グループID |
| group_name | te_ads_object.ad_group_name | 広告グループ名 |
| ad_id | te_ads_object.ad_id | 広告ID |
| ad_name | te_ads_object.ad_name | 広告名 |
| app_name | te_ads_object.app_name | アプリ名 |
| expose_nums | te_ads_object.impressions | 露出数 |
| click_nums | te_ads_object.clicks | クリック数 |
| down_cnt | te_ads_object.installs | コンバージョン数 |
| ad_price | te_ads_object.cost | 購入トラフィックのコスト。100で割った値で、単位は元 |
| buy_user_income_active | te_ads_object.revenue | 収益化の収益。100で割った値で、単位は元 |