Informacje o wersjach

wersja 21 (6.08.2025)

AI Max w kampaniach w sieci wyszukiwania

• Możesz teraz użyć pola ai_max_setting.enable_ai_max w Campaign, aby włączyć funkcje AI Max w kampaniach w sieci wyszukiwania. 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ć 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 AI Max w kampaniach w sieci wyszukiwania nie zostanie wyraźnie przełączony i wyłączony.Campaign.ai_max_setting.bundling_required można użyć, aby określić, czy AI Max w kampaniach w sieci wyszukiwania musi być włączony, 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 włączono funkcje AI Max w kampaniach w sieci wyszukiwania. Przeczytaj nasz post na blogu Zwiększ skuteczność kampanii dzięki 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, oraz skuteczność 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

• Dodano pola terms_and_conditions_text, terms_and_conditions_uri, promotion_barcode_info i promotion_qr_code_info w PromotionAsset. Pola kodu kreskowego i kodu QR znajdują się w promotion_trigger oneof.

• Dodano FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION do AssetAutomationTypeEnum. To ustawienie umożliwia kontrolowanie automatycznego generowania komponentów tekstowych i stron docelowych z końcowego adresu URL w kampaniach w sieci wyszukiwania.

• Dodaliśmy nową usługę AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset, która umożliwia usuwanie komponentów tworzonych automatycznie z Campaign. Ta usługa umożliwia tylko usuwanie komponentów z rozwiniętym końcowym adresem URL.

• Dodano wartość DESCRIPTION_PREFIX do wyliczenia ServedAssetFieldType. Rozwiązaliśmy problem, który powodował, że znak served_asset_field_type w ad_group_ad_asset_combination_view był UNKNOWN w przypadku komponentów służących jako prefiks opisu.

Kampanie

• Dodaliśmy nową wartość typu wyliczeniowego MISSING_LOCATION_TARGETING do CampaignPrimaryStatusReason. Ten nowy powód stanu będzie zwracany tylko w przypadku kampanii z ograniczeniami dotyczącymi lokalizacji, które nie określają kierowania na lokalizację. W przypadku kampanii z ograniczeniami dotyczącymi lokalizacji każda próba dodania kierowania na lokalizację poza dozwolonym obszarem spowoduje błąd kryterium LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN.

• Dodaliśmy obsługę partnerów integracyjnych zewnętrznych na poziomach VideoCustomer.third_party_integration_partners i Campaign.third_party_integration_partners. Zapoznaj się z artykułem w Centrum pomocy Śledzenie konwersji w aplikacjach za pomocą zewnętrznych rozwiązań do analityki aplikacji.

• Możesz teraz ustawić pole advertising_partner_ids dla istniejącego Campaign. Wcześniej to pole można było ustawić tylko w przypadku nowej kampanii podczas jej tworzenia.

• Korzystając z udostępnionej listy typu TYPE_PLACEMENT_LIST zdefiniowanej na poziomie konta menedżera, reklamodawcy mogą teraz używać kryteriów CustomerNegativeCriterion do wykluczania listy miejsc docelowych na poszczególnych kontach klientów reklamodawcy.

• Dodano wartość DESCRIPTION_PREFIX do wyliczenia ServedAssetFieldType. Rozwiązaliśmy problem, który powodował, że znak served_asset_field_type w ad_group_ad_asset_combination_view był UNKNOWN w przypadku komponentów służących jako prefiks opisu.

• Dodaliśmy obsługę pola target_roas_tolerance_percent_millis w strategiach ustalania stawek MaximizeConversionValue i TargetRoas. TargetRoas.target_roas_tolerance_percent_millis jest dostępna tylko w przypadku strategii portfolio, które są dostępne tylko w kampaniach w sieci wyszukiwania.

• Zmieniono kod błędu ProductGroup. W przypadku żądań z włączonym częściowym błędem zamiast INVALID_LISTING_GROUP_HIERARCHY zwracana jest wartość LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION.

