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. Będziesz musiał połączyć je 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.

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, na które kierowana jest kampania.

  • Pola do uwzględnienia:

  • Przykładowe zapytanie GAQL: w przypadku GeoX reklamodawcy powinni pobierać 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. „Warszawa”) ani krótkich kodów (np. „501” lub „PL”). Pola takie jak segments.geo_target_city czy segments.geo_target_country zwracają ciąg nazwy zasobu wskazujący na GeoTargetConstant (np. geoTargetConstants/1023191). Programiści mogą bezpośrednio wysyłać zapytania do tabeli geo_target_constant:

    SELECT geo_target_constant.canonical_name
FROM geo_target_constant
WHERE geo_target_constant.resource_name = 'geoTargetConstants/{extracted_id}'

    Możesz też pobrać statyczny plik CSV z lokalizacjami geo graficznymi w sekcji Lokalizacje geograficzne, aby wykonać łączenie lokalnie w kodzie.

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

Kody kierowania (DMA i kraj)

Podczas wykonywania mutacji kierowania reklamodawcy muszą wyszukać i przekazać dokładny identyfikator GeoTargetConstant wybranych regionów. Nie możesz przekazywać nieprzetworzonych kodów ISO ani Nielsen.

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

Sprawdzone metody i typowe błędy formatowania

  • Formatowanie daty: pole segments.date zwraca dane w formacie YYYY-MM-DD. Aplikacje arkuszy kalkulacyjnych, takie jak Excel, często automatycznie zmieniają formaty dat. Aby mieć pewność, że zakres dat jest prawidłowo odczytywany w wymaganym formacie YYYY-MM-DD, najpierw prześlij plik do Arkuszy Google.
  • Zera wiodące: upewnij się, że zera wiodące w kodach pocztowych (np. 01234) nie są usuwane. Aby wymusić ciąg 5-cyfrowy, użyj w Arkuszach Google opcji „Niestandardowy format liczb”.
  • Agregacja: jeśli prowadzisz badanie wielokomórkowe, musisz podać osobne dane o wydatkach dla każdej grupy 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:
    • Szeregi czasowe dzienne: dane muszą być agregowane według dnia.
    • Poziom geograficzny: każda konwersja musi być powiązana z dokładnymi jednostkami geograficznymi, które testujesz (np. dopasowanie kodu pocztowego dostawy klienta do DMA lub klastra kodów pocztowych używanego w projekcie).
    • Wartości brutto: dane muszą być nieujemnymi wartościami bezwzględnymi, takimi jak przychód brutto lub łączna liczba konwersji. Jeśli Twój system CRM śledzi przychód 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.