Informacje o wersjach

Wersja 17.1.0 (7.08.2024)

W wersji 17_1 dodaliśmy poniższe nowe funkcje i aktualizacje.

Zasoby

• AdGroupAdService.RemoveAutomaticallyCreatedAssets() umożliwia usuwanie określonych komponentów tworzonych automatycznie połączonych z elastycznymi reklamami w wyszukiwarce.

Odbiorcy

• Nowe wartości wyliczeniowe w 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 (w odpowiedzi shareable_preview_url w odpowiedzi) na potrzeby udostępniania podglądów reklam w aktywnych i wstrzymanych grupach komponentów.
  • Pole expiration_date_time wskazuje datę ważności adresów URL w odpowiedzi.
  • Jeśli wystąpi błąd, metoda zwróci partial_failure_error zamiast adresów URL.

Historia zmian

• Nowy typ zasobu stanu zmiany: ASSET_GROUP.

Konwersje

• Nowe pole segmentu dla wersji SKAdNetwork: segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary, który udostępnia diagnostykę przesyłania konwersji na poziomie działania powodującego konwersję.
• Do raportów diagnostyki offline dodawane są te dane, które informują o liczbie przesłanych konwersji, które są nadal przetwarzane:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

Planowanie

• AudienceInsights.GenerateAudienceOverlapInsights(), który akceptuje wejściowy atrybut główny i zbiór atrybutów dotyczących odbiorców, a następnie zwraca szacunkowe dane o pokrywaniu się potencjalnego zasięgu w YouTube między atrybutem podstawowym i odbiorcami.

Raportowanie

• Obsługa segmentowania per_store_view w oparciu o segments.date

Filmy

• Obsługa pobierania z raportów informacji związanych z tymi standardowymi strategiami ustalania stawek w kampaniach wideo, np. ad_group, campaign:
  • Campaign.fixed_cpm (stały CPM (koszt tysiąca wyświetleń))
  • Campaign.target_cpv (Docelowy CPV (koszt obejrzenia))
• Campaign.video_campaign_settings, który pozwala określić zasoby reklamowe, w których mogą się wyświetlać reklamy wideo, za pomocą 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, który umożliwia podział tych raportów na segmenty według typu formatu reklamy wideo:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

Wersja 17 (5.06.2024)

W wersji 17 dodaliśmy poniższe funkcje i zmiany.

Reklamy

• Użytkownik AdService.getAd został usunięty. Dzięki temu AdService zgodne z innymi usługami interfejsu Google Ads API. Zobacz sekcję Pobieranie obiektów dla zalecany sposób pobierania reklam i innych typów zasobów.
• Dodano więcej weryfikacji dla: ImageAdInfo.image_asset dotyczące wymiarów i formatu. Jeśli zdjęcie jest nieprawidłowe:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

Zasoby

• Dodano nową wyliczenie: ClickType.AD_IMAGE
• Dodaliśmy nowe raporty z nowymi danymi dotyczącymi kampanii Performance Max i kampanii w sieci wyszukiwania:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

Odbiorcy

• Dodano: OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

Zadania wsadowe

• Dodane BatchJobError.REQUEST_TOO_LARGE, który jest wysyłany, gdy przesłany element AddBatchJobOperationsRequest ma więcej niż 10 484 504 bajty.
• Dodano obsługę ustawienia MutateOperation.asset_group_operation podczas korzystania z BatchJobService. Dzięki temu możesz: korzystać z przetwarzania zbiorczego do tworzenia zarządzać całymi kampaniami Performance Max. Zapoznaj się z naszym nowym specjalnym przewodnikiem.

Kampanie

• Nazwa kampanii Discovery została zmieniona na generowanie popytu we wszystkich polach, wyliczeniach i błędach zasobów w interfejsie Google Ads API, takich jak kampanie, reklamy i komponenty. Dla: przykład, AdvertisingChannelType.DISCOVERY to teraz AdvertisingChannelType.DEMAND_GEN
• Dodane Campaign.keyword_match_type umożliwiając ustawienie typu dopasowania wszystkich słów kluczowych w kampanii.

Konwersje

