Informacje o wersjach

wersja 24.1 (13.05.2026)

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

Reklamy

• Dodano pole classic_display_images do DemandGenMultiAssetAd. Są to niestandardowe przesłane obrazy, które są wyświetlane bez konieczności stosowania dodatkowych komponentów i nie w ramach formatów reklam elastycznych.

Ogólne

• Dodano CustomerUserAccess.passkey_enabled do zasobu CustomerUserAccess. To pole tylko do odczytu wskazuje, czy użytkownik ma włączony klucz dostępu.

Eksperymenty

• Dodaliśmy obsługę tych nowych typówExperimentTypeEnum:
  • ADOPT_AI_MAX: w przypadku eksperymentów, które sprawdzają, jak AI Max może Ci pomóc w pozyskiwaniu większej liczby klientów dzięki sztucznej inteligencji Google i słowom kluczowym w dopasowaniu przybliżonym.
  • ADOPT_BROAD_MATCH_KEYWORDS: W przypadku eksperymentów, które testują, jak słowa kluczowe w dopasowaniu przybliżonym mogą wpływać na liczbę wyszukiwań, w których pojawiają się Twoje reklamy.
  • OPTIMIZE_ASSETS: w przypadku eksperymentów niestandardowych dotyczących optymalizacji komponentów.
  • PMAX_REPLACEMENT_SHOPPING: w przypadku eksperymentów, które testują skuteczność kampanii produktowych w porównaniu z kampaniami Performance Max.
• Dodaliśmy obsługę konfiguracji dotychczasowych eksperymentówYOUTUBE_CUSTOM obejmujących kampanie wideo za pomocą nowego pola video_experiment w Experiment.
• Do elementu ExperimentArm dodaliśmy te pola, aby obsługiwać testowanie komponentów, grupy plików i ustawienia eksperymentów w kampaniach Performance Max:
  • asset_testing_info: Szczegóły komponentów powiązanych z eksperymentalnymi kopiami reklam.
  • asset_groups: lista grup plików w grupie eksperymentalnej w przypadku eksperymentów Optimize Assets.
  • performance_max_experiment_arm_info: ustawienia kampanii Performance Max w PMAX_REPLACEMENT_SHOPPINGeksperymentach.

Raporty

• Dodaliśmy obsługę segmentu mobile_device_platform umożliwiającego raportowanie podzielone na segmenty według platformy urządzenia (np. iOS lub Android).

• Opublikuj REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED.

  Żądana szczegółowość czasu nie jest obsługiwana w przypadku zakresu dat w zapytaniu. Dane z segmentacją dzienną, godzinową lub tygodniową są dostępne tylko z ostatnich 37 miesięcy.

• Dodaliśmy te segmenty, które można wykorzystywać w reklamach w branżach:

  • vertical_ads_listing_user_rating
  • vertical_ads_listing_venue

• Dodaliśmy obsługę filtrowania według parametrów user_rating, venue i event_participant_display_name w VerticalAdsItemGroupRuleInfo dla zasobu SharedCriterion.

• Dodano obsługę danych eksperymentu w 7 grupach podstawowych danych:

  • Kliknięcia
  • wyświetlenia,
  • Koszt
  • Konwersje
  • Koszt konwersji
  • Wartość konwersji
  • Wartość konwersji/koszt

  W przypadku każdej z głównych rodzin danych dostępne są te pola:

  • control_metric (np. Metrics.control_clicks): wartość danych w grupie kontrolnej.
  • metric (np. Metrics.clicks): wartość danych w grupie eksperymentalnej.
  • metric_point_estimate (np. Metrics.clicks_point_estimate): szacunkowa wartość różnicy między grupami.
  • metric_margin_of_error (np. Metrics.clicks_margin_of_error): margines błędu różnicy.
  • metric_p_value (np. Metrics.clicks_p_value): wartość p różnicy. Wartość p mniejsza lub równa 0,05 oznacza poziom ufności co najmniej 95%.

• Dodano obsługę Metrics.conversions_absolute_change_point_estimate, Metrics.conversions_absolute_change_margin_of_error i Metrics.conversions_absolute_change_p_value.

Kierowanie