• Dodaliśmy nowy zasób LocationInterestView, który zawiera podsumowanie skuteczności kryteriów zainteresowań związanych z lokalizacją w grupie reklam.

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

• Dodano kod błędu CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM. W przyszłości ten błąd będzie zwracany podczas próby ustawienia bardzo niskiego budżetu kampanii generującej popyt. Szczegółowe informacje o wymaganym minimalnym budżecie znajdziesz w nowym polu szczegółów błędubudgetDailyMinimumErrorDetails.

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 próbą 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 grup 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 została jeszcze samodzielnie zadeklarowana.

  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

• Dodano nową metodę ReachPlanService.ListPlannableUserInterests, która umożliwia reklamodawcom odkrywanie zainteresowań użytkowników (zainteresowań i zamiarów zakupowych) obsługiwanych przez ReachPlanService.GenerateReachForecast. Ta metoda umożliwia wyszukiwanie określonych typów zainteresowań użytkowników oraz wysyłanie zapytań o nazwy i ścieżki.

• Dodano AdditionalApplicationInfo do ReachPlanService.ListPlannableUserLists jako opcjonalne pole do wprowadzania danych.

• Dodano obsługę AudienceInsightsService.ListAudienceInsightsAttributes pobierania dostępnych list użytkowników własnych dla identyfikatora klienta, który wysyła żądanie.

• Dodano obsługę własnych list użytkowników w AudienceInsightsService.GenerateAudienceCompositionInsights, aby pobierać statystyki dotyczące odbiorców kierowanych na listę użytkowników. Każde żądanie kierowane na listę użytkowników zwróci tylko indeks odbiorców i jest dostępne tylko w przypadku tych AudienceInsightsDimension:AGE_RANGE, GENDER, AFFINITY_USER_INTEREST, IN_MARKET_USER_INTEREST.

• Zaktualizowano typ danych wejściowych listy odbiorców na InsightsAudience w przypadku AudienceInsightsService.GenerateTargetingSuggestionMetrics. Nowe dane wejściowe dotyczące odbiorców umożliwiają łączenie zainteresowań użytkowników za pomocą operatorów AND i OR, co pozwala uzyskać potencjalne dane o zasięgu w przypadku bardziej spersonalizowanych definicji odbiorców.

• Dodano udział odbiorców w TrendInsightMetrics, aby uzyskać udział odbiorców w trendzie.

• Dodaliśmy nowe powiązane kategorie do KnowledgeGraphAttributeMetadata aby użytkownicy mogli filtrować atrybuty Grafu wiedzy według kategorii.

Raporty

• Dostępne są teraz różne nowe dane dotycząceAssetGroupAsset,ChannelAggregateAssetView iCampaignAggregateAssetView. Dodatkowo w przypadku ChannelAggregateAssetViewi CampaignAggregateAssetView, impressions, które wcześniej miało wartość zerową w kampaniach Performance Max, będzie teraz raportować prawdziwą wartość.

• Umożliwiliśmy wybieranie zasobu AssetSet za pomocą parametru ChangeStatus, aby użytkownicy mogli uzyskać więcej informacji o zasobie typu AssetSet lub CampaignAssetSet w jednym zapytaniu.

• Udostępniliśmy zasób CampaignAssetSet z możliwością wyboru za pomocą ChangeStatus dzięki czemu użytkownicy mogą uzyskać więcej informacji o zasobie typu AssetSet lub CampaignAssetSet w jednym zapytaniu.

• Dodaliśmy nowy segment search_term_targeting_status który można wybrać w widoku wyszukiwanych haseł kampanii.

• Dodaliśmy nowy element final_url_expansion_asset_view.

• Dodaliśmy obsługę danych value_adjustment i all_value_adjustment w raporcie AssetGroup.

• Umożliwia to segmentowanie danych AssetGroupAsset według ad_network_type.

• Dodaliśmy nowy segment landing_page_source, którego można używać z zasobem landing_page_view.

