Raportowanie wzrostu

Aby mierzyć wpływ przyczynowo-skutkowy kampanii reklamowych na postrzeganie marki, konwersje, wartość konwersji i zachowania związane z bezpłatnymi wynikami wyszukiwania, możesz wysyłać zapytania do zasobów raportowania pomiaru wzrostu w interfejsie Google Ads API:

  • Raporty dotyczące wyników marki: oceniają, jak ekspozycja reklamy wpływa na postrzeganie marki w przypadku typów pomiarów objętych ankietą w interfejsie Google Ads API w wersji 25 i nowszych.
  • Raporty dotyczące Zwiększenia liczby konwersji: mierzą dodatkowe konwersje, wartość konwersji, koszt dodatkowej konwersji (iCPA) i przyrostowy zwrot z nakładów na reklamę (iROAS) w porównaniu z grupą kontrolną, której nie wyświetlano reklam, w interfejsie Google Ads API w wersji 25 i nowszych, w tym:
  • Raporty wzrostu liczby wyszukiwań: określają ilościowo przyrostowy wzrost liczby bezpłatnych wyszukiwań w wyszukiwarce Google i na YouTube spowodowany ekspozycją reklamy w interfejsie Google Ads API w wersji 26 i nowszych.

Informacje o standardowych raportach z eksperymentów A/B dotyczących zasobów experiment i campaign znajdziesz w artykule Raporty z eksperymentów.

Raportowanie wyników marki

Aby ocenić, jak kampanie reklamowe wpływają na postrzeganie marki, w interfejsie Google Ads API w wersji 25 i nowszych możesz wysyłać zapytania do specjalnych zasobów pomiaru wyników marki.

Zasoby i widoki zestawień wyników marki

Konfiguracje, okresy wyświetlania i widoki zestawień Wyników marki są w interfejsie Google Ads API dostępne tylko do odczytu (wszystkie pola mają wartość OUTPUT_ONLY). Można je konfigurować w interfejsie Google Ads lub z pomocą przedstawiciela Google bądź kontaktu GPS. Zasoby te możesz sprawdzać za pomocą parametru customer_id konta (menedżera lub konta dziecka), które jest właścicielem badania.

Wyślij zapytanie do zasobu LiftMeasurementFlight, aby pobrać metadane harmonogramu i zbierania ankiet Wyników marki na poziomie serii wyświetleń, w tym stan serii wyświetleń (lift_measurement_flight.status, zdefiniowany przez typ wyliczeniowy LiftMeasurementFlightStatus z wartościami ENABLED dla aktywnych serii wyświetleń i STOPPED dla serii wyświetleń zatrzymanych ręcznie), zakresy dat serii wyświetleń (lift_measurement_flight.start_date i lift_measurement_flight.end_date) w strefie czasowej klienta oraz postęp zbierania odpowiedzi na ankiety docelowe (lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros, gdzie 0 to 0%, a 1000000 to 100%). Aby określić, czy okres wyświetlania ENABLED trwa czy się zakończył, porównaj bieżącą datę w strefie czasowej klienta z lift_measurement_flight.start_date i lift_measurement_flight.end_date oraz sprawdź, czy response_collection_ratio_micros osiągnął wartość 1000000.

Wyślij zapytanie do zasobu LiftMeasurementConfig, aby pobrać ogólne dane Wyników marki na poziomie badania, lub do tych zasobów podziału, aby przeanalizować dane Wyników marki w określonych wymiarach:

Uwzględnij segment segments.brand_lift_measurement_type, aby podzielić dane dotyczące Wyników marki według typu pytania w ankiecie, zdefiniowanego przez typ wyliczeniowy BrandLiftMeasurementType (np. RECALL lub AWARENESS). Jeśli pominiesz segment segments.brand_lift_measurement_type, interfejs API zwróci dane dla pojedynczego automatycznie wybranego typu pomiaru na wycinek. Uwzględnij segment segments.date, aby podzielić dane dotyczące wyników marki według daty (YYYY-MM-DD). Dane metrics.cost_per_lifted_cookie są zwracane w mikrojednostkach waluty konta, do którego należy badanie.

