Informacje o wersjach

wersja 23.1 (25.02.2026)

W wersji 23.1 dodaliśmy te nowe funkcje i aktualizacje:

Więcej informacji znajdziesz w artykule Przechodzenie na najnowszą wersję.

Zarządzanie kontem

  • Dodano advertising_partner_properties.allowed_domain do zasobów ProductLinkInvitation i ProductLink. Partner reklamowy będzie mógł wyświetlać reklamy tylko w tej domenie.
  • Dodano pole contains_eu_political_advertising do zasobu Customer. To pole pobiera stan deklaracji na poziomie konta, czy zawiera reklamy polityczne kierowane na UE, i zwraca wartość EuPoliticalAdvertisingStatusEnum.

Kampanie

  • Dodaliśmy obsługę wskazówek dotyczących tekstu, których można używać w kampaniach Performance Max i kampaniach w sieci wyszukiwania, aby programowo kontrolować komponenty tekstowe generowane przez AI.
  • Dodano parametry CampaignPrimaryStatusReason.CAMPAIGN_NOT_BOOKED, CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRING, CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRED i CampaignPrimaryStatusReason.BOOKING_CANCELLED, aby podawać główne przyczyny stanu kampanii ze strategią ustalania stawek FIXED_CPM.
  • Dodano Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure i Campaign.VideoCampaignSettings.booking_details(tylko do odczytu).
  • Dodaliśmy Campaign.missing_eu_political_advertising_declaration, aby umożliwić wyszukiwanie i filtrowanie kampanii, w których brakuje deklaracji dotyczących tego, czy zawierają reklamy polityczne kierowane na UE.

Konwersje

  • Dodano ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS, aby śledzić użytkowników, którzy obejrzeli reklamę, a później film z tego samego kanału.

Ogólne

  • Dodano CANNOT_TARGET_ONLY_UNDETERMINED do CriterionErrorEnum. Ten błąd jest zwracany podczas próby kierowania reklam tylko na kategorię „Nieokreślona” w wymiarach danych demograficznych.

Zachęty

  • Dodaliśmy 2 nowe kody błędów do IncentiveErrorEnum: MAX_INCENTIVES_REDEEMED i ACCOUNT_TOO_OLD. Te błędy mogą być zwracane w przypadku żądań wysłanych 11 marca 2026 r. lub później.

Planowanie

Raporty

  • Dodaliśmy nowe dane, które pokazują, ilu użytkowników zobaczyło Twoją reklamę co najmniej 2, 3, 4, 5 lub 10 razy: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus i unique_users_ten_plus.
  • Dodano VERTICAL_ADS_DATA_FEED do SearchTermMatchSourceEnum, aby obsługiwać pliki danych reklam w branżach (np. kierowanie na podmioty w reklamach branży turystycznej).

YouTubeVideoUpload

  • Dodaliśmy usługę YouTubeVideoUpload, która umożliwia przesyłanie filmów do YouTube i zarządzanie nimi, oraz zasób YouTubeVideoUpload, który umożliwia pobieranie stanu przesyłania i metadanych. Ta funkcja jest obsługiwana tylko w przypadku interfejsu REST i biblioteki klienta Python.

wersja 23 (28.01.2026)

W wersji 23 dodaliśmy te nowe funkcje i aktualizacje:

Reklamy

Zasoby

Płatności

Kampanie

Konwersje

  • Dodano YOUTUBE_FOLLOW_ON_VIEWS do ConversionActionCategory, aby obsługiwać śledzenie użytkowników, którzy oglądają reklamę, a później film z tego samego kanału.

Kreowanie popytu

Zachęty

  • Dodaliśmy obsługę zachęt Wybierz własną (CYO), dzięki czemu partnerzy mogą programowo pobierać i stosować zachęty Google Ads dla swoich klientów:

  • Aby ułatwić bardziej szczegółową obsługę błędów w ramach automatyzacji, w przyszłych wersjach dodamy do parametru IncentivesService kolejne kody błędów. Zalecamy śledzenie nadchodzących ogłoszeń i informacji o wersji, aby być na bieżąco z nowymi kodami błędów i mieć pewność, że aplikacje będą w stanie obsługiwać te nowe tryby awarii.

