Google Ads API でコンバージョンをレポートするには、特定のコンバージョン アクションに関するデータを取得するか、キャンペーン、広告グループ、広告などの他のリソースのコンバージョン指標を取得します。このガイドでは、その情報を取得する方法と、Google 広告管理画面の指標が Google Ads API の指標にどのようにマッピングされるかについて説明します。
特定のコンバージョン アクションに関するデータを取得する
既存のコンバージョン アクションの詳細は、conversion_action リソースを使用して取得できます。
たとえば、次のクエリは、すべてのコンバージョン アクションの名前、タイプ、ステータスを取得します。
SELECT
conversion_action.resource_name,
conversion_action.name,
conversion_action.type,
conversion_action.status
FROM conversion_action
conversion_action リソースで使用可能なすべてのフィールドを確認するか、Google 広告クエリビルダーを使用して独自のクエリを開始します。
他のリソースのコンバージョン指標を取得する
conversion_action で分割し、keyword_view や ad_group などの他のリソースをクエリするときに、conversions や all_conversions などのコンバージョン指標を取得できます。
たとえば、次のクエリは、過去 30 日間のキャンペーンの conversions 指標と conversions_value 指標を conversion_action で分割して取得します。
SELECT
campaign.name,
segments.conversion_action,
metrics.conversions,
metrics.conversions_value
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
segments.conversion_or_adjustment_lag_bucket やその他の指標フィールドなど、コンバージョン関連のフィールドの一部は、すべてのレポートで使用できるとは限りません。互換性のあるフィールドの一覧については、各リソースページをご覧ください。
よくある懸念事項
- データが最新ではない。
- コンバージョン データを確認する際は、パフォーマンス データがすぐに利用可能になるわけではないことに注意してください。コンバージョン データの更新頻度については、Google 広告のデータの更新速度に関するガイドをご覧ください。
- レポートが空です。
- 新しいコンバージョン アクションなど、指標がすべてゼロのレポートの行は返されません。
- Google Ads API を通じてカスタム列にアクセスできません。
- カスタム列は Google Ads API の対象外であり、レポートで取得できません。
地図のユーザー インターフェースの指標
Google 広告のユーザー インターフェースを使用してキャンペーンを表示すると、Google Ads API の指標に対応する多数の列が表示されます。次の表は、UI の列と API の同等の指標のマッピングをまとめたものです。