Informacje o wersjach

wersja 23 (28.01.2026)

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

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

Reklamy

• Dodano AD_SHARING_NOT_ALLOWED do AdGroupAdErrorEnum. Ten błąd jest zwracany podczas próby udostępnienia reklamy w wielu grupach reklam, co nie jest już dozwolone.
• Dodaliśmy nowe typy formatów do AdFormatType: TEXT, VERTICAL_ADS_BOOKING_LINK, VERTICAL_ADS_PROMOTION.
• W wersji 23 wycofano obsługę CallAd i CallAdInfo. Więcej informacji znajdziesz na stronie https://support.google.com/google-ads/answer/6341403.

Zasoby

• Dodaliśmy do raportu asset_group te dodatkowe dane:

  • metrics.engagements
  • metrics.engagement_rate
  • metrics.average_cpe

• Dodaliśmy do raportu asset_group_asset te dodatkowe dane:

  • metrics.average_cpe
  • metrics.average_cpm
  • metrics.trueview_average_cpv
  • metrics.video_trueview_view_rate
  • metrics.video_trueview_views
  • metrics.interaction_event_types

• Dodano pole tylko do odczytu orientation do komponentów z obrazem i wideo w kampanii Asset.

• Dodaliśmy obsługę pobierania wartości CampaignAsset za pomocą parametrów field_type HEADLINE i DESCRIPTION.

• Dodano HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE i DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO do ServedAssetFieldType w przypadku komponentów wyświetlanych jako linki do podstron.

• Zaktualizowane komponenty do wysyłania wiadomości do firmy:

  • Dodano obsługę Facebook Messengera i Zalo jako dostawców w BusinessMessageAsset, dodano FACEBOOK_MESSENGER i ZALO do BusinessMessageProviderEnum.BusinessMessageProvider oraz nowe pola facebook_messenger_info i zalo_info do BusinessMessageAsset.
  • Dodano CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS do AssetErrorEnum.

Płatności

• InvoiceService.ListInvoices może teraz zwracać bardziej szczegółowe informacje w Invoice, w tym podział kosztów na poziomie kampanii, wyszczególnione koszty regulacyjne i informacje o dostosowaniu, przez ustawienie include_granular_level_invoice_details w ListInvoicesRequest.
• Dodano RegulatoryFeeTypeEnum i UnitOfMeasureEnum.

Kampanie

• Dodano kody błędów CampaignError.DURATION_TOO_LONG_FOR_TOTAL_BUDGET i CampaignError.END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
• Dodaliśmy Campaign.start_date_time i Campaign.end_date_time, aby zastąpić Campaign.start_date i Campaign.end_date, co umożliwia określanie komponentów czasu w przypadku niektórych typów kampanii.

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

• Dodano pole DemandGenVideoResponsiveAdInfo.companion_banner.
• Usunięto pole lead_form_only z DemandGenMultiAssetAdInfo.

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:

  • Dodano IncentiveService:
    • Metoda FetchIncentive umożliwia pobieranie dostępnych zachęt dla użytkownika na podstawie kraju, języka i opcjonalnie adresu e-mail użytkownika. Może to zwrócić spersonalizowane opcje zachęt „Wybierz własną” (CYO).
    • Metoda ApplyIncentive umożliwia zastosowanie wybranej przez użytkownika zachęty do konkretnego konta klienta Google Ads.
  • Dodano zasób tylko do odczytu AppliedIncentive, do którego można wysyłać zapytania za pomocą GoogleAdsService.Search i GoogleAdsService.SearchStream. Zawiera szczegółowe informacje o wykorzystanych zachętach, w tym ich stan, postęp realizacji, kwoty nagród i odpowiednie daty.
  • Dodaliśmy nowe kody błędów w IncentiveErrorEnum, aby rozwiązywać problemy związane z pobieraniem lub stosowaniem zachęt.
  • Dodano INVALID_EMAIL_ADDRESS do AuthenticationErrorEnum.

• 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 monitorowanie 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

• Dodano LIFE_EVENT_USER_INTEREST do AudienceInsightsDimensionEnum. Ten nowy wymiar umożliwia użytkownikom tworzenie list odbiorców za pomocą zdarzeń z życia w przypadku tych metod:

  • AudienceInsightsService.GenerateAudienceCompositionInsights
  • AudienceInsightsService.GenerateSuggestedTargetingInsights
  • AudienceInsightsService.GenerateInsightsFinderReport
  • ContentCreatorInsightsService.GenerateCreatorInsights

  Kierowanie na zdarzenia z życia nie jest obsługiwane w przypadku innych metod AudienceInsightsService, takich jak AudienceInsightsService.GenerateAudienceOverlap i AudienceInsightsService.GenerateTargetingSuggestionMetrics.

