Twitter Ads統合プラン
サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください
概要
インターフェースの概要
| インターフェース名 | タイプ | 粒度 | アトリビューション | コスト | 収益 | 表示 | クリック | コンバージョン |
|---|---|---|---|---|---|---|---|---|
| Analytic API | API | 集約指標 | ✅ | ✅ | ✅ | ✅ |
Twitter Ads Analytic APIは、Twitterが提供する集約データインターフェースで、同期と非同期の2種類のデータインターフェースがあります。非同期データインターフェースは分析機能とデータ期間の両面で同期データインターフェースより優れているため、AEシステムは非同期データインターフェースの統合に対応しています。
統合の流れ
Twitter Adsデータの統合手順は次のとおりです：
-
Twitterプラットフォームで次の作業を完了する必要があります：
- Twitter Developerアカウントを取得し、APPを作成してAPI KeyとAPI Tokenを取得します
- Ads APIの使用権限を申請します
- 広告アカウントのAccess TokenとAccess Secretを作成します（Ads APIの申請前にAccess TokenとAccess Secretを作成済みの場合は、再生成する必要があります）
-
AE管理画面にログインし、サードパーティ統合モジュールでTwitter Ads統合を追加して、統合プランを作成します
-
AEシステムがデータを正常に受信しているかを確認し、レポートを作成します
1. 統合前の準備
1.1 Twitter開発者アカウントの申請とAPPの作成
Twitter APIを呼び出してTwitter Adsのデータを取得するには、まずTwitter開発者アカウントを申請する必要があります。開発者アカウントの申請にはTwitter公式の審査があります。
審査に通過したら、APPを作成し、そのAPPのAPI KeyとAPI Tokenを控えておいてください。後でAds APIを呼び出す際に使用します。
1.2 Ads APIの使用権限の申請
Twitter開発者アカウントの申請とAPPの作成が完了したら、次にTwitterの担当者に連絡し、開発者アカウントでAds APIを使用できるよう権限を開通してもらう必要があります。申請には数日かかる場合があります。
1.3 Access TokenとAccess Secretの取得
Ads APIの使用権限が開通したら、次にAccess TokenとAccess Secretを取得する必要があります。開発者プラットフォームに戻り、Ads API権限を申請済みのアプリをクリックして「Keys and tokens」タブに移動し、「Access Token and Secret」欄の「Generate」ボタンをクリックして、Access TokenとAccess Secretを作成します。アカウントのAccess TokenとAccess Secretは必ず大切に保管してください。後でAds APIを呼び出す際に必要になります。
1.4 まとめ
Twitterで次の情報を取得する必要があります：
- TwitterアプリのAPI KeyとAPI Key Secret
- 広告アカウントのAccess TokenとAccess Secret
- 広告アカウントのAccount ID
2. プランの設定
Twitter Adsプラットフォームでの準備が完了したら、AEシステムにログインし、「サードパーティ統合」モジュールで新しいプランの設定を完了できます。下図はTwitter Ads Analytic APIの設定画面です。この章の内容に従ってプランを作成してください：
2.1 認証情報の設定
「認証情報」の「認証情報設定」ボタンをクリックし、ポップアップでTwitter Adsプラットフォームで取得した情報を入力します
このうち、Account ID Listには、データを取得するTwitter広告アカウントIDを入力します。複数の広告アカウントIDは "," で区切ります
2.2 定期取得
「定期取得」モジュールで、AEシステムがTwitter Ads Analytic APIのデータを定期的に取得する方針を設定できます。毎日の特定の時刻、または毎時に一定期間のデータを取得するよう選択できます。取得したデータもデータ量に計上されるため、定期取得で長すぎる期間のデータを取得しないことをお勧めします
2.3 イベントデータの格納設定
「イベントデータの格納設定」スイッチをオンにすると、コールバックされたデータはすべてイベントテーブルに書き込まれます。イベントデータの格納を有効にすることをお勧めします。
2.4 統合構成
最後に、統合構成モジュールでデータ取得の詳細設定を制御できます。データの時間集計粒度、取得する指標フィールドとディメンション、格納後のイベント名などが含まれます。
統合構成の内容はJSONです。次の内容に従ってカスタム設定できます：
| モジュール | 名前 | 意味 |
|---|---|---|
| sink_event | event_name | 格納後のイベント名。カスタマイズ可能で、文字列型です。 |
| source | time_granularity | データ取得の時間粒度。以下から選択できます：
|
| metrics | 対応するインターフェースの指標フィールド。リスト型で、カスタマイズ可能 | |
| transfer | double_columns | データ内の指標。リスト型です。ここに含まれるフィールドはデータ受信時に数値型で格納され、その他のフィールドは文字列（または時間）型で格納されます |
- グループ化ディメンション
Twitter Adsでは、Campaign、Ad Groupなど各階層の広告ディメンションを「エンティティ（Entity）」と呼びます。Analytic APIを呼び出す際は、分析ディメンションを1つしか使用できません。広告ディメンションの情報をできるだけ多く取得するため、AEシステムはデータ取得時に最も細かい粒度であるPROMOTED_TWEETを分析エンティティとし、エンティティの関連付けインターフェースを通じてCampaign ID、Line Item IDなど上位階層のエンティティ情報を取得します。次の表に、すべてのディメンションフィールドとその意味を示します：
| ディメンション名 | 意味 |
|---|---|
| account_id | 広告アカウントID |
| campaign_id | Campaign ID |
| campaign_name | Campaign名 |
| line_item_id | Line Item ID（Ad set ID） |
| line_item_name | Line Item Name（Ad set名） |
| promoted_tweet_id | Tweet ID |
| placement | プレースメント |
| entity_id | エンティティID |
| currency | 通貨 |
- 指標フィールド
Analytic APIには選択可能な指標グループが複数あり、各指標グループには複数の指標フィールドが含まれます。取得する指標グループはカスタマイズできます。次の表は各指標グループの常用指標を示しています。すべての指標の情報については、Twitter公式ドキュメントを参照してください。調整する場合は、指標グループ名をsource.metricsに、指標フィールド名をtransfer.double_columnsに記述してください
| 指標グループ | 指標フィールド | 意味 | デフォルトかどうか |
|---|---|---|---|
ENGAGEMENT | engagements | 総エンゲージメント数（オーガニック露出、リツイート、返信、共有、いいねなどの行為を含む） | はい |
| impressions | オーガニック露出数（有料プロモーションを含まない） | はい | |
| retweets | リツイート数 | はい | |
| replies | 返信数 | はい | |
| likes | いいね数 | はい | |
| follows | フォロー数 | はい | |
| card_engagements | カード総エンゲージメント数 | はい | |
| clicks | クリック数 | はい | |
| app_clicks | クリック後のAPPインストール数または起動数 | はい | |
| url_clicks | ツイートのリンクまたはWebサイトカードのクリック回数 | はい | |
| qualified_impressions | 完全に表示された露出数 | はい | |
| carousel_swipes | カルーセル画像または動画のスワイプ回数 | はい | |
| BILLING | billed_engagements | 課金エンゲージメント数 | はい |
| billed_charge_local_micro | 課金総額（1000000倍に拡大） | はい | |
VIDEO | video_total_views | 動画再生数 | はい |
| video_views_25 | 動画25%進捗の再生数 | はい | |
| video_views_50 | 動画50%進捗の再生数 | はい | |
| video_views_75 | 動画75%進捗の再生数 | はい | |
| video_views_100 | 動画の完全再生数 | はい | |
| video_cta_clicks | Call-to-actionのクリック数 | はい | |
| video_content_starts | 動画の再生開始数 | はい | |
| video_3s100pct_views | 動画の完全再生数（3秒以上視聴） | はい | |
| video_6s_views | 動画を6秒視聴した再生数 | はい | |
| video_15s_views | 動画を15秒または95%進捗まで視聴した再生数 | はい | |
| MEDIA | media_views | マルチメディア視聴数（自動再生とクリック再生を含む） | はい |
| media_engagements | マルチメディアエンゲージメント数 | はい | |
| WEB_CONVERSION | conversion_* | タイプがPURCHASE、SIGN_UP、SITE_VISIT、DOWNLOAD、CUSTOMのコンバージョンイベントで、その後に課金行為があったコンバージョン数 | |
| MOBILE_CONVERSION | mobile_conversion_* | ||
| LIFE_TIME_VALUE_MOBILE_CONVERSION | mobile_conversion_lifetime_value_* |
2.5 イベントの格納ルール
- データ内のdayフィールド、つまりデータの日付を、集計データの#event_timeとして設定します
- デフォルトのデータイベント名は -- twitter_ads_data です
- 指標フィールドは数値型で格納され、その他のフィールドは文字列型で格納されます
2.6 標準化フィールド
Twitter Ads Analytic APIのデータ内の一部のフィールドは、AEシステムによって標準化処理されます：
| フィールド | 標準化フィールド | 意味 |
|---|---|---|
| account_id | te_ads_object.ad_account_id | 広告アカウントID |
| campaign_name | te_ads_object.campaign_name | 広告キャンペーン名 |
| campaign_id | te_ads_object.campaign_id | 広告キャンペーンID |
| line_item_name | te_ads_object.ad_group_name | 広告グループ名 |
| line_item_id | te_ads_object.ad_group_id | 広告グループID |
| promoted_tweet_id | te_ads_object.ad_id | 広告ID |
| placement | te_ads_object.placement | 広告の配置 |
| currency | te_ads_object.currency | コストまたは収益の通貨 |
| impressions | te_ads_object.impressions | 露出数 |
| clicks | te_ads_object.clicks | クリック数 |
| billed_charge_local_micro（1000000で割る） | te_ads_object.cost | ユーザー獲得コスト |