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 広告クエリビルダーを使用して独自のクエリを作成します。
他のリソースのコンバージョン指標を取得する
keyword_view
や ad_group_view
などの他のリソースをクエリする場合は、conversion_action
でセグメント化して、conversions
や all_conversions
などのコンバージョン指標を取得できます。
たとえば、次のクエリは、キャンペーンの conversions
指標と conversions_value
指標を conversion_action
で分割して取得します。
SELECT
campaign.name,
segments.conversion_action,
metrics.conversions,
metrics.conversions_value
FROM campaign
なお、segments.conversion_or_adjustment_lag_bucket
やその他の指標フィールドなど、一部のコンバージョン関連フィールドは、すべてのレポートで使用できるとは限りません。互換性のあるフィールドの一覧については、それぞれのリソースページをご覧ください。
一般的な懸念事項
- データが最新ではありません。
- コンバージョン データを確認する際は、パフォーマンス データがすぐに利用できない点に留意してください。コンバージョン データの更新頻度については、Google 広告のデータの更新頻度に関するガイドをご覧ください。
- レポートに何も表示されません。
- 新しいコンバージョン アクションなど、指標がすべてゼロであるレポートの行は返されません。
- Google Ads API からカスタム列にアクセスできません。
- カスタム列は Google Ads API ではサポートされていないため、レポートで取得することはできません。
ユーザー インターフェースの指標をマッピングする
Google 広告管理画面でキャンペーンを表示すると、Google Ads API の指標に対応する多数の列が表示されます。次の表は、UI の列と API の同等の指標のマッピングをまとめたものです。