• W przypadku SKAdNetwork konwersje,
  • Nazwa segments.sk_ad_network_conversion_value została zmieniona na segments.sk_ad_network_fine_conversion_value
  • Dodano: segments.sk_ad_network_redistributed_fine_conversion_value.
• Te dane są teraz zwracane wraz z odpowiedzią, nawet jeśli to zero. 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 następujących pól do tabeli AdGroupCriterion wskazuje, czy kryterium w grupie reklam wyświetla się lub dlaczego nie porcja:
  • primary_status
  • primary_status_reasons
• Dodano obsługę metrics.search_impression_share przez gender_view
• Dodano obsługę metrics.phone_calls przez keyword_view

Usługi Lokalne

• Dodano: LocalServicesLeadService.AppendLeadConversation() służy do dołączania nowych LocalServicesLeadConversation do LocalServicesLead, które wysyła za pomocą odpowiednich kanałów, takich jak SMS-y. utworzono potencjalną sprzedaż.
  • Rozmiar AppendLeadConversationRequest.conversations jest ograniczony do 1000.
  • Tylko LocalServicesLead z Ustawiono lead_type na LeadType.MESSAGE można określić w Conversation.local_services_lead.
• Dodano nowe wartości wyliczeniowe do: ConversationType:
  • WHATSAPP – reprezentuje rozmowę wprowadzoną na WhatsAppie.
  • ADS_API będzie reprezentować rozmowę wprowadzoną za pomocą nowego atrybutu LocalServicesLeadService.AppendLeadConversation() .
• Do local_services_verification_artifact dodano te nowe pola:
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

Raportowanie

• Teraz możesz wybrać tylko pola powiązane z jedną połączoną usługą w przypadku zapytania product_link. Wybieranie wielu elementów pola kilku połączonych produktów będą powodować QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE Przykład: product_link.advertising_partner.customer oraz product_link.data_partner.data_partner_id nie można wybrać w tym samym zapytaniu.
• Przekazuję sygnał page_size do: GoogleAdsService.Search otrzymasz RequestError.PAGE_SIZE_NOT_SUPPORTED .

kampania produktowa.

• Dodaliśmy nowy raport shopping_product, który odpowiada stronie Produkty w interfejsie Google Ads. Umożliwia zwrot związane z bieżącym stanem produktów z Google Merchant Center kont połączonych z kontem Google Ads.
  • Możesz filtrować dane z: shopping_product zastosuj, segments.date, gdy używasz GoogleAdsService.Search lub GoogleAdsService.SearchStream. Podział na segmenty według daty jest niedozwolony i zwróci błąd ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION .

Ujednolicone cele

• Dodano: UserListCustomerTypeService.MutateUserListCustomerTypes() aby skonfigurować odbiorców klienta .
• Użytkownik CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings został usunięty. Aby skonfigurować ustawienia odbiorców z celami związanymi z cyklem życia klienta, użyj UserListCustomerTypeService.MutateUserListCustomerTypes().
  • Dołączanie i odłączanie listy użytkowników za pomocą ustawienia UserListCustomerType.customer_type_category do UserListCustomerTypeCategory.PURCHASERS uwzględnić je w definicji klienta lub z niej wykluczyć, pod kątem celów związanych z cyklem życia klienta. Odwiedź stronę Posegmentuj odbiorcy .

Filmy

• Dodano następujące wartości do ContentLabelType Możesz wykluczyć te ContentLabelTypes na poziomie klienta:
  • 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
• Dodano: AdVideoAsset.ad_video_asset_info aby obsługiwać preferencje zasobów wideo dotyczące zasobów wideo podczas tworzenia DemandGenVideoResponsiveAdInfo
• Utworzono (tylko konta z listy dozwolonych) Campaign.video_brand_safety_suitability zmienny.

Wersja 16.1.0 (24.04.2024)

W wersji 16.1 dodaliśmy poniższe funkcje i zmiany.

Zarządzanie kontem

• CustomerNegativeCriterion.ip_block , który obsługuje dodawanie adresu IP jako kryterium wykluczającego na poziomie klienta.
• Nowa wartość enum: ProductLinkError.LINK_EXISTS
• Nowa wartość enum: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION

Zasoby

• Obsługa komponentów związanych z kampaniami generującymi popyt ad_group_ad_asset_view i asset_field_type_view
• Nowa wartość enum: AssetFieldType.DISCOVERY_CAROUSEL_CARD

Odbiorcy

• Nowa wartość enum: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER który ogranicza do 1000 podobnych list użytkowników.

Kampanie

• Obsługa zwrotu wartości docelowej Symulacje stawek ROASw kampanii dla Kampanie promujące aplikacje wykorzystujące campaign_simulation.
• Nowa wartość enum: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
• Nowa wartość enum: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
• Nowa wartość enum: CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS

Konwersje

• SkAdNetworkConversionValueSchema.postback_mappings która obsługuje SKAdNetwork 4,0 funkcje zabezpieczeń.
• Dodaliśmy obsługę ostrzeżeń dla: CustomerSkAdNetworkConversionValueSchemaService jako MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings Jeśli zasada jest ustawiona na true, wszystkie nieblokujące błędy związane z błędami operacji zostanie zwrócony jako MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
• Nowe wartości wyliczeniowe w CustomerSkAdNetworkConversionValueSchemaError:
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

Kryteria

• Nowe pola w BrandInfo:
  • display_name
  • primary_url
  • rejection_reason
  • status
• Nowa wyliczenie: BrandRequestRejectionReason
• Nowa wartość wyliczenia: CriterionType.LIFE_EVENT

Eksperymenty

• Nowa wartość enum: ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT.

Usługi Lokalne

• local_services_lead.credit_details.credit_state oraz local_services_lead.credit_details.credit_state_last_update_date_time który zwraca stan kredytu i sygnaturę czasową .
• local_services_lead_conversation.message_details.attachment_urls które zwraca adresy URL, których można użyć do pobrania zawartości załącznik.

Filmy

• customer.video_brand_safety_suitability oraz BrandSafetySuitability wspierające pobieranie treści wideo dla klienta pod kątem bezpieczeństwa marki na poziomie 300%.
• Nowa wartość enum: VideoCampaignError.MUTATE_REQUIRES_RESERVATION.

Wersja 16 (21.02.2024)

W wersji 16 dodaliśmy poniższe funkcje i zmiany.

Zarządzanie kontem

• Przeniesiono advertising_partner z AccountLink na ProductLink oraz ProductLinkInvitation.
• Użytkownik data_partner i google_ads został usunięty z: AccountLink.
• Dodane IdentityVerificationService do zarządzać weryfikacją reklamodawcy.
  • StartIdentityVerification() jest używana do rozpoczęcia sesji weryfikacyjnej przy użyciu podanego verification_program Tworzy nową sesję weryfikacji i zwraca pustą odpowiedź dla udało się utworzyć weryfikację.
    • Dodane IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION
  • GetIdentityVerification() może służyć do pobierania informacji weryfikacyjnych, które zwracają kilka obiektów IdentityVerification. Każda IdentityVerification obejmuje:
    • verification_program czyli typ programu weryfikacji tożsamości
    • identity_verification_requirement który zawiera szczegółowe informacje na temat terminu, do którego reklamodawca powinien dokończyć proces weryfikacji
    • verification_progress który zawiera szczegółowe informacje dotyczące sesji weryfikacyjnej, w tym:
      • program_status to bieżący stan sesja weryfikacyjna
      • action_url kieruje klienta do adresu URL, pod którym może dokończyć weryfikacji.
      • invitation_link_expiration_time oznacza datę ważności w okresie: action_url
  • Wyliczenia:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • Błędy:
    • IdentityVerificationError
• Dodane AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT

Zasoby

• Zmiany w asset_group:
  • Dodano obsługę segmentów związanych z czasem, takich jak segments.year i segments.month
  • Element campaign został przypisany do zasobu zamiast segmentowanie zasobów.

Kampanie

• Zmiany w kampaniach generujących popyt:
  • Dodano obsługę ustawienia Campaign.shopping_setting do do istniejącej kampanii generującej popyt.
  • Dodane ShoppingSetting.disable_product_feed , aby wyłączyć opcjonalny plik danych o produktach w kampaniach generujących popyt.
  • Dodano: Ad.demand_gen_product_ad i odpowiednik DemandGenProductAdInfo, dostępny dla Kampanie generujące popyt z wartością inną niż null Campaign.shopping_setting.