W interfejsie Google Ads API w wersji 27 i nowszych możesz też wybrać pole tylko do odczytu (OUTPUT_ONLY) lift_guidance (lift_guidance.outcome i lift_guidance.guidance_message typu LiftGuidance) w klauzuli SELECT języka zapytań Google Ads (GAQL) w przypadku lift_measurement_config i 5 zasobów podziału Wyników marki (lift_measurement_age_range, lift_measurement_campaign, lift_measurement_device, lift_measurement_gender i lift_measurement_video), aby otrzymywać interpretację statystyczną na poziomie wiersza. W przypadku lift_measurement_config pole lift_guidance jest wypełniane tylko wtedy, gdy zapytanie wybiera lub filtruje dane lub segmenty dotyczące wzrostu (jest pomijane w zapytaniach konfiguracyjnych dotyczących tylko metadanych), a lift_guidance.guidance_message może zawierać wbudowane linki Markdown (takie jak [Learn more](https://support.google.com/...)). Nie możesz filtrować ani sortować według pól podrzędnych lift_guidance w klauzulach WHERE ani ORDER BY. Opisy wartości LiftOutcomeEnum.LiftOutcome zwracanych w lift_guidance.outcome znajdziesz w artykule Interpretowanie wyników marki.

Wartości progowe raportowania i puste odpowiedzi

Raportowanie wyników marki jest zarówno ograniczone opóźnieniem (wymaga 24–48 godzin opóźnienia po rozpoczęciu badania), jak i ograniczone liczbą odpowiedzi na dany typ pomiaru (segments.brand_lift_measurement_type), aby spełnić wymagania dotyczące raportowania statystycznego i progi prywatności:

  • Odsetek odpowiedzi pozytywnych (metrics.brand_lift_baseline_positive_response_rate* i metrics.brand_lift_exposed_positive_response_rate*): co najmniej 50 odpowiedzi na ankietę w odpowiedniej grupie (eksperymentalnej lub kontrolnej).
  • Rygorystyczny próg wzrostu dodatniego (ogólne badanie na platformie LiftMeasurementConfig lub niezależny wycinek): statystycznie dodatni wzrost (p_value <= 0.50) przy co najmniej 2000 odpowiedziach ogółem i 860 odpowiedziach na grupę.
  • Złagodzony próg wzrostu pozytywnego dla wycinka (w zasobie podziału, gdy całe badanie spełnia rygorystyczny próg wzrostu pozytywnego): wzrost pozytywny pod względem statystycznym (p_value <= 0.50) przy co najmniej 500 odpowiedziach ogółem i 200 odpowiedziach na grupę.
  • Próg braku wzrostu (NO_SIGNIFICANT_LIFT w porównaniu z NOT_ENOUGH_DATA): co najmniej 4100 odpowiedzi na rodzaj danych,gdy nie wykryto statystycznie istotnego wzrostu.

Zapytania do LiftMeasurementConfig i 5 zasobów podziału wyników marki (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign i LiftMeasurementVideo) zwracają pustą odpowiedź (results: []) zamiast błędu w tych przypadkach:

  • Parametr customer_id, którego dotyczy zapytanie, nie znajduje się na liście dozwolonych lub nie jest właścicielem badania.
  • Filtry daty WHERE wykraczają poza oceniane daty okresu wyświetlania (lift_measurement_flight.start_date i lift_measurement_flight.end_date).
  • Badanie lub konkretny wycinek danych dotyczący danych demograficznych, urządzenia, kampanii lub filmu nie osiągnął progu liczby odpowiedzi na ankietę i nie upłynął jeszcze czas opóźnienia raportowania (24–48 godzin), nawet jeśli LiftMeasurementConfig zwraca ogólne wyniki badania.

Aby rozwiązać problemy z pustymi odpowiedziami, wykonaj te czynności:

  1. Wyślij zapytanie do lift_measurement_flight, aby sprawdzić, czy lift_measurement_flight.status = 'ENABLED', upewnij się, że filtry daty WHERE mieszczą się w zakresie od lift_measurement_flight.start_date do lift_measurement_flight.end_date, i sprawdź postęp ankiety w lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros (gdzie 1000000 wynosi 100%).
  2. Zanim wyślesz zapytanie o zasoby podziału wymiarowego, wyślij zapytanie LiftMeasurementConfig, aby sprawdzić, czy całe badanie wygenerowało dane dotyczące Wyników marki, które można uwzględnić w raporcie.

Interpretowanie wyników badania Wyników marki

W interfejsie Google Ads API w wersji 27 i nowszych pole lift_guidance.outcome zwraca wartość LiftOutcomeEnum.LiftOutcome, która klasyfikuje stan statystyczny każdego zwróconego wiersza, a także zrozumiałe dla człowieka porady dotyczące rozwiązania problemu w polu lift_guidance.guidance_message:

  • Wyniki badania w toku (gdy lift_measurement_flight.status to ENABLED, a bieżąca data w strefie czasowej klienta przypada na lift_measurement_flight.end_date lub wcześniej, przy czym lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros jest mniejsze niż 1000000):
    • STUDY_IN_PROGRESS_WITH_LIFT: badanie jest w toku i pojawia się wstępny wzrost.
    • STUDY_IN_PROGRESS_NO_LIFT_YET: badanie jest w toku i ma wystarczającą początkową liczbę danych, ale nie wykryto jeszcze wzrostu istotnego statystycznie.
    • STUDY_IN_PROGRESS_COLLECTING_DATA: badanie jest w toku i aktywnie zbiera wstępne odpowiedzi na ankietę, aby osiągnąć progi raportowania statystycznego.
  • Wyniki zakończonego badania (gdy upłynie lift_measurement_flight.end_date lub lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros osiągnie 1000000):
    • POSITIVE_LIFT_DETECTED: w zakończonym badaniu lub wycinku wykryto istotny statystycznie dodatni wzrost.
    • NO_SIGNIFICANT_LIFT: zakończone badanie lub wycinek osiągnęły progi precyzji statystycznej (co najmniej 4100 odpowiedzi na wskaźnik) i nie wykryto istotnego statystycznie wzrostu.
    • NOT_ENOUGH_DATA: zakończone badanie lub wycinek nie osiągnęły progów odpowiedzi na ankietę wymaganych do uzyskania raportu statystycznego (co najmniej 2000 odpowiedzi łącznie i 860 odpowiedzi na grupę w przypadku wzrostu pozytywnego w całym badaniu,500 odpowiedzi łącznie i 200 odpowiedzi na grupę w przypadku wzrostu pozytywnego w wycinku, gdy w całym badaniu występuje wzrost pozytywny, lub 4100 odpowiedzi łącznie na dane,gdy nie wykryto wzrostu pozytywnego).

Podczas interpretowania wyników badania Wyników marki stosuj się do tych wskazówek:

  • Okresy wyświetlania w toku a zakończone (STUDY_IN_PROGRESS_*): gdy okres wyświetlania w badaniu ENABLED jest nadal w toku (przed upływem lift_measurement_flight.end_date i zanim response_collection_ratio_micros osiągnie 1000000), odpowiedzi na pytania ankiety i modelowanie skorygowane o błąd systematyczny nadal się stabilizują. Dane dotyczące kampanii w toku traktuj jako wstępne i nie wstrzymuj kampanii ani nie zmniejszaj budżetów, dopóki nie zakończy się okres wyświetlania.
  • Wzrost pozytywny (POSITIVE_LIFT_DETECTED): gdy wykryjesz wzrost pozytywny wyników marki, prześlij zapytanie do zasobów podziału wymiarowego (LiftMeasurementAgeRange, LiftMeasurementGender, LiftMeasurementDevice, LiftMeasurementCampaign i LiftMeasurementVideo), aby zidentyfikować kohorty odbiorców o wysokiej skuteczności („jasne punkty”) i ocenić oddźwięk kreacji na ścieżce marki.
  • Niewystarczająca ilość danych lub brak znacznego wzrostu (NOT_ENOUGH_DATA lub NO_SIGNIFICANT_LIFT): jeśli liczba odpowiedzi na pytania ankiety jest niewystarczająca (łącznie mniej niż 4100 odpowiedzi na dany rodzaj danych bez wzrostu pozytywnego lub mniej niż 2000/860 odpowiedzi w przypadku rygorystycznych progów wycinka lub 500/200 odpowiedzi w przypadku mniej rygorystycznych progów wycinka dla wzrostu pozytywnego) lub w danym wycinku nie wykryto istotnego statystycznie wzrostu, nie traktuj tego jako niepowodzenia kampanii ani nie wykluczaj odbiorców na podstawie niewystarczającej liczby próbek w jednym wycinku. Sprawdź ogólne dane badania dotyczące LiftMeasurementConfig, zapytaj o inne badane wartości segments.brand_lift_measurement_type (np. RECALL lub AWARENESS na początku ścieżki) i sprawdź pozostałe wymiary podziału.

Przykładowe zapytania dotyczące Wyników marki

Metadane i statystyki wzrostu znajdują się w osobnych zasobach, dlatego zapytania o szczegóły i statystyki skuteczności wymagają osobnych zapytań GAQL.

Zapytanie o szczegóły lotu

Aby pobrać metadane dotyczące okresu wyświetlania reklam objętego badaniem wyników marki, takie jak stan, typ pomiaru, zaplanowane daty i postęp zbierania odpowiedzi na ankietę, wyślij zapytanie do zasobu LiftMeasurementFlight:

SELECT
  lift_measurement_flight.lift_measurement_config_id,
  lift_measurement_flight.lift_measurement_flight_id,
  lift_measurement_flight.name,
  lift_measurement_flight.status,
  lift_measurement_flight.lift_type,
  lift_measurement_flight.start_date,
  lift_measurement_flight.end_date,
  lift_measurement_flight.survey_lift_measurement.response_collection_ratio_micros
FROM lift_measurement_flight
WHERE lift_measurement_flight.lift_measurement_config_id = CONFIG_ID
  AND lift_measurement_flight.lift_type = 'SURVEY'

Zastąp te elementy:

  • CONFIG_ID: identyfikator konfiguracji pomiaru wzrostu w postaci liczby całkowitej (lift_measurement_config.lift_measurement_config_id).

Zapytanie o statystyki

Aby pobrać dane dotyczące wyników marki, wyślij zapytanie do zasobu LiftMeasurementConfig lub odpowiedniego zasobu podziału. Na przykład to zapytanie pobiera z zasobu LiftMeasurementCampaign dane dotyczące Wyników marki posegmentowane według kampanii i typu pomiaru Wyników marki:

SELECT
  lift_measurement_campaign.lift_measurement_config_id,
  lift_measurement_campaign.campaign,
  segments.brand_lift_measurement_type,
  metrics.absolute_brand_lift,
  metrics.relative_brand_lift
FROM lift_measurement_campaign
WHERE lift_measurement_campaign.lift_measurement_config_id = CONFIG_ID

Zastąp te elementy:

  • CONFIG_ID: identyfikator konfiguracji pomiaru wyników marki w postaci liczby całkowitej.

Raportowanie zwiększenia liczby konwersji

W interfejsie Google Ads API w wersji 25 i nowszych raporty dotyczące zwiększenia liczby konwersji mierzą dodatkowy wpływ reklam na konwersje i wartość konwersji. Badania zwiększenia liczby konwersji porównują zachowania związane z konwersją między grupą eksperymentalną (użytkownikami, którzy mogli zobaczyć Twoje reklamy) a grupą kontrolną (użytkownikami, którym nie wyświetlano Twoich reklam).

Konfiguracje, okresy wyświetlania i linki do eksperymentów związane ze Zwiększeniem liczby konwersji są w interfejsie Google Ads API dostępne tylko do odczytu (wszystkie pola mają wartość OUTPUT_ONLY). Można je konfigurować w interfejsie Google Ads lub z pomocą przedstawiciela Google albo kontaktu GPS. Wyślij zapytanie do zasobu lift_measurement_config, używając parametru customer_id konta, które jest właścicielem badania. Konto menedżera może bezpośrednio wysyłać zapytania dotyczące badań Zwiększenia liczby konwersji na wielu kontach, których jest właścicielem. Wysyłaj zapytania o badania należące do konta dziecka, używając parametru customer_id konta dziecka (opcjonalnie uwierzytelnionego za pomocą nagłówka login-customer-id).

Raportowanie Zwiększenia liczby konwersji obsługuje 2 procesy badania, które mają te same badania i okresy wyświetlania, skumulowane zakresy dat podsumowania i zakresy działań powodujących konwersję:

  • Samodzielne raportowanie zwiększenia liczby konwersji: mierzy ogólny przyrost wartości, koszt dodatkowej konwersji (iCPA) i przyrostowy zwrot z nakładów na reklamę (iROAS) w przypadku wybranych działań powodujących konwersję lub wszystkich działań powodujących konwersję z kampanii objętych badaniem.
  • Raporty dotyczące testów A/B i Zwiększenia liczby konwersji: mierzą przyrost wartości w poszczególnych grupach i wyniki zwycięzcy bayesowskiego między 2 konkurującymi grupami eksperymentalnymi (kontrolną i eksperymentalną) oraz ogólny przyrost wartości w badaniu.

Aby uzyskać pomoc w tworzeniu prawidłowych zapytań dotyczących zasobu lift_measurement_config, użyj narzędzia Kreator zapytań Google Ads.

W interfejsie Google Ads API w wersji 27 i nowszych możesz wybrać pole tylko do odczytu (OUTPUT_ONLY) lift_measurement_config.lift_guidance (lift_guidance.outcome i lift_guidance.guidance_message typu LiftGuidance) w klauzuli GAQL SELECT w lift_measurement_config, aby otrzymywać interpretację statystyczną na poziomie wiersza w przypadku samodzielnych zapytań dotyczących Zwiększenia liczby konwersji oraz zapytań dotyczących testów A/B i Zwiększenia liczby konwersji. W przypadku lift_measurement_config pole lift_guidance jest wypełniane tylko wtedy, gdy zapytanie wybiera lub filtruje dane albo segmenty dotyczące wzrostu (jest pomijane w zapytaniach konfiguracyjnych dotyczących tylko metadanych), a pole lift_guidance.guidance_message może zawierać wbudowane linki Markdown (takie jak [Learn more](https://support.google.com/...)). Nie możesz filtrować ani sortować według pól podrzędnych lift_guidance w klauzulach WHERE ani ORDER BY. Pole lift_guidance.outcome zwraca jedną z tych wartości LiftOutcomeEnum.LiftOutcome:

  • Wyniki badania w toku (gdy lift_measurement_flight.status to ENABLED, a bieżąca data w strefie czasowej klienta przypada na lift_measurement_flight.end_date lub wcześniej):
    • STUDY_IN_PROGRESS_WITH_LIFT: badanie jest w toku i pojawia się wstępny wzrost.
    • STUDY_IN_PROGRESS_NO_LIFT_YET: badanie jest w toku i ma wystarczającą początkową liczbę danych, ale nie wykryto jeszcze wzrostu istotnego statystycznie.
    • STUDY_IN_PROGRESS_COLLECTING_DATA: badanie jest w toku i aktywnie zbiera wstępne dane o konwersjach, aby osiągnąć progi raportowania statystycznego.
  • Wyniki zakończonego badania (po upływie lift_measurement_flight.end_date):
    • POSITIVE_LIFT_DETECTED: w zakończonym badaniu, grupie eksperymentalnej lub wycinku wykryto istotny statystycznie wzrost.
    • AB_WINNER_WITH_LIFT: badanie typu A/B + badanie zwiększenia liczby konwersji zakończone wyłonieniem zwycięskiej grupy eksperymentalnej w porównaniu bezpośrednim i istotnym statystycznie pozytywnym wzrostem w stosunku do grupy kontrolnej, której nie wyświetlano reklam.
    • AB_WINNER_PARITY_VS_CONTROL: badanie typu A/B + badanie zwiększenia liczby konwersji zakończone wygraną grupy eksperymentalnej w porównaniu z grupą kontrolną, ale z wynikiem równym wynikowi grupy kontrolnej, której nie wyświetlano reklam.
    • NO_SIGNIFICANT_LIFT: zakończone badanie, grupa eksperymentalna lub wycinek osiągnęły progi precyzji statystycznej i nie wykryto istotnego statystycznie wzrostu.
    • NOT_ENOUGH_DATA: zakończone badanie, grupa eksperymentalna lub wycinek nie zgromadziły wystarczającej liczby konwersji, aby osiągnąć progi precyzji statystycznej.

Odkrywanie konfiguracji badania i lotów

Aby utworzyć raport na podstawie badania zwiększenia liczby konwersji, najpierw sprawdź konfigurację badania i jego harmonogram wyświetlania:

  1. Pobieranie konfiguracji badania: wyślij zapytanie do zasobu LiftMeasurementConfig, aby pobrać nazwę badania, współczynnik grupy kontrolnej (lift_measurement_config.conversion_lift_holdback_ratio_micros), śledzone działania powodujące konwersję (lift_measurement_config.conversion_actions) oraz – w interfejsie Google Ads API w wersji 26 i nowszych – aktywnie połączone kampanie (lift_measurement_config.campaigns). Pole conversion_lift_holdback_ratio_micros jest wyrażone w mikro, gdzie 1,000,000 odpowiada 100% (np. 300000 reprezentuje 30% grupy kontrolnej, której nie wyświetlono reklam). Jeśli nie znasz identyfikatora CONFIG_ID badania, pomiń klauzulę WHERE, aby wyświetlić listę wszystkich konfiguracji badań na koncie.
  2. Pobieranie okien obserwacji lotu: wyślij zapytanie do zasobu LiftMeasurementFlight, aby znaleźć zaplanowane daty lotu (lift_measurement_flight.start_date i lift_measurement_flight.end_date) w strefie czasowej klienta. Pojedynczy zasób LiftMeasurementConfig może grupować okresy wyświetlania reklam objęte badaniem wyników marki (SURVEY), zwiększenia liczby konwersji (CONVERSION) i wzrostu liczby wyszukiwań (SEARCH), dlatego we fragmencie kodu SELECT uwzględnij pole lift_measurement_flight.lift_type, a we fragmencie kodu WHERE zastosuj filtrowanie według lift_measurement_flight.lift_type = 'CONVERSION'. Pola lift_measurement_flight.start_date i lift_measurement_flight.end_date można sortować w klauzulach ORDER BY, ale nie można ich filtrować w klauzuli WHERE.

To zapytanie pobiera konfigurację badania (pomiń pole lift_measurement_config.campaigns w interfejsie Google Ads API w wersji 25, ponieważ wymaga ono interfejsu Google Ads API w wersji 26 lub nowszej):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  lift_measurement_config.name,
  lift_measurement_config.conversion_lift_holdback_ratio_micros,
  lift_measurement_config.conversion_actions,
  lift_measurement_config.campaigns
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID

Zastąp te elementy:

  • CONFIG_ID: identyfikator konfiguracji pomiaru wzrostu w postaci liczby całkowitej (lift_measurement_config.lift_measurement_config_id).

To zapytanie pobiera harmonogram wyświetlania reklam w ramach badania zwiększenia liczby konwersji:

SELECT
  lift_measurement_flight.lift_measurement_config_id,
  lift_measurement_flight.lift_measurement_flight_id,
  lift_measurement_flight.name,
  lift_measurement_flight.status,
  lift_measurement_flight.lift_type,
  lift_measurement_flight.start_date,
  lift_measurement_flight.end_date
FROM lift_measurement_flight
WHERE lift_measurement_flight.lift_measurement_config_id = CONFIG_ID
  AND lift_measurement_flight.lift_type = 'CONVERSION'

Zastąp te elementy:

  • CONFIG_ID: identyfikator konfiguracji pomiaru wzrostu w postaci liczby całkowitej (lift_measurement_config.lift_measurement_config_id).

W interfejsie Google Ads API w wersji 26 i nowszych możesz też sprawdzić konfigurację pomiaru wzrostu powiązaną z kampanią bezpośrednio w zasobie campaign, wysyłając zapytanie do pola campaign.lift_measurement_config. Wysłanie zapytania o to pole pozwala uniknąć konieczności osobnego porównywania danych z różnych kanałów w zasobie LiftMeasurementConfig:

SELECT
  campaign.id,
  campaign.lift_measurement_config
FROM campaign
WHERE campaign.id = CAMPAIGN_ID

Zastąp te elementy:

  • CAMPAIGN_ID: identyfikator kampanii w postaci liczby całkowitej (campaign.id).

Pole campaign.lift_measurement_config zwraca nazwę zasobu w formacie customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID. Jeśli kampania uczestniczyła w kilku badaniach wzrostu, to pole wskazuje ostatnio połączoną konfigurację (aktywną lub nieaktywną). Natomiast pole lift_measurement_config.campaigns zawiera tylko aktywnie połączone kampanie.

Zakresy dat skumulowanych zrzutów zapytań

Wyniki Zwiększenia liczby konwersji są uporządkowane jako dzienne skumulowane migawki oceny, począwszy od daty rozpoczęcia okresu wyświetlania:

Pola segments.conversion_lift_start_date i segments.conversion_lift_end_date to pola INT64 sformatowane jako nieujęte w cudzysłów 8-cyfrowe liczby całkowite bez łączników w formacie YYYYMMDD (np. 20260501). Natomiast pola lift_measurement_flight.start_date i lift_measurement_flight.end_date zwracają ciągi znaków daty w formacie ISO 8601 YYYY-MM-DD (np. 2026-05-01). W przeciwieństwie do zapytań dotyczących Wyników marki i wzrostu liczby wyszukiwań segment segments.date jest niezgodny ze wszystkimi danymi i segmentami dotyczącymi Zwiększenia liczby konwersji. Wybranie segmentu segments.date razem z segmentami zwiększenia liczby konwersji (np. segments.conversion_lift_start_date) w klauzuli SELECT zwraca błąd QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE, a połączenie segmentu segments.date z danymi zwiększenia liczby konwersji zwraca błąd QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE.

Najnowsze obliczone podsumowanie może być opóźnione w stosunku do daty zakończenia aktywnej emisji podczas przetwarzania danych. Zawsze wysyłaj zapytanie do zasobu lift_measurement_config o dostępne pary (segments.conversion_lift_start_date, segments.conversion_lift_end_date) uporządkowane według segments.conversion_lift_end_date DESC, aby zidentyfikować najnowszy oceniony zrzut.

To zapytanie pobiera dostępne zakresy dat podsumowania danych dotyczących badania:

SELECT
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'
ORDER BY segments.conversion_lift_end_date DESC

Zastąp te elementy:

  • CONFIG_ID: identyfikator konfiguracji pomiaru wyników marki w postaci liczby całkowitej.

Filtrowanie według zakresu działania powodującego konwersję

Zwiększenie liczby konwersji ocenia przyrost wartości w 2 zakresach zdefiniowanych przez segment segments.conversion_lift_included_conversion_action_types:

  • SELECTED: działania powodujące konwersję wybrane podczas konfigurowania badania lub wszystkie działania powodujące konwersję, w przypadku których można określać stawki (główne), jeśli nie określono niestandardowych działań powodujących konwersję.
  • ALL: wszystkie działania powodujące konwersję z kampanii objętych badaniem.

Jeśli wysyłasz zapytanie do zasobu lift_measurement_config o dane dotyczące Zwiększenia liczby konwersji bez filtrowania według segmentu segments.conversion_lift_included_conversion_action_types, interfejs API zwraca 2 wiersze na wycinek – jeden dla ALL i jeden dla SELECTED. W GAQL każde pole segmentu, które nie jest datą (oraz każde pole segmentu daty migawki zwiększenia liczby konwersji) i jest filtrowane w klauzuli WHERE, musi też występować w klauzuli SELECT. W przeciwnym razie interfejs API zwraca błąd QueryError.EXPECTED_REFERENCED_FIELD_IN_SELECT_CLAUSE. Jeśli filtrujesz według segments.conversion_lift_included_conversion_action_types = 'SELECTED' w klauzuli WHERE, uwzględnij ten segment w klauzuli SELECT.

Samodzielne raportowanie zwiększenia liczby konwersji

Samodzielne badania zwiększenia liczby konwersji mierzą przyrostowy wpływ Twoich reklam na grupę kontrolną, która nie widziała reklam, bez dzielenia kampanii na konkurujące kampanie eksperymentalne.

Sprawdzanie zwiększenia liczby konwersji i przyrostowego CPA

Zwiększenie liczby konwersji podaje szacunki punktowe wraz z 90-procentowymi jednostronnymi granicami ufności (*_p90_lower_bound i *_p90_upper_bound, które razem tworzą 80-procentowy dwustronny przedział ufności) i wartościami p (p_value <= 0.10 odpowiada 90-procentowej jednostronnej istotności statystycznej):

Interfejs API pomija dane dotyczące Zwiększenia liczby konwersji w zwracanych wierszach w tych przypadkach:

  • Okno uwzględniania zdjęć jest krótsze niż 4 dni.
  • Liczba nieskalowanych odnotowanych konwersji jest mniejsza niż minimalne progi precyzji (mniej niż 65 odnotowanych konwersji bazowych w grupie kontrolnej lub mniej niż 150 odnotowanych konwersji w grupie eksperymentalnej, ocenianych przed skalowaniem metrics.conversion_lift_baseline_conversions).
  • Zmierzony wzrost jest niedodatni (metrics.incremental_conversions_p_value > 0.5 w przypadku danych o konwersjach lub metrics.incremental_conversion_value_p_value > 0.5 w przypadku danych o wartości konwersji).
  • W interfejsie Google Ads API w wersji 27 i nowszych dane iROAS (metrics.incremental_conversion_value_per_cost*) oraz dane dotyczące wyniku zwycięzcy pod względem wartości konwersji (metrics.incremental_conversion_value_winner_score i metrics.incremental_conversion_value_per_cost_winner_score) są pobierane w ramach badania, które podczas konfiguracji zostało skonfigurowane z liczbą konwersji, a nie z wartością konwersji jako głównymi danymi. Dane wartości konwersji niezwiązane z kosztami (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* i metrics.relative_conversion_value_lift*) są nadal wypełniane w badaniach liczby konwersji (głównych), gdy można raportować wzrost wartości konwersji.
  • Wiele wierszy lub badań jest agregowanych, ponieważ w klauzuli SELECT pominięto pola lift_measurement_config.lift_measurement_config_id, segments.conversion_lift_start_date, segments.conversion_lift_end_date lub segments.conversion_lift_included_conversion_action_types.

Podczas interpretowania wyników samodzielnego badania zwiększenia liczby konwersji stosuj te wytyczne:

  • Okresy wyświetlania w toku i zakończone (STUDY_IN_PROGRESS_*): gdy okres wyświetlania badania ENABLED jest nadal w toku (gdy bieżąca data w strefie czasowej klienta przypada na dzień lift_measurement_flight.end_date lub wcześniej), modelowanie konwersji w grupie kontrolnej i eksperymentalnej oraz atrybucja opóźnionych konwersji nadal się stabilizują. Dane dotyczące kampanii w toku traktuj jako wstępne i nie wstrzymuj kampanii ani nie zmniejszaj budżetów, dopóki kampania się nie zakończy.
  • Wzrost dodatni (POSITIVE_LIFT_DETECTED): dane dotyczące Zwiększenia liczby konwersji są raportowane i wyświetlane są komunikaty lift_guidance.outcome = 'POSITIVE_LIFT_DETECTED', gdy zmierzony wzrost jest dodatni (p_value <= 0.50, co odpowiada co najmniej 50% pewności przy dodatniej estymacji punktowej, podczas gdy p_value <= 0.10 oznacza 90% jednostronnej istotności statystycznej, gdzie *_p90_lower_bound >= 0) i osiągnięte są minimalne progi precyzji (co najmniej 4 dni migawki, co najmniej 65 nieskalowanych konwersji bazowych i co najmniej 150 nieskalowanych konwersji w grupie eksperymentalnej). Jeśli wykryjesz wzrost, sprawdź zestawienia wymiarów (dane demograficzne, urządzenie, kraj lub kategoria konwersji i działanie powodujące konwersję), aby zidentyfikować kohorty o wysokiej skuteczności („jasne punkty”).
  • Niewystarczająca ilość danych lub brak istotnego wzrostu (NOT_ENOUGH_DATA lub NO_SIGNIFICANT_LIFT): jeśli ilość danych jest niewystarczająca (mniej niż 65 nieskalowanych konwersji bazowych lub mniej niż 150 nieskalowanych konwersji w grupie eksperymentalnej) lub w danym wycinku nie wykryto istotnego statystycznie wzrostu, nie traktuj tego jako niepowodzenia kampanii ani nie wykluczaj odbiorców na podstawie niewystarczającej próbki w jednym wycinku. Sprawdź ogólne dane i zapytanie dotyczące badania segments.conversion_lift_included_conversion_action_types = 'ALL' (jeśli SELECTED nie wykazuje wzrostu) lub pozostałe zestawienia wymiarów, aby sprawdzić, czy wzrost nie został odnotowany w innym miejscu.

To zapytanie pobiera ogólny przyrost konwersji, przedziały ufności i przyrostowy CPA:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.incremental_conversions_p90_lower_bound,
  metrics.incremental_conversions_p90_upper_bound,
  metrics.incremental_conversions_p_value,
  metrics.cost_per_incremental_conversion,
  metrics.cost_per_incremental_conversion_p90_lower_bound,
  metrics.cost_per_incremental_conversion_p90_upper_bound,
  metrics.relative_conversion_lift,
  metrics.relative_conversion_lift_p90_lower_bound,
  metrics.relative_conversion_lift_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Zastąp te elementy:

  • CONFIG_ID: identyfikator konfiguracji pomiaru wyników marki w postaci liczby całkowitej.
  • START_DATE: data rozpoczęcia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260501).
  • END_DATE: data zakończenia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260515).

Sprawdzanie wzrostu wartości konwersji i przyrostowego ROAS

Aby ocenić przyrost przychodów wygenerowany przez wydatki na reklamę, prześlij zapytanie o dane dotyczące wartości konwersji i dane metrics.incremental_conversion_value_per_cost. Dane o wartości konwersji niezwiązane z kosztami (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* i metrics.relative_conversion_value_lift*) są wypełniane zawsze, gdy badanie wykazuje możliwy do raportowania wzrost wartości konwersji, niezależnie od tego, czy głównymi danymi badania jest liczba konwersji czy wartość konwersji. W interfejsie Google Ads API w wersji 27 i nowszych dane iROAS (metrics.incremental_conversion_value_per_cost*) – wraz z metrics.incremental_conversion_value_winner_score i metrics.incremental_conversion_value_per_cost_winner_score – są zwracane tylko wtedy, gdy badanie zostało skonfigurowane podczas konfiguracji z wartością konwersji jako danymi podstawowymi (i są pomijane w badaniach z liczbą konwersji jako danymi podstawowymi):

To zapytanie pobiera przyrostowość wartości konwersji, przedziały ufności i przyrostowy ROAS:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  metrics.conversion_lift_baseline_conversion_value,
  metrics.conversion_lift_exposed_conversion_value,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_p90_lower_bound,
  metrics.incremental_conversion_value_p90_upper_bound,
  metrics.incremental_conversion_value_p_value,
  metrics.incremental_conversion_value_per_cost,
  metrics.incremental_conversion_value_per_cost_p90_lower_bound,
  metrics.incremental_conversion_value_per_cost_p90_upper_bound,
  metrics.relative_conversion_value_lift,
  metrics.relative_conversion_value_lift_p90_lower_bound,
  metrics.relative_conversion_value_lift_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Zastąp te elementy:

  • CONFIG_ID: identyfikator konfiguracji pomiaru wyników marki w postaci liczby całkowitej.
  • START_DATE: data rozpoczęcia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260501).
  • END_DATE: data zakończenia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260515).