• Dodano CANNOT_EXCLUDE_ALL_TARGETS do CriterionErrorEnum. Ten błąd jest zwracany, gdy próbujesz wykluczyć wszystkie rodzaje kierowania demograficznego, co jest niedozwolone.

Filmy

• Opublikuj ZEFR jako partnera integracyjnego ds. widoczności innej firmy.
• Dodano pole channel_id do pola youtube_video w zasobie DataLink, aby udostępnić identyfikator kanału w YouTube powiązany z połączeniem danych.

wersja 24 (22.04.2026)

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

Więcej informacji znajdziesz w artykule Uaktualnianie do najnowszej wersji.

Reklamy

Te pola są teraz wymagane:

• W obiekcie DemandGenVideoResponsiveAdInfo:

  • videos
  • logo_images

• W obiekcie VideoResponsiveAdInfo:

  • videos
  • business_name
  • logo_images

  Wartość VideoResponsiveAdInfo można teraz zmieniać.

Zasoby

• Dodano pole travel_feed_data do zasobu AssetSet. To nowe pole umożliwia odczytywanie danych z pliku danych o podróżach z zestawu komponentów pliku danych o podróżach, udostępniając informacje tylko do odczytu, takie jak hotel_center_account_id, merchant_center_id, partner_center_id, subset_id i travel_feed_vertical_type.

Kampanie

• Usunęliśmy pole Campaign.video_brand_safety_suitability. To ustawienie jest nadal dostępne na poziomie klienta. Więcej informacji znajdziesz w artykule Customer.video_brand_safety_suitability.
• Dodaliśmy pole Campaign.view_through_conversion_optimization_enabled, które domyślnie ma wartość false, aby umożliwić włączanie optymalizacji pod kątem konwersji po wyświetleniu w kampaniach generujących popyt i kampaniach promujących aplikacje.
• Włączono wykluczenia ze względu na płeć w kampaniach Performance Max. To wykluczenie jest teraz dostępne w kampaniach Performance Max we wszystkich wersjach interfejsu Google Ads API.

Konwersje

• Dodaliśmy obsługę typów konwersji związanych z pozyskiwaniem potencjalnych klientów. Są to nowe wyliczenia ConversionActionType w wersji 24:

  • GOOGLE_ANALYTICS_4_GENERATE_LEAD
  • GOOGLE_ANALYTICS_4_QUALIFY_LEAD
  • GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD
  • FIREBASE_ANDROID_GENERATE_LEAD
  • FIREBASE_ANDROID_QUALIFY_LEAD
  • FIREBASE_ANDROID_CLOSE_CONVERT_LEAD
  • FIREBASE_IOS_GENERATE_LEAD
  • FIREBASE_IOS_QUALIFY_LEAD
  • FIREBASE_IOS_CLOSE_CONVERT_LEAD

• Usunęliśmy kategorię typu klienta LOYALTY_SIGN_UPS lista użytkowników.

Ogólne

• Dodano kod UserListErrorEnum.DUPLICATE_LOOKALIKE, który jest zwracany podczas próby utworzenia podobnej listy klientów UserList, która jest identyczna z istniejącą.

Planowanie

• Zmieniono definicję typu InsightsAudience.topic_audience_combinations z InsightsAudienceAttributeGroup na common.InsightsAudienceAttributeGroup. W przypadku bibliotek klienta z określonym typem jest to zmiana powodująca niezgodność, która wymaga aktualizacji istniejących integracji.

• Usunięto pole youtube_select_lineups z usługi ReachPlanService.ListPlannableProducts.

  Użytkownicy powinni zacząć korzystać z harmonogramów od youtube_select_lineup_targeting.

• Usunęliśmy pole is_brand_connect_creator z usług ContentCreatorInsightsService.GenerateCreatorInsights i ContentCreatorInsightsService.GenerateTrendingInsights.

  Zamiast tego użytkownicy powinni poszukać twórcy, który ma dostępną opcję CREATOR_PARTNERSHIPS w sekcji partnership_opportunities.

