Informacje o wersjach

19.1 (16.04.2025)

W wersji 19.1 dodano te funkcje i zmiany:

Zasoby

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

Kampanie

• Możesz teraz oceniać potencjalnych klientów i przekazywać na ich temat opinie w kampaniach Usług Lokalnych. W ramach tej zmiany w wersji 19.1:
  • Dodano nową usługę o nazwie LocalServicesLeadService. Aby przesłać ocenę i opinię dotyczącą potencjalnych klientów, możesz użyć metody ProvideLeadFeedback.
  • Dodaliśmy nowe pole o nazwie lead_feedback_submitted do LocalServicesLead, aby ułatwić ustalenie, czy opinia została przesłana do potencjalnego klienta.
• Dodano nową kolumnę danychbiddable_cohort_app_post_install_conversionsw przypadku kampanii promujących aplikacje.

Generowanie popytu

• W usługach planowania wprowadzono dodatkowe metody, aby ułatwić generowanie popytu.

• Dodaliśmy obsługę ustawień kanałów w kampaniach generujących popyt na poziomie grupy reklam. Możesz wybrać zdefiniowaną wstępnie ogólną grupę kanałów lub podzbiór kanałów za pomocą 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
  • Odkryj
  • Gmail
  • Sieć reklamowa

• Dodaliśmy nowy typ zasobu dla TALL_PORTRAIT_MARKETING_IMAGE. Ten typ komponentu odnosi się do pola tall_portrait_marketing_images w formatach reklam generujących popyt z wieloma komponentami.

Historia zmian

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

Konwersje

• Teraz możesz ustawić pole google_ads_conversion_customer podczas tworzenia nowego klienta za pomocą interfejsu Google Ads API. Wcześniej było to pole tylko do odczytu.
• Podczas przesyłania konwersji offline możesz teraz określić typ klienta powiązany z konwersją.
• Wprowadzono nowe pole session_attributes dla ClickConversion.

Reklamy Usług Lokalnych

• Dodaliśmy nowy RPC ProvideLeadFeedback do LocalServicesLeadService, aby umożliwić przekazywanie opinii na temat jakości LocalServicesLead.
• Do zasobu LocalServicesLead dodaliśmy nowe pole lead_feedback_submitted, które potwierdza, czy w przypadku konkretnego zasobu została przesłana opinia.

Usługi planowania

• Dodano obsługę prognoz miesięcznych docelowej częstotliwości w ReachPlanService.GenerateReachForecast.
  • Deweloperzy mogą ustawić parametr TargetFrequencyTimeUnit.MONTHLY w TargetFrequencySettings, gdy używają kodu produktu TARGET_FREQUENCY, aby wygenerować prognozę zasięgu miesięcznego na podstawie docelowej częstotliwości.
• Dodano nową metodę ReachPlanService.GenerateConversionRates, która umożliwia reklamodawcom żądanie sugerowanych współczynników konwersji w przypadku obsługiwanych produktów z możliwością zaplanowania.
• Prognozy popytu w ramach kampanii 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 kodu produktu DEMAND_GEN_MAX_CONVERSIONS, który można zaplanować, do generowania prognoz zasięgu kampanii generujących popyt.
  • Dodaliśmy nowe pole conversion_rate, które pozwala deweloperom przesyłać prognozy zasięgu kampanii generujących popyt z dodatkowym współczynnikiem konwersji. Sugerowane współczynniki konwersji można pobrać za pomocą nowej metody ReachPlanService.GenerateConversionRates. To pole jest wymagane w przypadku próśb o prognozy popytu. Nie jest ona obsługiwana w przypadku innych produktów, w których można tworzyć harmonogramy.
  • Do prognoz zwracanych przez funkcję dodano nowe pole conversions. To pole zawiera liczbę konwersji w danym punkcie krzywej zasięgu. Konwersje są obsługiwane tylko w przypadku produktu DEMAND_GEN_MAX_CONVERSIONS, który można zaplanować.

Rekomendacje

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

kampania produktowa.

• W kampaniach Performance Max możesz teraz zastąpić wykluczenia marek w reklamach produktowych. Jest ono dostępne w nowym polu pmax_campaign_settings na poziomie kampanii i działa tylko w przypadku kampanii Performance Max dla handlu detalicznego. Jeśli spróbujesz ustawić to pole w przypadku niezgodnego typu kampanii, pojawi się nowy błąd CampaignError.BRAND_TARGETING_OVERRIDES_NOT_SUPPORTED.