Segmentowanie wyników według wymiaru

Możesz segmentować dane o konwersjach przyrostowych według kategorii konwersji, działania powodującego konwersję, danych demograficznych, urządzenia lub położenia geograficznego. Podczas wysyłania zapytania do zasobu lift_measurement_config wybieraj tylko zgodne kombinacje segmentów:

Wybranie wzajemnie niezgodnych segmentów w klauzuli SELECT powoduje niepowodzenie weryfikacji zapytania i zwrócenie błędu QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Aby interaktywnie sprawdzać kombinacje segmentów, użyj Kreatora zapytań Google Ads.

Wskaźniki opłacalności (metrics.cost_per_incremental_conversion* i metrics.incremental_conversion_value_per_cost*) oceniaj tylko w wierszach ogólnych badania lub w wierszach segments.experiment_arm. W interfejsie Google Ads API w wersjach 25 i 26 schemat umożliwia wybór 6 rodzajów danych o współczynniku kosztów (metrics.cost_per_incremental_conversion, metrics.cost_per_incremental_conversion_p90_lower_bound, metrics.cost_per_incremental_conversion_p90_upper_bound, metrics.incremental_conversion_value_per_cost, metrics.incremental_conversion_value_per_cost_p90_lower_bound i metrics.incremental_conversion_value_per_cost_p90_upper_bound) z 8 segmentami niebędącymi segmentami ARM (segments.conversion_action, segments.conversion_action_name, segments.conversion_lift_conversion_category, segments.age_range, segments.gender, segments.device, segments.country i segments.country_localized_name). Od wersji 27 interfejsu Google Ads API wybranie dowolnego z tych 6 rodzajów danych o współczynniku kosztów z dowolnym z tych 8 segmentów niebędących segmentami ARM powoduje niepowodzenie weryfikacji zapytania i zwrócenie błędu QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE. Dane o wartości konwersji niezwiązane z kosztami (metrics.conversion_lift_baseline_conversion_value, metrics.conversion_lift_exposed_conversion_value, metrics.incremental_conversion_value* i metrics.relative_conversion_value_lift*) są nadal obsługiwane w przypadku segmentów kategorii konwersji, działania powodującego konwersję, danych demograficznych, urządzenia i kraju, gdy można raportować wzrost wartości konwersji (niezależnie od tego, czy głównymi danymi badania jest liczba konwersji czy wartość konwersji).

