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 の同等の指標のマッピングをまとめたものです。