• Dodaliśmy do odpowiedzi ReachPlanService.ListPlannableProducts nowe pola, aby zawierała więcej szczegółów o każdym produkcie, który można zaplanować. Większość tych pól jest zwracana w nowym polu ProductCoreAttributes w ramach ListPlannableProductsResponse. Nowe pola odpowiedzi to:

  • ProductMetadata.plannable_product_description
  • ProductCoreAttributes.marketing_objective
  • ProductCoreAttributes.cost_model
  • ProductCoreAttributes.buying_method

• Usunięto różne pola z elementu KeywordPlanIdeaService.GenerateKeywordForecastMetrics:

  • CampaignToForecast.geo_modifiers[] zastępuje CampaignToForecast.geo_target_constants[].
  • ForecastAdGroup.biddable_keywords[] zastępuje ForecastAdGroup.keywords[].
  • CampaignToForecast.keyword_plan_network
  • CampaignToForecast.negative_keywords
  • ForecastAdGroup.max_cpc_bid_micros
  • ForecastAdGroup.negative_keywords
  • BiddableKeyword
  • CriterionBidModifier
  • KeywordForecastMetrics.impressions
  • KeywordForecastMetrics.click_through_rate

Raporty

• Usunęliśmy segment ad_sub_network_type w przypadku zasobu campaign_budget.
• Usunęliśmy segment click_type z widoków AdGroupAsset, CampaignAsset i CustomerAsset.
• Dodano nowy zasób CartDataSalesView. Umożliwia segmentowanie danych o konwersjach nie tylko według klikniętego produktu, ale też według sprzedanego produktu, z segmentami takimi jak product_sold_brand.
• Dodaliśmy dane, które nie podlegają określaniu stawek, czyli dane obejmujące też konwersje, pod kątem których kampanie nie są aktywnie optymalizowane, np. all_cost_of_goods_sold_micros. Nowe dane są dodawane do wszystkich zasobów obsługujących odpowiednie dane, za które można ustalać stawki.
• Dodano segment conversion_attribution_event_type do zasobu ShoppingPerformanceView.

Zakupy

• Dodaliśmy obsługę kampanii promujących aplikacje w zasobie ShoppingProduct. Pamiętaj, że w przypadku kampanii promujących aplikacje pola status i issues nie są obsługiwane.
• Wprowadziliśmy filtrowanie produktów na podstawie tagów za pomocą wyrażeń logicznych w przypadku kampanii produktowych.
  • Dodaliśmy typy kryteriów RETAIL_FILTER_BUNDLE i RETAIL_FILTER.
  • Dodano RETAIL_FILTER jako nowy SharedSetType.
  • AdGroupCriterion może teraz używać pola retail_filter_bundle, aby połączyć się z elementem SharedSet typu RETAIL_FILTER.
  • SharedCriterion może teraz używać pola retail_filter do definiowania poszczególnych reguł tagów lub wyrażeń w ramach SharedSet.
  • Dodano RETAIL do ListingGroupFilterListingSource.
  • Dodano wymiar RetailFilter do grupy AssetGroupListingGroupFilter.
  • Dodano nowe kody błędów w CriterionError i AssetGroupListingGroupFilterError na potrzeby weryfikacji.
  • Ta funkcja jest dostępna tylko dla użytkowników znajdujących się na liście dozwolonych.

Filmy

• Zaktualizowano ShareablePreviewService.GenerateShareablePreviews, aby nie używać już częściowych błędów. Jeśli żądania nie powiodą się w przypadku dowolnego identyfikatora, zostanie zgłoszony błąd. Zwracanie nowych kodów błędów dotyczących grup plików, aby były zgodne z błędami reklam w grupach reklam:
  • MutateErrorEnum.RESOURCE_NOT_FOUND zamiast ShareablePreviewError.ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER
  • ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST zamiast ShareablePreviewError.TOO_MANY_ASSET_GROUPS_IN_REQUEST

wersja 23.2 (25.03.2026)

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

Zasoby

• Dodaliśmy zasób VideoEnhancement z informacjami o reklamach wideo, które zostały ulepszone, np. czy zostały wygenerowane przez Google, czy dostarczone przez reklamodawcę. Więcej informacji znajdziesz w sekcji Ulepszenia filmów.
• Dodaliśmy zasób tylko do odczytu AppTopCombinationView, aby dostarczać statystyki dotyczące najskuteczniejszych kombinacji komponentów w kampaniach promujących aplikacje.
• Dodaliśmy obsługę pobierania wartości CustomerAsset za pomocą funkcji field_type BUSINESS_LOGO.

