Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

テスト用の地域データを取得する

GeoX テストの自動化されたデータ取得や大規模なデータ取得の場合は、Google Ads API を使用して費用と支出のデータを取得する必要があります。次に、このデータを、内部 CRM、POS（販売時点管理）、内部販売データベースから取得した、未加工、未フィルタ、未帰属のコンバージョンデータまたは収益データと組み合わせます。

推奨される API ワークフローアーキテクチャ

地域セグメント別にキャンペーンデータと費用データを正確に取得するには、次のアーキテクチャに従います。

サービス: GoogleAdsService、特に Search メソッドまたは SearchStream メソッドを使用します。
リソース: クエリ geographic_view を使用して、ユーザーの実際の所在地または関心のある地域を確認します。これは通常、GeoX テストの標準です。または、location_view をクエリして、キャンペーンのターゲットに設定された特定の地域に基づくパフォーマンスを確認します。

注: campaign_location_target_report は使用しないでください。この以前の AdWords API レポートは廃止されました。
含めるフィールド:
- campaign.id
- segments.date
- segments.geo_target_city （または、GeoX の粒度に応じて地域または国）
- metrics.cost_micros
GAQL クエリの例: GeoX の場合、広告主様は、費用指標を（内部 CRM またはサードパーティシステムから取得する）貢献度割り当てによるコンバージョンではなく、Google Ads API を使用して取得します。次のクエリを使用できます。
```
SELECT
  campaign.id,
  segments.date,
  segments.geo_target_city,
  metrics.cost_micros
FROM geographic_view
WHERE segments.date DURING LAST_30_DAYS
```
注: geographic_view は、特定の日付にインプレッション数または費用が記録された地域セグメントの行のみを返します。費用がゼロの日と地域を GeoX 時系列に含めるには、データパイプラインで、日付とターゲット地域の完全なデカルト積に対して左外部結合を実行します。

後処理とデータ抽出

地域セグメントのマッピング: API は、レポートビューでプレーンテキストの名前（「ニューヨーク」など）やショートコード（「501」や「ES」など）を返しません。segments.geo_target_city や segments.geo_target_country などのフィールドは、GeoTargetConstant を指すリソース名文字列（geoTargetConstants/1023191 など）を返します。数値 ID（1023191）を抽出し、geo_target_constant リソースをクエリします。
```
SELECT
  geo_target_constant.id,
  geo_target_constant.name,
  geo_target_constant.canonical_name
FROM geo_target_constant
WHERE geo_target_constant.id = 1023191
```
または、コード内でローカルに結合を実行するには、地域ターゲティングで静的な地域ターゲティングの CSV をダウンロードします。
費用の変換: API は費用値をマイクロ単位で返します。アップロードファイルに必要な標準の通貨値を出力するには、metrics.cost_micros を 1,000,000 で割る必要があります。

ターゲティングの変更に使用する地理位置情報 ID

キャンペーンまたは広告グループの地域ターゲティングの変更を実行する際、広告主様は選択した地域の正確な GeoTargetConstant ID（geoTargetConstants/ID）を検索して渡す必要があります。未加工の ISO コードまたは Nielsen コードを渡すことはできません。

リージョンタイプ	必要な API ID（`GeoTargetConstant`）	以前の形式（使用しないでください）
DMA 地域	ID `200501`（ニューヨークの場合）	Nielsen コード（ニューヨークの場合は `501` など）
国	ID `2724`（スペインの場合）	ISO コード（スペインの場合は `"ES"` など）

ベストプラクティスと一般的なフォーマットエラー

日付の形式: segments.date フィールドは、ISO-8601 の日付文字列を YYYY-MM-DD 形式で返します。ETL パイプラインで、日付フィールドを YYYY-MM-DD 文字列として明示的にシリアル化し、エクスポートされた CSV ファイルを、日付列を自動的に再フォーマットするスプレッドシートアプリケーションで開かないようにします。
郵便番号の先頭のゼロ: 郵便番号と ZIP コード（01234 など）を整数ではなく文字列型（VARCHAR または STRING）としてデータパイプライン全体で処理し、先頭のゼロが削除されないようにします。
集計: マルチセル調査を実施する場合は、各介入群の費用指標を個別に指定する必要があります。
コンバージョンデータの結合: 内部 CRM システムまたは内部販売データベースのコンバージョンデータと結合する場合は、Google Ads API データと GeoX でのシームレスなデータ処理を確保するため、コンバージョンデータに次のプロパティがあることを確認してください。
- 日次時系列: データは日単位で集計する必要があります。
- 地域レベル: すべてのコンバージョンを、テスト対象の正確な地域単位にマッピングする必要があります（たとえば、顧客の配送先郵便番号を、設計で使用されている DMA または郵便番号クラスタに一致させるなど）。
- 総額: データは、総収益や総コンバージョン数など、負でない絶対値にする必要があります。CRM で純収益を追跡し、払い戻しに負の値を使用している場合は、テストに総数を使用し、後で払い戻し率を適用する必要があります。

レポート

非同期エラー