Geografische Daten für Tests abrufen

Für automatisierte oder umfangreiche Datenabrufe für GeoX-Tests müssen Sie die Google Ads API verwenden, um Kosten- und Ausgabendaten abzurufen. Anschließend kombinieren Sie diese Daten mit Rohdaten, ungefilterten Daten und Daten zu Conversions oder Umsätzen ohne Zuordnung aus Ihrem internen CRM-System, einem Kassensystem oder internen Verkaufsdatenbanken.

Empfohlene API-Workflowarchitektur

Wenn Sie Kampagnen- und Kostendaten nach geografischen Segmenten genau abrufen möchten, folgen Sie dieser Architektur:

• Dienst:Verwenden Sie GoogleAdsService, insbesondere die Methoden Search oder SearchStream.

• Ressource:Mit der Abfrage geographic_view können Sie sehen, wo sich der Nutzer physisch befand oder wofür er sich interessierte. Das ist in der Regel der Standard für GeoX-Tests. Alternativ können Sie location_view abfragen, um die Leistung basierend auf bestimmten Standorten zu sehen, auf die die Kampagne ausgerichtet ist.

• Einzuschließende Felder:

  • campaign.id
  • segments.date
  • segments.geo_target_city (oder Region oder Land, je nach GeoX-Granularität)
  • metrics.cost_micros

• Beispiel für eine GAQL-Abfrage:Für GeoX rufen Werbetreibende Kostenmesswerte über die Google Ads API ab und nicht über zugeordnete Conversions (die aus internen CRM- oder Drittanbietersystemen stammen sollten). Sie können die folgende Abfrage verwenden:

  SELECT
    campaign.id,
    segments.date,
    segments.geo_target_city,
    metrics.cost_micros
  FROM geographic_view
  WHERE segments.date DURING LAST_30_DAYS
  

Nachbearbeitung und Datenextraktion

• Zuordnung geografischer Segmente:Die API gibt in Berichtsansichten keine Namen im Klartext (z. B. „New York“) oder Shortcodes (z. B. „501“ oder „ES“) zurück. Felder wie segments.geo_target_city oder segments.geo_target_country geben einen Ressourcennamenstring zurück, der auf eine GeoTargetConstant verweist (z. B. geoTargetConstants/1023191). Extrahieren Sie die numerische ID (1023191) und fragen Sie die Ressource geo_target_constant ab:

  SELECT
    geo_target_constant.id,
    geo_target_constant.name,
    geo_target_constant.canonical_name
  FROM geo_target_constant
  WHERE geo_target_constant.id = 1023191
  

  Alternativ können Sie die statische CSV-Datei mit geografischen Zielvorhaben unter Geografische Zielvorhaben herunterladen, um den Join lokal im Code auszuführen.

• Kosten-Conversion:Die API gibt Kostenwerte in Mikros zurück. Sie müssen metrics.cost_micros durch 1.000.000 dividieren,um den Standardwährungswert zu erhalten,der in Ihrer Upload-Datei erforderlich ist.

Standort-IDs für Targeting-Mutationen

Wenn Werbetreibende Mutationen für das Standort-Targeting von Kampagnen oder Anzeigengruppen ausführen, müssen sie die genaue GeoTargetConstant-ID (geoTargetConstants/ID) für die ausgewählten Regionen abrufen und übergeben. Sie können keine Roh-ISO- oder Nielsen-Codes übergeben.

Regionstyp	Erforderliche API-ID (GeoTargetConstant)	Legacy-Format (nicht verwenden)
DMA-Region	ID 200501 (für New York)	Nielsen-Code (z. B. 501 für New York)
Land	ID 2724 (für Spanien)	ISO-Code (z. B. "ES" für Spanien)

Best Practices und häufige Formatierungsfehler

• Datumsformatierung:Im Feld segments.date werden Datumsstrings im ISO 8601-Format im Format YYYY-MM-DD zurückgegeben. Serialisieren Sie in Ihrer ETL-Pipeline Datumsfelder explizit als YYYY-MM-DD-Strings und vermeiden Sie es, exportierte CSV-Dateien in Tabellenanwendungen zu öffnen, die Datumsspalten automatisch neu formatieren.
• Führende Nullen in Postleitzahlen:Behandeln Sie Postleitzahlen (z. B. 01234) in Ihrer gesamten Datenpipeline als String-Typen (VARCHAR oder STRING) und nicht als Ganzzahlen, damit führende Nullen nicht entfernt werden.
• Aggregation:Wenn Sie eine Studie mit mehreren Testgruppen durchführen, müssen Sie separate Ausgabenmesswerte für jede Behandlungsgruppe angeben.
• Conversion-Daten zusammenführen:Wenn Sie Conversion-Daten aus einem internen CRM-System oder internen Verkaufsdatenbanken zusammenführen, müssen die Conversion-Daten die folgenden Eigenschaften haben, damit die Datenverarbeitung mit Google Ads API-Daten und GeoX reibungslos funktioniert:
  • Tägliche Zeitreihen: Die Daten müssen nach Tag aggregiert werden.
  • Geografische Ebene:Jede Conversion muss den geografischen Einheiten zugeordnet werden, die Sie testen. Das bedeutet, dass beispielsweise die Postleitzahl des Kunden mit der DMA oder dem Postleitzahlcluster übereinstimmen muss, die im Design verwendet werden.
  • Bruttowerte:Die Daten müssen nicht negative, absolute Werte wie Bruttoeinnahmen oder die Bruttoanzahl der Conversions sein. Wenn in Ihrem CRM der Nettoumsatz mit negativen Werten für Erstattungen erfasst wird, müssen Sie die Bruttozahlen für den Test verwenden und später ein Erstattungsverhältnis anwenden.