• Dodaliśmy nowy segment search_term_match_source który można wybrać w widokach wyszukiwanych słów i wyszukiwanych słów w kampanii.

• Dodaliśmy nowy segment match_type, który można wybrać w widoku słów kluczowych.

• Dodaliśmy obsługę danych dotyczących klastrów unikalnych intencji zapytań, które obejmują:

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

• Dodaliśmy nowy typ kliknięcia VEHICLE_ASSETS w segmentacji click_view, aby śledzić i raportować kliknięcia związane z formatami reklam dotyczącymi zasobów związanych z pojazdami.

Eksploracyjne inteligentne określanie stawek w przypadku strategii ustalania stawek Docelowy ROAS w sieci wyszukiwania

• Możesz teraz włączyć eksplorację inteligentnego określania stawek w kampaniach w sieci wyszukiwania, ustawiając w polu target_roas_tolerance_percent_millis w strategiach ustalania stawek MaximizeConversionValue i TargetRoas dowolną wartość podzielną przez 1000 z zakresu od 10000 (10%) do 30000 (30%) włącznie. W przypadku strategii ustalania stawek MaximizeConversionValue należy też ustawić pole target_roas. TargetRoas.target_roas_tolerance_percent_millis jest dostępna tylko w przypadku strategii portfolio. Przeczytaj nasz post na blogu o eksploracyjnym określaniu stawek oraz artykuł w Centrum pomocy.

• W przypadku klastrów unikalnych intencji zapytań obsługiwane jest teraz zbiorcze raportowanie dotyczące różnorodności w odniesieniu do tych danych: Widok z podziałem na segmenty czasowe jest dostępny w interfejsie Google Ads.

  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters

Wideo

• Dodano YouTubeVideoListAsset. Dodano też element Asset#youtube_video_list_asset, którego można używać do tworzenia połączeń między elementami typu campaign i YouTubeVideoListAsset. Przeczytaj artykuł w Centrum pomocy Korzystanie z powiązanych filmów.

• Dodaliśmy nowe pola metadanych do YouTubeChannelInsights i YouTubeVideoAttributeMetadata.

• Udostępniliśmy nowe typy kliknięć: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK i PRODUCT_ASSETS.

• Dodaliśmy pole allow_non_skippable_in_stream do VideoAdInventoryControl aby umożliwić wyświetlanie elastycznych reklam wideo jako reklam In-Stream niemożliwych do pominięcia. Ta opcja jest dostępna w przypadku kampanii, które obsługują łączenie formatu niemożliwego do pominięcia z innymi formatami.

• Dodano pola Campaign.VideoCampaignSettings.video_ad_sequence i AdGroup.VideoAdGroupSettings.VideoAdSequenceStepSetting (tylko do odczytu). Przeczytaj artykuł w Centrum pomocy Informacje o sekwencjonowaniu reklam wideo.

• Dodaliśmy nowe pola metadanych do YouTubeChannelInsights i YouTubeVideoAttributeMetadata.

• Dodano typ kryterium VIDEO_LINEUP i pole video_lineup do elementów CampaignCriterion i AdGroupCriterion. Ta funkcja jest dostępna tylko na kontach znajdujących się na liście dozwolonych. Aby uzyskać więcej informacji, skontaktuj się z przedstawicielem Google ds. rozwoju biznesu.

• Dodaliśmy raport Dopasowanie treści na poziomie szczegółowym i grupy. Zapoznaj się z artykułem w Centrum pomocy Raport „Dopasowanie treści”.

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 próbą 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 grup 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 została jeszcze samodzielnie zadeklarowana.

  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ą.

v20 (2025-06-04)

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

Zasoby

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

Kolumny z danymi

• new_customer_lifetime_value
• all_new_customer_lifetime_value
• 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

Kolumny segmentów

• ad_network_type
• conversion_action
• conversion_action_name
• conversion_action_category
• external_conversion_source
• conversion_attribution_event_type
• conversion_adjustment
• conversion_lag_bucket
• conversion_or_adjustment_lag_bucket
• new_versus_returning_customers
• device
• slot