Kampanie

• Dodaliśmy pola AdGroupAd.start_date_time i AdGroupAd.end_date_time, aby zapewnić bardziej szczegółowe ograniczenia harmonogramu w zakresie dat kampanii. Jest to obsługiwane tylko w przypadku niektórych typów grup reklam.
• Dodano HotelSettingInfo.disable_hotel_setting, aby umożliwić wyłączanie pliku danych o hotelach w kampaniach generujących popyt.

Ogólne

• Dodaliśmy 2 nowe kody błędów do CustomerClientLinkError: MAX_CUSTOMER_LIMIT_REACHED i ACCOUNT_CREATION_POLICY_VIOLATION.
• Podczas próby użycia wycofanej kategorii typu klienta LOYALTY_SIGN_UPS lista użytkowników występuje teraz błąd.

Planowanie

• Dodaliśmy obsługę niestandardowych kombinacji warunków I/LUB dotyczących encji, tematów i odbiorców w GenerateTrendingInsights i GenerateCreatorInsights.
• Dodaliśmy nowe przedziały wiekowe, na które można kierować reklamy, np. AGE_RANGE_21_44 lub AGE_RANGE_21_49, w ReachPlanService.GenerateReachForecast.
• Dodano youtube_select_lineup_targeting do ReachPlanService.ListPlannableProducts, co zastąpi youtube_select_lineups. Oba pola są obecnie wypełnione.
• Dodano IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS jako opcję platformy w ReachPlanSurface.
• Dodano clicks do Forecast w przypadku kampanii generujących popyt z maksymalizacją liczby kliknięć (CPC) w ReachPlanService.GenerateReachForecast.
• Dodano partnership_opportunities do ContentCreatorInsightsService.GenerateCreatorInsights i ContentCreatorInsightsService.GenerateTrendingInsights.

Raporty

• Dodano wskaźnik biddable_indirect_install_first_in_app_conversion_micros do zasobów Campaign, Customer i AdGroup.

Filmy

• Rozszerzono ShareablePreviewService, aby obsługiwać podglądy YouTube na żywo przez ustawienie preview_type na YOUTUBE_LIVE_PREVIEW. Dodano użytkowników UNSUPPORTED_AD_TYPE i TOO_MANY_RESOURCES_IN_REQUEST do ShareablePreviewError. Jest to obsługiwane tylko w przypadku niektórych typów reklam.

wersja 23.1 (25.02.2026)

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

Więcej informacji znajdziesz w artykule Uaktualnianie do najnowszej wersji.

Zarządzanie kontem

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

Kampanie

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

Konwersje

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

Ogólne

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

Zachęty

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

Planowanie

• Dodaliśmy obsługę podziałów według daty w GenerateBenchmarksMetrics za pomocą BreakdownDefinition.
• Dodaliśmy GOOGLE_DISPLAY_NETWORK jako platformę, na której można wyświetlać reklamy w kampaniach generujących popyt z ustawieniami Maksymalizacja liczby konwersji w ReachPlanService.GenerateReachForecast.
• Dodano informacje o historycznej linii trendu w zakresie TrendInsightDataPoint–TrendInsights w GenerateTrendingInsights podczas wyszukiwania według tematu.

Raporty

• Dodaliśmy nowe dane, które informują, ilu użytkowników zobaczyło Twoją reklamę co najmniej 2, 3, 4, 5 lub 10 razy: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus i unique_users_ten_plus.
• Dodaliśmy VERTICAL_ADS_DATA_FEED do SearchTermMatchSourceEnum do obsługi plików danych reklam w branżach, np. kierowania na podmioty w reklamach podróży.

YouTubeVideoUpload

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

wersja 23 (28.01.2026)

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

Reklamy

• 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 w artykule Reklamy generujące połączenia.

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 atrybuty 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 parametry Campaign.start_date_time i Campaign.end_date_time, które zastępują parametry 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 Twoje aplikacje będą w stanie obsługiwać te nowe tryby awarii.

Planowanie