Planowanie

Rekomendacje

  • Dodano pole is_new_customer do GenerateRecommendationsRequest. Jeśli ustawisz wartość true w przypadku rekomendacji typu CAMPAIGN_BUDGET, będą one generowane na podstawie modelu dla nowych klientów. Jest to zalecane tylko w przypadku klientów, którzy nie mają kampanii.

Raporty

Zakupy

  • ShoppingPerformanceView obsługuje teraz te dane podzielone według daty konwersji: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date.
  • ShoppingPerformanceView obsługuje teraz te dane o konkurencji: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share, search_rank_lost_absolute_top_impression_share.
  • Dodano product_image_uri do ShoppingProduct.

Reklamy pionowe

  • Dodaliśmy vertical_ads_format_setting do AdGroup w przypadku kampanii w sieci wyszukiwania korzystających z plików danych o miejscach noclegowych, co pozwala kontrolować, które formaty reklam mogą się wyświetlać.
  • Dodano typ kryterium vertical_ads_item_group_rule_list do AdGroupCriterion. Dodano vertical_ads_item_group_rule do SharedCriterion. Te kryteria umożliwiają kierowanie na grupy produktów w kampaniach w sieci wyszukiwania z plikami danych o podróżach.
  • Możesz teraz połączyć plik danych o reklamach w branży z kampanią w sieci wyszukiwania, która korzysta z AI Max, aby wyświetlać reklamy promujące obiekty i reklamy z linkiem do rezerwacji obok reklam tekstowych. Na poziomie grupy reklam możesz określić, które formaty mają się wyświetlać za pomocą ustawienia vertical_ads_format_setting, i zdefiniować zestaw reguł grupy produktów, aby kierować reklamy na podzbiór Twoich obiektów z pliku danych reklam wertykalnych. Raportowanie można teraz segmentować zarówno według AdFormatType, jak i według wymiarów z pliku danych reklam wertykalnych.

Wideo

wersja 22.1 (25.02.2026)

W wersji 22.1 dodaliśmy tę nową funkcję:

Zarządzanie kontem

  • Dodano pole contains_eu_political_advertising do zasobu Customer. To pole pobiera stan deklaracji na poziomie konta, czy zawiera reklamy polityczne kierowane na UE, i zwraca wartość EuPoliticalAdvertisingStatusEnum.

Kampanie

  • Dodaliśmy Campaign.missing_eu_political_advertising_declaration, aby umożliwić wyszukiwanie i filtrowanie kampanii, w których brakuje deklaracji dotyczących tego, czy zawierają reklamy polityczne kierowane na UE.

wersja 22 (15.10.2025)

W wersji 22 dodaliśmy te nowe funkcje i aktualizacje:

Zasoby

  • Dodaliśmy LANDING_PAGE_PREVIEW jako nowy typ pola komponentu z obrazem.
  • Wprowadziliśmy AssetGenerationService (beta):
    • Ta usługa umożliwia generowanie komponentów z tekstem i obrazami przy użyciu generatywnej AI. Ta usługa jest początkowo dostępna tylko dla ograniczonej liczby uczestników zamkniętych testów beta.
    • GenerateText: generuje tekst na podstawie danych wejściowych, takich jak końcowy adres URL, prompty w formie swobodnej, słowa kluczowe i kontekst istniejącej kampanii.
    • GenerateImages: generuje obrazy na podstawie danych wejściowych, takich jak ostateczny adres URL, prompty w formie dowolnego tekstu, kontekst istniejącej kampanii lub poprzez zmianę kontekstuistniejących zdjęć produktów.
    • Błędy podczas generowania komponentów są zwracane z kodami z zakresu AssetGenerationErrorEnum.

Kampanie