Kampanie

• Dodaliśmy obsługę dodawania i aktualizowania wykluczających słów kluczowych na poziomie kampanii w kampaniach Performance Max.

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 użytkowników z Europejskiego Obszaru Gospodarczego (EOG), Wielkiej Brytanii ani Szwajcarii. Dodaj logikę, która warunkowo wyklucza udostępnianie 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.

Generowanie popytu

• Dodaliśmy do segmentu ad_network_type nowe wartości, które umożliwiają segmentowanie kampanii generujących popyt według kanału:
  • MAPS
  • GMAIL
  • DISCOVER
• Dodaliśmy dane dotyczące konwersji porównywalnych na różnych platformach:
  • platform_comparable_conversions_from_interactions_rate
  • platform_comparable_conversions
  • platform_comparable_conversions_value
  • platform_comparable_conversions_value_per_cost
  • platform_comparable_conversions_by_conversion_date
  • platform_comparable_conversions_value_by_conversion_date
  • platform_comparable_conversions_from_interactions_value_per_interaction
  • cost_per_platform_comparable_conversion
  • value_per_platform_comparable_conversion
  • value_per_platform_comparable_conversions_by_conversion_date
  • cost_converted_currency_per_platform_comparable_conversion

Rekomendacje

• Dodano obsługę znaku ShoppingSetting podczas tworzenia kampanii, gdy używasz GenerateRecommendationsRequest.
• Dodaliśmy pole merchant_center_account_id do 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ę 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 analizowanie danych o twórcach. 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 klienta, 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 poniżej lub powyżej wstrzymanego filmu bezpłatnego, 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 próbą 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 grup 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 została jeszcze samodzielnie zadeklarowana.

  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 w przypadku, gdy kampanie w eksperymencie nie zadeklarują, 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

• Dodaliśmy pole asset_coverage dla AssetGroup, które zwraca informacje o lukach w grupie plików.
  • Zawiera pole podrzędne ad_strength_action_items zwracające listę działań, które reklamodawca może podjąć, aby zwiększyć skuteczność reklamy w grupie plików.

Kampanie

• Możesz teraz oceniać potencjalnych klientów i przekazywać opinie na ich temat w kampaniach Usług Lokalnych. W ramach tej zmiany wersja 19.1
  • Dodano nową usługę o nazwie LocalServicesLeadService. Do przesyłania ocen i opinii o potencjalnych klientach możesz użyć metody ProvideLeadFeedback.
  • Dodaliśmy nowe pole o nazwie lead_feedback_submitted w LocalServicesLead, aby ułatwić określanie, czy opinia została przesłana do potencjalnego klienta.
• Dodaliśmy nową kolumnę danychbiddable_cohort_app_post_install_conversions w kampaniach promujących aplikacje.

Generowanie popytu

• W usługach planowania wprowadziliśmy dodatkowe metody, które obsługują kampanie generujące popyt.

• Dodaliśmy obsługę ustawień kanałów na poziomie grupy reklam w kampaniach generujących popyt. Możesz wybrać zdefiniowane wcześniej ogólne grupowanie kanałów lub podzbiór kanałów, korzystając z pola demand_gen_ad_group_settings. W bieżącej wersji obsługiwane są te kanały:

  • Reklama In-Stream w YouTube
  • Reklamy In-Feed w YouTube
  • YouTube Shorts
  • Karty Discover,
  • Gmail
  • Wyświetlacz

• Udostępniliśmy nowy typ komponentu dla TALL_PORTRAIT_MARKETING_IMAGE. Ten typ komponentu jest powiązany z polem tall_portrait_marketing_images w formacie reklamy z wieloma komponentami w kampanii generującej popyt.

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.
• Podczas przesyłania konwersji offline możesz teraz określać typ klienta powiązanego z konwersją.
• W przypadku ClickConversion wprowadzono nowe pole session_attributes.

Reklamy Usług Lokalnych