• Dodano LIFE_EVENT_USER_INTEREST do AudienceInsightsDimension. Ten nowy wymiar umożliwia użytkownikom tworzenie list odbiorców na podstawie zdarzeń z życia za pomocą 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 powierzchnie, co umożliwia 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 określanie dystrybucji językowej w treściach na kanale w YouTube.

• Dodano BenchmarksService, aby porównywać dane reklam w YouTube z analizami porównawczymi w branży.

• Dodano AudienceInsightsService.GenerateAudienceDefinition, aby tłumaczyć opis grupy docelowej w formie tekstu swobodnego na pasujące atrybuty grupy odbiorców za pomocą generatywnej AI.

• Dodano 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óra przedstawia 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ą żadnych kampanii.

Raporty

• Dane i segmentacja

  • AdGroupAdAssetView obsługuje 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, udostępniając wskaźniki 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 zbiorcze dane o skuteczności etykiet zasobów. Wyliczenie etykiety skuteczności nie jest już zwracane w przypadku sieci wyszukiwania i reklam displayowych.

Zakupy

• ShoppingPerformanceView obsługuje teraz te dane segmentowane 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 ikonę vertical_ads_format_setting do ikony 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 reklam wertykalnych z kampanią w sieci wyszukiwania, która korzysta z AI Max, aby wyświetlać reklamy promujące obiekty i reklamy dotyczące podróży 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 segmentować zarówno według AdFormatType, jak 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ść.

wersja 22.1 (25.02.2026)

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

Zarządzanie kontem

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

Kampanie

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

wersja 22 (15.10.2025)

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

Zasoby

• Dodaliśmy LANDING_PAGE_PREVIEW jako nowy typ pola komponentu z obrazem.
• Wprowadziliśmy AssetGenerationService (wersja beta):
  • Ta usługa umożliwia generowanie komponentów z tekstem i obrazami przy użyciu generatywnej AI. Ta usługa jest początkowo dostępna tylko dla ograniczonej liczby uczestników zamkniętych testów beta.
  • GenerateText: generuje tekst na podstawie danych wejściowych, takich jak końcowy adres URL, prompty w formie swobodnego tekstu, 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

• Dodaliśmy nowe cele ustalania stawek w kampaniach promujących instalacje aplikacji, aby umożliwić 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 Campaign.feed_types, który pokazuje typy plików danych dołączonych do kampanii. W przypadku kampanii Performance Max może to być kategoria, 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ę ustalania stawek Docelowy CPC w kampaniach 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 nowy AssetAutomationType: * GENERATE_DESIGN_VERSIONS_FOR_IMAGES: dostępny 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 nowy AssetAutomationType: * GENERATE_VIDEOS_FROM_OTHER_ASSETS: dostępny 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 AddBatchJobOperations żądanie.
• Zaktualizowano obsługę pola page_size w ListBatchJobResultsRequest:
  • Jeśli wartość page_size nie jest ustawiona lub wynosi 0, domyślnie przyjmuje wartość maksymalną 1000 (wcześniej zwracał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ółczynnika aktywacji profilu płatności.

Performance Max

• Dodano 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 przypadku kampanii 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

• 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. Ten parametr jest zwracany przez funkcję ContentCreatorInsightsService.GenerateCreatorInsights i wskazuje, czy twórca opublikował transmisję na żywo w ciągu ostatnich 90 dni.

• Dodano nowy komunikat PlannableUserListMetadata, który zawiera UserListCrmDataSourceType w PlannableUserList. Ten komunikat jest zwracany przez 'ReachPlanService.ListPlannableUserLists', aby wskazać, czy źródło danych listy klientów CRM jest FIRST_PARTY czy THIRD_PARTY_PARTNER_DATA.

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

• W TrendInsight dodaliśmy obsługę related_videos i related_creators. Dodaliśmy 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 tematów i odbiorców z użyciem operatorów AND i OR.

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 w pełni obsługuje teraz dane o skuteczności i konwersjach w przypadku RESPONSIVE_SEARCH_AD. Wcześniej w tym widoku w przypadku tego typu reklam zwracane były 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 Performance Max. Więcej informacji znajdziesz w aktualizacjach dotyczących kampanii Performance Max.

  ### Zakupy

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

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.
  • 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 lista dozwolonych).
    • TARGET_ALL (Domyślnie): 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.1 (25.02.2026)

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