Kreowanie popytu

Ogólne

  • Dodano limit 10 tys. operacji na żądanie AddBatchJobOperations.
  • Zaktualizowano obsługę pola page_size w ListBatchJobResultsRequest:
    • Jeśli wartość page_size nie jest ustawiona lub wynosi 0, domyślnie jest teraz ustawiana na maksymalną wartość 1000 (wcześniej zwracana była wartość INVALID_PAGE_SIZE).
    • Jeśli wartość page_size przekracza 1000, interfejs API zwraca teraz błąd INVALID_PAGE_SIZE (wcześniej wartość była cicho ograniczana do 1000).
  • Dodano nowy kod błędu: QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED, który wskazuje, kiedy został przekroczony limit współczynników aktywacji profilu płatności.

Performance Max

  • Dodaliśmy nowe wartości AssetAutomationType w przypadku kampanii Performance Max:
    • GENERATE_IMAGE_ENHANCEMENT: umożliwia automatyczne tworzenie ulepszonych obrazów, np. automatyczne przycinanie. Ta opcja jest domyślnie włączona.
    • GENERATE_IMAGE_EXTRACTION: umożliwia automatyczne pozyskiwanie obrazów z końcowych adresów URL. Domyślnie jest to ustawienie rozszerzenia z obrazem dynamicznym na poziomie konta.
  • Usunięto AssetPerformanceLabel w przypadku kampanii Performance Max.
  • Funkcjonalność usuniętego elementu Campaign.url_expansion_opt_out jest teraz zarządzana przez ustawienie AssetAutomationType w AssetAutomationSetting.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION
  • Dodaliśmy nowe segmenty do kampanii Performance Max. Każdy z tych segmentów jest dostępny tylko w kampaniach Performance Max i nie zwraca danych, gdy jest wybrany inny typ kampanii.
    • ad_using_product_data: wskazuje, czy reklama korzysta z danych o produktach z pliku danych Google Merchant Center.
    • ad_using_video: wskazuje, czy reklama korzysta z komponentu wideo.

Planowanie

Raporty

Cele ujednolicone

  • Dodaliśmy obsługę celów dotyczących utrzymania klientów, aby optymalizować kampanie pod kątem ponownego zaangażowania obecnych klientów.

Wideo

wersja 21.1 (25.02.2026)

W wersji 21.1 dodaliśmy tę nową funkcję:

Zarządzanie kontem

  • Dodano pole contains_eu_political_advertising do zasobu Customer. To pole pobiera stan deklaracji na poziomie konta, czy zawiera reklamy polityczne kierowane na UE, i zwraca wartość EuPoliticalAdvertisingStatusEnum.

Kampanie

  • Dodaliśmy Campaign.missing_eu_political_advertising_declaration, aby umożliwić wyszukiwanie i filtrowanie kampanii, w których brakuje deklaracji dotyczących tego, czy zawierają reklamy polityczne kierowane na UE.

wersja 21 (06.08.2025)

Więcej informacji znajdziesz w artykule Przechodzenie na najnowszą wersję.