• Dodaliśmy nowy RPC ProvideLeadFeedback do LocalServicesLeadService, aby umożliwić przesyłanie opinii o jakości LocalServicesLead.
• Dodaliśmy nowe pole lead_feedback_submitted do zasobu LocalServicesLead, które potwierdza, czy w przypadku danego zasobu przesłano opinię.

Usługi planowania

• Dodaliśmy obsługę miesięcznych prognoz docelowej częstotliwości w ReachPlanService.GenerateReachForecast.
  • Deweloperzy mogą ustawić TargetFrequencyTimeUnit.MONTHLY w TargetFrequencySettings, gdy używają kodu produktu planowanego TARGET_FREQUENCY, aby wygenerować prognozę miesięcznego zasięgu Docelowej częstotliwości.
• 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, które można zaplanować.
  • 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

• Nowe pole ad_strength jest dostępne w przypadku ImprovePerformanceMaxAdStrengthRecommendation, które zwraca bieżący wynik skuteczności reklamy grupy plików powiązanej z rekomendacją.

  Zakupy

• Możesz teraz zastępować wykluczenia marek w reklamach produktowych w kampaniach Performance Max. Jest to widoczne w nowym polu pmax_campaign_settings na poziomie kampanii i działa tylko w przypadku kampanii PMax dla handlu detalicznego. Jeśli spróbujesz ustawić to pole w przypadku niezgodnego typu kampanii, pojawi się nowy błądCampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED.

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:
  • Nowy AdvertisingChannelSubType o nazwie YOUTUBE_AUDIO.
  • Nowy AdGroupType o nazwie YOUTUBE_AUDIO.
  • Nowe wyliczenie formatu reklamy o nazwie YOUTUBE_AUDIO_AD i odpowiadające mu pola YouTubeAudioAdInfo.
• 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.

wersja 19 (26.02.2025)

W wersji 19 dodaliśmy te funkcje i zmiany:

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

• Dodano DemandGenMultiAssetAdInfo.tall_portrait_marketing_images aby obsługiwać komponenty z obrazem pionowym o współczynniku proporcji 9:16 w reklamach generujących popyt.

Zasoby

• (Tylko w przypadku kont z białej listy) Dodano obsługę komponentów do wysyłania wiadomości za pomocą Asset.business_message_asset, BusinessMessageAsset oraz tych wyliczeń i błędów:
  • Enums:
    • AssetFieldType.BUSINESS_MESSAGE
    • AssetType.BUSINESS_MESSAGE
    • BusinessMessageCallToActionType
    • BusinessMessageProvider
  • Błędy:
    • AssetError.CUSTOMER_NOT_ON_ALLOWLIST_FOR_WHATSAPP_MESSAGE_ASSETS
    • ResourceLimitType
      • BUSINESS_MESSAGE_ASSET_LINKS_PER_CUSTOMER
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_CAMPAIGN
      • WHATSAPP_BUSINESS_MESSAGE_ASSET_LINKS_PER_AD_GROUP
• Dodano AssetAutomationType.GENERATE_LANDING_PAGE_PREVIEW, aby obsługiwać automatyczne generowanie podglądu strony docelowej.
• AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS jest teraz domyślnie włączona w przypadku reklam wideo generujących popyt.
• (Tylko dla kont na liście dozwolonych; lista jest obecnie zamknięta) Dodano Asset.app_deep_link_asset i AppDeepLinkAsset.

Konwersje

• Cele konwersji
  • LifecycleGoalValueSettings.high_lifetime_value jest już dostępny poza wersją beta i można go zmieniać.
  • Dodano CustomerLifecycleGoal.owner_customer aby wyświetlać nazwę zasobu klienta, który jest właścicielem celu związanego z cyklem życia klienta.
• Wycofano ConversionActionType.SALESFORCE.

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. Listę wszystkich usuniętych elementów znajdziesz w uwagach dotyczących migracji.

Hotele i podróże

• W polu optional zmieniliśmy min_days i max_days z ValueRuleItineraryAdvanceBookingWindow, 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