Filmy

• Dodaliśmy obsługę reklam audio tylko do odczytu. Więcej informacji o tej funkcji znajdziesz w Centrum pomocy Google Ads. Te zmiany dotyczą:
  • Nowy AdvertisingChannelSubType o nazwie YOUTUBE_AUDIO.
  • nowy AdGroupType o nazwie YOUTUBE_AUDIO.
  • Nowy typ formatu reklamy o nazwie YOUTUBE_AUDIO_AD i odpowiadające mu pola YouTubeAudioAdInfo.
• Dodaliśmy nowe dane i segmenty do zapytań o dane dotyczące zasięgu z uwzględnieniem korekty demograficznej. W ramach tych zmian:
  • Wprowadziliśmy 2 nowe kolumny danych o nazwach coviewed_impressions i primary_impressions.
  • Udostępniliśmy 2 nowe segmenty o nazwach adjusted_age_range i adjusted_gender.
  • Jeśli wybrano jeden z 2 nowych segmentów razem z polem danych o zasięgu (coviewed_impressions, primary_impressions, unique_users lub average_impression_frequency_per_user), aby pobrać prawidłowe statystyki dla tych kolumn, musisz też wybrać drugi segment.
  • Ta funkcja jest obecnie dostępna tylko dla klientów, którzy znajdują się na liście dozwolonych.

v19 (26.02.2025)

W wersji 19 dodaliśmy te funkcje i zmiany:

Zarządzanie kontem

• Do elementu CustomerError dodano te wartości, aby uwzględnić nadchodzące zmiany:
  • CREATION_DENIED_FOR_POLICY_VIOLATION
  • CREATION_DENIED_INELIGIBLE_MCC

Reklamy

• Dodano komponent DemandGenMultiAssetAdInfo.tall_portrait_marketing_images, aby umożliwić obsługę komponentów z obrazem pionowym o stosunku proporcji 9:16 w reklamach generujących popyt.

Zasoby

• (Dotyczy tylko kont na białej liście) Dodano obsługę komponentów wiadomości za pomocą Asset.business_message_asset, BusinessMessageAsset oraz tych enumeracji i błędów.
  • Wykazy:
    • 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 umożliwić automatyczne generowanie podglądu strony docelowej.
• AssetAutomationType.GENERATE_SHORTER_YOUTUBE_VIDEOS jest teraz domyślnie włączona w przypadku responsywnych reklam wideo generujących popyt.
• (Tylko dla kont na liście dozwolonych; lista dozwolonych jest obecnie zamknięta) Dodano Asset.app_deep_link_asset i AppDeepLinkAsset.

Konwersje

• Cele konwersji
  • Właściwość LifecycleGoalValueSettings.high_lifetime_value wyszła z wersji beta i może być teraz modyfikowana.
  • Dodaliśmy 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.

Kanały

• Usunęliśmy wszystkie elementy związane z plikami danych, takie jak Feed, FeedMapping, FeedService, AdGroupFeed, feed_placeholder_view itp. Użytkownicy powinni teraz używać atrybutu assets w tym samym celu. Listę wszystkich usuniętych elementów znajdziesz w notatkach dotyczących migracji.

Hotele i podróże

• Zmiana pól min_days i max_days w ValueRuleItineraryAdvanceBookingWindow na pola optional, aby umożliwić podanie wartości 0. Umożliwia to kierowanie reklam na wyszukiwania dotyczące podróży, które mają miejsce dzisiaj.

Performance Max

• (Dotyczy tylko kont na liście dozwolonych) Wytyczne dotyczące marki
  • Ustawienie Campaign.brand_guidelines_enabledstało się możliwe do zmiany tylko podczas tworzenia kampanii Performance Max.
  • Ta funkcja jest niezgodna z kampaniami Performance Max do celów związanych z podróżami.
  • Aby włączyć wskazówki dotyczące marki w dotychczasowych kampaniach Performance Max, użyj nowo dodanego CampaignService.EnablePMaxBrandGuidelines. Wyłączenie wskazówek dotyczących marki nie jest obsługiwane.
  • Dodano Campaign.brand_guidelines i BrandGuidelines, aby umożliwić ustawienie 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