AI Max w kampaniach w sieci wyszukiwania

  • Aby włączyć funkcje AI Max w kampaniach w sieci wyszukiwania, możesz teraz użyć pola ai_max_setting.enable_ai_max w Campaign. Funkcje AI Max w kampaniach w sieci wyszukiwania zwiększają zasięg kampanii w sieci wyszukiwania dzięki dopasowywaniu wyszukiwanych słów i umożliwiają kontrolowanie, czy po ustawieniu mają być wyświetlane ustawienia kierowania i kreacji. Automatyzacja komponentów tekstowych i ustawienia list marek, które zostały skonfigurowane w poprzednich żądaniach wersji, będą nadal uwzględniane, dopóki funkcje AI Max w kampaniach w sieci wyszukiwania nie zostaną wyraźnie przełączone i wyłączone. Za pomocą parametru Campaign.ai_max_setting.bundling_required można określić, czy funkcje AI Max w kampaniach w sieci wyszukiwania muszą być włączone, aby uwzględniać lub modyfikować automatyzację komponentów tekstowych i ustawienia list marek. AdGroup.ai_max_ad_group_setting.disable_search_term_matching można użyć do wyłączenia dopasowywania wyszukiwanych słów, gdy kampania nadrzędna ma włączone funkcje AI Max w kampaniach w sieci wyszukiwania. Przeczytaj nasz post na blogu Osiągaj jeszcze lepsze wyniki dzięki AI Max w kampaniach w sieci wyszukiwania.

  • Dodano kod błędu CampaignError.AI_MAX_MUST_BE_ENABLED, który jest zwracany w przypadku kampanii w sieci wyszukiwania, gdy włączysz FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION bez włączania w kampanii funkcji AI Max w kampaniach w sieci wyszukiwania.

  • Dodaliśmy obsługę stosowania ustawień kierowania na poziomie grupy reklam w kampaniach w sieci wyszukiwania z włączonymi funkcjami AI Max. Do grup reklam możesz teraz dodawać te kryteria:

    • Listy marek
    • Lokalizacje
    • Strony internetowe (reguły dotyczące adresów URL)

  • Dodaliśmy ai_max_search_term_ad_combination_view, aby raportować skuteczność kombinacji wyszukiwanych haseł, nagłówków i stron docelowych. Ten widok pokazuje, które wyszukiwane hasła spowodowały wyświetlenie Twoich reklam, oraz skuteczność tych konkretnych kombinacji. W przyszłej wersji dodamy dodatkowy widok, który będzie też zawierać dane o kampaniach Performance Max. Jeśli nie chcesz przenosić implementacji, aby uzyskać dane kampanii Performance Max, poczekaj na tę wersję.

  • Dodano AI_MAX jako nową wartość segmentu search_term_match_type.

Zasoby

Kampanie

Konwersje

  • Dodano ENGAGED_VIEW jako nową wartość segmentu conversion_attribution_event_type.

  • Klienci nie będą już mieć dostępu do trybu debug_enabled w ConversionUploadService. To pole, jeśli ma wartość TRUE, było wcześniej używane do odróżniania błędu CLICK_NOT_FOUND od błędu SUCCESS w przypadku importowania konwersji rozszerzonych dotyczących potencjalnych klientów.

Kreowanie popytu

Zmiany w reklamach politycznych w UE

Te zmiany dotyczące reklam politycznych w UE zostały również wprowadzone w wersjach v19.2 i v20.1.

  • Dodano Campaign.contains_eu_political_advertising. To pole określa, czy Twoja kampania zawiera treści reklamowe o charakterze politycznym kierowane na Unię Europejską. Jeśli to pole ma wartość CONTAINS_EU_POLITICAL_ADVERTISING, od 22 września 2025 r. kampania nie będzie już wyświetlać reklam w UE. Wywołania interfejsu API w celu utworzenia nowej kampanii zakończą się niepowodzeniem i wygenerują błąd FieldError.REQUIRED, jeśli to pole nie zostanie ustawione.

    W przypadku wszystkich dotychczasowych kampanii przed podjęciem próby zmiany kierowania na bliskość, lokalizację lub grupę lokalizacji na poziomie kampanii lub grupy reklam należy ustawić pole contains_eu_political_advertising. Wywołania interfejsu API służące do tworzenia lub aktualizowania tych kryteriów kampanii lub grupy reklam w przypadku istniejących kampanii zakończą się niepowodzeniem i wyświetlą błąd CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION, jeśli kampania nie zakończyła samodzielnej deklaracji.

    W przypadku wersji 19.x i 20.x wymaganie ustawienia tego pola nie jest jeszcze egzekwowane, ale w przyszłości będzie. O tej zmianie poinformujemy z wyprzedzeniem.

  • Wersje próbne i eksperymenty będą zwracać błąd ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION w przypadku, gdy kampanie w eksperymencie nie zadeklarują, czy zawierają reklamy polityczne kierowane na Unię Europejską.