• (Tylko konta na liście dozwolonych) Wytyczne dotyczące marki
  • Można zmieniać tylko podczas tworzenia kampanii Performance Max.Campaign.brand_guidelines_enabled
  • Jest to niezgodne z kampaniami Performance Max do celów związanych z podróżami.
  • Aby włączyć wskazówki dotyczące marki w przypadku dotychczasowych kampanii Performance Max, użyj nowo dodanego elementu CampaignService.EnablePMaxBrandGuidelines. Wyłączanie wskazówek dotyczących marki nie jest obsługiwane.
  • Dodano Campaign.brand_guidelines i BrandGuidelines, aby umożliwić ustawianie kolorów i rodziny czcionek marki.
  • Nowe wartości błędów:
    • BatchJobError.CAMPAIGN_AND_CAMPAIGN_ASSET_TRANSACTION_FAILURE
    • BrandGuidelinesMigrationError
    • BRAND_GUIDELINES_ALREADY_ENABLED
    • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_REMOVED_CAMPAIGN
    • BRAND_GUIDELINES_LOGO_LIMIT_EXCEEDED
    • CANNOT_AUTO_POPULATE_BRAND_ASSETS_WHEN_BRAND_ASSETS_PROVIDED
    • AUTO_POPULATE_BRAND_ASSETS_REQUIRED_WHEN_BRAND_ASSETS_OMITTED
    • TOO_MANY_ENABLE_OPERATIONS
  • CampaignError
  • BRAND_GUIDELINES_NOT_ENABLED_FOR_CAMPAIGN
  • BRAND_GUIDELINES_MAIN_AND_ACCENT_COLORS_REQUIRED
  • BRAND_GUIDELINES_COLOR_INVALID_FORMAT
  • BRAND_GUIDELINES_UNSUPPORTED_FONT_FAMILY
  • BRAND_GUIDELINES_UNSUPPORTED_CHANNEL
  • CANNOT_ENABLE_BRAND_GUIDELINES_FOR_TRAVEL_GOALS
  • CUSTOMER_NOT_ALLOWLISTED_FOR_BRAND_GUIDELINES
• Dodano AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOS obsługę automatycznego generowania ulepszonych komponentów wideo w kampaniach Performance Max.

Planowanie

• (Tylko w przypadku kont dodanych do listy dozwolonych) Dodano funkcję ContentCreatorInsightsService.GenerateTrendingInsights umożliwiającą użytkownikom wyświetlanie popularnych tematów w YouTube dla określonych definicji odbiorców.
• Dodano GenerateCreatorInsightsRequest.country_locations[] aby określić kraje, w których mają być wyszukiwane dane według podanych kryteriów.
• Dodano GenerateCreatorInsightsRequest.search_brand, aby określić markę, której twórców chcesz wyszukać.
• Dodaliśmy nowe pola do YouTubeChannelInsights, aby udostępniać dodatkowe informacje o kanale w przypadku żądań search_channels:
  • channel_url
  • channel_description
  • top_videos
• Dodaliśmy nowe pola metadanych do AudienceInsightsAttributeMetadata:
  • youtube_video_metadata
  • user_interest_attribute_metadata
  • knowledge_graph_attribute_metadata

Filmy

• Po wprowadzeniu DataLinkService.CreateDataLink dodaliśmy te metody, aby umożliwić modyfikowanie wcześniej utworzonych połączeń danych:
  • RemoveDataLink usuwania połączeń danych na koncie Google Ads;
  • UpdateDataLink – akceptowanie, odrzucanie i cofanie połączeń danych na koncie Google Ads
• Usunięto obsługę wartości VIDEO_OUTSTREAM z tych wyliczeń:
  • AdType
  • AdvertisingChannelSubType
  • AdGroupType

wersja 18 (16.10.2024)

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

Zarządzanie kontem

