Tencent新版配信日次レポート
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| 新版配信日次レポート | API | 集計データ | ✅ | ✅ | ✅ | ✅ | ✅ |
Tencent Adsの新版配信日次レポートは、消費、クリック、表示などの指標を含む集約データのコールバックに対応しています
統合の流れ
Tencent Adsとのデータ統合の流れは以下のとおりです：
- AE管理画面にログインし、サードパーティ統合モジュールでTencent新版配信日次レポートの統合プランを追加して関連する設定を完了し、認証用のコールバックURLをコピーします
- Tencent Ads開発者プラットフォームにアクセスし、開発者として登録してアプリを作成し、Client IDとClient Secretを取得します
- AE管理画面に戻り、先ほどのTencent新版配信日次レポートの統合プランを編集してアプリのClient IDとSecretを使用し、認証リンクを開いて認証を完了します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. プランの設定
Tencent Adsのデータを統合する前に、まずAE管理画面で対応する統合プランを作成し、認証用のコールバックURLを取得する必要があります。このドキュメントに従って統合プランを作成してください
1.1 仮の認証情報の入力
まず、認証情報欄の「認証情報設定」ボタンをクリックし、表示される認証情報のポップアップで、一時的な認証情報として任意の値を入力します。Tencent Ads開発者プラットフォームでアプリを作成した後、この値を再度調整する必要があります。
1.2 定期取得
「定期取得」モジュールで、AEシステムがTencent新版配信日次レポートのデータを定期的に取得する方針を設定できます。毎日の特定の時刻に一定期間のデータを取得するよう選択できます。取得したデータもデータ量に計上されるため、定期取得で長すぎる期間のデータを取得しないことをお勧めします
1.3 格納設定
データをイベントとして書き込むかどうかを制御できます。オフにすると、データはイベントテーブルに書き込まれなくなるため、この設定はオフにしないでください。
1.4 統合構成
最後に、統合構成モジュールでデータ取得の詳細設定を制御できます。データの時間集計粒度、取得する指標フィールドとディメンション、格納後のイベント名などが含まれます。
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 意味 |
|---|---|---|
| sink_event | event_name | 格納後のイベント名。カスタマイズ可能 |
| source | metrics | 取得するデータのフィールド。リスト型で、カスタマイズできます |
| group_by | 取得するデータの集約条件。リスト型で、カスタマイズできます | |
| transfer | double_columns | 取得するデータのフィールド（つまりsource.metrics）のうち、数値に変換する必要があるフィールド。このリストにないフィールドは文字列に変換して格納されます。リスト型で、カスタマイズできます |
| extra_params | level | 取得するデータのレポートタイプレベル。カスタマイズできます |
- レポートタイプレベルと集約条件
レポートタイプレベルと集約条件によって、広告単位で集約するかクリエイティブ単位で集約するかなど、日次レポートのデータ粒度が決まります。1回のクエリで選択できるレポートタイプレベルは1つだけで、レポートタイプレベルごとに対応する集約条件が異なります。以下は、よく使われるレベルの一部とそれぞれが対応する集約条件です。調整する場合は、レポートタイプレベルをextra_paramsに、集約条件をsource.group_byに記入してください：
| レポートタイプレベル | 説明 | デフォルト | 対応する集約条件 |
|---|---|---|---|
| REPORT_LEVEL_ADVERTISER | 広告主レベルのレポート | "date" | |
| REPORT_LEVEL_ADGROUP | 広告レベルのレポート | "date", "adgroup_id" | |
| REPORT_LEVEL_DYNAMIC_CREATIVE | 広告クリエイティブレベルのレポート | はい | "date", "dynamic_creative_id" |
- 取得フィールド
以下は、新版配信日次レポートでデフォルトで取得するグループフィールドです。グループフィールドは取得ディメンションの影響を受けることに注意してください。細かい粒度の集約条件では、それより粗い粒度の集約条件のグループフィールドも取得できます。たとえば"dynamic_creative_id"を集約条件にすると、"account_id"、"adgroup_id"などの粗い粒度のグループフィールドも取得できます。調整する場合は、必要なグループフィールド名をsource.metricsに記述してください：
| グループ化フィールド | 説明 |
|---|---|
| adgroup_id | 広告ID |
| dynamic_creative_name | クリエイティブ名 |
| dynamic_creative_id | クリエイティブID |
| account_id | 広告アカウントID |
以下は、日次レポートが対応している指標の一部です。このレポートは指標が非常に多いため、ここではよく使われる指標の一部のみを掲載しています。すべての指標については公式ドキュメントを参照してください（プランで設定したlevelを選択してください）。調整する場合は、フィールド名をsource.metricsに記述してください：
| フィールド | 説明 |
|---|---|
| view_count | 露出数 |
| view_user_count | インプレッションユーザー数 |
| valid_click_count | クリック数 |
| click_user_count | クリックユーザー数 |
| ctr | クリック率 |
| cpc | 平均クリック単価 |
| cost | 費用 |
| conversion_count | 目標コンバージョン数 |
| conversion_rate | 目標コンバージョン率 |
| conversion_cost | 目標コンバージョンコスト |
| download_count | APPダウンロード完了数 |
| activated_count | APPアクティベーション総数 |
| activated_rate | APPダウンロードからのアクティベーション率 |
| activated_cost | APPアクティベーションコスト |
| thousand_display_price | 1,000回表示あたりの平均単価 |
| download_rate | APPダウンロード率 |
| download_cost | APPダウンロードコスト |
| install_count | APPインストール数 |
| install_rate | APPインストール率 |
| install_cost | APPインストールコスト |
| click_activated_rate | APPクリックからのアクティベーション率 |
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_v3 です
- その他のフィールドはすべて格納されます
4.2 標準化フィールド
Tencent新版配信日次レポートのデータの一部のフィールドについて、AEシステムは標準化処理を行います：
| 元フィールド | 標準化 | 説明 |
|---|---|---|
| adgroup_id | te_ads_object.ad_group_id | 広告グループID |
| dynamic_creative_name | te_ads_object.ad_name | 広告名 |
| dynamic_creative_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インストール数 |