• Dodano do następujących pól w tabeli AdGroup, aby pokazać, czy grupa reklam wyświetla reklamy lub przyczyny, dla których reklama się nie wyświetla:
  • primary_status
  • primary_status_reasons
• Dodano do następujących pól w polu AdGroupAd, aby wyświetlić informacje o tym, czy reklama z grupy reklam wyświetla się lub jakie są przyczyny jej niewyświetlania:
  • primary_status
  • primary_status_reasons
• Dodano następujące wartości do AdGroupError:
  • CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
  • INVALID_STATUS

Eksperyment

• Element Experiment.sync_enabled został dodany do określ, czy w eksperymencie ma być włączona synchronizacja. Z funkcją synchronizacji włączono, zmiany wprowadzone w pierwotna kampania, podczas trwania eksperymentu, są automatycznie skopiowano do kampanii z eksperymentem.
• Dodane ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
• Dodane CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL

Hotele i Podróże

• Dodano następujące pola do ListingDimensionInfo – Atrakcje aby umożliwić tworzenie grup informacji o produktach według stanu i miasta, w którym aktywności związane z podróżami są dostępne:
  • activity_state
  • activity_city
• Dodano obsługę poniższych segmentów do travel_activity_performance_view:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

Usługi Lokalne

• Dodane LocalServicesVerificationArtifact.business_registration_check_verification_artifact oraz BusinessRegistrationCheckArtifact aby umożliwić reklamodawcom monitorowanie postępów w procesie rejestracji firmy proces weryfikacji.
• Dodano nowy zasób local_services_employee, aby zezwolić pozwala reklamodawcom pobrać dodane przez siebie informacje o pracownikach.

Planowanie

• Użytkownik score został usunięty z AudienceInsightsAttributeMetadata

Rekomendacje

• Dodane RecommendationService.GenerateRecommendations() która zwraca rekomendacje na podstawie określonych ustawień, takich jak typów rekomendacji i kanałów reklamowych. To szczególnie przydatne podczas tworzenia kampanii.
• Dodane RecommendationMetrics.conversions_value
• Zalecane słowa kluczowe z nieskonfigurowanym typem dopasowania słów kluczowych mają teraz recommended_match_type ustawiono na UNSPECIFIED, a nie na UNKNOWN.
• Dodaliśmy następujące typy rekomendacji:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN która zaleca włączenie strategii Maksymalizacja wartości konwersji. strategiczne
  • IMPROVE_GOOGLE_TAG_COVERAGE w ramach której zaleca się wdrożenie tagu Google na większej liczbie stron
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN który zaleca włączenie rozwinięcia końcowego adresu URL w kampanii Performance Max. kampanie
  • REFRESH_CUSTOMER_MATCH_LIST która zaleca aktualizację listy klientów, która nie była aktualizowana w ostatnie 90 dni
  • CUSTOM_AUDIENCE_OPT_IN W tej sytuacji zaleca się utworzenie niestandardowej grupy odbiorców,
  • LEAD_FORM_ASSET który zaleca dodanie komponentów z formularzem kontaktowym na poziomie kampanii lub klienta poziom
  • IMPROVE_DEMAND_GEN_AD_STRENGTH W ramach tej strategii zaleca się zwiększenie skuteczności reklamy w kampaniach generujących popyt.

kampania produktowa.

• Dodane CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT oraz CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS Aby wyświetlać bardziej szczegółowe błędy w kampaniach produktowych powiązanych z Comparison Shopping Service Center konta.
• Dodano następujące wartości do AssetGroupListingGroupFilterError:
  • DIMENSION_TYPE_NOT_ALLOWED
  • DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
  • FILTER_EXCLUSION_NOT_ALLOWED
  • LISTING_SOURCE_NOT_ALLOWED
  • MULTIPLE_LISTING_SOURCES
  • MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
  • MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
  • PAGE_FEED_FILTER_HAS_PARENT

Cele cyklu życia