• (Tylko w przypadku kont dodanych do listy dozwolonych) Dodano DataLinkService.CreateDataLink, która umożliwia połączenie konta Google Ads z filmami twórców hostowanymi na kanale w YouTube należącym do twórcy. Łączenie filmów umożliwia kontu Google Ads wyświetlanie reklam partnerskich z wykorzystaniem filmów twórców.

Grupy reklam

• Dodano parametr AdGroup.exclude_demographic_expansion, który umożliwia wykluczanie danych demograficznych z rozszerzania, gdy parametr optimized_targeting_enabled ma wartość true. Ta funkcja była wcześniej obsługiwana tylko w przypadku kampanii generujących popyt.

Reklamy

• Dodano AdGroupAd.ad_group_ad_asset_automation_settings, co umożliwia włączanie i wyłączanie automatycznego generowania komponentów w reklamach.
• Dodaliśmy te wartości do parametru AssetAutomationType:
  • GENERATE_VERTICAL_YOUTUBE_VIDEOS
  • GENERATE_SHORTER_YOUTUBE_VIDEOS
• Dodano AdNetworkType.GOOGLE_OWNED_CHANNELS, które jest używane przez reklamy wyświetlane w kanałach należących do Google, takich jak YouTube, Gmail i karty Discover.

Zasoby

• Zmieniono nazwę AssetType.DISCOVERY_CAROUSEL_CARD na AssetType.DEMAND_GEN_CAROUSEL_CARD.

Kampanie

• Dodano funkcję metrics.store_visits_last_click_model_attributed_conversions, która zwraca liczbę wizyt w sklepie stacjonarnym przypisanych przez model ostatniego kliknięcia w kampanii.
• Dodaliśmy te dane dotyczące wyświetleń filmu w kampanii:
  • metrics.video_view_rate_in_feed
  • metrics.video_view_rate_in_stream
  • metrics.video_view_rate_shorts
• Dodano metrics.results_conversions_purchase, które zwraca zakupy prowadzące do konwersji w przypadku wyników ujednoliconych celów kampanii.
• Zmieniono wartość domyślną parametru DemandGenCampaignSettings.upgraded_targeting z false na true.

Kryterium

• Dodano pole content_criterion_view, które zwraca dane o skuteczności kierowanych treści, takich jak słowa kluczowe, miejsca docelowe i tematy, w przypadku kampanii w sieci reklamowej, kampanii generujących popyt i kampanii wideo.

Hotele i podróże

• Obsługa plików danych o miejscach noclegowych w reklamach w wyszukiwarce
  • Dodano parametr ClickType.TRAVEL_ASSETS, aby umożliwić segmentowanie danych dotyczących plików danych o miejscach noclegowych w reklamach w wyszukiwarce.
  • Dodano AssetSetType.TRAVEL_FEED które można wykorzystać do włączania i wyłączania korzystania z pliku danych o miejscach noclegowych w reklamach w wyszukiwarce.
• (Tylko w przypadku kont znajdujących się na liście dozwolonych) Dodano plan podróży jako nową regułę wartości konwersji z tymi nowymi polami i wartościami:
  • ConversionValueRule.itinerary_condition z ValueRuleItineraryCondition, która umożliwia określenie okresu rezerwacji z wyprzedzeniem, długości planu podróży i dni rozpoczęcia podróży w tygodniu.
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• Dodaliśmy te segmenty do raportów campaign i ad_group, aby umożliwić dzielenie danych o skuteczności na segmenty według konkretnych miejsc docelowych (miast, krajów i regionów) w kampaniach reklam hoteli i w sieci wyszukiwania:
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

Usługi Lokalne

• PhoneCallDetails.call_recording_url będzie puste zamiast podawać nieprawidłowy adres URL, jeśli nagranie rozmowy nie istnieje w przypadku danej rozmowy z potencjalnym klientem Usług Lokalnych.
• Dodano CategoryBid.target_cpa_bid_micro która umożliwia ustawienie docelowego CPA dla kategorii za pomocą Campaign.local_services_campaign_settings.

Performance Max