• Dodaliśmy AssetAutomationType.GENERATE_ENHANCED_YOUTUBE_VIDEOSobsługę automatycznego generowania ulepszonych komponentów wideo w kampaniach Performance Max.

Planowanie

• (Tylko w przypadku kont na liście dozwolonych) Dodano ContentCreatorInsightsService.GenerateTrendingInsights, który pozwala użytkownikom wyświetlać w YouTube tematy treści na topie dla określonych definicji odbiorców.
• Dodano GenerateCreatorInsightsRequest.country_locations[], aby można było określić kraje, w których mają być wyszukiwane dane kryteria.
• Dodano GenerateCreatorInsightsRequest.search_brand, aby umożliwić wyszukiwanie twórców według marki.
• Dodaliśmy nowe pola do interfejsu YouTubeChannelInsights, aby przekazywać dodatkowe informacje o kanale w żądaniach 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 wydaniu wersji DataLinkService.CreateDataLink dodaliśmy te metody, aby umożliwić modyfikowanie wcześniej utworzonych połączeń danych:
  • RemoveDataLink informacje o usuwaniu połączeń danych na koncie Google Ads
  • UpdateDataLink – do akceptowania, odrzucania i odwoływania połączeń danych na koncie Google Ads.
• Usunięto obsługę wartości VIDEO_OUTSTREAM z tych typów enumeracji:
  • AdType
  • AdvertisingChannelSubType
  • AdGroupType

v18 (16.10.2024)

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

Zarządzanie kontem

• (Tylko w przypadku kont na białej liście) Dodano DataLinkService.CreateDataLink, który umożliwia połączenie konta Google Ads z filmami twórców hostowanymi na ich kanale w YouTube. Łączenie filmów umożliwia prowadzenie reklam partnerskich na podstawie filmów twórców na koncie Google Ads.

Grupy reklam

• Dodano AdGroup.exclude_demographic_expansion, która umożliwia wykluczenie danych demograficznych z rozwiniętego zakresu, gdy optimized_targeting_enabled true. Ta funkcja była wcześniej obsługiwana tylko w elementach zamówienia generujących popyt.

Reklamy

• Dodano AdGroupAd.ad_group_ad_asset_automation_settings, która umożliwia włączanie i wyłączanie automatycznego generowania komponentów reklamy.
• Do wartości AssetAutomationType dodaliśmy te wartości:
  • 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

• Nazwa AssetType.DISCOVERY_CAROUSEL_CARD została zmieniona na AssetType.DEMAND_GEN_CAROUSEL_CARD.

Kampanie

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

Kryterium

• Dodano kolumnę content_criterion_view, która 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 podróżach w reklamach w wyszukiwarce
  • Dodano ClickType.TRAVEL_ASSETS, aby umożliwić podział danych plików danych o podróżach w reklamach w wyszukiwarce na segmenty.
  • Dodano opcję AssetSetType.TRAVEL_FEED, która umożliwia wyrażenie zgody na korzystanie z pliku danych o miejscach noclegowych w reklamach w wyszukiwarce lub rezygnację z tego.
• (Dotyczy tylko kont na białej liście) Dodano plan podróży jako nową regułę wartości konwersji z tymi nowymi polami i wartościami:
  • ConversionValueRule.itinerary_condition z ValueRuleItineraryCondition, co umożliwia określenie okresu rezerwacji z wyprzedzeniem, długości planu podróży oraz dni tygodnia, w których rozpoczyna się podróż
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
• Do raportów campaign i ad_group dodaliśmy te segmenty, aby umożliwić dzielenie danych o skuteczności na segmenty według konkretnych miejsc docelowych (miast, krajów i regionów) w przypadku kampanii reklam hoteli i kampanii w sieci wyszukiwania:
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

Usługi Lokalne

• Jeśli w przypadku danej rozmowy z potencjalnym klientem Usług Lokalnych nie ma nagrania rozmowy, parametr PhoneCallDetails.call_recording_url będzie pusty, a nie będzie zawierać nieprawidłowego adresu URL.
• Dodano CategoryBid.target_cpa_bid_micro, który umożliwia ustawienie docelowego CPA dla danej kategorii za pomocą Campaign.local_services_campaign_settings.

Performance Max