Aby ocenić wzrost w kategoriach konwersji zdefiniowanych w wyliczeniu ConversionActionCategory (np. PURCHASE, SIGNUP lub SUBMIT_LEAD_FORM), posegmentuj wyniki według segmentu segments.conversion_lift_conversion_category:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.conversion_lift_conversion_category,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Zastąp te elementy:

  • CONFIG_ID: identyfikator konfiguracji pomiaru wyników marki w postaci liczby całkowitej.
  • START_DATE: data rozpoczęcia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260501).
  • END_DATE: data zakończenia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260515).

Segment segments.conversion_action zwraca nazwę zasobu działania powodującego konwersję w formacie customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID. Wybierz segment segments.conversion_action_name w zasobie lift_measurement_config, aby pobrać zrozumiałe dla człowieka nazwy działań powodujących konwersję bez osobnego wysyłania zapytania do zasobu conversion_action. To zapytanie dzieli dane dotyczące zwiększenia liczby konwersji na segmenty według działania powodującego konwersję, nazwy działania powodującego konwersję i kategorii konwersji:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.conversion_action,
  segments.conversion_action_name,
  segments.conversion_lift_conversion_category,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Zastąp te elementy:

  • CONFIG_ID: identyfikator konfiguracji pomiaru wyników marki w postaci liczby całkowitej.
  • START_DATE: data rozpoczęcia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260501).
  • END_DATE: data zakończenia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260515).