Performance Max

Planowanie

Raporty

Wideo

wersja 20.2 (25.02.2026)

W wersji 20.2 dodaliśmy tę nową funkcję:

Zarządzanie kontem

  • Dodano pole contains_eu_political_advertising do zasobu Customer. To pole pobiera stan deklaracji na poziomie konta, czy zawiera reklamy polityczne kierowane na UE, i zwraca wartość EuPoliticalAdvertisingStatusEnum.

Kampanie

  • Dodaliśmy Campaign.missing_eu_political_advertising_declaration, aby umożliwić wyszukiwanie i filtrowanie kampanii, w których brakuje deklaracji dotyczących tego, czy zawierają reklamy polityczne kierowane na UE.

wersja 20.1 (6.08.2025)

Te zmiany dotyczące reklam politycznych w UE zostały również wprowadzone w wersjach v19.2 i v21.

Zmiany w reklamach politycznych w UE

  • Dodano Campaign.contains_eu_political_advertising. To pole określa, czy Twoja kampania zawiera treści reklamowe o charakterze politycznym kierowane na Unię Europejską. Jeśli to pole ma wartość CONTAINS_EU_POLITICAL_ADVERTISING, od 22 września 2025 r. kampania nie będzie już wyświetlać reklam w UE.

    W przypadku wszystkich dotychczasowych kampanii przed podjęciem próby zmiany kierowania na bliskość, lokalizację lub grupę lokalizacji na poziomie kampanii lub grupy reklam należy ustawić pole contains_eu_political_advertising. Wywołania interfejsu API służące do tworzenia lub aktualizowania tych kryteriów kampanii lub grupy reklam w przypadku istniejących kampanii zakończą się niepowodzeniem i wyświetlą błąd CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION, jeśli kampania nie zakończyła samodzielnej deklaracji.

    W przypadku wersji 19.x i 20.x wymaganie ustawienia tego pola nie jest jeszcze egzekwowane, ale w przyszłości będzie. O tej zmianie poinformujemy z wyprzedzeniem.

  • Wersje próbne i eksperymenty będą zwracać błąd ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION w przypadku, gdy kampanie w eksperymencie nie zadeklarują, czy zawierają reklamy polityczne kierowane na Unię Europejską.

wersja 20 (2025-06-04)

W wersji 20 dodaliśmy te nowe funkcje i aktualizacje:

Więcej informacji znajdziesz w artykule Przechodzenie na najnowszą wersję.

Zasoby

Dodaliśmy kilka nowych rodzajów danych i kolumn segmentów do raportu asset_group.

Kolumny z danymi

Kolumny segmentów

Kampanie

Konwersje

  • Możesz teraz zaktualizować pole google_ads_conversion_customer na koncie obecnego klienta, aby włączyć śledzenie konwersji na wielu kontach lub zmienić dotychczasowe nadrzędne konto śledzenia konwersji na inne konto menedżera.

  • Dodano pole ClickConversion.user_ip_address. Google Ads nie obsługuje dopasowywania adresów IP w przypadku użytkowników z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii (UK) i Szwajcarii (CH). Dodaj logikę warunkowego wykluczania udostępniania adresów IP użytkowników z tych regionów. Zadbaj o to, aby podać użytkownikom jasne i wyczerpujące informacje o danych, które zbierasz w swoich witrynach, aplikacjach i innych usługach, a jeśli jest to wymagane przez prawo lub obowiązujące zasady Google, uzyskać zgodę na ich zbieranie. Więcej informacji znajdziesz na stronie Importowanie konwersji offline.

Kreowanie popytu

Rekomendacje

  • Dodano obsługę znaku ShoppingSetting podczas tworzenia kampanii przy użyciu GenerateRecommendationsRequest.
    • Dodaliśmy pole merchant_center_account_id do GenerateRecommendationsRequest, aby wskazać, kiedy rekomendacje powinny być generowane w przypadku kampanii Performance Max służących do promowania sprzedaży detalicznej, a nie standardowych kampanii Performance Max.

