Pobieranie danych geograficznych na potrzeby eksperymentów

Aby automatycznie lub na dużą skalę pobierać dane na potrzeby eksperymentów GeoX, musisz użyć interfejsu Google Ads API. Następnie połącz te dane z nieprzetworzonymi, niefiltrowanymi i nieprzypisanymi danymi o konwersjach lub przychodach z wewnętrznego systemu CRM, punktu sprzedaży lub wewnętrznych baz danych sprzedaży.

Zalecana architektura przepływu pracy interfejsu API

Aby dokładnie pobierać dane o kampaniach i kosztach według segmentów geograficznych, postępuj zgodnie z tą architekturą:

• Usługa: użyj GoogleAdsService, a konkretnie metod Search lub SearchStream.

• Zasób: wysyłaj zapytania do geographic_view, aby sprawdzić gdzie użytkownik się znajdował lub czym się interesował. Jest to zwykle standard w przypadku eksperymentów GeoX. Możesz też wysyłać zapytania do location_view, aby sprawdzić skuteczność na podstawie konkretnych lokalizacji docelowych kampanii.

• Pola do uwzględnienia:

  • campaign.id
  • segments.date
  • segments.geo_target_city (lub region lub kraj w zależności od szczegółowości GeoX)
  • metrics.cost_micros

• Przykładowe zapytanie GAQL: w przypadku GeoX reklamodawcy pobierają dane o kosztach za pomocą interfejsu Google Ads API, a nie przypisanych konwersji (które powinny pochodzić z wewnętrznego systemu CRM lub systemów innych firm). Możesz użyć tego zapytania:

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

Przetwarzanie końcowe i wyodrębnianie danych

• Mapowanie segmentów geograficznych: interfejs API nie zwraca w widokach raportów nazw w postaci zwykłego tekstu (np. „Nowy Jork”) ani krótkich kodów (np. „501” lub „ES”). Pola takie jak segments.geo_target_city czy segments.geo_target_country zwracają ciąg nazwy zasobu wskazujący na GeoTargetConstant (np. geoTargetConstants/1023191). Wyodrębnij identyfikator liczbowy (1023191) i wyślij zapytanie do zasobu 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
  

  Możesz też wykonać złączenie lokalnie w kodzie. W tym celu pobierz statyczny plik CSV z lokalizacjami docelowymi w sekcji Lokalizacje docelowe.

• Konwersja kosztów: interfejs API zwraca wartości kosztów w mikrach. Aby uzyskać standardową wartość waluty wymaganą w przesyłanym pliku, musisz podzielić metrics.cost_micros przez 1 000 000.

Identyfikatory lokalizacji geograficznych na potrzeby mutacji kierowania

Podczas wykonywania mutacji kierowania na lokalizację w kampanii lub grupie reklam reklamodawcy muszą wyszukać i przekazać dokładny identyfikator GeoTargetConstant (geoTargetConstants/ID) wybranych regionów. Nie możesz przekazywać nieprzetworzonych kodów ISO ani Nielsena.

Typ regionu	Wymagany identyfikator interfejsu API (GeoTargetConstant)	Starszy format (nie używać)
Region DMA	Identyfikator 200501 (Nowy Jork)	Kod Nielsena (np. 501 dla Nowego Jorku)
Kraj	Identyfikator 2724 (Hiszpania)	Kod ISO (np. "ES" dla Hiszpanii)

Sprawdzone metody i typowe błędy formatowania

• Formatowanie daty: Pole segments.date zwraca ciągi dat w formacie ISO-8601 w formacie YYYY-MM-DD. W potoku ETL serializuj pola daty jawnie w postaci ciągów YYYY-MM-DD i unikaj otwierania wyeksportowanych plików CSV w aplikacjach do obsługi arkuszy kalkulacyjnych, które automatycznie zmieniają format kolumn dat.
• Zera wiodące w kodach pocztowych: traktuj kody pocztowe (np. 01234) jako ciągi znaków (VARCHAR lub STRING) w całym potoku danych, a nie jako liczby całkowite, aby zera wiodące nigdy nie były usuwane.
• Agregacja: Jeśli prowadzisz badanie wielokomórkowe, musisz podać osobne dane o wydatkach dla każdej kampanii eksperymentalnej.
• Łączenie danych o konwersjach: podczas łączenia z danymi o konwersjach z wewnętrznego systemu CRM lub wewnętrznych baz danych sprzedaży upewnij się, że dane o konwersjach mają te właściwości, aby zapewnić bezproblemowe przetwarzanie danych za pomocą interfejsu Google Ads API i GeoX:
  • Szereg czasowy dzienny: dane muszą być agregowane według dnia.
  • Poziom geograficzny: każda konwersja musi być przypisana do dokładnych jednostek geograficznych, które testujesz (np. kod pocztowy dostawy klienta musi być zgodny z rynkiem docelowym lub klastrem kodów pocztowych używanym w projekcie).
  • Wartości brutto: dane muszą być nieujemnymi wartościami bezwzględnymi, takimi jak przychody brutto lub liczba konwersji brutto. Jeśli Twój system CRM śledzi przychody netto z wartościami ujemnymi w przypadku zwrotów, musisz użyć wartości brutto na potrzeby eksperymentu i zastosować współczynnik zwrotów później.