Podane niżej zapytanie dzieli dane o zwiększeniu liczby konwersji na segmenty według segmentu segments.device. Zastąp segment segments.age_range lub segments.gender w oddzielnych żądaniach, aby pobrać zestawienia demograficzne (opcjonalnie połączone z segmentami kategorii konwersji lub działań powodujących konwersję):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.device,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Zastąp te elementy:

  • CONFIG_ID: identyfikator konfiguracji pomiaru wyników marki w postaci liczby całkowitej.
  • START_DATE: data rozpoczęcia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260501).
  • END_DATE: data zakończenia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260515).

Aby podzielić wyniki według regionu geograficznego, uwzględnij segmenty segments.country i segments.country_localized_name (opcjonalnie połączone z segmentami kategorii konwersji lub działania powodującego konwersję). Segment segments.country zwraca globalną nazwę zasobu stałego celu kierowania geograficznego w formacie geoTargetConstants/CRITERION_ID (np. geoTargetConstants/2840 w przypadku Polski).

To zapytanie dzieli dane dotyczące zwiększenia liczby konwersji według nazwy zasobu kryterium kraju i zlokalizowanej nazwy kraju:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.country,
  segments.country_localized_name,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.relative_conversion_lift
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Zastąp te elementy:

  • CONFIG_ID: identyfikator konfiguracji pomiaru wyników marki w postaci liczby całkowitej.
  • START_DATE: data rozpoczęcia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260501).
  • END_DATE: data zakończenia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260515).