• Użytkownik update został dodany do listy CustomerLifecycleGoalOperation oraz CampaignLifecycleGoalOperation aby ujednolicić te typy operacji z innymi typami operacji w interfejsie API.

Wersja 15 (18.10.2023 r.)

W wersji 15 wprowadziliśmy następujące nowe funkcje i aktualizacje.

Zarządzanie kontem

• Jeśli Twoje konto zostało zawieszone z powodu nieautoryzowanego konta aktywność, customer.status i customer_client.status są teraz zwracane jako SUSPENDED Wcześniej były zwracane jako ENABLED
• Dodaliśmy obsługę dodawania i usuwania połączenia między kontem Google Ads a konto Merchant Center:
  • Dodane ProductLink.merchant_center i MerchantCenterIdentifier
  • Dodane LinkedProductType.MERCHANT_CENTER
• Dodane ProductLinkInvitationService i ProductLinkInvitation do obsługi aktualizowanie zaproszenia do linku wysłanego z innych usług, dostępnego dla hoteli Center i Merchant Center Center.
• Użytkownik MerchantCenterLinkService został usunięty.
  • Aby połączyć konta Google Ads z kontami Merchant Center, użyj ProductLinkInvitationService i ProductLinkService.
• Usunięto AccountLink.hotel_center i obsługę aktualizowania zaproszeń do linków z kont Hotel Center korzystających z AccountLinkService
  • Aby zaktualizować zaproszenie do połączenia z konta Hotel Center, użyj ProductLinkInvitationService

Zasoby

• Tekst ImageAdInfo.media_file został zamieniony na ImageAdInfo.image_asset do zespołu pomocy dodawania i usuwania obrazów za pomocą tych komponentów. W związku z tym usunęliśmy też MediaFileService, które nie jest już potrzebne.
• Dodane ListingGroupFilterDimension.webpage do tworzenia filtra grup informacji o produktach na podstawie etykiet własnych i adresu URL podłańcuchy.
  • Zastąpiono też: AssetGroupListingGroupFilter.vertical AssetGroupListingGroupFilter.listing_source oraz ListingGroupFilterListingSource
• Dodano stronę asset_group_asset.source do wyświetlania źródło zasobu grupy plików.
• Dodane ad_group_ad_asset_view.source do źródło komponentu reklamy z grupy reklam.

Odbiorcy

• Dodano funkcję kierowania na listę klientów CustomerMatchUserListMetadata.consent popiera udzielenie zgody. Od 6 marca 2024 r., jeśli zgoda w przypadku użytkowników z EOG, oznacza to, że wartość zgody użytkownika jest uznawana za nieudzieloną. Dane pochodzące od użytkowników z Europejskiego Obszaru Gospodarczego, którzy nie wyrazili zgody, nie będą przetwarzane i nie będzie można ich używać w reklamach personalizacji za pomocą kierowania na listę klientów. Zapoznaj się z naszą Przewodnik po kierowaniu na listę klientów .
• W przypadku sprzedaży w sklepie dodano adres UserData.consent do udzielają zgody na wykorzystanie danych. Zapoznaj się z naszą Przewodnik po sprzedaży w sklepie dla . Jeśli używasz kierowania na listę klientów w przypadku sprzedaży w sklepie, zapoznaj się z artykułem Najczęstsze pytania, i informacjami o nich.
• Dodane UserList.lookalike_user_list do możesz pomóc w tworzeniu podobnego segment, czyli utworzenie listy odbiorców, na podstawie dotychczasowych modelowych odbiorców. Można używać podobnych segmentów w kampanii generującej popyt.

Kampanie