• Odpowiedź ReachPlanService.GenerateConversionRates zawiera teraz parametry, które umożliwiają podawanie różnych sugestii dotyczących współczynnika konwersji na podstawie ustawień powierzchni (np. Gmail, Shorts). Jest to obsługiwane tylko w przypadku kampanii generujących popyt.

• Dodano LanguageDistribution do YouTubeChannelInsights, co umożliwia rozpowszechnianie treści w różnych językach na kanale w YouTube.

• Dodano BenchmarksService, aby porównywać dane reklam w YouTube z benchmarkami branżowymi.

• Dodano AudienceInsightsService.GenerateAudienceDefinition, aby tłumaczyć opis tekstowy odbiorców docelowych na pasujące atrybuty odbiorców za pomocą generatywnej AI.

• Dodaliśmy YouTubeChannelInsights.relevance_score, który ocenia, jak bardzo twórca jest odpowiedni w danym temacie, z uwzględnieniem liczby wyświetleń.

• Dodano TrendInsightMetrics.trend_change_percent, który reprezentuje procentową zmianę wartości trendu w okresie porównawczym.

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

• Dane i segmentacja

  • AdGroupAdAssetView i AdGroupAdAssetCombinationView obsługują teraz dane o wyświetleniach, skuteczności i konwersjach w przypadku RESPONSIVE_DISPLAY_AD.
  • Dodaliśmy segment ad_sub_network_type, aby uzyskać bardziej szczegółowe informacje o skuteczności w sieci reklamowej. Początkowo ta funkcja będzie dostępna w kampaniach Demand Gen w YouTube (reklamy In-Stream, In-Feed i Shorts). Ten segment musi być wybrany razem z segmentem ad_network_type.
  • Podział włączonych typów sieci reklamowych w kampaniach Performance Max.
  • Widoki UserLocationView i GeographicView obsługują teraz 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,
    • cross_device_conversions_by_conversion_date,
    • cross_device_conversions_value_by_conversion_date.

• Nowe segmenty dla reklam w branżach

  • vertical_ads_event_participant_display_names
  • vertical_ads_hotel_class
  • vertical_ads_listing
  • vertical_ads_listing_brand
  • vertical_ads_listing_city
  • vertical_ads_listing_country
  • vertical_ads_listing_region
  • vertical_ads_partner_account
  • vertical_ads_vertical

• Nowe wyświetlenia:

  • Dodano PerStoreView do zapytania o szczegóły lokalizacji sklepu.
  • Dodano MatchedLocationInterestView w przypadku kampanii AI Max, podając dane o skuteczności podzielone według lokalizacji geograficznych, w których użytkownicy wykazali zainteresowanie.

• Kampanie Performance Max:

  • Podział włączonych typów sieci reklamowych w kampaniach Performance Max.

• Usuwanie:

  • Usunięto zagregowane dane dotyczące skuteczności komponentu. W przypadku sieci wyszukiwania i sieci reklamowej wyliczenie performance_label nie jest już zwracane.

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, a także zdefiniować zestaw reguł grupy produktów, aby kierować reklamy na podzbiór obiektów z pliku danych reklam wertykalnych. Dodatkowo raporty można teraz dzielić na segmenty według AdFormatType i wymiarów z pliku danych reklam wertykalnych.

Wideo

• Dodano pole AdVideoAssetInfo.ad_video_asset_feature_control.
• Dodano kod błędu CampaignCriterionError.INVALID_VIDEO_LINEUP_ID.
• Dodaliśmy dane o słyszalności reklam audio w YouTube, które informują, czy reklama była słyszalna i w przypadku ilu wyświetleń można było zmierzyć słyszalność.