Raporty dotyczące testów A/B i Zwiększenia liczby konwersji

W interfejsie Google Ads API w wersji 25 i nowszych badania typu test A/B + Zwiększenie liczby konwersji łączą eksperyment z 2 grupami (porównujący strategię kontrolną ze strategią eksperymentalną) z pomiarem grupy kontrolnej w interfejsie Google Ads API, aby oceniać przyrostową skuteczność poszczególnych grup i obliczać wyniki zwycięzcy metodą bayesowską. W odróżnieniu od raportowania bezpośrednich eksperymentów w zasobie experiment, które porównuje nieskorygowane dane o ruchu w poszczególnych grupach, zapytanie do zasobu lift_measurement_config z segmentem segments.experiment_arm mierzy przyrostowy wzrost w każdej grupie w porównaniu z bazową grupą kontrolną, która nie była objęta eksperymentem.

Eksperymenty Discovery i grupy eksperymentalne

Badanie typu A/B + Zwiększenie liczby konwersji łączy zasób LiftMeasurementConfig z dwuramiennym zasobem experiment za pomocą pola experiment.lift_measurement_config tylko do odczytu (OUTPUT_ONLY).

Aby w jednym żądaniu znaleźć połączony eksperyment i jego grupy, wyślij zapytanie do zasobu ExperimentArm z przypisanymi polami experiment i filtrem w polu experiment.lift_measurement_config. Odpowiedź zawiera stan kontrolny każdej grupy (experiment_arm.control), podział ruchu (experiment_arm.traffic_split), połączone kampanie (experiment_arm.campaigns) i nazwę zasobu. Użyj zwróconej wartości experiment_arm.resource_name (sformatowanej jako customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID), aby filtrować według segmentu segments.experiment_arm:

SELECT
  experiment.experiment_id,
  experiment.name,
  experiment.lift_measurement_config,
  experiment_arm.resource_name,
  experiment_arm.name,
  experiment_arm.control,
  experiment_arm.traffic_split,
  experiment_arm.campaigns
FROM experiment_arm
WHERE experiment.lift_measurement_config =
  'customers/CUSTOMER_ID/liftMeasurementConfigs/CONFIG_ID'

Zastąp te elementy:

  • CUSTOMER_ID: 10-cyfrowy identyfikator klienta konta, do którego należy badanie (bez łączników).
  • CONFIG_ID: identyfikator konfiguracji pomiaru wyników marki w postaci liczby całkowitej.

Jeśli zaczynasz od znanego EXPERIMENT_ID (lub chcesz wyświetlić listę wszystkich eksperymentów z włączonymi danymi o wzroście na koncie), uruchom to samo zapytanie experiment_arm przefiltrowane według WHERE experiment.experiment_id = EXPERIMENT_ID (lub WHERE experiment.lift_measurement_config IS NOT NULL).

Sprawdzanie przyrostu i wyników zwycięzcy dla poszczególnych grup

Aby mierzyć przyrost wartości w przypadku każdej grupy i oceniać prawdopodobieństwo statystyczne, że dana grupa jest zwycięska, uwzględnij w zapytaniu do zasobu lift_measurement_config segment segments.experiment_arm.

Podane niżej bayesowskie dane dotyczące zwycięzcy oceniają prawdopodobieństwo (od 0.0 do 1.0, sumując się do 1.0 w obu grupach, gdy obie grupy mają możliwy do raportowania wzrost), że dana grupa jest lepsza:

  • metrics.incremental_conversions_winner_score: prawdopodobieństwo, że ta grupa jest zwycięzcą pod względem konwersji przyrostowych, znormalizowane według podziału ruchu w grupie (experiment_arm.traffic_split).
  • metrics.incremental_conversion_value_winner_score: prawdopodobieństwo, że ta grupa eksperymentalna jest zwycięzcą pod względem przyrostowej wartości konwersji, znormalizowane według podziału ruchu w grupie eksperymentalnej (experiment_arm.traffic_split). W interfejsie Google Ads API w wersji 27 i nowszych jest wypełniane tylko wtedy, gdy głównym wskaźnikiem badania jest wartość konwersji, a pomijane (pozostawiane bez ustawienia) w badaniach, w których głównym wskaźnikiem jest liczba konwersji.
  • metrics.cost_per_incremental_conversion_winner_score: prawdopodobieństwo, że ta grupa eksperymentalna jest zwycięzcą pod względem kosztu dodatkowej konwersji (najniższy iCPA), znormalizowane według wydatków.
  • metrics.incremental_conversion_value_per_cost_winner_score: prawdopodobieństwo, że ta grupa eksperymentalna jest zwycięzcą pod względem przyrostowej wartości konwersji na koszt (najwyższy przyrostowy ROAS), znormalizowane według wydatków. W interfejsie Google Ads API w wersji 27 i nowszych: wypełniane tylko wtedy, gdy podstawowymi danymi badania jest wartość konwersji; pomijane (nieustawione) w badaniach, w których podstawowymi danymi jest liczba konwersji.

Poniższe zapytanie pobiera wyniki przyrostu i zwycięzcy bayesowskiego dla obu grup:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.experiment_arm,
  metrics.conversion_lift_baseline_conversions,
  metrics.conversion_lift_exposed_conversions,
  metrics.incremental_conversions,
  metrics.cost_per_incremental_conversion,
  metrics.incremental_conversions_winner_score,
  metrics.cost_per_incremental_conversion_winner_score,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_winner_score,
  metrics.incremental_conversion_value_per_cost_winner_score
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Zastąp te elementy:

  • CONFIG_ID: identyfikator konfiguracji pomiaru wyników marki w postaci liczby całkowitej.
  • START_DATE: data rozpoczęcia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260501).
  • END_DATE: data zakończenia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260515).

Aby filtrować według jednej grupy, dodaj AND segments.experiment_arm = 'customers/CUSTOMER_ID/experimentArms/EXPERIMENT_ID~ARM_ID' do klauzuli WHERE, gdzie EXPERIMENT_ID to identyfikator eksperymentu, a ARM_ID to identyfikator grupy zwracany w polu experiment_arm.resource_name. Segment segments.experiment_arm obsługuje filtrowanie w klauzulach WHERE (=, !=, IN, NOT IN), ale nie można go sortować w klauzuli ORDER BY.

Interpretowanie wyników testów A/B i Zwiększenia liczby konwersji

Badanie typu A/B + Zwiększenie liczby konwersji ocenia jednocześnie 2 hipotezy: wyższość grupy eksperymentalnej nad grupą kontrolną (metrics.*_winner_score) i przyczynowy wzrost liczby konwersji w porównaniu z grupą kontrolną, której nie wyświetlano reklam (metrics.incremental_* i *_p_value). Gdy okres wyświetlania reklam w ramach badania ENABLED nadal trwa (STUDY_IN_PROGRESS_*, gdy bieżąca data w strefie czasowej klienta przypada na lift_measurement_flight.end_date lub wcześniej), porównanie grup eksperymentalnych i modelowanie konwersji w grupie kontrolnej nadal się stabilizują. Dane dotyczące trwającego eksperymentu traktuj jako wstępne i unikaj promowania grupy eksperymentalnej lub ponownego przydzielania budżetów przed zakończeniem okresu wyświetlania.

