Informacje o wersjach

wersja 22 (15.10.2025)

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

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

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 tekstowych i komponentów z obrazem 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, dowolne prompty, słowa kluczowe i kontekst istniejącej kampanii.
    • GenerateImages: generuje obrazy na podstawie danych wejściowych, takich jak końcowy adres URL, dowolne prompty, kontekst istniejącej kampanii lub poprzez zmianę kontekstu istniejących zdjęć produktów.
    • Błędy podczas generowania komponentów są zwracane z kodami z zakresu AssetGenerationErrorEnum.

Kampanie

Generowanie popytu

Ogólne

  • Dodano limit 10 000 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).
  • Dodaliśmy nowy kod błędu: QuotaError.PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED wskazujący, że limit współczynników aktywacji profilu płatności został przekroczony.

Performance Max

  • Dodano nowe AssetAutomationType wartości 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 pobieranie obrazów z końcowych adresów URL. Domyślnie jest to ustawienie dynamicznego rozszerzenia graficznego na poziomie konta.
  • Usunięto AssetPerformanceLabel w przypadku kampanii Performance Max.
  • Funkcją usuniętego parametru Campaign.url_expansion_opt_out zarządza się teraz przez ustawienie parametru AssetAutomationType FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION w AssetAutomationSetting.
  • 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 wybrany jest 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 (06.08.2025)

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

AI Max w kampaniach w sieci wyszukiwania

  • Możesz teraz użyć pola ai_max_setting.enable_ai_max w Campaign, aby włączyć AI Max w kampaniach w sieci wyszukiwania. AI Max w kampaniach w sieci wyszukiwania zwiększa zasięg kampanii w sieci wyszukiwania dzięki dopasowywaniu wyszukiwanych słów i umożliwia kontrolowanie, czy po ustawieniu mają być stosowane ustawienia kierowania i kreacji. Automatyzacja komponentów tekstowych i ustawienia list marek, które zostały skonfigurowane w żądaniach poprzedniej 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. Campaign.ai_max_setting.bundling_required można użyć, aby 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 w kampanii nadrzędnej są włączone funkcje AI Max w kampaniach w sieci wyszukiwania. Przeczytaj nasz post na blogu Osiągaj lepsze wyniki dzięki funkcjom AI Max w kampaniach w sieci wyszukiwania.

  • Dodano CampaignError.AI_MAX_MUST_BE_ENABLED, który jest zgłaszany 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 funkcjami AI Max. Teraz możesz dodawać do grup reklam 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 i jakie były wyniki tych konkretnych kombinacji. W przyszłej wersji dodamy widok, który będzie zawierać też dane o kampaniach Performance Max. Jeśli chcesz uniknąć migracji 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ż mieli 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.

Generowanie 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 wskazuje, 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 służące do tworzenia 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 jeszcze autodeklaracji.

    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 zwrócą błąd ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION jeśli kampanie w eksperymencie nie zadeklarowały, czy zawierają reklamy polityczne kierowane na Unię Europejską.

Performance Max

  • W przypadku nowych kampanii PMax domyślna wartość parametru Campaign.brand_guidelines_enabled to teraz true.

  • Dodano raport campaign_search_term_view. Ten widok zawiera dane dotyczące wyszukiwanych słów zagregowane na poziomie kampanii. W tym widoku wprowadziliśmy też obsługę kampanii Performance Max w przypadku haseł.

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

Planowanie

Raporty

Wideo

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 wskazuje, 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 jeszcze autodeklaracji.

    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 zwrócą błąd ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION, jeśli kampanie eksperymentu 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) ani Szwajcarii (CH). Dodaj logikę warunkowego wykluczania adresów IP udostępnianych przez 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.

Generowanie popytu

Rekomendacje

  • Dodano obsługę znaku ShoppingSetting podczas tworzenia kampanii, gdy używasz GenerateRecommendationsRequest.
  • Dodaliśmy pole merchant_center_account_id do sekcji GenerateRecommendationsRequest, aby wskazywać, kiedy rekomendacje powinny być generowane w przypadku kampanii detalicznych, a nie standardowych kampanii Performance Max.

