Wycofanie funkcji udostępniania reklam w interfejsie Google Ads API w styczniu 2026 r.

Środa, 9 lipca 2025 r.

Co się zmienia?

Google wycofuje funkcję udostępniania reklam w interfejsie Google Ads API.

Wraz ze styczniową wersją 23 (styczeń 2026 r.) 28 stycznia 2026 r. usuniemy możliwość tworzenia reklam udostępnianych we wszystkich obsługiwanych wersjach.

• Na czym polega zmiana? Funkcja „reklamy udostępnione” zostanie wycofana w II kwartale 2026 r.
• Jakie są konsekwencje? Pierwotne reklamy udostępnione przestaną się wyświetlać w grupach reklam, w których były udostępniane.
• Jakie jest rozwiązanie? Aby nadal wyświetlać reklamy, automatycznie utworzymy nową, indywidualną kopię każdej z nich. Te nowe kopie będą nadal wyświetlane jako zwykłe reklamy.
• Kiedy? Dokładna data nie została jeszcze ustalona i zostanie podana w przyszłości.

Ta zmiana wpłynie na sposób tworzenia reklam i zarządzania nimi na dużą skalę, dlatego ważne jest, aby zrozumieć jej konsekwencje i odpowiednio przygotować systemy. Wyjaśnimy, co się dzieje, dlaczego to ważne i co musisz zrobić.

Czym jest udostępnianie reklam?

Mówiąc prościej, „udostępnianie reklam” oznacza utworzenie jednej reklamy i używanie jej w wielu grupach reklam.

Zamiast tworzyć identyczne reklamy dla każdej grupy reklam, tworzysz je raz i łączysz wszędzie tam, gdzie są potrzebne.

Dlaczego to się zmienia?

Ta zmiana jest zgodna z przejściem na reklamy oparte na komponentach. Przyszłość Google Ads koncentruje się wokół formatów reklam opartych na komponentach, takich jak elastyczne reklamy w wyszukiwarce i kampanie Performance Max. W tych formatach „reklama” jest dynamicznie tworzona z puli komponentów (nagłówków, tekstów reklamy, obrazów), co sprawia, że koncepcja statycznego obiektu reklamowego, który można udostępniać, jest mniej skuteczna.

Jak się przygotować

Harmonogram daje Ci wystarczająco dużo czasu na dostosowanie się do zmian, ale zdecydowanie zalecamy rozpoczęcie tego procesu już teraz, aby uniknąć zakłóceń w działaniach reklamowych. Aby zapewnić płynne przejście, wykonaj te czynności.

Krok 1. Przeprowadź kontrolę aplikacji

Najpierw musisz określić, czy Twoja aplikacja korzysta z modelu udostępniania reklam.

Sprawdź bazę kodu, a w szczególności logikę, która wchodzi w interakcję z AdGroupAdService. Poszukaj przypadków, w których utworzono AdGroupAd, wskazując nazwę zasobu istniejącej reklamy, która jest już używana w innej grupie reklam.

Twoja obecna, wkrótce wycofana logika może wyglądać mniej więcej tak:

1. Utwórz obiekt AdGroupAd, który zawiera obiekt Ad.
2. Utwórz AdGroup.
3. Utwórz kolejny obiekt AdGroupAd, używając umieszczonego obiektu Ad z kroku 1 i obiektu AdGroup z kroku 2. (To jest funkcja, która zostanie usunięta).

Krok 2. Zaktualizuj logikę tworzenia reklam

Musisz refaktoryzować kod, aby utworzyć nową, unikalną reklamę dla każdej grupy reklam. Zamiast udostępniać reklamę, nowy proces powinien być pętlą, która tworzy osobną reklamę dla każdej wybranej grupy reklam. Nie będzie już można tworzyć reklam samodzielnych. Zamiast tego parametry reklamy określasz podczas tworzenia grupy reklam.

Nowa, zgodna z zasadami logika powinna wyglądać tak:

1. AdGroup_1:
   • Utwórz obiekt AdGroupAd za pomocą metody ad for ad_group_1.
2. AdGroup_2:
   • Utwórz obiekt AdGroupAd za pomocą metody ad for ad_group_2.

Nawet jeśli tekst reklamy jest identyczny, reklamy muszą zostać utworzone jako osobne obiekty reklamowe w interfejsie API.

