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 などのコンバージョン指標を取得できます。
たとえば、次のクエリは、キャンペーンの 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 広告 API を使用してカスタム列にアクセスできません。
- カスタム列は Google Ads API でサポートされておらず、レポートで取得できません。
ユーザー インターフェース指標をマッピングする
Google 広告の管理画面でキャンペーンを表示すると、Google 広告 API の指標に対応する多数の列が表示されます。次の表に、UI の列と API の同等の指標のマッピングを示します。