Planowanie

  • Dodano AudienceInsightsDimension.YOUTUBE_LINEUP w miejsce AudienceInsightsDimension.YOUTUBE_DYNAMIC_LINEUP w AudienceInsightsService i ContentCreatorInsightsService. Ten nowy wymiar umożliwia pobieranie 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ń w Google Ads. Ta funkcja jest dostępna tylko na kontach na liście dozwolonych.
  • Dodano AdditionalApplicationInfo i ApplicationInstance w AudienceInsightsService, ContentCreatorInsightsService i ReachPlanService. Ta funkcja jest dostępna tylko na kontach na liście dozwolonych.
  • Zaktualizowaliśmy pola 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 parametró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ę dla 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 sub_country_locations są podane z innymi typami kryteriów, żądanie będzie nieprawidłowe. Umożliwia to bardziej szczegółowe kierowanie geograficzne i analizę danych dla twórców. Ta funkcja jest dostępna tylko na kontach na liście dozwolonych.
  • Dodaliśmy ReachPlanService.ListPlannableUserLists, które zwraca własne listy użytkowników należące do klienta, oraz dodaliśmy UserListInfo do opcji kierowania na odbiorców w GenerateReachForecastRequest. Dzięki temu możesz pobierać listy użytkowników, których można uwzględnić w planowaniu, dla danego klienta, a następnie generować prognozy zasięgu kampanii kierowanych na tych konkretnych odbiorców. Te ulepszenia zwiększają skuteczność planowania zasięgu dostosowanego do potrzeb, ponieważ bezpośrednio uwzględniają w prognozach Twoje dane własne o odbiorcach. Prognozowanie zasięgu jest dostępne tylko dla kont znajdujących się na liście dozwolonych.

Filmy

  • Dodaliśmy AdFormatType.PAUSEreklamy wyświetlane w bezpłatnych filmach w YouTube na ekranach telewizorów, które są uwzględniane w raportach. Reklamy te wyświetlają się bezpośrednio obok statycznej klatki filmu na ekranie pauzy. Nie obejmuje to reklam wideo generujących popyt wyświetlanych w panelu reklamowym pod lub nad wstrzymanym filmem bezpłatnym, które są raportowane w sekcji AdFormatType.INFEED.

wersja 19.2 (6.08.2025)

Te zmiany dotyczące reklam politycznych w UE zostały też wprowadzone w wersjach v20.1 i v21.

Zmiany w reklamach politycznych w UE

  • Dodano Campaign.contains_eu_political_advertising. To pole wskazuje, 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 jeszcze autodeklaracji.

    W przypadku wersji 19.x i 20.x wymaganie ustawienia tego pola nie jest jeszcze egzekwowane, ale w przyszłości będzie. Poczekaj na ogłoszenie tej zmiany.

  • Wersje próbne i eksperymenty zwrócą błąd ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION jeśli kampanie w eksperymencie nie zadeklarowały, czy zawierają reklamy polityczne kierowane na Unię Europejską.

wersja 19.1 (16.04.2025)

W wersji 19.1 dodaliśmy te funkcje i zmiany:

Zasoby

Kampanie

Generowanie popytu

Historia zmian

  • Dodano obsługę 3 kolejnych typów zasobów w ChangeStatusResourceType:
    • CAMPAIGN_BUDGET
    • ASSET_SET
    • CAMPAIGN_ASSET_SET
  • Te 3 bardziej szczegółowe typy możesz uzyskać z raportu change_status.

Konwersje

  • Podczas tworzenia nowego klienta za pomocą interfejsu Google Ads API możesz teraz ustawić pole google_ads_conversion_customer. Wcześniej było to pole tylko do odczytu.

    UWAGA: ta funkcja jest dostępna tylko na zamkniętej liście dozwolonych. Aby z niej skorzystać, skontaktuj się z menedżerem konta.

  • Podczas przesyłania konwersji offline możesz teraz określać typ klienta powiązanego z konwersją.

  • Wprowadziliśmy nowe pole session_attributes w przypadku ClickConversion.