Planowanie

  • Dodano AudienceInsightsDimension.YOUTUBE_LINEUP, aby zastąpić AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP w AudienceInsightsService i ContentCreatorInsightsService. Ten nowy wymiar umożliwia uzyskiwanie statystyk i metadanych dotyczących lineupów YouTube Select (YTS). Zastąpiliśmy obiekty powiązane z YOUTUBE_DYNAMIC_LINEUP, takie jak DynamicLineupAttributeMetadata i AudienceInsightsDynamicLineup, aby dostosować je do szerszego zakresu usuwania dynamicznych zestawień reklam w Google Ads. Ta funkcja jest dostępna tylko na kontach znajdujących się na liście dozwolonych.
  • Dodano AdditionalApplicationInfo i ApplicationInstance w sekcjach AudienceInsightsService, ContentCreatorInsightsService i ReachPlanService. Ta funkcja jest dostępna tylko na kontach znajdujących się na liście dozwolonych.
  • Zaktualizowaliśmy AudienceInsightsService i ContentCreatorInsightsService, aby dostarczać bardziej szczegółowe informacje. W obu usługach możesz teraz segmentować dane twórców treści według urządzenia za pomocą nowych wymiarów AudienceInsightsDimension.DEVICE i AudienceInsightsAttribute.device. Ta funkcja jest dostępna tylko na kontach znajdujących się na liście dozwolonych.
  • Dodaliśmy do GenerateCreatorInsightsResponse dodatkowe zagregowane dane dotyczące filmów, aby umożliwić bardziej kompleksową analizę twórców treści: engagement_rate, average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video, shorts_views_count, shorts_video_count i is_brand_connect_creator. Ta funkcja jest dostępna tylko na kontach na liście dozwolonych.
  • Dodano sub_country_locations do GenerateCreatorInsightsRequest w przypadku ContentCreatorInsightsService. Umożliwia to określanie lokalizacji geograficznych w ramach kraju, aby zawężać wyszukiwania statystyk dotyczących twórców. Pole sub_country_locations jest obsługiwane tylko wtedy, gdy w polu criteria używasz typu search_attributes oneof. Jeśli parametr sub_country_locations jest podany z innymi typami kryteriów, żądanie będzie nieprawidłowe. Umożliwia to bardziej szczegółowe kierowanie geograficzne i analizowanie danych o twórcach. Ta funkcja jest dostępna tylko na kontach na liście dozwolonych.
  • Dodaliśmy funkcję ReachPlanService.ListPlannableUserLists, która zwraca listy użytkowników własnych klienta, oraz dodaliśmy UserListInfo do opcji kierowania na odbiorców w GenerateReachForecastRequest. Umożliwia to pobieranie list użytkowników, na których można kierować reklamy, w przypadku danego klienta, a następnie generowanie prognoz zasięgu kampanii kierowanych na tych konkretnych odbiorców. Te ulepszenia zwiększają skuteczność planowania zasięgu dostosowanego do potrzeb, ponieważ uwzględniają dane o odbiorcach własnych bezpośrednio w prognozach. Prognozowanie zasięgu jest dostępne tylko dla kont znajdujących się na liście dozwolonych.

Filmy

  • Dodano AdFormatType.PAUSE reklamy wyświetlane w bezpłatnych filmach w YouTube na ekranach telewizorów, które są uwzględniane w raportach. Wyświetlają się one bezpośrednio obok statycznej klatki filmu na ekranie pauzy. Nie obejmuje to reklam wideo generujących popyt wyświetlanych w panelu reklamowym poniżej lub powyżej wstrzymanego filmu organicznego, które są raportowane w sekcji AdFormatType.INFEED.

Zarchiwizowane informacje o wersji

Informacje o wersjach wycofanych znajdziesz w sekcji Wycofane wersje.