TikTok Audience Report
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| Audience Report | API | 集約指標 | ✅ | ✅ | ✅ | ✅ |
TikTok Audience Reportは、Basic Reportと比べて、ユーザーの集約グループのディメンション（オーディエンスディメンションと呼ばれます）をより多く提供しますが、返される指標の種類は比較的少なく、6-12時間の処理遅延があります。
統合の流れ
- TikTok API Businessプラットフォームにログインし、開発者アカウントを登録して、アプリを作成し認証情報を取得します
- AE管理画面にログインし、サードパーティ統合モジュールでTikTok Audience Reportプランを追加して、関連する設定を完了します
- TikTok APIアプリの認証URLを変更し、認証を完了します
- AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. 認証情報の取得
-
まず、TikTok API Businessページにアクセスし、TikTok広告アカウントにログインするか、新規登録する必要があります
-
次に、手順に従って開発者として登録します
-
開発者として登録したら、下図のようにアプリを1つ作成する必要があります。作成時のパラメータは、次のように設定できます：
- Application name：プロジェクト名。プロジェクトに合わせて名前を付けます
- App Description：プロジェクトの説明。備考情報を追加できます
- Callback Address：コールバックURL。作成時にはhttps://www.thinkingdata.cn/を入力しておき、後でAEシステムのデータコールバックURLに変更します
- Scope of Permission：アクセス可能なデータ権限。ここでは必ずReporting権限を選択してください。その他の権限は必要に応じて設定します
- 「Confirm」をクリックして確定すると、アプリは最初は保留状態になります。1～2日ほどでアプリは審査を通過します（ステータスがApprovedになります）。アプリのApp IDとSecretを取得します
2. プランの設定
TikTokプラットフォームでの準備が完了したら、AEシステムにログインし、「サードパーティ統合」モジュールで新しいプランの設定を完了できます。下図はTikTok Audience Reportの設定画面です。この章の内容に従ってプランを作成してください
2.1 認証情報の設定
「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップに前の手順で取得した認証情報を入力します：
APP IDとApp Secretは前の手順で取得したものです。Account IDには、データを取得するTikTok広告アカウントのIDを入力します
2.2 定期取得
「定期取得」モジュールで、AEシステムがTikTok Audience Reportのデータを定期的に取得する方針を設定できます。毎日の特定の時刻に一定期間のデータを取得するよう選択できます。取得したデータもデータ量に計上されるため、定期取得で長すぎる期間のデータを取得しないことをお勧めします
2.3 格納設定
データをイベントとして書き込むかどうかを制御できます。オフにすると、データはイベントテーブルに書き込まれなくなるため、この設定はオフにしないでください。
2.4 統合構成
最後に、統合構成モジュールでデータ取得の詳細設定を制御できます。データの時間集計粒度、取得する指標フィールドとディメンション、格納後のイベント名などが含まれます。
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 意味 |
|---|---|---|
| sink_event | event_name | 格納後のイベント名。カスタマイズ可能で、文字列型です。 |
| source | report_types | データの集約ディメンション。リスト型で、要素は1つだけ入力できます。つまり、一度に取得できる集約ディメンションは1つのみです。詳しくは後述の内容を参照してください |
time_granularity | データの時間集計粒度。つまり、取得したデータを日単位と時間単位のどちらで集計するか 選択可能な値: day、hour | |
| metrics | データ内の指標。リスト型 | |
| group_by | データ内のグループ化ディメンション。リスト型です |
- 集約ディメンション
Audience Reportでは以下の集約ディメンションを提供しています。Audience Reportでは、オーディエンスディメンションと広告ディメンションをそれぞれ1つしか選択できず、オーディエンスディメンションは必須、広告ディメンションは任意である点に注意してください。一部例外もあるため、詳しくは下表の備考欄を参照してください。
また、国（地域）別にグループ化する場合は、country_codeディメンションのみを使用できます：
| ディメンションタイプ | ディメンションフィールド | 説明 | 備考 | デフォルトかどうか |
|---|---|---|---|---|
広告ディメンション | advertiser_id | 広告主IDでグループ化 | ||
| campaign_id | キャンペーンIDでグループ化 | |||
| adgroup_id | 広告グループIDでグループ化 | |||
| ad_id | 広告IDでグループ化 | はい | ||
オーディエンスディメンション | country_code | 配信国でグループ化 | 国でグループ化する場合は、country_codeディメンションのみを使用できます | |
| gender | 性別でグループ化 | ageとgenderは同時に使用できます | ||
| age | 年齢でグループ化 | ageとgenderは同時に使用できます | ||
province_id | 省レベルの地域でグループ化。地域の選択可能な値は、地域ターゲティングを参照してください。 | 時間ディメンションと同時に使用できません | ||
| dma_id | 指定市場地域（DMA）でグループ化。この地域区分は米国にのみ存在します。選択可能な値は、地域ターゲティングを参照してください。 | 時間ディメンションと同時に使用できません | ||
| ac | ネットワークでグループ化 | |||
| language | オーディエンスの言語でグループ化 | |||
| platform | OSでグループ化 | はい | ||
| interest_category | 第1階層の興味・関心ターゲティングでグループ化 | 時間ディメンションと同時に使用できません | ||
| interest_category_tier2 | 第2階層の興味・関心ターゲティングでグループ化 | 時間ディメンションと同時に使用できません | ||
| interest_category_tier3 | 第3階層の興味・関心ターゲティングでグループ化 | 時間ディメンションと同時に使用できません | ||
| interest_category_tier4 | 第4階層の興味・関心ターゲティングでグループ化 | 時間ディメンションと同時に使用できません | ||
| behavior_id | 行動でグループ化 | 時間ディメンションと同時に使用できません | ||
| placement | 配信プレースメントでグループ化 | 時間ディメンションと同時に使用できません | ||
| device_brand_id | デバイスブランドでグループ化 | 時間ディメンションと同時に使用できません。また、このディメンションを使用する場合、lifetimeをtrueに設定できません |
Audience Reportが対応しているフィールドは非常に豊富です。以下では最も一般的なグループディメンションと指標フィールドのみを示します。完全なフィールドの一覧については、TikTokの指標リストを参照してください。
- グループ化ディメンション
下表は現在AEがデフォルトで取得するグループディメンションです（device_brand_name、behavior_name、action_category、action_scene、user_action、action_periodは除きます。この6つのフィールドはデフォルトでは取得しません。使用条件は表の説明を参照してください）。調整が必要な場合は、フィールド名をsource.group_byに記述してください：
| 指標 | 概要 | 詳細説明 |
|---|---|---|
| advertiser_id | 広告アカウントID | 必ず格納 |
| campaign_name | キャンペーン名 | キャンペーン名。CAMPAIGN、ADGROUP、ADレベルでのみ対応 |
| campaign_id | キャンペーンID | キャンペーンID。ADGROUP、ADレベルでのみ対応 |
| adgroup_name | 広告グループ名 | 広告グループ名。ADGROUP、ADレベルでのみ対応 |
| placement_type | プレースメント | プレースメント。ADGROUP、ADレベルでのみ対応 |
| adgroup_id | 広告グループID | 広告グループID。ADレベルでのみ対応 |
| aeo_type | AEO広告タイプ | AEO（App Event Optimization）広告タイプ。列挙値はAuto Bid Multi Bid IAEOで、AEO以外の広告グループでは-を返します。ADGROUPレベルでのみ対応 |
| ad_name | 広告名 | 広告名。ADレベルでのみ対応 |
| ad_text | 広告タイトル | 広告タイトル。ADレベルでのみ対応 |
| tt_app_id | プロモーションアプリID | プロモーションアプリID。ADGROUP、ADレベルでのみ対応。プロモーション対象がAppの場合に値があります |
| tt_app_name | プロモーションアプリ名 | プロモーションアプリ名。ADGROUP、ADレベルでのみ対応。プロモーション対象がAppの場合に値があります |
| mobile_app_id | Google PlayまたはApple App StoreにおけるプロモーションアプリのID | Google PlayまたはApple App StoreにおけるプロモーションアプリのID。ADGROUP、ADレベルでのみ対応。プロモーション対象がAppの場合に値があります |
| device_brand_name | デバイスブランド名 | ディメンションにdevice_brand_idが含まれる場合に、この指標に対応します。 |
| behavior_name | Behavior name | ディメンションにbehavior_idが含まれる場合に、この指標に対応します。 |
| action_category | 行動カテゴリ | ディメンションにbehavior_idが含まれる場合に、この指標に対応します。リアルタイムレポートのみ対応し、非同期レポートは対応していません。 |
| action_scene | 行動シーン。列挙値：VIDEO_RELATED（動画行動）、CREATOR_RELATED（クリエイター行動）。 | ディメンションにbehavior_idが含まれる場合に、この指標に対応します。リアルタイムレポートのみ対応し、非同期レポートは対応していません。 |
| user_action | ユーザー行動 | 動画行動シーンの場合、選択可能な値はWATCHED_TO_END（最後まで視聴）、LIKED（いいね）、COMMENTED（コメント）、SHARED（シェア）です。クリエイター行動シーンの場合、選択可能な値はFOLLOWING（フォロー）とVIEW_HOMEPAGE（ホームページの閲覧）です。 |
| action_period | 行動日数。選択可能な値：7, 15。 | リアルタイムレポートのみ対応し、非同期レポートは対応していません。 |
| promotion_type | Promotion type | プロモーションタイプ。選択可能な値はapp（アプリ）、website（ウェブサイト）、others（その他）です。ADGROUPとADレベルで対応。同期レポートと非同期レポートのどちらもこの指標に対応しています。 |
| dpa_target_audience_type | Target audience type for DPA | DPA広告のターゲットオーディエンスタイプ。ADGROUPとADレベルで対応。同期レポートと非同期レポートのどちらもこの指標に対応しています。 |
currency | 通貨 | 通貨コード（USDなど）。currencyを有効にするには、リクエストのdimensionsフィールドにadgroup_id/ ad_id/campaign_id/advertiser_idが含まれている必要があります。 |
- 指標フィールド
下表は現在AEがデフォルトで取得する指標フィールドです。調整が必要な場合は、フィールド名をsource.metricsに記述してください：
| 指標 | 概要 | 詳細説明 |
|---|---|---|
| spend | 総消費 | 選択した期間内に広告配信で発生した費用の金額。 |
| cpc | CPC | 広告費用を1回のクリックあたりで平均したコスト。 |
| cpm | CPM | 1000回の表示あたりに発生した平均費用。 |
| impressions | 表示数 | 広告の表示回数。 |
| clicks | クリック数 | 広告のクリック回数。 |
| ctr | CTR (%) | 広告の表示のうちクリックが発生した回数の割合。 |
| conversion | コンバージョン数 | 広告が目標コンバージョンを達成した回数。目標コンバージョンは作成時の配信設定によって異なります（カウント結果は表示時点に基づいて集計されます）。 |
| cost_per_conversion | コンバージョンコスト | 広告費用を1回のコンバージョンあたりで平均したコスト（カウント結果は表示時点に基づいて集計されます）。 |
conversion_rate | コンバージョン率（%） | 広告のクリックのうちコンバージョンが発生した回数の割合（カウント結果は表示時点に基づいて集計されます）。 |
| real_time_conversion | リアルタイムコンバージョン | 広告が目標コンバージョンを達成した回数。目標コンバージョンは作成時の配信設定によって異なります（カウント結果はコンバージョンイベントの発生時刻に基づいて集計されます） |
| real_time_cost_per_conversion | リアルタイムのコンバージョン単価 | 広告費用を1回のコンバージョンあたりで平均したコスト（カウント結果はコンバージョンイベントの発生時刻に基づいて集計されます） |
| real_time_conversion_rate | リアルタイムコンバージョン率（%） | 広告のクリックのうちコンバージョンが発生した回数の割合（カウント結果はコンバージョンイベントの発生時刻に基づいて集計されます） |
| result | 成果 | 広告が最終的に成果を達成した回数で、最適化目標に対応します。（カウント結果は表示時点に基づいて集計されます） |
| cost_per_result | 成果単価 | 1回の成果を獲得するためのコスト。（カウント結果は表示時点に基づいて集計されます） |
| result_rate | 成果率（%） | 広告の視聴またはクリックの過程で成果を獲得した割合。（カウント結果は表示時点に基づいて集計されます） |
| real_time_result | リアルタイム成果 | 広告が最終的に成果を達成した回数で、最適化目標に対応します。（カウント結果はコンバージョンイベントの発生時刻に基づいて集計されます） |
| real_time_cost_per_result | リアルタイムの成果単価 | 1回の成果を獲得するためのコスト。（カウント結果はコンバージョンイベントの発生時刻に基づいて集計されます） |
| real_time_result_rate | リアルタイム成果率（%） | 広告の視聴またはクリックの過程で成果を獲得した割合。（カウント結果はコンバージョンイベントの発生時刻に基づいて集計されます） |
2.5 データの格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
- TikTok Marketing APIが返すのは集約データであるため、固定値をこのデータのユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐付けられていると考えてください
- データ内のstat_time_dayまたはstat_time_hourフィールドを、集約データの#event_timeとして使用します
- デフォルトのイベント名は――tiktok_audience_reportです
2.6 標準化フィールド
データに次のイベントプロパティが存在する場合は、自動的に標準化処理を行います：
| 元フィールド | 標準化フィールド | 意味 |
|---|---|---|
| advertiser_id | te_ads_object.ad_account_id | 広告アカウントID |
| 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 |
| placement_type | te_ads_object.placement | 広告の配置 |
| mobile_app_id | te_ads_object.app_id | アプリID |
| tt_app_name | te_ads_object.app_name | アプリ名 |
| country_code | te_ads_object.country | 国・地域コード |
| currency | te_ads_object.currency | コストまたは収益の通貨 |
| impressions | te_ads_object.impressions | 露出数 |
| clicks | te_ads_object.clicks | クリック数 |
| conversion | te_ads_object.installs | コンバージョン数 |
| spend | te_ads_object.cost | ユーザー獲得コスト |
2.7 認証の完了
設定が完了したら、右上の「保存して許可する」をクリックしてプランの設定を保存します。次に、最後の認証作業を完了する必要があります：
まず、表示される「認証情報」ページで、最初のステップのアドレスをコピーします
再度TikTok API Businessページに戻り、先ほど作成したアプリを編集して、Advertiser redirect URLsに先ほどコピーした認証URLを貼り付けます。
最後に、AEの画面に戻って「認証設定へ」をクリックすると、TikTokの認証ページが開きます。認証ページの指示に従って認証を完了してください
認証が完了したら、「認証情報」で左下の「以上の2つのステップを完了しました」をクリックしてから、右下の「認証完了」をクリックして設定を終了します。これで、TikTok Audience Reportのデータ統合は完了です。