• Pomoc odnośnie do wskazówek dotyczących marki
  • Dodano kolumnę Campaign.brand_guidelines_enabled, która wskazuje, czy w danej kampanii Performance Max włączono wskazówki dotyczące marki. Jeśli ta opcja jest włączona, komponenty z ustawioną wartością field_type na BUSINESS_NAME, LOGO lub LANDSCAPE_LOGO muszą być połączone jako zasoby CampaignAsset, a nie jako zasoby AssetGroupAsset.
  • Dodano błędy CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED i CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED wskazujące, że kampanie Performance Max z włączonymi wytycznymi dotyczącymi marki nie mają wymaganych zasobów CampaignAsset połączonych z kampanią.
  • Gdy wytyczne dotyczące marki są włączone, z kampanią musi być powiązany co najmniej 1 komponent z ustawieniem field_type na BUSINESS_NAME oraz co najmniej 1 komponent z ustawieniem LOGO jako zasoby CampaignAsset. Kampanie Performance Max z celami dotyczącymi sprzedaży online za pomocą pliku danych o produktach muszą spełniać to wymaganie tylko wtedy, gdy istnieją komponenty połączone z grupami plików kampanii.
  • Dodano te wartości do AssetLinkError:
  • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, która jest zgłaszana podczas próby połączenia komponentów marki z kampaniami jako zasobów CampaignAsset zamiast zasobów AssetGroupAsset w kampaniach Performance Max z wytycznymi dotyczącymi marki, które nie są włączone.
  • BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL error, który jest zgłaszany podczas próby połączenia komponentów marki z kampaniami jako zasoby AssetGroupAsset zamiast zasobów CampaignAsset w kampaniach Performance Max z włączonymi wskazówkami dotyczącymi marki.
• Dodaliśmy pole performance_max_placement_view, które zwraca wyświetlenia miejsc docelowych, w których wyświetlały się reklamy Performance Max.
• Dodano AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

Planowanie

• (Tylko w przypadku kont z listy dozwolonych) Dodaliśmy nową usługę z metodą ContentCreatorInsightsService.GenerateCreatorInsights, która umożliwia użytkownikom poznawanie statystyk dotyczących najpopularniejszych twórców w YouTube. Umożliwia to klientom wyszukiwanie twórców na podstawie kombinacji kierowania na odbiorców i kierowania na treści lub statystyk twórców na podstawie listy identyfikatorów kanałów w YouTube.
• Zmiany w AudienceInsightsService.GenerateSuggestedTargetingInsights:
  • Przeniesiono audience, baseline_audience i data_month do audience_definition.
  • Dodano audience_description możliwość generowania sugestii dotyczących kierowania na podstawie opisu w formie tekstu swobodnego za pomocą generatywnej AI.
• Dodano usługę AudienceInsightsService.GenerateTargetingSuggestionMetrics, która zwraca dane o potencjalnym zasięgu w przypadku podanych kombinacji kierowania na odbiorców.

Rekomendacje

• RecommendationService.GenerateRecommendations można teraz używać do generowania rekomendacji dotyczących zoptymalizowanych sugestii budżetowych podczas tworzenia kampanii, uwzględniając typ rekomendacji CAMPAIGN_BUDGET w GenerateRecommendationsRequest.recommendation_types[]. Dotyczy to kampanii Performance Max i kampanii w sieci wyszukiwania.

Raportowanie

• Pola summary_row_setting i return_total_results_count w SearchGoogleAdsRequest zostały zastąpione polem search_settings, którego typ to SearchSettings, z tymi polami:
  • omit_results
  • return_summary_row
  • return_total_results_count
• Dodaliśmy te nowe dane dotyczące ogólnych nieprawidłowych kliknięć, np. kliknięć generowanych przez boty lub roboty indeksujące oraz kliknięć o nieregularnych wzorcach. Można je sprawdzać za pomocą raportu campaign.
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• Dodaliśmy te wartości do elementu QuotaError:
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

Zarchiwizowane informacje o wersji

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