W przypadku zakończonych badań grupa eksperymentalna jest klasyfikowana jako zwycięzca bezpośredniego porównania, gdy spełnia minimalne progi precyzji (co najmniej 4 dni, w których wykonano zrzut, 65 nieskalowanych konwersji w grupie bazowej i 150 nieskalowanych konwersji w grupie eksperymentalnej), ma 0 <= p_value <= 0.50 i osiąga bayesowski wynik zwycięzcy większy niż 0.55 (> 0.55) w przypadku głównego rodzaju danych badania. Ta ocena oparta na 2 hipotezach daje 2 różne stany zwycięzcy (odzwierciedlone też w lift_guidance.outcome w interfejsie Google Ads API w wersji 27 i nowszych):

  • Wyraźny zwycięzca ze wzrostem przyczynowym (AB_WINNER_WITH_LIFT): zwycięska grupa eksperymentalna osiąga lepsze wyniki niż grupa konkurencyjna (winner_score > 0.55) i generuje istotne statystycznie przyrostowe konwersje lub przyrostową wartość konwersji w porównaniu z grupą kontrolną, która nie miała kontaktu z reklamami. Promuj lub skaluj strategię zwycięskiej grupy i sprawdzaj zestawienia wymiarów, aby przeanalizować kohorty o wysokiej skuteczności.
  • Zwycięzca w porównaniu bezpośrednim na poziomie grupy kontrolnej (AB_WINNER_PARITY_VS_CONTROL): zwycięska grupa eksperymentalna osiąga lepsze wyniki niż grupa eksperymentalna, z którą jest porównywana (winner_score > 0.55), ale żadna z nich nie generuje istotnego statystycznie wzrostu przyrostowego w porównaniu z grupą kontrolną, która nie miała kontaktu z reklamami, na wybranym poziomie. Zanim zwiększysz wydatki na zwycięską grupę eksperymentalną, sprawdź zapytania ALL, konwersje (segments.conversion_lift_included_conversion_action_types = 'ALL') i zestawienia segments.conversion_lift_conversion_category, aby sprawdzić, czy pozytywny wzrost przyczynowy nie został wyizolowany w innym miejscu.

Wynik POSITIVE_LIFT_DETECTED ma zastosowanie do poziomów szczegółowości zapytania dotyczącego eksperymentu A/B i Zwiększenia liczby konwersji w następujący sposób:

  • Wiersze badania z grupą połączoną (OVERALL) (zapytania bez segments.experiment_arm): badanie wykazało pozytywny wzrost w porównaniu z grupą kontrolną, która nie miała kontaktu z reklamami (p_value <= 0.50), a żadna z grup nie osiągnęła wyniku zwycięzcy w porównaniu bezpośrednim większego niż 0.55.
  • Wiersze dla poszczególnych grup (segments.experiment_arm): gdy jedna grupa wygrywa (winner_score > 0.55), a obie grupy osiągają dodatni wzrost w porównaniu z grupą kontrolną, wiersz grupy zwycięskiej zwraca wartość AB_WINNER_WITH_LIFT, a wiersz grupy, która nie wygrała, zwraca wartość POSITIVE_LIFT_DETECTED.
  • Wiersze wycinka kategorii konwersji (segments.conversion_lift_conversion_category): wiersze ze wzrostem dodatnim zawsze zwracają wartość POSITIVE_LIFT_DETECTED, ponieważ wyniki zwycięzców nie są oceniane według kategorii konwersji.

Jeśli wycinek zwraca wartość NOT_ENOUGH_DATA lub NO_SIGNIFICANT_LIFT, nie wstrzymuj grup eksperymentalnych ani nie wykluczaj odbiorców na podstawie niewystarczającej liczby próbek w jednym wycinku. Sprawdź ogólne dane badania i ALL konwersje (segments.conversion_lift_included_conversion_action_types = 'ALL').

Zapytania o wyniki z połączonych grup i wielu badań

Jeśli w zapytaniu dotyczącym zasobu lift_measurement_config pominiesz segment segments.experiment_arm, interfejs API zwróci przyrost wartości na poziomie badania zagregowany dla obu połączonych grup. W przypadku zapytań dotyczących grup połączonych pomiń 4 rodzaje danych metrics.*_winner_score, które mają zastosowanie tylko do grup konkurujących i są pomijane (pozostają nieustawione) w wierszach grup połączonych bez segments.experiment_arm. Użyj zapytań na poziomie badania w sekcjach Zwiększenie liczby konwersji z zapytań i przyrostowy CPA oraz Zwiększenie wartości konwersji z zapytań i przyrostowy ROAS.

Gdy dzielisz wyniki testu A/B i zwiększenia liczby konwersji na segmenty według segmentu segments.experiment_arm, interfejs API obsługuje tylko segment segments.conversion_lift_conversion_category jako dodatkowy wymiar podziału. Wydatki na grupę nie są przypisywane do poszczególnych kategorii konwersji, dlatego podczas uwzględniania segmentu segments.conversion_lift_conversion_category oceniaj dane dotyczące wzrostu liczby i wartości konwersji (pomijając dane dotyczące przyrostowego CPA i przyrostowego ROAS, które nie przechodzą weryfikacji zapytania i powodują błąd QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE w interfejsie Google Ads API w wersji 27 i nowszych). Segmenty segments.conversion_action, segments.conversion_action_name, segments.age_range, segments.gender, segments.device, segments.country, segments.country_localized_name i segments.date są niezgodne z segmentem segments.experiment_arm i danymi metrics.*_winner_score. Wybranie dowolnego z tych niezgodnych segmentów razem z segments.experiment_arm powoduje zwrócenie błędu QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE (oraz błędu QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE, jeśli zapytanie wybiera też dowolne dane metrics.*_winner_score).

Aby pobrać wyniki dla wielu konfiguracji badań w jednym żądaniu, użyj filtra z operatorem IN:

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.conversion_lift_start_date,
  segments.conversion_lift_end_date,
  segments.conversion_lift_included_conversion_action_types,
  segments.experiment_arm,
  segments.conversion_lift_conversion_category,
  metrics.incremental_conversions,
  metrics.incremental_conversions_winner_score,
  metrics.incremental_conversion_value,
  metrics.incremental_conversion_value_winner_score
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id IN (
    CONFIG_ID_1, CONFIG_ID_2)
  AND segments.conversion_lift_start_date = START_DATE
  AND segments.conversion_lift_end_date = END_DATE
  AND segments.conversion_lift_included_conversion_action_types = 'SELECTED'

Zastąp te elementy:

  • CONFIG_ID_1: identyfikator liczby całkowitej pierwszej konfiguracji pomiaru wzrostu.
  • CONFIG_ID_2: identyfikator liczby całkowitej drugiej konfiguracji pomiaru wzrostu.
  • START_DATE: data rozpoczęcia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260501).
  • END_DATE: data zakończenia zrzutu jako 8-cyfrowa liczba całkowita YYYYMMDD bez cudzysłowu (np. 20260515).

Dokładna data (= START_DATE i = END_DATE) zwraca wiersze tylko dla badań, które mają dokładnie to samo okno podsumowania. Podczas wysyłania zapytań dotyczących badań z różnymi datami rozpoczęcia wyświetlania lub datami ostatniej oceny stanu używaj operatorów zakresu (>= i <=) lub pomiń filtry daty w klauzuli WHERE, zachowując segmenty segments.conversion_lift_start_date i segments.conversion_lift_end_date w klauzuli SELECT.

Raportowanie wzrostu liczby wyszukiwań

Aby mierzyć wzrost liczby bezpłatnych wyników wyszukiwania wywołany przez Twoje kampanie reklamowe, w interfejsie Google Ads API w wersji 26 i nowszych wysyłaj zapytania do zasobów raportowania wzrostu liczby wyszukiwań. Wzrost liczby wyszukiwań określa różnicę w zachowaniach związanych z wyszukiwaniem Twojej marki lub Twoich produktów między użytkownikami, którzy widzieli Twoje reklamy, a grupą kontrolną, która ich nie widziała.

Zasoby i segmentacja wzrostu liczby wyszukiwań

Wyślij zapytanie do zasobu SearchLiftKeywordBundle, aby pobrać szczegółowe informacje o grupach słów kluczowych skonfigurowanych na potrzeby badań wzrostu liczby wyszukiwań. Zasób SearchLiftKeywordBundle jest w interfejsie Google Ads API tylko do odczytu (wszystkie pola mają wartość OUTPUT_ONLY), a pakiety słów kluczowych są konfigurowane w interfejsie Google Ads lub przez przedstawiciela Google albo osobę kontaktową ds. GPS. Jego pola, które można wyszukiwać w GAQL, to resource_name, search_lift_keyword_bundle_id, source (SearchLiftMatchingInfoSource) i status (SearchLiftKeywordBundleStatus) (powtarzanego pola keywords nie można wybrać w zapytaniach GAQL).

