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

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

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

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

• サービス: GoogleAdsService、特に Search メソッドまたは SearchStream メソッドを使用します。

• リソース: クエリ geographic_view を使用して、ユーザーの実際の所在地または関心のある地域を確認します。これは通常、GeoX テストの標準です。または、location_view をクエリして、キャンペーンの対象地域に基づいてパフォーマンスを確認します。

• 含めるフィールド:

  • 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
  

後処理とデータ抽出

• 地域セグメントのマッピング: 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（ニューヨークの場合）	ニールセン コード（例: ニューヨークの場合は 501）
国	ID 2724（スペインの場合）	ISO コード（例: スペインの場合は "ES"）

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

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