• Zmiany w kampaniach Performance Max:

  • Aplikacja AssetGroupSignal obsługuje teraz 2 korzyści typy sygnałów, które można dołączyć do grupy plików, aby ulepszyć kierowanie:
    • AssetGroupSignal.audience
      • Dodano Audience.scope i Audience.asset_group, aby ograniczyć dzięki wykorzystaniu list odbiorców w konkretnej grupie plików. Wartość Audience.asset_group musi być ustawiona gdy i tylko wtedy, gdy Audience.scope jest ASSET_GROUP
    • AssetGroupSignal.search_theme
      • Dodane CriterionType.SEARCH_THEME do obsługi tego nowego typu kryterium. Ten nowy typ kryterium może obejmować tylko można ich używać w kampaniach Performance Max do tworzenia AssetGroupSignal wypełniając pole AssetGroupSignal.search_theme z kryterium SearchThemeInfo.
  • Dodane AssetGroupSignalOperation.exempt_policy_violation_keys do przesyłania próśb o zwolnienie podczas dodawania sygnałów grupy plików.
  • Dodano nowy element asset_group_top_combination_view aby generować raporty o najskuteczniejszych komponentach na poziomie grupy plików.
  • Do aplikacji asset_group można teraz wysyłać zapytania za pomocą pól danych do pobierania danych o skuteczności kampanii Performance Max.
  • W PerformanceMaxUpgradeStatus, zmienił(a) nazwę społeczności UPGRADE_ELIGIBLE na UPGRADE_ELIGIBLE.

• Kampanie generujące popyt Odkrywanie Symulatory określania docelowej stawki CPA w kampaniach ze strategią Docelowy CPA (campaign_simulation.target_cpa_point_list.points) teraz zwraca TargetCpaSimulationPoint.interactions zamiast TargetCpaSimulationPoint.clicks

• Dodano narzędzie BrandSuggestionService, które może zaproponować marki na podstawie podanego prefiksu marki i listy wykluczonych marek. Dzięki tym markom można: Dodano kryterium BRAND do wspólnego zestawu BRANDS, a potem dołączyć do kampanii za pomocą CampaignCriterion z brand_list ustaw na wspólny zestaw. Kryteria kampanii mogą być kierowane w kampaniach w sieci wyszukiwania i wykluczane w Kampanie Performance Max.

  • Pola:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • Wyliczenia:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• Dodane Campaign.asset_automation_settings[] aby wyświetlić stan automatyzacji każdego typu komponentu.

• Dodaliśmy następujące wartości do CampaignPrimaryStatusReason wyliczenie:

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

Konwersje

• Dodano CallConversion.consent i ClickConversion.consent do obsługi udzielenie zgody. Zapoznaj się z naszą przewodnik po konwersjach telefonicznych i przewodnik po konwersjach po kliknięciu. .
• Dodano te pola związane z SKAdNetwork konwersji, dostępnych w przypadku zapytań z customer lub campaign:
  • Segmenty:
    • segments.sk_ad_network_coarse_conversion_value
    • segments.sk_ad_network_source_domain
    • segments.sk_ad_network_source_type
    • segments.sk_ad_network_postback_sequence_index
  • Dane:
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• Tekst metrics.sk_ad_network_conversions został zamieniony na metrics.sk_ad_network_installs
• Dodano obsługę diagnozowania przesyłania konwersji offline
  • Przeniesiono offline_conversion_upload_client_summary z pola zasobu customer do raportu najwyższego poziomu. Użyj tej raport, aby uzyskać przydatne informacje o stanie przesyłania konwersji, np. liczbę udanych zdarzeń, wskaźnik sukcesu i odsetek błędów.
    • Zastrzeżenie: przesyłana konwersja, która powoduje błąd ConversionUploadError.CLICK_NOT_FOUND jest nadal zaliczany do powodzenie, ale jest także oznaczony OfflineConversionAlert
  • Dodaliśmy job_id jako opcjonalny parametr dla poniższych typów żądań, możesz logicznie zgrupować wiele żądań przesłania w jedną oferta pracy:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • Dodano INVALID_JOB_ID do tych błędów:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • Tekst INVALID_CONVERSION_ACTION został zamieniony na NO_CONVERSION_ACTION_FOUND i INVALID_CONVERSION_ACTION_TYPE w przypadku tych błędów:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• Dodaliśmy 3 raporty dotyczące obsługi wielu sieci Piaskownicy prywatności na Androida atrybucja bez przekierowania:
  • android_privacy_shared_key_google_campaign, która zawiera shared_campaign_key i kilka pól, które pomagają w kodowaniu klucza.
  • android_privacy_shared_key_google_ad_group, która zawiera shared_ad_group_key i kilka pól, które pomagają w kodowaniu klucza.
  • android_privacy_shared_key_google_network_type, która zawiera shared_network_type_key i kilka pól, które pomagają w kodowaniu klucza.