Aby pobrać dane dotyczące wzrostu liczby wyszukiwań i ogólne konfiguracje badań, wyślij zapytanie do zasobu LiftMeasurementConfig.

W interfejsie Google Ads API w wersji 27 i nowszych możesz też wybrać pole lift_measurement_config.lift_guidance tylko do odczytu (OUTPUT_ONLY) (lift_guidance.outcome i lift_guidance.guidance_message typu LiftGuidance) w klauzuli SELECT GAQL w lift_measurement_config podczas wysyłania zapytań o dane lub segmenty dotyczące wzrostu liczby wyszukiwań (segments.search_lift_keyword_bundle lub segments.search_property). W lift_measurement_config pole lift_guidance jest pomijane w zapytaniach o konfigurację zawierających tylko metadane, a pole lift_guidance.guidance_message może zawierać wbudowane linki Markdown (np. [Learn more](https://support.google.com/...)). W przypadku wzrostu liczby wyszukiwań pole lift_guidance.outcome zwraca wartość STUDY_IN_PROGRESS_WITH_LIFT, STUDY_IN_PROGRESS_NO_LIFT_YET, STUDY_IN_PROGRESS_COLLECTING_DATA, POSITIVE_LIFT_DETECTED (co najmniej 70% pewności, p_value <= 0.30), NO_SIGNIFICANT_LIFT lub NOT_ENOUGH_DATA (oceniane na podstawie progów wynoszących co najmniej 1 000 000 wyświetleń ogółem lub 100 000 wyświetleń w wycinku, co najmniej 75 zaobserwowanych wyszukiwań i co najmniej 17 z 20 grup plików cookie, gdzie pojedynczy pakiet słów kluczowych o niskiej skuteczności powoduje, że ogólne wyniki badania wskazują wartość NOT_ENOUGH_DATA).

Możesz segmentować skuteczność wzrostu liczby wyszukiwań według tych wymiarów:

  • segments.search_lift_keyword_bundle: segmentowanie według nazwy zasobu pakietu słów kluczowych. Zgodne z segmentami segments.search_property, segments.date i segmentami demograficznymi (segments.device, segments.age_range i segments.gender). Każdy pakiet słów kluczowych raportuje pełny koszt kampanii i wyświetlenia, a słowa kluczowe mogą należeć do więcej niż 1 pakietu. Nie sumuj danych dotyczących metrics.search_lift_cost_micros, metrics.search_lift_impressions ani wzrostu liczby wyszukiwań w grupach słów kluczowych.
  • segments.search_property: segmentuj według usługi wyszukiwania, w której nastąpiło wyszukiwanie, zdefiniowanej przez typ wyliczeniowy SearchLiftSearchProperty (np. GOOGLE_SEARCH lub YOUTUBE). Segment segments.search_property jest zgodny tylko z segmentami segments.search_lift_keyword_bundle i segments.date. Połączenie wymiaru segments.search_property z segmentami demograficznymi (segments.device, segments.age_range lub segments.gender) nie przechodzi weryfikacji zapytania. Ponieważ segments.search_property dzieli dane według partycji, w których nastąpiły kolejne bezpłatne wyniki wyszukiwania, a nie według miejsca, w którym wyświetlono reklamy, wiersze podzielone na segmenty według segments.search_property powtarzają niepodzielone koszty i wyświetlenia na poziomie kampanii w interfejsie Google Ads API w wersji 26. Od wersji 27 interfejsu Google Ads API wszystkie 8 rodzajów danych dotyczących wydatków i wyświetleń (metrics.search_lift_cost_micros, metrics.search_lift_impressions, metrics.normalized_incremental_searches_per_cost* i metrics.normalized_incremental_searches_per_impression*) jest niezgodnych z segments.search_property i powoduje błąd QueryError.PROHIBITED_SEGMENT_WITH_METRIC_IN_SELECT_OR_WHERE_CLAUSE podczas weryfikacji zapytania.
  • Segmenty demograficzne i daty: segments.device, segments.age_range, segments.gender i segments.date.

Dane dotyczące wzrostu liczby wyszukiwań

Zasób LiftMeasurementConfig udostępnia dane dotyczące wzrostu liczby wyszukiwań, które umożliwiają ocenę zmian w zachowaniach związanych z wyszukiwaniem:

  • metrics.relative_search_lift: różnica w liczbie wyszukiwanych haseł między grupą eksperymentalną a grupą kontrolną, wyrażona jako ułamek liczby wyszukiwanych haseł w grupie kontrolnej.
  • metrics.relative_search_lift_p90_lower_bound i metrics.relative_search_lift_p90_upper_bound: jednostronne granice ufności na poziomie 90% (które razem tworzą dwustronny przedział ufności na poziomie 80%) dla względnego wzrostu liczby wyszukiwań.
  • metrics.incremental_searches_p_value: wartość p dla przyrostowych wyszukiwań, która reprezentuje statystyczne prawdopodobieństwo, że zaobserwowany wzrost liczby wyszukiwanych haseł wystąpił przypadkowo.
  • metrics.search_lift_cost_micros: łączny koszt (w mikrogroszach) wyświetleń reklam w ramach tego wycinka pomiaru wzrostu liczby wyszukiwań. Niezgodne z segments.search_property w interfejsie Google Ads API w wersji 27 i nowszych.
  • metrics.search_lift_impressions: łączna liczba wyświetleń reklam zrealizowanych w ramach tego wycinka pomiaru wzrostu liczby wyszukiwań. Niezgodne z segments.search_property w interfejsie Google Ads API w wersji 27 i nowszych.

Gdy wzrost jest statystycznie dodatni, raportowane są te znormalizowane dane przyrostowe wraz z odpowiadającymi im jednostronnymi granicami ufności na poziomie 90% (*_p90_lower_bound i *_p90_upper_bound):

Przykładowe zapytania dotyczące wzrostu liczby wyszukiwań

Podane niżej zapytania GAQL pokazują, jak pobierać pakiety słów kluczowych i wskaźniki skuteczności dotyczące wzrostu liczby wyszukiwań.

Zapytanie dotyczące grupy słów kluczowych

Aby pobrać pakiety słów kluczowych skonfigurowane na potrzeby pomiarów wzrostu liczby wyszukiwań, wyślij zapytanie do zasobu search_lift_keyword_bundle:

SELECT
  search_lift_keyword_bundle.resource_name,
  search_lift_keyword_bundle.search_lift_keyword_bundle_id,
  search_lift_keyword_bundle.source,
  search_lift_keyword_bundle.status
FROM search_lift_keyword_bundle

Zapytanie dotyczące wskaźników

Wartości search_lift_keyword_bundle.resource_name pobrane w zapytaniu o pakiet słów kluczowych odpowiadają wartościom zwróconym w segmencie segments.search_lift_keyword_bundle w poniższym zapytaniu. Aby poznać CONFIG_ID, połączone kampanie i harmonogram wyświetlania reklam w ramach badania, postępuj zgodnie z instrukcjami podanymi w artykule Odkrywanie konfiguracji badania i wyświetleń reklam w ramach badania dotyczącym zasobów lift_measurement_config i lift_measurement_flight (filtrowanie wyświetleń reklam według lift_measurement_flight.lift_type = 'SEARCH').

To zapytanie pobiera dane o wzroście liczby wyszukiwań podzielone według pakietu słów kluczowych i usługi wyszukiwania (podczas wybierania metrics.search_lift_cost_micros lub metrics.search_lift_impressions pomiń segments.search_property):

SELECT
  lift_measurement_config.lift_measurement_config_id,
  segments.search_lift_keyword_bundle,
  segments.search_property,
  metrics.relative_search_lift,
  metrics.relative_search_lift_p90_lower_bound,
  metrics.relative_search_lift_p90_upper_bound,
  metrics.incremental_searches_p_value,
  metrics.normalized_incremental_searches,
  metrics.normalized_incremental_searches_p90_lower_bound,
  metrics.normalized_incremental_searches_p90_upper_bound
FROM lift_measurement_config
WHERE lift_measurement_config.lift_measurement_config_id = CONFIG_ID

Zastąp te elementy:

  • CONFIG_ID: identyfikator konfiguracji pomiaru wyników marki w postaci liczby całkowitej.