v22 (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 tekstowych i graficznych 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

• Dodaliśmy nowe cele ustalania stawek w kampaniach promujących instalacje aplikacji, które umożliwiają optymalizację bez określania celu. Jest to przydatne w przypadku szybkiego skalowania lub gdy trudno jest określić odpowiedni cel. W AppCampaignBiddingStrategyGoalType:OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: używaj ze standardową strategią Maksymalizacja liczby konwersji.
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: Używaj ze standardową strategią Maksymalizacja wartości konwersji.
• Dodano obsługę strategii ustalania stawek pod kątem stałego udziału w odsłonach.
• Dodano kolumnę Campaign.feed_types, która zawiera typy plików danych dołączonych do kampanii. W przypadku kampanii Performance Max może to być branża, np. MERCHANT_CENTER_FEED w przypadku handlu detalicznego.
• Umożliwia dołączanie udostępnionych zbiorów NEGATIVE_KEYWORDS do kampanii MULTI_CHANNEL (w przypadku kampanii promujących aplikacje) i kampanii LOCAL.

Kreowanie popytu

• Dodaliśmy strategię określania stawek Docelowy CPC w przypadku kampanii generujących popyt. Ta strategia ustala stawki tak, aby zmaksymalizować liczbę kliknięć przy skonfigurowanym docelowym koszcie kliknięcia (CPC).
  • Ustaw docelowy CPC na poziomie kampanii za pomocą funkcji Campaign.target_cpc.
  • Zastąp na poziomie grupy reklam za pomocą ikony AdGroup.target_cpc_micros.
• Dodano nową AssetAutomationType: * GENERATE_DESIGN_VERSIONS_FOR_IMAGES: dostępna w DemandGenMultiAssetAds. Jeśli ta opcja jest włączona, dodaje elementy projektu i osadza komponenty tekstowe w komponentach z obrazem, aby tworzyć nowe komponenty z obrazem o różnych formatach. NoweDemandGenMultiAssetAds są domyślnie włączone.
• Dodano nową AssetAutomationType: * GENERATE_VIDEOS_FROM_OTHER_ASSETS: dostępna w DemandGenMultiAssetAds. Jeśli ta opcja jest włączona, generuje filmy przy użyciu innych komponentów, takich jak obrazy i tekst. Te filmy można następnie wykorzystać do tworzenia nowych DemandGenVideoResponsiveAds. NoweDemandGenMultiAssetAds są domyślnie włączone.
• Zmieniono nazwę pola BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros na minimum_budget_amount_micros.

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

• W UserListCrmDataSourceType dodano wartość THIRD_PARTY_PARTNER_DATA.
  • Dodaliśmy nowe kody błędów związane z odbiorcami partnerów:
  • PARTNER_AUDIENCE_SOURCE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_AUDIENCE_TYPE_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • COMMERCE_PARTNER_NOT_ALLOWED
  • PARTNER_AUDIENCE_INFO_NOT_SUPPORTED_FOR_USER_LIST_TYPE
  • PARTNER_MANAGER_ACCOUNT_DISALLOWED
  • PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ADVERTISER_TOS_NOT_ACCEPTED
  • ADVERTISER_PARTNER_LINK_MISSING
  • ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA
  • ACCOUNT_SETTING_TYPE_NOT_ALLOWED_FOR_USER_LIST_TYPE
  • INVALID_CAMPAIGN_TYPE_FOR_THIRD_PARTY_PARTNER_DATA_LIST
• Dodano is_active_live_stream_creator do YouTubeMetrics. Ta wartość jest zwracana przez ContentCreatorInsightsService.GenerateCreatorInsights i wskazuje, czy twórca opublikował transmisję na żywo w ciągu ostatnich 90 dni.

• Dodaliśmy nowy komunikat PlannableUserListMetadata, który zawiera UserListCrmDataSourceType w PlannableUserList. Ten komunikat jest zwracany przez „ReachPlanService.ListPlannableUserLists”, aby wskazać, czy źródło danych listy użytkowników CRM ma wartość FIRST_PARTY czy THIRD_PARTY_PARTNER_DATA.

• W polu ReachPlanService dodano pole trueview_views, które zastępuje pole views.

• W wersji TrendInsight dodaliśmy obsługę właściwości related_videos i related_creators. Dodano też metadane właściwości filmu i daty publikacji w YouTubeVideoAttributeMetadata.video_properties i YouTubeVideoAttributeMetadata.publish_date.

  • AudienceInsightsService.GenerateInsightsFinderReport obsługuje teraz parental_status i income_ranges oraz bardziej złożone kombinacje operatorów AND/OR dotyczące tematów i odbiorców.

Raporty

• Dodaliśmy 2 nowe typy kliknięć: CLICK_TO_MESSAGE_THIRD_PARTY_CLICK i CLICK_TO_MESSAGE_LANDING_PAGE_CLICK.
  • Dane AssetGroupAsset można teraz segmentować według device, conversion_action, conversion_action_name i conversion_action_category.
    • AdGroupAdAssetView i AdGroupAdAssetCombinationView w pełni obsługują teraz dane o skuteczności i konwersjach w przypadku RESPONSIVE_SEARCH_AD. Wcześniej w tych widokach w przypadku tego typu reklamy zwracano tylko wyświetlenia.
• Aby ułatwić eksplorację inteligentnego określania stawek, te dane można teraz segmentować według pól daty (date, month, quarter, week, year):
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
• Dodaliśmy nowe źródło danych: TargetingExpansionView, które zawiera dane o rozszerzeniach kierowania ręcznego, np. o rozszerzeniu bez słów kluczowych w przypadku AI Max w kampaniach w sieci wyszukiwania.

• Dodaliśmy nowe segmenty do kampanii PMax. Zobacz aktualizacje kampanii Performance Max.

  ### Zakupy

• Naprawiono zakres danych kampanii i grup reklam w zasobie ShoppingProduct.

Ujednolicone cele

• Dodaliśmy obsługę celów dotyczących utrzymania klientów, aby optymalizować kampanie pod kątem ponownego zaangażowania obecnych klientów.
  • Skonfiguruj kierowanie za pomocą tych ustawień:CampaignRetentionGoalSettings.target_option: * TARGET_SPECIFIC: używa tylko użytkowników z list użytkowników powiązanych z kampanią. (Obecnie tylko na liście dozwolonych).
    • TARGET_ALL (Domyślne): kieruje reklamy na wszystkich użytkowników w celu ponownego zaangażowania.

Wideo

• Zmieniliśmy nazwy kilku rodzajów danych związanych z wyświetleniami filmów:
  • average_cpv to teraz trueview_average_cpv
  • video_view_rate to teraz video_trueview_view_rate
  • video_views to teraz video_trueview_views
  • video_view_rate_in_feed to teraz video_trueview_view_rate_in_feed
  • video_view_rate_in_stream to teraz video_trueview_view_rate_in_stream
  • video_view_rate_shorts to teraz video_trueview_view_rate_shorts
• Dodatkowe dane dotyczące czasu oglądania reklam wideo:
  • video_watch_time_duration_millis: łączny czas oglądania,
  • average_video_watch_time_duration_millis: średni czas oglądania na wyświetlenie.

wersja 21 (6.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

• 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. Zapoznaj się z artykułem w Centrum pomocy Komponenty z promocją.

• 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 do usuwania komponentów tworzonych automatycznie z Campaign. Ta usługa umożliwia tylko usuwanie komponentów z rozwinięciem końcowego adresu 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 pełniących rolę prefiksu 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 wyświetlenie błędu 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. Po ustawieniu tego pola nie można go zmienić.

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

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

• 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 niepowodzeniem zwracana będzie wartość LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION zamiast INVALID_LISTING_GROUP_HIERARCHY.

• Dodaliśmy nowy zasób LocationInterestView, który zawiera podsumowanie skuteczności kryteriów kierowania na lokalizacje w grupach reklam.

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

• 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łędu budgetDailyMinimumErrorDetails.

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

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

• Dodaliśmy 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ę haseł w kampaniach Performance Max.

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

Planowanie

• Dodaliśmy nową metodę ReachPlanService.ListPlannableUserInterests, która umożliwia reklamodawcom odkrywanie zainteresowań użytkowników (zainteresowań i zainteresowań 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, aby pobierać dostępne listy użytkowników własnych danych dla identyfikatora klienta wysyłającego żą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.

• Dodaliśmy 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ące AssetGroupAsset, ChannelAggregateAssetView i CampaignAggregateAssetView. Dodatkowo w przypadku ChannelAggregateAssetView i CampaignAggregateAssetView impressions, które wcześniej miały wartość zerową w kampaniach Performance Max, będą 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.

• Umożliwiliśmy wybieranie zasobu CampaignAssetSet za pomocą parametru ChangeStatus, aby użytkownicy mogli uzyskać więcej informacji o zasobach 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 final_url_expansion_asset_view.

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

• Umożliwia podział na segmenty 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 click_viewsegmentacji, aby śledzić i raportować kliknięcia związane z formatami reklam specyficznymi dla komponentów dotyczących pojazdów.

Eksploracja inteligentnego określania 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 na temat eksploracyjnego określania stawek oraz artykuł w Centrum pomocy.

• W przypadku unikalnych klastrów 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żyć do utworzenia linku między elementem campaign a typem 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 elastyczne reklamy wideo mogły wyświetlać się jako reklamy In-Stream niemożliwe 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 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 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

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

  Uwaga: ta funkcja jest dostępna w ramach zamkniętej listy dozwolonych. Aby z niej skorzystać, skontaktuj się z menedżerem konta.

• 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

• 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
• Dodano 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 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 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 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.