TikTok Basic Report
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| Basic Report | API | 集約指標 | ✅ | ✅ | ✅ | ✅ |
TikTok Basic Reportは広告ディメンションの集約グループを提供します。返されるデータには、表示、クリック、コンバージョン、広告獲得コストなど一連の指標データが含まれます。
統合の流れ
- TikTok API Businessプラットフォームにログインし、開発者アカウントを登録して、アプリを作成し認証情報を取得します
- AE管理画面にログインし、サードパーティ統合モジュールでTikTok Basic 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 Basic Reportの設定画面です。この章の内容に従ってプランを作成してください
2.1 認証情報の設定
「認証情報」の下にある「認証情報設定」ボタンをクリックし、ポップアップに前の手順で取得した認証情報を入力します：
APP IDとApp Secretは前の手順で取得したものです。Account IDには、データを取得するTikTok広告アカウントのIDを入力します
2.2 定期取得
「定期取得」モジュールで、AEシステムがTikTok Basic Reportのデータを定期的に取得する方針を設定できます。毎日の特定の時刻に一定期間のデータを取得するよう選択できます。取得したデータもデータ量に計上されるため、定期取得で長すぎる期間のデータを取得しないことをお勧めします
2.3 格納設定
データをイベントとして書き込むかどうかを制御できます。オフにすると、データはイベントテーブルに書き込まれなくなるため、この設定はオフにしないでください。
2.4 統合構成
最後に、統合構成モジュールでデータ取得の詳細設定を制御できます。データの時間集計粒度、取得する指標フィールドとディメンション、格納後のイベント名などが含まれます。
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 意味 |
|---|---|---|
| sink_event | event_name | 格納後のイベント名。カスタマイズ可能で、文字列型です。 |
| source | report_types | データの集約ディメンション。リスト型で、要素は1つだけ入力できます。つまり、一度に取得できる集約ディメンションは1つのみです。詳しくは後述の内容を参照してください |
time_granularity | データの時間集計粒度。つまり、取得したデータを日単位と時間単位のどちらで集計するか 選択可能な値: day、hour | |
| metrics | データ内の指標。リスト型 | |
| group_by | データ内のグループ化ディメンション。リスト型です |
- 集約ディメンション
Basic Reportでは以下の集約ディメンションを提供しています。Basic Reportで選択できるディメンションは1つのみである点に注意してください。国（地域）別にグループ化する場合は、country_codeディメンションのみを使用できます：
| ディメンションタイプ | ディメンションフィールド | 説明 | デフォルトかどうか |
|---|---|---|---|
広告ディメンション | advertiser_id | Advertiserレベル | |
| campaign_id | CAMPAIGNレベル | ||
| adgroup_id | ADGROUPレベル | ||
| ad_id | ADレベル | はい | |
| 国（地域）ディメンション | country_code | 国（地域）別にグループ化 |
広告ディメンションによって、取得できる指標フィールドや対応するフィルター条件が異なります。返されるフィールドとフィルターの備考情報に必ず注意し、選択した広告ディメンションで取得できるデータを把握してください。
Basic Reportが対応しているフィールドは非常に豊富です。以下では最も一般的なグループディメンションと指標フィールドのみを示します。完全なフィールドの一覧については、TikTokの指標リストを参照してください。
- グループ化ディメンション
下表は現在AEがデフォルトで取得するグループディメンションです。調整が必要な場合は、フィールド名をsource.group_byに記述してください：
| フィールド | 画面表示名 | 説明・備考 |
|---|---|---|
| advertiser_id | 広告アカウントID | 必ず格納 |
| campaign_name | キャンペーン名 | CAMPAIGN、ADGROUP、ADレベルでのみ対応 |
| campaign_id | キャンペーンID | ADGROUP、ADレベルでのみ対応 |
| adgroup_name | 広告グループ名 | ADGROUP、ADレベルでのみ対応 |
| adgroup_id | 広告グループID | 広告グループID。ADレベルでのみ対応 |
| placement_type | プレースメント | ADGROUP、ADレベルでのみ対応 |
aeo_type | AEO広告タイプ | 列挙値はAuto Bid、Multi Bid、IAEOで、AEO以外の広告グループでは-を返します。ADGROUPレベルでのみ対応 |
| ad_name | 広告名 | ADレベルでのみ対応 |
| ad_text | 広告タイトル | ADレベルでのみ対応 |
| tt_app_id | プロモーションアプリID | ADGROUP、ADレベルでのみ対応。プロモーション対象がAppの場合に値があります |
| tt_app_name | プロモーションアプリ名 | ADGROUP、ADレベルでのみ対応。プロモーション対象がAppの場合に値があります |
| mobile_app_id | アプリID | Google PlayまたはApple App StoreにおけるアプリのID。ADGROUP、ADレベルでのみ対応。プロモーション対象がAppの場合に値があります |
| promotion_type | プロモーションタイプ | 選択可能な値はapp（アプリ）、website（ウェブサイト）、others（その他）です。ADGROUPとADレベルで対応。同期レポートと非同期レポートのどちらもこの指標に対応しています。 |
| dpa_target_audience_type | DPA広告のターゲットオーディエンスタイプ | ADGROUPとADレベルで対応。同期レポートと非同期レポートのどちらもこの指標に対応しています。 |
currency | 通貨 | 通貨コード（USDなど）。currencyを有効にするには、リクエストの’dimensions‘フィールドにadgroup_id/ ad_id/campaign_id/advertiser_idが含まれている必要があります。 |
- 指標フィールド
下表は現在AEがデフォルトで取得する指標フィールドです。調整が必要な場合は、フィールド名をsource.metricsに記述してください：
| フィールド | 画面表示名 | 説明・備考 |
|---|---|---|
| spend | 総消費 | 選択した期間内に広告配信で発生した費用の金額。 |
| cash_spend | 現金消費 | 選択した期間内に広告配信で発生した現金の消費額。Advertiserレベルでのみ対応し、lifetimeおよび時間別のクエリには対応していません。 注意：指標の更新には24-48時間の遅延が発生する場合があります |
| voucher_spend | 広告クレジット消費 | 選択した期間内に広告配信で発生した広告クレジットの消費額。Advertiserレベルでのみ対応し、lifetimeおよび時間別のクエリには対応していません。 注意：指標の更新には24-48時間の遅延が発生する場合があります |
| cpc | CPC | 広告費用を1回のクリックあたりで平均したコスト。 |
| cpm | CPM | 1000回の表示あたりに発生した平均費用。 |
| impressions | 表示数 | 広告の表示回数。 |
| clicks | クリック数 | 広告のクリック回数。 |
| ctr | CTR (%) | 広告の表示のうちクリックが発生した回数の割合。 |
| reach | 総リーチ数 | 広告を少なくとも1回見た人数。この指標は推定値です。 |
| cost_per_1000_reached | リーチ1000人あたりのコスト | 1000人にリーチするための平均コスト。この指標は推定値です。 |
| 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 | リアルタイム成果率（%） | 広告の視聴またはクリックの過程で成果を獲得した割合。（カウント結果はコンバージョンイベントの発生時刻に基づいて集計されます） |
| secondary_goal_result | 深層目標の成果 | 広告が最終的に深層目標を達成した回数で、設定した深層目標に対応します。同じキャンペーンが異なる深層目標に対応する場合があるため、現在はキャンペーンディメンションでの成果数の合計を開示していません。対応する深層目標の成果数は広告グループディメンションで確認してください。 |
| cost_per_secondary_goal_result | 深層目標の成果単価 | 1回の深層目標の成果を獲得するためのコスト。同じキャンペーンが異なる深層目標に対応する場合があるため、現在はキャンペーンディメンションでの深層目標の成果単価を開示していません。対応する深層目標の成果単価は広告グループディメンションで確認してください。 |
| secondary_goal_result_rate | 深層目標の成果率（%） | 深層目標の成果数が広告の表示回数に占める割合。 |
| frequency | フリークエンシー | リーチしたユーザー1人あたりの平均視聴回数。 |
| real_time_app_install | リアルタイムアプリインストール | ユーザーがappでアクティベーションし、広告にアトリビューションされた回数。（カウント結果はコンバージョンイベントの発生時刻に基づいて集計されます） |
| real_time_app_install_cost | リアルタイムアプリインストールコスト | appインストール1回あたりのコスト。（カウント結果はコンバージョンイベントの発生時刻に基づいて集計されます） |
| app_install | アプリインストール | ユーザーがappでアクティベーションし、広告にアトリビューションされた回数。（カウント結果は表示時点に基づいて集計されます。） |
| cost_per_app_install | アプリインストールコスト | appインストール1回あたりのコスト。（カウント結果は表示時点に基づいて集計されます。） |
| registration | ユニーク登録数 | 重複排除後の、ユーザーがappで登録し、広告にアトリビューションされた回数。（カウント結果は表示時点に基づいて集計されます。） |
| cost_per_registration | ユニーク登録コスト | 重複排除後の登録1回あたりのコスト。（カウント結果は表示時点に基づいて集計されます。） |
| registration_rate | 登録率（%） | 重複排除後のユーザーの登録数がappアクティベーションに占める割合。（カウント結果は表示時点に基づいて集計されます。） |
2.5 データの格納ルール
デフォルトでは、取得したデータはイベントとしてAEプロジェクトに書き込まれます：
- TikTok Marketing APIが返すのは集約データであるため、固定値をこのデータのユーザー識別子として使用します。すべてのデータが1人の仮想ユーザーに紐付けられていると考えてください
- データ内のstat_time_dayまたはstat_time_hourフィールドを、集約データの#event_timeとして使用します
- デフォルトのイベント名は -- tiktok_marketing_api_data です
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 | クリック数 |
| app_install | te_ads_object.installs | コンバージョン数（インストール） |
| spend | te_ads_object.cost | ユーザー獲得コスト |
2.7 認証の完了
設定が完了したら、右上の「保存して許可する」をクリックしてプランの設定を保存します。次に、最後の認証作業を完了する必要があります：
まず、表示される「認証情報」ページで、最初のステップのアドレスをコピーします
再度TikTok API Businessページに戻り、先ほど作成したアプリを編集して、Advertiser redirect URLsに先ほどコピーした認証URLを貼り付けます。
最後に、AEの画面に戻って「認証設定へ」をクリックすると、TikTokの認証ページが開きます。認証ページの指示に従って認証を完了してください
認証が完了したら、「認証情報」で左下の「以上の2つのステップを完了しました」をクリックしてから、右下の「認証完了」をクリックして設定を終了します。これで、TikTok Basic Reportのデータ統合は完了です。