• Pomoc dotycząca wskazówek dotyczących marki
  • Dodano kolumnę Campaign.brand_guidelines_enabled, która pokazuje, czy w danej kampanii Performance Max są włączone wskazówki dotyczące marki. Jeśli ta opcja jest włączona, komponenty z ustawionym parametrem field_type BUSINESS_NAME, LOGO lub LANDSCAPE_LOGO muszą być połączone jako zasoby CampaignAsset zamiast zasobów AssetGroupAsset.
  • Dodano błędy CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED i CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED, które wskazują, że kampanie Performance Max z włączonymi wytycznymi dotyczącymi marek nie mają powiązanych z kampanią wymaganych zasobów CampaignAsset.
  • Gdy włączone są wytyczne dotyczące marki, do kampanii musi być powiązany co najmniej 1 komponent z ustawionym parametrem field_typeBUSINESS_NAMEi co najmniej 1 komponent z parametrem LOGOCampaignAsset. Kampanie Performance Max nastawione na sprzedaż online za pomocą pliku danych o produktach muszą spełniać ten wymóg tylko wtedy, gdy są w nich komponenty powiązane z grupami plików kampanii.
  • Do wartości AssetLinkError dodaliśmy te wartości:
    • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, który jest zgłaszany, gdy podczas próby połączenia komponentów marki z kampaniami jako zasobów CampaignAsset zamiast zasobów AssetGroupAsset w kampaniach Performance Max z niewłączonymi wytycznymi dotyczącymi marki.
    • BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL błąd, który występuje podczas próby połączenia zasobó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 kolumnę performance_max_placement_view, która zwraca liczbę wyświetleń w miejscach docelowych, w których wyświetlały się reklamy z kampanii Performance Max.
• Dodano AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

Planowanie

• (Tylko dla kont na liście dozwolonych) Dodano nową usługę z metodą ContentCreatorInsightsService.GenerateCreatorInsights, która umożliwia użytkownikom poznawanie statystyk najlepszych twórców YouTube. Dzięki temu klienci mogą wyszukiwać twórców na podstawie kombinacji kierowania na odbiorców i treści lub statystyk twórców na podstawie listy identyfikatorów kanałów YouTube.
• Aktualizacje AudienceInsightsService.GenerateSuggestedTargetingInsights:
  • Elementy audience, baseline_audience i data_month zostały przeniesione do audience_definition.
  • Dodano audience_description, aby generować sugestie kierowania na podstawie dowolnego tekstu z opisu za pomocą generatywnej AI.
• Dodano funkcję AudienceInsightsService.GenerateTargetingSuggestionMetrics, która zwraca dane o potencjalnym zasięgu w przypadku określonych kombinacji kierowania na odbiorców.

Rekomendacje

• RecommendationService.GenerateRecommendations możesz teraz używać do generowania rekomendacji dotyczących sugestii optymalizacji budżetu podczas tworzenia kampanii. Aby to zrobić, dodaj typ rekomendacji CAMPAIGN_BUDGET GenerateRecommendationsRequest.recommendation_types[]. Ta funkcja działa w przypadku kampanii Performance Max i kampanii w sieci wyszukiwania.

Raportowanie

• Pola summary_row_setting i return_total_results_count w kolumnie SearchGoogleAdsRequest zostały zastąpione polem search_settings, którego typ to SearchSettings, a zawartość to:
  • omit_results
  • return_summary_row
  • return_total_results_count
• Dodaliśmy te nowe dane dotyczące ogólnych nieprawidłowych kliknięć, np. kliknięć wygenerowanych przez boty lub roboty indeksujące albo takich, które mają nieregularne wzorce. Można je wyszukiwać za pomocą raportu campaign.
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
• Do wartości QuotaError dodaliśmy te wartości:
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

17.1.0 (7.08.2024)

W wersji 17_1 dodano te nowe funkcje i aktualizacje.

Zasoby

• AdGroupAdService.RemoveAutomaticallyCreatedAssets() umożliwia usunięcie określonych komponentów tworzonych automatycznie powiązanych z elatycznymi reklamami w wyszukiwarce.

Odbiorcy

• Nowe wartości typu wyliczeniowego w atrybucie UserListCustomerTypeCategory:
  • LOYALTY_TIER_1_MEMBERS
  • LOYALTY_TIER_2_MEMBERS
  • LOYALTY_TIER_3_MEMBERS
  • LOYALTY_TIER_4_MEMBERS
  • LOYALTY_TIER_5_MEMBERS
  • LOYALTY_TIER_6_MEMBERS
  • LOYALTY_TIER_7_MEMBERS

