Google Ads API v25.1: odczyt danych Conversion Lift bez możliwości założenia badania

Google Ads API v25.1 opublikowano 19 sierpnia 2026. Wydanie dodało odczyt badań lift oraz 24 nowe metryki Conversion Lift i metryki winner score. Informacje o badaniach i szacunki efektu mogą dzięki temu trafiać do automatycznych raportów. Nowe zasoby lift są tylko do odczytu: nie pozwalają tworzyć ani sterować badaniami.

Artykuł opisuje to rozszerzenie v25. W dniu kontroli, 24 października 2026, była już dostępna wersja v26. Nowa integracja wymaga osobnego sprawdzenia obsługiwanych wersji, bibliotek i kombinacji pól.

Odczyt i dostęp dla konta

Google wymaga odrębnego dopuszczenia konta do zapowiedzianych funkcji Conversion Lift i Brand Lift. Oficjalnym kontaktem jest opiekun konta Google. Skuteczne uwierzytelnienie w API nie zastępuje tego dodatkowego wymogu.

LiftMeasurementConfig zawiera między innymi nazwę badania, aktualnie powiązane kampanie, działania powodujące konwersję i udział holdback. Holdback oznacza część odbiorców przeznaczoną do grupy kontrolnej. Lista kampanii przedstawia wyraźnie bieżące powiązania, a nie pełną historię. Okresowe migawki pomagają więc w późniejszych porównaniach.

LiftMeasurementFlight udostępnia informacje o fazie pomiaru, między innymi status oraz daty początku i końca w strefie czasowej konta. Flight oznacza fazę pomiaru. Dokumentacja zasobu opisuje w szczególności fazy Brand Lift; okresów różnych rodzajów lift nie można utożsamiać bez weryfikacji. Raport Conversion Lift wymaga rzeczywistego okresu pomiarowego wykazanego w wynikach.

Co mierzy Conversion Lift

Conversion Lift porównuje grupę testową z grupą kontrolną, w której wstrzymano badaną reklamę. Zależnie od rodzaju badania porównanie obejmuje osoby lub obszary geograficzne. Przyrostowość jest oszacowaniem dodatkowego efektu badanej reklamy w warunkach eksperymentu. Interpretacja wymaga uwzględnienia podziału grup, pokrycia pomiarowego i niepewności.

Atrybucja odpowiada na inne pytanie: którym kontaktom reklamowym przypisać zarejestrowane konwersje według wybranych zasad? Różne okna czasowe, cele konwersji, grupy i metody modelowania mogą dawać różne liczby. Różnica między konwersjami przypisanymi i przyrostowymi nie liczy więc automatycznie zakupów, które i tak by nastąpiły. Nie dowodzi również powszechnie dużej luki dla wyszukiwania markowego lub remarketingu.

Wyniki śródokresowe są wstępne. Google zaleca ocenę po zakończeniu badania; zależnie od metody mogą pojawić się konwersje modelowane lub opóźnione. Pojedynczy szacunek lift bez przedziału i statusu wyniku nie wystarcza do automatycznej decyzji budżetowej.

Rzetelny przebieg integracji

1. Inwentaryzacja: zapis konta, identyfikatora badania, aktualnych powiązań kampanii i działań powodujących konwersję wraz z czasem pobrania.
2. Kontekst pomiaru: rodzaj lift, okres, udział grupy kontrolnej, status wyniku i dostępne informacje o niepewności.
3. Porównanie: uzgodnienie kampanii, celów, okresów, walut i poziomów agregacji przed zestawieniem wyników.
4. Zmiany: osobne rejestrowanie nowych powiązań, brakujących wyników i zmian fazy pomiaru.

Wyniku badania obejmującego kilka kampanii nie można przypisać w całości każdej kampanii, a następnie zsumować. Podobna ostrożność dotyczy wyników skumulowanych zwracanych ponownie przy codziennym pobieraniu. Przed łączeniem tabel potrzebne są identyfikator badania, okres pomiaru i poziom szczegółowości metryki.

Pusty wynik nie diagnozuje uprawnień

Technicznie poprawna odpowiedź bez wierszy oznacza początkowo tylko „brak widocznych danych dla tego zapytania”. Przyczyną może być niewłaściwe konto klienta, filtr, nieodpowiedni zasób, brak wyników lub uprawnienia. Badanie widoczne w interfejsie, lecz nieobecne w odpowiedzi API, nie dowodzi więc braku dopuszczenia konta.

Błędy API wymagają osobnej obsługi: uwierzytelnienie, autoryzacja, niepoprawne zapytania i przejściowe awarie techniczne nie są pustymi listami badań. Kontrola obejmuje identyfikator klienta, dostęp przez konto menedżera, wersję API, filtry i potwierdzone uprawnienia. Niewyjaśnione różnice wymagają sprawdzenia z opiekunem konta lub pomocą API.

Znaczenie zgodnej aktualizacji minor

Google opisuje v25.1 jako rozszerzenie v25 zgodne wstecznie. Chroni to istniejące wywołania przed zapowiedzianymi zmianami łamiącymi zgodność w tym wydaniu minor. Nowe pola mogą jednak wymagać aktualizacji bibliotek klienckich, nowego kodu i dostosowania testów. Automatyczny panel nadal wymaga pracy integracyjnej.

Wartość zależy od kosztu dotychczasowego raportowania i podejmowanych decyzji. Nawet niewiele badań o dużym znaczeniu ekonomicznym może uzasadnić integrację. Stały próg dwóch lub trzech badań rocznie ani ogólny szacunek „jedno popołudnie” nie są wiarygodne.