Reklamy Usług Lokalnych

Usługi planowania

  • Dodaliśmy obsługę miesięcznych prognoz docelowej częstotliwości w ReachPlanService.GenerateReachForecast.
  • Dodano nową metodę ReachPlanService.GenerateConversionRates, która umożliwia reklamodawcom przesyłanie próśb o sugerowane współczynniki konwersji w przypadku obsługiwanych produktów, które można zaplanować.
  • Prognozowanie w kampaniach generujących popyt w ReachPlanService.GenerateReachForecast:
    • Deweloperzy mogą teraz prosić o prognozy zasięgu w przypadku kampanii generujących popyt. Deweloperzy mogą używać nowego DEMAND_GEN_MAX_CONVERSIONSkodu produktu do planowania, aby generować prognozy zasięgu reklam generujących popyt.
    • Dodaliśmy nowe pole conversion_rate, które umożliwia deweloperom wysyłającym prośby o prognozy zasięgu kampanii generujących popyt podanie współczynnika konwersji. Sugerowane współczynniki konwersji można pobrać za pomocą nowej metody ReachPlanService.GenerateConversionRates. To pole jest wymagane w przypadku próśb o prognozy dotyczące kampanii generujących popyt. Nie jest obsługiwana w przypadku innych produktów, w których można zaplanować kampanie.
    • Dodano nowe pole conversions do zwracanych prognoz. To pole zawiera liczbę konwersji w danym punkcie na krzywej zasięgu. Konwersje są obsługiwane tylko w przypadku usługi DEMAND_GEN_MAX_CONVERSIONS, którą można zaplanować.

Rekomendacje

Filmy

  • Dodaliśmy obsługę reklam audio w trybie tylko do odczytu. Więcej informacji o tej funkcji znajdziesz w Centrum pomocy Google Ads. Ta zmiana udostępnia:
  • Dodaliśmy nowe dane i segmenty do danych o zasięgu zapytań z dostosowaniem do danych demograficznych. W ramach tych zmian:
    • Wprowadziliśmy 2 nowe kolumny danych o nazwach coviewed_impressions i primary_impressions.
    • Wprowadziliśmy 2 nowe segmenty o nazwach adjusted_age_range i adjusted_gender.
    • Jeśli którykolwiek z 2 nowych segmentów zostanie wybrany wraz z polem danych o zasięgu (coviewed_impressions, primary_impressions, unique_users lub average_impression_frequency_per_user), aby uzyskać prawidłowe statystyki w tych kolumnach, należy wybrać również drugi segment.
    • Ta funkcja jest obecnie dostępna tylko dla klientów, którzy znajdują się na liście dozwolonych.

v19 (26.02.2025)

W wersji 19 dodaliśmy te funkcje i zmiany:

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

Zarządzanie kontem

  • Dodaliśmy te wartości do CustomerError, aby uwzględnić nadchodzące zmiany:
    • CREATION_DENIED_FOR_POLICY_VIOLATION
    • CREATION_DENIED_INELIGIBLE_MCC

Reklamy

Zasoby

Konwersje

Pliki danych

  • Usunęliśmy wszystkie elementy związane z plikiem danych, takie jak Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view itp. Użytkownicy powinni teraz używać assets, aby osiągnąć ten sam cel.

Hotele i podróże

  • Zmieniliśmy pola min_days i max_days w ValueRuleItineraryAdvanceBookingWindow na pola optional, aby można było określić wartość 0. Umożliwia to kierowanie na wyszukiwania dotyczące podróży, które mają miejsce dzisiaj.

Performance Max

Planowanie

Filmy

Zarchiwizowane informacje o wersji

Informacje o wersjach, które nie są już obsługiwane, znajdziesz w sekcji Wersje wycofane.