Kampanie

• ShareablePreviewService.GenerateShareablePreviews()generuje adresy URL shareable_preview_urlw odpowiedzi na podgląd reklamy, którą można udostępnić, w przypadku włączonych i wstrzymanych grup komponentów.
  • Pole expiration_date_time wskazuje datę wygaśnięcia adresów URL w odpowiedzi.
  • W przypadku wystąpienia błędu zamiast adresów URL metoda zwróci wartość partial_failure_error.

Historia zmian

• Nowy typ zasobu zmiany stanu: ASSET_GROUP.

Konwersje

• Nowe pole segmentu w wersji SKAdNetwork: segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary, który zawiera diagnostykę przesyłania konwersji na poziomie działania powodującego konwersję.
• Aby podać liczbę przesłanych konwersji, które są jeszcze przetwarzane, do raportów diagnostycznych offline dodawane są te dane:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

Planowanie

• AudienceInsights.GenerateAudienceOverlapInsights(), która przyjmuje jako dane wejściowe atrybut główny i zbiór atrybutów dotyczących odbiorców, a następnie zwraca szacowane pokrycie potencjalnego zasięgu w YouTube między atrybutem głównym a atrybutami dotyczącymi odbiorców.

Raportowanie

• Obsługa podziału na segmenty według właściwości per_store_view na podstawie kolumny segments.date

Filmy

• Obsługa pobierania informacji związanych z tymi standardowymi strategiami ustalania stawek w przypadku kampanii wideo za pomocą raportów, takich jak ad_group i campaign:
  • Campaign.fixed_cpm(CPM stały (koszt tysiąca wyświetleń))
  • Campaign.target_cpv(Docelowy CPV (koszt obejrzenia))
• Campaign.video_campaign_settings, która pozwala określić, w jakich zasobach reklamowych mogą się wyświetlać reklamy wideo. W tym celu możesz użyć tych pól raportu:
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream
  • campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts
• segments.ad_format_type, za pomocą którego możesz podzielić te raporty na podstawie typu formatu reklamy wideo:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

17 (5.06.2024)

W wersji 17 dodano te funkcje i zmiany:

Reklamy

• Użytkownik AdService.getAd został usunięty. Dzięki temu usługa AdService będzie zgodna z innymi usługami w interfejsie Google Ads API. Zapoznaj się z artykułem Pobieranie obiektów, aby dowiedzieć się, jak pobierać reklamy i inne typy zasobów.
• Dodano więcej weryfikacji ImageAdInfo.image_asset dotyczących wymiarów i formatu. Jeśli obraz jest nieprawidłowy, mogą wystąpić te błędy:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

Zasoby

• Dodano nowy typ wyliczeniowy: ClickType.AD_IMAGE
• Dodaliśmy nowe raporty z nowymi danymi dla kampanii Performance Max i kampanii w sieci wyszukiwania:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

Odbiorcy

• Dodano stronę OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

Zadania wsadowe

• Dodano parametr BatchJobError.REQUEST_TOO_LARGE, który zostanie wywołany, gdy przesłany parametr AddBatchJobOperationsRequest będzie większy niż 10484504 bajty.
• Dodano obsługę ustawienia MutateOperation.asset_group_operation podczas używania BatchJobService. Dzięki temu możesz używać przetwarzania w partiach do tworzenia i zarządzania całymi kampaniami Performance Max. Zapoznaj się z naszym nowym przewodnikiem.

Kampanie

• Zmieniliśmy nazwę „Discovery” na „Demand Gen” we wszystkich polach, typach danych i błędach wszystkich zasobów interfejsu Google Ads API, takich jak kampanie, reklamy i komponenty. Na przykład AdvertisingChannelType.DISCOVERY to teraz AdvertisingChannelType.DEMAND_GEN.
• Dodano Campaign.keyword_match_type, aby umożliwić Ci ustawianie typu dopasowania słów kluczowych we wszystkich słowach w kampanii.

Konwersje

• W przypadku konwersji SKAdNetwork:
  • Nazwa segments.sk_ad_network_conversion_value została zmieniona na segments.sk_ad_network_fine_conversion_value.
  • Dodano stronę segments.sk_ad_network_redistributed_fine_conversion_value.
• Te dane są teraz zwracane w odpowiedzi nawet wtedy, gdy mają wartość 0. Dzięki temu są one spójne z innymi danymi.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

