For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.
X 広告
AmplitudeのX広告連携は、X広告の支出額、クリック数、インプレッション数データをインポートして、Amplitudeでの分析に使用します。
この連携は、X Adsからキャンペーンレベルのメトリクスを1日1回インポートします。これらのメトリクスは広告レベルのメトリクスとしてAmplitudeに表示され、個々のユーザーに関連付けられることはありません。
Amplitudeでは、広告データはDaily Ad Metricsという専用のイベントとして表示され、以下のようなイベントプロパティが含まれます:
ad_metrics.impressionsad_metrics.clicksad_group_idcampaign_id
Daily Ad Metrics には以下のユーザープロパティが含まれています。これらのプロパティは、キャンペーン分析や、カスタマー新規獲得単価(CAC)や広告費用対効果(ROAS)などのその他の指標の計算に使用できます。
utm_mediumutm_campaignutm_content
UTM パラメータには手動での設定が必要です。
X Ads では、UTM パラメータはデフォルトで自動入力されません。これらのフィールドを確実にAmplitudeに表示するには、UTMパラメータを広告URLに追加してください。
前提条件
開始する前に、次のものが揃っていることを確認してください。
- 管理者アクセス権を持つX広告マネージャーアカウント。これにより、Amplitudeは広告アカウントデータを読み取る権限を得ることができます。
- 管理者ユーザーの下に少なくとも1つのX広告アカウントが必要です。 認証後、Amplitudeはアクセス可能なすべての広告アカウントのリストを表示します。
Amplitudeの設定。
Amplitudeでの連携を有効にするには:
- データソースに移動し、X 広告を見つけます。
- 接続の表示名を入力します。
- データをインポートしたいX広告アカウントを選択します。
- 指定した期間(最大1年間)の履歴データをインポートすることを選択できます。Amplitudeはこのデータをバックフィルし、毎日インポートを続けます。
- インポート前に X 広告のデータが完了するまで待機する日数を選択します。
- 1日:データはより早く利用可能になりますが、X Adsからの訂正が遅れる可能性があるため、クリック数、支出額、インプレッション数が過小評価されるリスクが高くなります。
- 3日:データの入手は遅くなりますが、X Adsはボットトラフィックやコンバージョンの遅延、アトリビューションの変更などを遡及的に調整する場合があるため、より正確なメトリクスとなります。
- [保存] をクリックして連携を作成します。
データを分析する
X広告データをインポートした後、Out-of-the-Boxマーケティング分析の広告パフォーマンスダッシュボードでキャンペーンのパフォーマンスを分析してください。
サポートされているプロパティ:
X Adsは、このセクションに記載されているプロパティを提供します。
イベントプロパティ
| プロパティ名 | 概要 |
|---|---|
ad_account_id | 接続されている X 広告アカウントの ID。 |
ad_group_id | 広告グループの ID。 |
ad_group_name | 広告グループの名前です。 |
ad_group_status | 広告グループの現在のステータスです。 |
ad_id | 広告のID。 |
ad_metrics.app_clicks | アプリ固有のクリック数。 |
ad_metrics.clicks | 広告に対するクリック数です。 |
ad_metrics.cost | 広告に関連付けられた総コスト。 |
ad_metrics.impressions | 広告がユーザーに表示された回数。 |
ad_metrics.retweets | 記録されたリツイート数。 |
ad_metrics.url_clicks | 外部URLへのリンクのクリック数。 |
ad_platform | 広告のプラットフォームソース(値は「x」)。 |
campaign_currency | キャンペーンの費用に使用された通貨。 |
campaign_id | キャンペーンのIDです。 |
campaign_name | キャンペーンの名前です。 |
campaign_status | キャンペーンの現在のステータス。 |
tweet_id | プロモーション広告で使用されているツイートのIDです。 |
ユーザープロパティ
X広告URLにUTMパラメータが含まれている場合、Amplitudeは以下のユーザープロパティをキャプチャします。
| プロパティ名 | 概要 |
|---|---|
utm_source | ユーザーを紹介したソース。 |
utm_medium | 広告媒体またはマーケティング媒体。 |
utm_campaign | UTMトラッキングからのキャンペーン名。 |
utm_content | 広告コンテンツまたはUTMトラッキングからのバリエーション。 |
utm_term | UTM トラッキングからの検索語またはキーワード。 |
トラブルシューティング
連携を構築する際には、次のような潜在的な問題に留意してください。
権限が不十分です
X 広告マネージャーアカウントには管理者権限が必要です。 この権限レベルにより、AmplitudeはX広告の特定のユーザーリストからユーザーを追加したり削除したりできます。
毎日の広告メトリックの不一致
X Adsは、最初のインタラクションの数日後に広告指標を更新することがあります。 これは、変換アトリビューションの遅延や無効なトラフィックの削除など、さまざまな理由で発生する可能性があります。 たとえば、あるユーザーが今日広告をクリックしたが、数日間コンバージョンが完了しないとします。 コンバージョン後、X はそれを数日前のクリックに遡って帰属させます。
また、X は詐欺的または非人間的であると検出したクリックを除外することもできます。 このため、報告されるインプレッション数や支出額が減少する可能性があります。 これらの更新は、コンバージョン、コスト、インプレッションなどの主要な指標に影響を与えます。
Amplitudeは1日1回、常に前日のX広告データをインポートします。インポートは毎日のバッチ処理で行われるため、リアルタイムで利用することも、時間ごとの分析を行うこともできません。
Amplitudeのインポートが完了した後にXがキャンペーンデータを修正した場合、それらの変更は自動的には表示されません。 最も正確なレポートを確保するには、手動でバックフィルをトリガーして、影響を受ける期間のメトリクスを更新してください。
キャンペーンのパフォーマンスを分析する際、特に短期的な傾向を確認したり、異常を診断したり、ツール間でメトリックを比較したりする際には、この点を考慮してください。 インポート時に正確に見えるデータは、X広告のこれらの遡及的更新のために数日後に変化することがあります。
広告イベントはユーザーにマップされません
X Adsは、デバイスID、メールアドレス、ユーザーIDなどのユーザーレベルの識別子をエクスポートしません。 その結果、Daily Ad MetricsイベントはAmplitudeのユーザープロフィールにリンクされることはなく、他のプロダクトイベント全体で既知のユーザーと関連付けられることもありません。
これらのイベントは、合成識別子(X AdsデバイスIDなど)を使用してユーザーストリームに表示されることがありますが、これはID解決が成功したことを意味するものではありません。Amplitudeはイベントをスタンドアロンのエントリとして扱います。これはユーザーレベルのレポート作成には適していません。
Daily Ad Metrics イベントはキャンペーンレベルの分析に最適です。 Amplitudeは、ユーザーIDに依存するファネル、コホート定義、行動ジャーニーからユーザーを除外することを推奨しています。
これは役に立ちましたか?