Jeśli nadal wyświetlasz starsze rozszerzone reklamy tekstowe (ETA), które są udostępniane, musisz je przekształcić w elastyczne reklamy w wyszukiwarce i przypisać każde udostępnione wystąpienie do jednej grupy reklam.

Krok 3. Zrozum wpływ na raportowanie

Jeśli przestaniesz udostępniać pojedynczą reklamę i zaczniesz tworzyć unikalne reklamy dla każdej grupy reklam, wpłynie to na historię skuteczności.

Ważne: statystyki skuteczności (wyświetlenia, kliknięcia, konwersje) są powiązane z unikalną reklamą. Nowe reklamy, które utworzysz, nie będą miały historii skuteczności. Dane historyczne ze starych, udostępnionych reklam zostaną zachowane, ale nie zostaną przeniesione do nowych reklam.

Pamiętaj, aby poinformować o tym swój zespół lub klientów. Zanim przejdziesz na nowy system, zaplanuj eksport i archiwizację danych o skuteczności historycznej, aby móc przeprowadzać długoterminowe analizy na poziomie reklam.

Migracja dotychczasowych udostępnianych reklam

Krok 1. Znajdź reklamy udostępnione

Najpierw musisz utworzyć ostateczną listę wszystkich reklam, które są obecnie udostępniane w więcej niż 1 grupie reklam.

SELECT
  ad_group_ad.ad.id,  -- This is the unique ID of the 'Ad' itself
  ad_group.id,        -- This is the unique ID of the 'AdGroup'
  ad_group_ad.status,
  ad_group_ad.ad.type,
  campaign.id,
  campaign.name,
  ad_group.name
FROM
  ad_group_ad
WHERE
  ad_group_ad.status IN ('ENABLED', 'PAUSED')
ORDER BY
  ad_group_ad.ad.id, ad_group.id

Jeśli w wynikach znajdziesz element ad_group_ad.ad.id, którego powiązana kolekcja ad_group.ids zawiera więcej niż 1 wpis, oznacza to, że dana reklama (identyfikowana przez ad_group_ad.ad.id) jest połączona z wieloma grupami reklam (każda z nich jest identyfikowana przez unikalny element ad_group.id w kolekcji).

Jeśli ad_group.id jest powiązana z więcej niż jednym ad_group.id, jest uznawana za „udostępnioną”.

Krok 2. Zbierz treść reklamy i powiązane grupy reklam

W przypadku każdej reklamy udostępnionej, którą udało Ci się zidentyfikować w kroku 1, musisz pobrać 2 elementy:

1. treść reklamy (nagłówki i teksty reklamy);
2. listę wszystkich grup reklam, w których jest obecnie aktywny;

Krok 3. Utwórz w każdej grupie reklam nową, unikalną reklamę ResponsiveSearchAd

Aby przeprowadzić główną część migracji, przejdź przez każdą grupę reklam zidentyfikowaną w kroku 2 i utwórz w niej nową reklamę ResponsiveSearchAd.

Sprawdzona metoda: jeśli udostępniona reklama jest rozszerzoną reklamą tekstową, nie kopiuj tylko 3 nagłówków i 2 tekstów. Użyj ich jako punktu wyjścia i dodaj więcej komponentów. Siła ResponsiveSearchAds wynika z dużej liczby nagłówków i tekstów reklamy, które Google może testować. Postaraj się dodać 5 krótkich nagłówków, 1 długi nagłówek i 5 tekstów reklamy.

Oto krótkie podsumowanie limitów dotyczących ResponsiveSearchAds:

Asset Type	Maksymalna dozwolona liczba	Limit znaków	Sprawdzone metody
Krótki nagłówek	maks. 5	30 znaków	Podaj wszystkie 5
Długi nagłówek	1	90 znaków	Zawsze podawaj 1.
Opis	maks. 5	90 znaków	Podaj wszystkie 5

Oto ogólny opis operacji mutate z użyciem AdGroupAdService:

1. Przejrzyj wszystkie ad_group.resource_name z wyników z kroku 2.
2. Wewnątrz pętli utwórz nowy obiekt AdGroupAd.
3. W polu ad_group ustaw bieżącą wartość ad_group.resource_name.
4. Utwórz obiekt Ad w ramach AdGroupAd.
5. Wypełnij pole responsive_search_ad swoimi zasobami:
   • Utwórz listę obiektów AdTextAsset dla nagłówków.
   • Utwórz listę obiektów AdTextAsset dla opisów.
   • Ustaw final_urls, path1 i path3, korzystając z danych ze starej reklamy.
6. Wykonaj żądanie MutateAdGroupAds().

Dzięki temu każda grupa reklam ma teraz własne, unikalne reklamy ResponsiveSearchAds, które są gotowe do wyświetlania.

Krok 4. Usuń stare reklamy udostępnione

Po utworzeniu nowych ResponsiveSearchAds i pomyślnym przejściu przez nie weryfikacji (stan to ENABLED) możesz wycofać wszystkie udostępnione reklamy.

1. Określ nazwę zasobu starego obiektu AdGroupAd (połączenie między udostępnioną reklamą a grupą reklam).
2. Aby przeprowadzić mutację, użyj AdGroupAdService . W ramach tej usługi utworzysz obiekt AdGroupAdOperation. Ten obiekt operacji ma pole remove, w którym podajesz nazwę zasobu AdGroupAd, który chcesz usunąć.
3. Na koniec wywołaj metodę mutateAdGroupAds w usłudze AdGroupAdService.

Harmonogram wycofywania reklam udostępnianych

Zdecydowanie zalecamy samodzielne przeniesienie udostępnionych reklam.

• To najlepsze podejście. Umożliwia tworzenie nowych reklam z unikalnymi obrazami i nagłówkami dostosowanymi do odbiorców w każdej grupie reklam. Trafniejsze reklamy dają lepsze wyniki.

Etap 1. Od 28 stycznia 2026 r.

• Nie możesz już tworzyć nowych reklam udostępnianych.
• Każda próba połączenia pojedynczej reklamy z nową grupą reklam zostanie zablokowana i zwróci błąd. Jeśli używasz do tego automatycznych narzędzi lub skryptów, przestaną one działać.

Etap 2. Od 28 stycznia 2026 r. do I kwartału 2027 r.

• Dotychczasowe udostępnione reklamy będą nadal wyświetlać się normalnie.
• W przypadku reklam, które zostały już udostępnione, nie musisz teraz podejmować żadnych działań. W tym okresie nie będzie to miało na nie wpływu.

Etap 3. I kwartał 2027 r.

• Automatycznie przekonwertujemy wszystkie pozostałe udostępnione reklamy.
• W przypadku reklam, które nadal są udostępniane, utworzymy osobne kopie w każdej grupie reklam, do której należą.

Zalecamy zapoznanie się z oficjalną dokumentacją interfejsu Google Ads API i śledzenie bloga Google Ads dla deweloperów, na którym w miarę zbliżania się daty wycofania będziemy publikować więcej informacji.

Rozpocznij audyt już dziś i udostępnij ten post zespołowi programistów, aby przygotować się na płynne przejście.

Proces automatyczny w II kwartale 2026 r.

Jeśli nie podejmiesz żadnych działań, w II kwartale 2026 r. automatycznie rozdzielimy Twoje reklamy udostępniane.

Oto jak będzie działać nasz automatyczny proces:

• Jedna grupa reklam zachowuje pierwotną reklamę: pierwotna reklama zostanie zachowana tylko w jednej z grup reklam (konkretnie w tej, która ma najniższy identyfikator grupy reklam).
• Inne grupy reklam otrzymają kopie: utworzymy nowe kopie oryginalnej reklamy dla wszystkich innych grup reklam, którym została udostępniona.
• Treści automatyczne zostaną wygenerowane ponownie: ustawienia funkcji takich jak „automatyzacja komponentów” zostaną skopiowane. Nie zostaną jednak przeniesione rzeczywiste komponenty wygenerowane przez system (np. automatycznie utworzone nagłówki lub obrazy). Nasz system utworzy zupełnie nowy zestaw dla każdej skopiowanej reklamy, co może wpłynąć na początkową skuteczność.

Jeśli masz pytania, skontaktuj się z nami na forum.

Bob Hancock, zespół ds. interfejsu Google Ads API

Etykiety: google-ads-api