Kryteria

• Dodano do tych pól, abyAdGroupCriterion pokazać, czy kryterium w grupie reklam jest wyświetlane, czy nie, oraz powody, dla których nie jest wyświetlane:
  • primary_status
  • primary_status_reasons
• Dodaliśmy obsługę właściwości metrics.search_impression_share w przypadku gender_view
• Dodaliśmy obsługę właściwości metrics.phone_calls w przypadku keyword_view

Usługi Lokalne

• Dodano LocalServicesLeadService.AppendLeadConversation() do korzystania z nowego LocalServicesLeadConversation do LocalServicesLead, który wysyła wiadomości do użytkowników przez odpowiednie kanały, np. SMS-y, w zależności od sposobu utworzenia potencjalnego klienta.
  • Rozmiar AppendLeadConversationRequest.conversations jest ograniczony do 1000.
  • W Conversation.local_services_lead można określić tylko parametr LocalServicesLead z wartością lead_type LeadType.MESSAGE.
• Dodano nowe wartości typu wyliczeniowego do kolumny ConversationType:
  • WHATSAPP, aby reprezentować rozmowę prowadzoną w WhatsApp.
  • ADS_API – do reprezentowania rozmowy rozpoczętej za pomocą nowej metody LocalServicesLeadService.AppendLeadConversation().
• Dodaliśmy do local_services_verification_artifact te nowe pola:
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

Raportowanie

• Podczas wykonywania zapytania product_link możesz teraz wybierać tylko pola powiązane z jednym połączonym produktem. Zaznaczenie wielu pól wielu połączonych produktów spowoduje błąd QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. Na przykład:product_link.advertising_partner.customer i product_link.data_partner.data_partner_id nie mogą być wybrane w tym samym zapytaniu.
• Przekazywanie wartości page_size do GoogleAdsService.Search spowoduje błąd RequestError.PAGE_SIZE_NOT_SUPPORTED.

kampania produktowa.

• Dodaliśmy nowy raport shopping_product, który odpowiada stronie Produkty w interfejsie Google Ads. Obsługuje ona zwracanie danych dotyczących bieżącego stanu produktów z kont Merchant Center połączonych z kontem Google Ads.
  • Dane w raporcie shopping_product możesz filtrować za pomocą filtra segments.date, gdy korzystasz z opcji GoogleAdsService.Search lub GoogleAdsService.SearchStream. Podział na segmenty według daty jest niedozwolony i spowoduje błąd ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION.

Cele ujednolicone

• Dodano UserListCustomerTypeService.MutateUserListCustomerTypes(), aby skonfigurować typy klientów odbiorców.
• Użytkownik CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings został usunięty. Aby skonfigurować ustawienia list odbiorców celów związanych z cyklem życia klienta, użyj zamiast tego reguły UserListCustomerTypeService.MutateUserListCustomerTypes().
  • Załącz lub odłącz listę użytkowników, ustawiając parametr UserListCustomerType.customer_type_categoryUserListCustomerTypeCategory.PURCHASERS, aby odpowiednio uwzględnić lub wykluczyć ją z dotychczasowej definicji klienta na potrzeby celów związanych z cyklem życia klienta. Aby dowiedzieć się więcej, przeczytaj artykuł Podział odbiorców na segmenty.

Filmy

• Do ContentLabelType dodano te wartości: Na poziomie klienta możesz wykluczyć te ContentLabelTypes:
  • BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
  • BRAND_SUITABILITY_GAMES_FIGHTING
  • BRAND_SUITABILITY_GAMES_MATURE
  • BRAND_SUITABILITY_HEALTH_SENSITIVE
  • BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
  • BRAND_SUITABILITY_NEWS_RECENT
  • BRAND_SUITABILITY_NEWS_SENSITIVE
  • BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
  • BRAND_SUITABILITY_POLITICS
  • BRAND_SUITABILITY_RELIGION
• Dodaliśmy parametr AdVideoAsset.ad_video_asset_info, aby umożliwić preferencje dotyczące zasobów wideo podczas tworzenia DemandGenVideoResponsiveAdInfo.
• (tylko konta na liście dozwolonych) Umożliwiono Campaign.video_brand_safety_suitabilitymodyfikowanie.

Archiwalne informacje o wersjach

Aby wyświetlić zarchiwizowane informacje o wersji, kliknij Wycofane wersje.