Zarządzanie kontem

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

Kampanie

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

wersja 21 (06.08.2025)

Więcej informacji znajdziesz w artykule Uaktualnianie do najnowszej wersji.

AI Max w kampaniach w sieci wyszukiwania

• Możesz teraz używać 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 w przypadku ustawienia mają być wyświetlane ustawienia kierowania i komponentów. 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ą pola Campaign.ai_max_setting.bundling_required możesz 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. Za pomocą pola AdGroup.ai_max_ad_group_setting.disable_search_term_matching możesz wyłączyć dopasowywanie wyszukiwanych słów, gdy kampania nadrzędna ma włączone funkcje AI Max w kampaniach w sieci wyszukiwania. Więcej informacji znajdziesz w naszym poście na blogu Osiągaj jeszcze lepsze wyniki dzięki funkcjom 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 AI Max 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. W tym widoku znajdziesz informacje o tym, które wyszukiwane hasła spowodowały wyświetlenie Twoich reklam, oraz o skuteczności 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

• W polu PromotionAsset dodaliśmy pola terms_and_conditions_text, terms_and_conditions_uri, promotion_barcode_info i promotion_qr_code_info. Pola kodu kreskowego i kodu QR znajdują się w polu promotion_trigger. Więcej informacji znajdziesz w artykule w Centrum pomocy Informacje o komponentach promocji.

• 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 komponentu z rozwinięciem końcowego adresu URL.

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

Kampanie

• Dodaliśmy nową wartość wyliczeniową 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.

• Dodano obsługę partnerów integracyjnych innych firm 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ą analityki aplikacji innych firm.

• Możesz teraz ustawić pole advertising_partner_ids w przypadku istniejącejCampaign. 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 już zmienić.

• Korzystając z udostępnionej listy typu NEGATIVE_PLACEMENTS 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 DESCRIPTION_PREFIX do wyliczenia ServedAssetFieldType. Rozwiązuje to problem, w którym wartość served_asset_field_type w ad_group_ad_asset_combination_view była 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ępne 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 podsumowuje skuteczność kryteriów zainteresowań lokalizacyjnych 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 było ustawione na 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 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 grupy reklam w przypadku dotychczasowych 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. Ta zmiana zostanie ogłoszona z wyprzedzeniem.

• Wersje próbne i eksperymenty zwrócą błąd ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION jeśli 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ę kampanii Performance Max w przypadku haseł.

• 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ę list użytkowników własnych do 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ą operatora AND-of-ORs, 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

• W przypadku AssetGroupAsset, ChannelAggregateAssetView i CampaignAggregateAssetView dostępnych jest teraz wiele nowych danych. Dodatkowo w przypadku ChannelAggregateAssetView i CampaignAggregateAssetView wartość impressions, która wcześniej była zerowana w kampaniach Performance Max, będzie teraz podawana w prawidłowej wysokości.

• 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ł segmentu 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 haseł i wyszukiwanych haseł 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 dotyczącymi elementów związanych z pojazdami.

Eksploracja inteligentnego określania stawek w przypadku strategii ustalania stawek Docelowy ROAS w sieci wyszukiwania

• W kampaniach w sieci wyszukiwania możesz teraz włączyć eksplorację inteligentnego określania stawek, ustawiając w strategiach ustalania stawek MaximizeConversionValue i TargetRoas wartość pola target_roas_tolerance_percent_millis na dowolną liczbę podzielną przez 1000 z zakresu od 10 000 (10%) do 30 000 (30%) włącznie. W przypadku strategii ustalania stawek MaximizeConversionValue trzeba też ustawić wartość pola target_roas. Pole TargetRoas.target_roas_tolerance_percent_millis jest dostępne tylko w przypadku strategii portfolio. Więcej informacji znajdziesz w naszym poście na blogu o eksploracji inteligentnego określania stawek i w artykule 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”.

Zarchiwizowane informacje o wersji

Informacje o wersjach, które zostały wycofane, znajdziesz w sekcji Wycofane wersje.