• Dodane ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS ConversionActionOperation, próbuje użyć jednej z wycofanych atrybucji opartej na regułach modele teraz kończy się ten błąd. Wcześniej operacja kończyła się niepowodzeniem z UNKNOWN błąd.

Hotele i Podróże

• Dodaliśmy obsługę poniższych pól w travel_activity_group_view i travel_activity_performance_view:
  • Segmenty:
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • Dane:
    • metrics.search_absolute_top_impression_share
    • metrics.search_budget_lost_absolute_top_impression_share
    • metrics.search_budget_lost_impression_share
    • metrics.search_budget_lost_top_impression_share
    • metrics.search_impression_share
    • metrics.search_rank_lost_absolute_top_impression_share
    • metrics.search_rank_lost_impression_share
    • metrics.search_rank_lost_top_impression_share
    • metrics.search_top_impression_share

Reklamy Usług Lokalnych

• Dodano: LocalServicesSettings i do raportu customer, który zwraca Szczegółowe stany licencji i ubezpieczenia reklamodawcy usług.
• Dodaliśmy nowe raporty dla Lokalnej Usługi:
  • local_services_lead zawiera wszystkie szczegóły dotyczące Usług Lokalnych, potencjalnych klientów Google Ads, takich jak lead_charged, lead_type, lead_status.
    • Wyliczenia:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation zawiera szczegóły wiadomości i rozmów telefonicznych, takie jak conversation_channel, call_duration_millis, call_recording_url.
    • Adres URL nagrania rozmowy telefonicznej jest uwierzytelniany w odniesieniu do klienta docelowego i jego kontach menedżera.
  • local_services_verification_artifact zwraca artefakty reklamodawcy korzystającego z Usług Lokalnych, takie jak sprawdzenie przeszłości pracownika, zezwolenie na prowadzenie działalności i dane dotyczące ubezpieczenia dla firm. Wszelkie powiązane dokumenty z licencją i ubezpieczeniem można otworzyć za pomocą adresu URL.
    • Wyliczenia:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

Planowanie

• Dodaliśmy obsługę zwracania Forecast.views i PlannedProductForecast.views za ReachPlanService.ListPlannableProducts odpowiednich typów produktów.
• Dodaliśmy obsługę zwrotów PlannableTargeting.surface_targeting w przypadku ReachPlanService.ListPlannableProducts, opisujące dostępne platformy produktu.
• Dodano nowy element Wyliczenie ReachPlanSurface.
• Dodano obsługę kierowania na wartość docelową częstotliwości, AdvancedProductTargeting.target_frequency_settings, , która zwraca PlannedProductForecast.average_frequency
• Dodane AudienceInsightsService.GenerateSuggestedTargetingInsights aby wyświetlić sugerowane listy odbiorców, na które można kierować reklamy.
• Dodano następujące wartości do ReachPlanError:
  • NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
  • NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED

Rekomendacje

• Dodane RecommendationSubscriptionService który zarządza subskrypcjami rekomendacji:
  • Materiały: RecommendationSubscription
  • Pole: MutateOperation.recommendation_subscription_operation
  • Wyliczenie: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • Błędy:
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• Dodaliśmy następujące typy rekomendacji:
  • FORECASTING_SET_TARGET_CPA W rezultacie zalecamy ustawienie docelowego CPA dla kampanii, które go nie mają. przed wydarzeniem sezonowym, którego prognoza przewiduje wzrost ruchu.
  • SET_TARGET_CPA W rezultacie zalecamy ustawienie docelowego CPA dla kampanii, które go nie mają. określone dane.
  • SET_TARGET_ROAS W tym przypadku zaleca się ustawienie docelowego ROAS w przypadku kampanii, które go nie mają. określone dane.

Raportowanie

• Dodaliśmy nowe dane, których można używać do wysyłania zapytań campaign (dostępna w przypadku kampanii w sieci reklamowej, kampanii wideo, Discovery i kampanie promujące aplikacje) i segments.device:
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

