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_view
などの他のリソースをクエリする際に、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 の同等の指標のマッピングをまとめたものです。