Tencent日次レポート
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| 日次レポート | API | 集計データ | ✅ | ✅ | ✅ | ✅ | ✅ |
Tencent Adsの日次レポートは、消費、クリック、表示などの指標を含む集約データのコールバックに対応しています
統合の流れ
Tencent Adsとのデータ統合の流れは以下のとおりです：
- AE管理画面にログインし、サードパーティ統合モジュールでTencent Ads日次レポートの統合プランを追加して関連する設定を完了し、認証用のコールバックURLをコピーします
- Tencent Ads開発者プラットフォームにアクセスし、開発者として登録してアプリを作成し、Client IDとClient Secretを取得します
- AE管理画面に戻り、先ほどのTencent Ads日次レポートの統合プランを編集してアプリのClient IDとSecretを使用し、認証リンクを開いて認証を完了します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. プランの設定
Tencent Adsのデータを統合する前に、まずAE管理画面で対応する統合プランを作成し、認証用のコールバックURLを取得する必要があります。このドキュメントに従って統合プランを作成してください
1.1 仮の認証情報の入力
まず、認証情報欄の「認証情報設定」ボタンをクリックし、表示される認証情報のポップアップで、一時的な認証情報として任意の値を入力します。Tencent Ads開発者プラットフォームでアプリを作成した後、この値を再度調整する必要があります。
1.2 定期取得
「定期取得」モジュールで、AEシステムがTencent Ads日次レポートのデータを定期的に取得する方針を設定できます。毎日の特定の時刻に一定期間のデータを取得するよう選択できます。取得したデータもデータ量に計上されるため、定期取得で長すぎる期間のデータを取得しないことをお勧めします
1.3 格納設定
データをイベントとして書き込むかどうかを制御できます。オフにすると、データはイベントテーブルに書き込まれなくなるため、この設定はオフにしないでください。
1.4 統合構成
最後に、統合構成モジュールでデータ取得の詳細設定を制御できます。データの時間集計粒度、取得する指標フィールドとディメンション、格納後のイベント名などが含まれます。
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 意味 |
|---|---|---|
| sink_event | event_name | 格納後のイベント名。カスタマイズ可能 |
| source | metrics | 取得するデータのフィールド。リスト型で、カスタマイズできます |
| group_by | 取得するデータの集約条件。リスト型で、カスタマイズできます | |
| extra_params | level | 取得するデータのレポートタイプレベル。カスタマイズできます |
- レポートタイプレベルと集約条件
レポートタイプレベルと集約条件によって、広告グループ単位で集約するか素材単位で集約するかなど、日次レポートのデータ粒度が決まります。1回のクエリで選択できるレポートタイプレベルは1つだけで、レポートタイプレベルごとに対応する集約条件が異なります。以下は、よく使われるレベルの一部とそれぞれが対応する集約条件です。詳しくは公式ドキュメントを参照してください。デフォルトのレポートタイプレベルと集約条件は、それぞれREPORT_LEVEL_ADと"date","ad_id","site_set"です。調整する場合は、レポートタイプレベルをextra_paramsに、集約条件をsource.group_byに記入してください：
| レポートタイプレベル | 説明 | デフォルト | 対応する集約条件 |
|---|---|---|---|
| REPORT_LEVEL_ADVERTISER | 広告主レベルのレポート | "date" | |
| REPORT_LEVEL_CAMPAIGN | キャンペーンレベルのレポート | "date", "campaign_id" | |
| REPORT_LEVEL_ADGROUP | 広告グループレベルのレポート | "date", "adgroup_id", "site_set" | |
| REPORT_LEVEL_AD | 広告レベルのレポート | はい | "date", "ad_id", "site_set" |
| REPORT_LEVEL_MATERIAL_VIDEO | 動画素材レポート | "date", "material_id", "site_set" | |
| REPORT_LEVEL_MATERIAL_IMAGE | 画像素材レポート | "date", "material_id", "site_set" |
- 取得フィールド
以下は、日次レポートでデフォルトで取得するグループフィールドです。グループフィールドは取得ディメンションの影響を受けることに注意してください。細かい粒度の集約条件では、それより粗い粒度の集約条件のグループフィールドも取得できます。たとえば"ad_id"を集約条件にすると、"campaign_name"、"adgroup_id"などの粗い粒度のグループフィールドも取得できます。調整する場合は、必要なグループフィールド名をsource.metricsに記述してください：
| グループ化フィールド | 説明 |
|---|---|
| campaign_name | 広告キャンペーン名 |
| campaign_id | 広告キャンペーンID |
| adgroup_name | 広告グループ名 |
| adgroup_id | 広告グループID |
| ad_name | 広告名 |
| ad_id | 広告ID |
| account_id | 広告アカウントID |
以下は、日次レポートが対応している指標の一部です。このレポートは指標が非常に多いため、ここではよく使われる指標の一部のみを掲載しています。すべての指標については公式ドキュメントを参照してください。調整する場合は、フィールド名をsource.metricsに記述してください：
| フィールド | 説明 |
|---|---|
| view_count | 露出数 |
| download_count | APPダウンロード完了数 |
| activated_count | APPアクティベーション総数 |
| activated_rate | APPダウンロードからのアクティベーション率 |
| thousand_display_price | 1,000回表示あたりの平均単価 |
| valid_click_count | クリック数 |
| ctr | クリック率 |
| cpc | 平均クリック単価 |
| cost | 費用 |
| key_page_view_cost | 主要ページ訪問コスト |
| coupon_click_count | （ゲーム）ギフト交換ボタンのクリック |
| coupon_issue_count | （ゲーム）ギフト（クーポン）配布数 |
| coupon_get_count | （ゲーム）ギフト（クーポン）受け取り数 |
| download_rate | APPダウンロード率 |
| download_cost | APPダウンロードコスト |
| install_count | APPインストール数 |
| install_cost | APPインストールコスト |
| click_activated_rate | APPクリックからのアクティベーション率 |
| activated_cost | APPアクティベーションコスト |
| app_register_count | 登録数（APP） |
| register_by_display_count | 登録数（ビュースルーアトリビューション） |
| app_register_cost | 登録コスト（APP） |
| app_order_cost | 注文コスト（APP） |
| app_checkout_count | 課金アクション数（APP） |
| app_checkout_by_display_count | 課金アクション数（ビュースルーアトリビューション） |
| app_checkout_cost | 課金アクションコスト（APP） |
| app_ad_paying_users | 広告収益化ユーザー数（APP） |
| ad_pur_val_app | 広告収益化金額（APP） |
| game_create_role_count | ゲーム内キャラクター作成数 |
| game_authorize_count | ゲーム認証数 |
| game_tutorial_finish_count | ゲームのチュートリアル完了数 |
| app_checkout_rate | クリックからの課金アクション率（APP） |
| app_activated_checkout_rate | アクティベーションからの課金アクション率（APP） |
| app_register_rate | 登録率（APP） |
| install_rate | APPインストール率 |
| first_pay_count | 初回課金アクションのユーザー数 |
| first_pay_rate | 初回アクティベーション課金率 |
| wechat_app_register_uv | WeChatミニゲーム登録者数 |
| no_interest_count | 「興味なし」のクリック数 |
| mini_game_register_users | ミニゲーム登録者数 |
| mini_game_register_cost | ミニゲーム登録コスト |
| mini_game_register_rate | ミニゲーム登録率 |
| mini_game_ad_monetization_users | ミニゲーム広告収益化ユーザー数 |
| mini_game_paying_count | ミニゲーム課金回数 |
| mini_game_paying_amount | ミニゲーム課金額 |
| mini_game_first_paying_users | ミニゲーム初回課金ユーザー数 |
| mini_game_create_role_users | ゲーム内キャラクター作成ユーザー数 |
| mini_game_create_role_cost | ゲーム内キャラクター作成コスト |
| mini_game_key_page_viewers | ミニゲーム主要ページ訪問ユーザー数 |
| mini_game_key_page_view_cost | ミニゲーム主要ページ訪問コスト |
| mini_game_ad_monetization_amount | ミニゲーム広告収益化金額 |
| key_page_view_rate | 主要ページ訪問率 |
| activate_register_rate | アクティベーションからの登録率 |
| key_behavior_conversions_count | 主要アクションのコンバージョン数 |
| key_behavior_conversions_cost | 主要アクションのコンバージョンコスト |
| key_behavior_conversions_rate | 主要アクションのコンバージョン率 |
| mini_game_ad_monetization_cost | ミニゲーム広告収益化コスト |
| mini_game_bf_uv | ミニゲーム復帰ユーザー数 |
| mini_game_bf_cost | ミニゲーム復帰コスト |
| mini_game_bf_income_uv | ミニゲーム復帰ユーザーの広告収益化ユーザー数 |
| mini_game_bf_income_amount | ミニゲーム復帰ユーザーの広告収益化金額 |
| mini_game_bf_income_d1_uv | ミニゲーム初日復帰ユーザーの広告収益化ユーザー数 |
| mini_game_bf_income_d1_amount | ミニゲーム初日復帰ユーザーの広告収益化金額 |
| mini_game_bf_income_d1_cost | ミニゲーム初日復帰ユーザーの広告収益化コスト |
1.5 認証用のポストバックURLの取得
上記の設定が完了したら、右上の「保存して許可する」をクリックし、認証情報を取得してください。最初のステップにある認証用のポストバックURLをコピーし、大切に保管してください。その後、「認証保留中」をクリックしてポップアップを閉じます：
「保存して許可する」をクリックした時点でプランは保存されるため、別途保存する必要はありません。これでAE管理画面での設定作業はひとまず完了です。次にTencent Adsの管理画面で関連する設定を完了してください。
2. 開発者登録とアプリの作成
次に、Tencent Ads開発者管理画面にログインし、別のQQアカウントで開発者として登録します。
開発者として登録したら、アプリケーション管理ボードで「新しいアプリを作成」をクリックします。
続いて、「アプリの作成」ページでアプリを作成します：
- アプリタイプは「サードパーティアプリケーション」を選択します
- アプリアイコン、アプリ名、アプリの説明は自由に設定できます
- コールバックURLには、AEシステムで取得した認証情報のURLを入力します
「権限の選択」で、少なくとも広告インサイト（Ads Insight）の権限を選択してください
アプリを作成したら、次にアプリのclient idとclient_secretを取得して控えておきます
3. AE管理画面に戻り、認証作業を完了
Tencentのアプリを作成したら、AE管理画面に戻り、先ほど作成したTencent統合プランを開いて、「認証情報」の下にある「認証情報設定」ボタンをクリックします：
次に、TencentアプリのClient IDとClient Secretを該当する欄に入力します。Login IDには認証時にログインする予定のQQアカウントまたはWeChatアカウントを入力します。Account ID Listには取得したい広告アカウントのIDを入力できます。複数のIDは “,” で区切ります。入力しない場合は、認証済みのすべての広告アカウントのデータを取得します。編集が完了したら保存ボタンをクリックします：
続いて右上の「保存して許可する」をクリックし、再度認証情報のポップアップに入ります。ここで「認証設定へ」をクリックすると、Tencentプラットフォームの認証ページが開きます
認証ページで広告アカウントにログインし、少なくとも「広告インサイト」のデータ権限を選択して、同意して認証するボタンをクリックすると認証が完了します
なお、ログインして認証したのが【QQ直接取引アカウント】の場合は、現在の顧客のプロモーションアカウントのデータ権限のみが付与されます。ログインして認証したのが【QQビジネスマネージャーアカウント】の場合は、そのマネージャーアカウント配下のすべてのプロモーションアカウントのデータ権限を取得できます。
認証が完了したら、「認証情報」で左下の「以上の2つのステップを完了しました」をクリックし、右下の「認証完了」をクリックして設定を終了します。これで、Tencentプラットフォームのデータ統合は完了です。
4. データの格納
4.1 格納ルール
- データ内のstart_dateフィールド、つまりデータの集約時間を、イベントの#event_timeとして使用します
- デフォルトのイベント名は —— tencent_ads_daily_report です
- その他のフィールドはすべて格納されます
4.2 標準化フィールド
Tencent日次レポートのデータの一部のフィールドについて、AEシステムは標準化処理を行います：
| 元フィールド | 標準化 | 説明 |
|---|---|---|
| campaign_name | te_ads_object.campaign_name | 広告キャンペーン名 |
| campaign_id | te_ads_object.campaign_id | 広告キャンペーンID |
| adgroup_name | te_ads_object.ad_group_name | 広告グループ名 |
| adgroup_id | te_ads_object.ad_group_id | 広告グループID |
| ad_name | te_ads_object.ad_name | 広告名 |
| ad_id | te_ads_object.ad_id | 広告ID |
| account_id | te_ads_object.account_id | 広告アカウントID |
| view_count | te_ads_object.impressions | 露出数 |
| valid_click_count | te_ads_object.clicks | クリック数 |
| cost | te_ads_object.cost | 費用 |
| install_count | te_ads_object.installs | APPインストール数 |