kampania produktowa.

• Usunięto kolumnę ShoppingSetting.sales_country, której wartości są teraz zwracane jako ShoppingSetting.feed_label
  • Możesz nadal korzystać z konkretnego Merchant Center pliku danych w kampanii za pomocą funkcji ShoppingSetting.feed_label . Należy ustawić wartość etykiety pliku danych lub dwuliterowy kraj poprzednio używany wcześniej dla ShoppingSetting.sales_country. Aby dowiedzieć się więcej, zobacz artykuł pomocy na temat kanałów etykiety.
• W raportach usunięto zależność kategorii produktów od kodu kraju. Zestaw obsługiwanych identyfikatorów kategorii nie uległ zmianie.
  • Zastąpiono następujące pola używane w shopping_performance_view:
    • segments.product_bidding_category_level1 z segments.product_category_level1
    • segments.product_bidding_category_level2 z segments.product_category_level2
    • segments.product_bidding_category_level3 z segments.product_category_level3
    • segments.product_bidding_category_level4 z segments.product_category_level4
    • segments.product_bidding_category_level5 z segments.product_category_level5
  • Tekst product_bidding_category_constant został zamieniony na product_category_constant, czyli zwraca wszystkie dostępne lokalizacje kategorii w polu powtarzanym.
  • Tekst ListingDimensionInfo.product_bidding_category został zamieniony na ListingDimensionInfo.product_category
  • Tekst ListingGroupFilterDimension.product_bidding_category został zamieniony na ListingGroupFilterDimension.product_category
• Usunięto obsługę dodawania Campaign.shopping_setting do wyszukiwarki kampanie. Próbujesz utworzyć kampanię w sieci wyszukiwania z: Campaign.shopping_setting lub dodaj Campaign.shopping_setting na dotychczasowe kampanie w sieci wyszukiwania OPERATION_NOT_PERMITTED_FOR_CONTEXT
• Usunięto obsługę dodawania CampaignCriterion.listing_scope do kampanii w sieci wyszukiwania. Próbuję dodać CampaignCriterion.listing_scope w dotychczasowej kampanii w sieci wyszukiwania OPERATION_NOT_PERMITTED_FOR_CONTEXT
• Dodano następujące konwersje z koszykiem danych:
  • metrics.orders
  • metrics.average_order_value_micros
  • metrics.average_cart_size
  • metrics.cost_of_goods_sold_micros
  • metrics.gross_profit_micros
  • metrics.gross_profit_margin
  • metrics.revenue_micros
  • metrics.units_sold
  • metrics.cross_sell_cost_of_goods_sold_micros
  • metrics.cross_sell_gross_profit_micros
  • metrics.cross_sell_revenue_micros
  • metrics.cross_sell_units_sold
  • metrics.lead_cost_of_goods_sold_micros
  • metrics.lead_gross_profit_micros
  • metrics.lead_revenue_micros
  • metrics.lead_units_sold
  • Wszystkie te dane można wybrać w tych raportach:
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

Ujednolicone cele

• Dodane CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals , aby skonfigurować cele związane z pozyskiwaniem klientów na poziomie klienta.
  • Raport: customer_lifecycle_goal
• Dodane CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals , aby skonfigurować cele związane z pozyskiwaniem klientów na poziomie kampanii.
  • Raport: campaign_lifecycle_goal
• Dodane CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
• Dodano następujące wartości do ConversionGoalCampaignConfigError:
  • EMPTY_CONVERSION_GOALS
  • STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
  • PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES

Filmy

• Dodaliśmy obsługę kierowania na Google TV na poziomie kampanii:
  • Dodane NetworkSettings.target_google_tv_network
  • Dodane AdNetworkType.GOOGLE_TV
• Dodaliśmy obsługę kierowania na YouTube na poziomie kampanii:
  • Dodane NetworkSettings.target_youtube
  • Scalono w polu AdNetworkType YOUTUBE_WATCH i YOUTUBE_SEARCH w: YOUTUBE.
  • Dodane CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE

Informacje o zarchiwizowanych wersjach

Zarchiwizowane informacje o wersjach znajdziesz w sekcji Wersje wyłączone.