Note di rilascio

Versione 17.1.0 (7/08/2024)

Le nuove funzionalità e gli aggiornamenti seguenti sono stati aggiunti nella versione v17_1.

Asset

• AdGroupAdService.RemoveAutomaticallyCreatedAssets() ti consente di rimuovere gli asset creati automaticamente specificati collegati agli annunci adattabili della rete di ricerca.

Segmenti di pubblico

• Nuovi valori enum in 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

Campagne

• ShareablePreviewService.GenerateShareablePreviews() genera gli URL (shareable_preview_url nella risposta) per le anteprime degli annunci condivisibili per i gruppi di asset attivati e in pausa.
  • Il campo expiration_date_time indica la data di scadenza degli URL nella risposta.
  • Se si verifica un errore, il metodo restituisce partial_failure_error al posto degli URL.

Cronologia delle modifiche

• Nuovo tipo di risorsa di stato della modifica: ASSET_GROUP.

Conversioni

• Nuovo campo del segmento per la versione SKAdNetwork: segments.sk_ad_network_version
• offline_conversion_upload_conversion_action_summary, che mostra la diagnostica del caricamento delle conversioni a livello di azione di conversione.
• Ai report di diagnostica offline vengono aggiunte le seguenti metriche per indicare il numero di conversioni caricate che sono ancora in fase di elaborazione:
  • offline_conversion_upload_client_summary
    • pending_event_count
    • pending_rate
  • offline_conversion_upload_conversion_action_summary:
    • pending_count

Pianificazione

• AudienceInsights.GenerateAudienceOverlapInsights(), che accetta un attributo principale di input e una raccolta di attributi del pubblico, e restituisce le stime della sovrapposizione della potenziale copertura su YouTube tra l'attributo principale e gli attributi del pubblico.

Rapporti

• Supporto per la segmentazione di per_store_view basata su segments.date

Video

• Supporto per il recupero delle informazioni relative alle seguenti strategie di offerta standard per le campagne video che utilizzano i report, ad esempio ad_group e campaign:
  • Campaign.fixed_cpm (CPM (costo per mille impressioni) fisso)
  • Campaign.target_cpv (CPV (costo per visualizzazione) target)
• Campaign.video_campaign_settings, che ti consente di determinare su quali inventari possono essere mostrati gli annunci video utilizzando i seguenti campi del report:
  • 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 che ti consente di segmentare i seguenti report in base al tipo di formato dell'annuncio video:
  • ad_group
  • ad_group_ad
  • ad_group_ad_asset_view
  • campaign
  • customer

versione 17 (5/06/2024)

Nella versione 17 sono state aggiunte le seguenti funzionalità e modifiche.

Annunci

• AdService.getAd rimosso. Ciò porta AdService in linea con gli altri servizi del API Google Ads. Consulta Recupero di oggetti per consigliato per recuperare annunci e altri tipi di risorse.
• Sono state aggiunte altre convalide per ImageAdInfo.image_asset in merito dimensioni e formato. Potrebbero essere visualizzati i seguenti errori se l'immagine è non valido:
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

Asset

• Nuova enum aggiunta: ClickType.AD_IMAGE
• Sono stati aggiunti i seguenti nuovi report con nuove metriche per le campagne Performance Max e sulla rete di ricerca:
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

Segmenti di pubblico

• Hai aggiunto OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

Job batch

• Aggiunta BatchJobError.REQUEST_TOO_LARGE, che verrà restituito quando il valore AddBatchJobOperationsRequest inviato supera i 10484504 byte.
• Aggiunto il supporto per l'impostazione MutateOperation.asset_group_operation quando utilizzi BatchJobService. Questo consente di utilizzare l'elaborazione batch per creare gestire intere campagne Performance Max. Consulta la nostra nuova guida dedicata.

Campagne

• Discovery rinominata in Demand Gen in tutti i campi, le enumerazioni e gli errori di tutti risorse nell'API Google Ads, come campagne, annunci e asset. Per esempio, AdvertisingChannelType.DISCOVERY è ora AdvertisingChannelType.DEMAND_GEN
• Aggiunta Campaign.keyword_match_type per impostare il tipo di corrispondenza delle parole chiave per tutte le parole chiave di una campagna.

Conversioni

• Per SKAdNetwork conversioni,
  • segments.sk_ad_network_conversion_value rinominato in segments.sk_ad_network_fine_conversion_value
  • segments.sk_ad_network_redistributed_fine_conversion_value aggiunto.
• Le seguenti metriche vengono ora restituite con la risposta anche quando sono pari a zero. Questo le rende coerenti con le altre metriche.
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

Criteri

• Aggiunti ai seguenti campi a AdGroupCriterion per mostrare se il criterio del gruppo di annunci viene pubblicato o i motivi per cui non viene pubblicazione:
  • primary_status
  • primary_status_reasons
• È stato aggiunto il supporto per metrics.search_impression_share per gender_view
• È stato aggiunto il supporto per metrics.phone_calls per keyword_view

Servizi locali

• Hai aggiunto LocalServicesLeadService.AppendLeadConversation() utilizzato per aggiungere un nuovo LocalServicesLeadConversation a LocalServicesLead, che invia i messaggi agli utenti tramite canali appropriati come gli SMS, a seconda di come è stato creato un lead.
  • Le dimensioni di AppendLeadConversationRequest.conversations sono limitate a 1000.
  • Solo LocalServicesLead con lead_type impostato su LeadType.MESSAGE può essere specificato in Conversation.local_services_lead
• Sono stati aggiunti nuovi valori enum a ConversationType:
  • WHATSAPP per rappresentare una conversazione introdotta tramite WhatsApp.
  • ADS_API per rappresentare una conversazione introdotta utilizzando il nuovo LocalServicesLeadService.AppendLeadConversation() .
• Sono stati aggiunti i nuovi nuovi campi seguenti a local_services_verification_artifact:
  • local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
  • local_services_verification_artifact.license_verification_artifact.expiration_date_time

Rapporti

• Ora puoi selezionare solo i campi relativi a un prodotto collegato durante l'esecuzione di query su product_link. Selezione di più elementi campi di diversi prodotti collegati generano QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE Ad esempio: product_link.advertising_partner.customer e product_link.data_partner.data_partner_id non può essere selezionato nella stessa query.
• Passaggio di page_size per GoogleAdsService.Search in corso... produrrà un RequestError.PAGE_SIZE_NOT_SUPPORTED .

Shopping

• È stato aggiunto un nuovo report shopping_product, che corrisponde alla pagina Prodotti dell'interfaccia utente di Google Ads. Supporta la restituzione Dati relativi allo stato attuale dei prodotti di Google Merchant Center account collegati a un account Google Ads.
  • Puoi filtrare le metriche shopping_product segnala con segments.date quando utilizzi GoogleAdsService.Search oppure GoogleAdsService.SearchStream. La segmentazione per data non è consentita e restituisce un ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION .

Obiettivi unificati

• Hai aggiunto UserListCustomerTypeService.MutateUserListCustomerTypes() per configurare il cliente del segmento di pubblico tipi.
• CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings rimosso. Per configurare le impostazioni relative al pubblico degli obiettivi del ciclo di vita dei clienti, utilizza UserListCustomerTypeService.MutateUserListCustomerTypes() in alternativa.
  • Collegare o scollegare un elenco di utenti tramite l'impostazione UserListCustomerType.customer_type_category a UserListCustomerTypeCategory.PURCHASERS per includerlo o escluderlo da una definizione di cliente esistente per gli obiettivi del ciclo di vita dei clienti. Visita la pagina segmentare segmenti di pubblico per ulteriori dettagli.

Video

• Sono stati aggiunti i seguenti valori a ContentLabelType Puoi escludere questi ContentLabelTypes a livello di cliente:
  • 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
• Hai aggiunto AdVideoAsset.ad_video_asset_info per supportare le preferenze dell'inventario per gli asset video durante la creazione DemandGenVideoResponsiveAdInfo.
• (Solo account inclusi nella lista consentita) Data Campaign.video_brand_safety_suitability modificabile.

Versione 16.1.0 (24/04/2024)

Nella versione 16.1 sono state aggiunte le seguenti funzionalità e modifiche.

Gestione dell'account

• CustomerNegativeCriterion.ip_block il che supporta l'aggiunta di un IP come criterio negativo a livello di cliente.
• Nuovo valore enum: ProductLinkError.LINK_EXISTS
• Nuovo valore enum: ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION

Asset

• Supporto per gli asset correlati a Demand Gen per ad_group_ad_asset_view e asset_field_type_view.
• Nuovo valore enum: AssetFieldType.DISCOVERY_CAROUSEL_CARD

Segmenti di pubblico

• Nuovo valore enum: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER che limita il numero di elenchi di utenti simili che un cliente può avere a 1000.

Campagne

• Supporto per la restituzione di Target Simulazioni di offerte a livello di campagna basate sul ROAS per Campagne per app che utilizzano campaign_simulation.
• Nuovo valore enum: CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
• Nuovo valore enum: AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
• Nuovo valore enum: CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS

Conversioni

• SkAdNetworkConversionValueSchema.postback_mappings che supporta SKAdNetwork 4,0 le funzionalità di machine learning.
• Aggiunto il supporto per gli avvisi per CustomerSkAdNetworkConversionValueSchemaService come MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings. Se il criterio viene impostato su true, eventuali errori non bloccanti relativi a errori delle operazioni verrà restituito come MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
• Nuovi valori enum in CustomerSkAdNetworkConversionValueSchemaError:
  • INVALID_EVENT_COUNTER
  • INVALID_EVENT_NAME

Criteri

• Nuovi campi in BrandInfo:
  • display_name
  • primary_url
  • rejection_reason
  • status
• Nuova enum: BrandRequestRejectionReason
• Nuovo valore enum: CriterionType.LIFE_EVENT

Esperimenti

• Nuovo valore enum: ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT.

Servizi locali

• local_services_lead.credit_details.credit_state e local_services_lead.credit_details.credit_state_last_update_date_time che restituisce lo stato del credito e il timestamp quando lo stato del credito rispettivamente.
• local_services_lead_conversation.message_details.attachment_urls che restituisce gli URL utilizzabili per scaricare i contenuti allegato.

Video

• customer.video_brand_safety_suitability e BrandSafetySuitability che supportano il recupero dell'idoneità alla sicurezza del brand per i video presso il cliente livello.
• Nuovo valore enum: VideoCampaignError.MUTATE_REQUIRES_RESERVATION.

versione 16 (21/02/2024)

Nella versione 16 sono state aggiunte le seguenti funzionalità e modifiche.

Gestione dell'account

• Migrazione di advertising_partner eseguita da Da AccountLink a ProductLink e ProductLinkInvitation
• data_partner e google_ads rimossi da AccountLink
• Aggiunta Da IdentityVerificationService a gestire la verifica dell'inserzionista.
  • StartIdentityVerification() viene utilizzato per avviare una sessione di verifica utilizzando verification_program. Crea una nuova sessione di verifica e restituisce una risposta vuota per un verifica creata correttamente.
    • Aggiunta IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION
  • GetIdentityVerification() può essere utilizzato per recuperare le informazioni di verifica, che restituiscono diversi oggetti di IdentityVerification. Ciascun IdentityVerification include:
    • verification_program che è il tipo di programma di verifica dell'identità,
    • identity_verification_requirement contenente i dettagli relativi alla scadenza entro la quale L'inserzionista deve completare la verifica
    • verification_progress contenente i dettagli relativi alla sessione di verifica, tra cui:
      • program_status rappresenta lo stato attuale di questa sessione di verifica
      • action_url indirizza il cliente a un URL per completare la verifica.
      • invitation_link_expiration_time rappresenta la data di scadenza per action_url
  • Enum:
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • Errori:
    • IdentityVerificationError
• Aggiunta AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT

Asset

• Modifiche a asset_group:
  • È stato aggiunto il supporto per i segmenti temporali, ad esempio segments.year e segments.month.
  • Ha reso campaign una risorsa attribuita invece di la segmentazione delle risorse.

Campagne

• Modifiche alle campagne Demand Gen:
  • Aggiunto il supporto per l'impostazione Da Campaign.shopping_setting a di una campagna Demand Gen esistente.
  • Aggiunta ShoppingSetting.disable_product_feed per disattivare il feed dei prodotti facoltativo delle campagne Demand Gen.
  • Hai aggiunto Ad.demand_gen_product_ad e i corrispondenti DemandGenProductAdInfo, disponibile per Campagne Demand Gen con un valore non null Campaign.shopping_setting
• Aggiunti ai seguenti campi a AdGroup per mostrare se se il gruppo di annunci viene pubblicato o i motivi per cui non viene pubblicato:
  • primary_status
  • primary_status_reasons
• Aggiunti ai seguenti campi a AdGroupAd per mostrarli se l'annuncio del gruppo di annunci viene pubblicato o i motivi per cui non viene pubblicato:
  • primary_status
  • primary_status_reasons
• Sono stati aggiunti i seguenti valori a AdGroupError:
  • CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
  • INVALID_STATUS

Esperimento

• Elemento Experiment.sync_enabled aggiunto a specificare se la sincronizzazione deve essere attivata nell'esperimento. Con sincronizzazione attivata, le modifiche apportate campagna originale mentre l'esperimento è in esecuzione, vengono automaticamente copiato nella campagna sperimentale.
• Aggiunta ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
• Aggiunta CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL

Hotel e Viaggi

• Sono stati aggiunti i seguenti campi a ListingDimensionInfo per una sezione Cose da fare per attivare la creazione di gruppi di schede in base allo stato e alla città in cui è disponibile l'attività di viaggio:
  • activity_state
  • activity_city
• È stato aggiunto il supporto dei seguenti segmenti per travel_activity_performance_view:
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

Servizi locali

• Aggiunta LocalServicesVerificationArtifact.business_registration_check_verification_artifact e BusinessRegistrationCheckArtifact per consentire agli inserzionisti di monitorare l'avanzamento della registrazione dell'azienda procedura di verifica.
• È stata aggiunta una nuova risorsa local_services_employee per consentire agli inserzionisti di recuperare le informazioni sui dipendenti che hanno aggiunto.

Pianificazione

• score rimosso da AudienceInsightsAttributeMetadata

Consigli

• Aggiunta RecommendationService.GenerateRecommendations() che restituisce consigli in base alle impostazioni specificate, ad esempio tipi di consigli e canali pubblicitari. Ciò è particolarmente utile durante la creazione della campagna.
• Aggiunta RecommendationMetrics.conversions_value
• Le parole chiave consigliate con tipo di corrispondenza delle parole chiave non impostato ora hanno recommended_match_type impostato su UNSPECIFIED anziché su UNKNOWN.
• Sono stati aggiunti i seguenti tipi di consigli:
  • MAXIMIZE_CONVERSION_VALUE_OPT_IN che consiglia di attivare l'offerta Massimizza il valore di conversione di strategia
  • IMPROVE_GOOGLE_TAG_COVERAGE che consiglia di implementare il tag Google su più pagine
  • PERFORMANCE_MAX_FINAL_URL_OPT_IN che consiglia di attivare l'espansione dell'URL finale per Performance Max campagne
  • REFRESH_CUSTOMER_MATCH_LIST che consiglia di aggiornare un elenco di clienti che non è stato aggiornato in ultimi 90 giorni
  • CUSTOM_AUDIENCE_OPT_IN che consiglia di creare un segmento di pubblico personalizzato
  • LEAD_FORM_ASSET che consiglia di aggiungere asset modulo per i lead alla campagna o al cliente livello
  • IMPROVE_DEMAND_GEN_AD_STRENGTH che consiglia di migliorare l'efficacia dell'annuncio nelle campagne Demand Gen

Shopping

• Aggiunta CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT e CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS al fine di fornire errori più dettagliati per le campagne Shopping collegate a un Centro per i servizi di shopping comparativo Fitbit.com.
• Sono stati aggiunti i seguenti valori a 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

Obiettivi del ciclo di vita

• Elemento update aggiunto a CustomerLifecycleGoalOperation e CampaignLifecycleGoalOperation per rendere questi tipi di operazioni coerenti con altri tipi di operazioni nell'API.

versione 15 (18/10/2023)

Le nuove funzionalità e gli aggiornamenti seguenti sono stati introdotti nella versione 15.

Gestione dell'account

• Se il tuo account è stato sospeso a causa di account non autorizzato attività, customer.status e customer_client.status vengono ora restituiti SUSPENDED In precedenza, venivano restituiti ENABLED
• È stato aggiunto il supporto per l'aggiunta e la rimozione di un collegamento tra un account Google Ads e Un account Merchant Center:
  • Aggiunta ProductLink.merchant_center e MerchantCenterIdentifier.
  • Aggiunta LinkedProductType.MERCHANT_CENTER
• Aggiunta ProductLinkInvitationService e ProductLinkInvitation all'assistenza aggiornare un invito al link inviato da altri prodotti, disponibile per hotel Center e Merchant Center Google Cloud.
• MerchantCenterLinkService rimosso.
  • Per collegare gli account Google Ads agli account Merchant Center, utilizza ProductLinkInvitationService e ProductLinkService.
• AccountLink.hotel_center e supporto per l'aggiornamento degli inviti ai collegamenti rimossi dagli account Hotel Center utilizzando AccountLinkService
  • Per aggiornare un invito al collegamento da un account Hotel Center, utilizza ProductLinkInvitationService

Asset

• ImageAdInfo.media_file sostituito con ImageAdInfo.image_asset all'assistenza l'aggiunta e la rimozione di immagini utilizzando gli asset. Di conseguenza, abbiamo anche rimosso MediaFileService, che non è più necessario.
• Aggiunta ListingGroupFilterDimension.webpage per supportare la creazione di un filtro del gruppo di schede basato su etichette personalizzate e URL sottostringhe.
  • Inoltre ha sostituito AssetGroupListingGroupFilter.vertical con AssetGroupListingGroupFilter.listing_source e ListingGroupFilterListingSource
• asset_group_asset.source aggiunto al programma l'origine dell'asset del gruppo di asset.
• Aggiunta Da ad_group_ad_asset_view.source a mostrano l'origine dell'asset annuncio del gruppo di annunci.

Segmenti di pubblico

• Per Customer Match, CustomerMatchUserListMetadata.consent per supportare la fornitura del consenso. A partire dal 6 marzo 2024, se il consenso è mancante per gli utenti SEE, il valore del consenso viene determinato come non fornito. I dati degli utenti nel SEE senza consenso non verranno elaborati e non potranno essere utilizzati per l'annuncio personalizzazione tramite Customer Match. Consulta le nostre Guida di Customer Match per ulteriori dettagli.
• Per le vendite in negozio, ha aggiunto UserData.consent a all'assistenza clienti fornendo il consenso. Consulta le nostre Guida alle vendite in negozio per ulteriori dettagli. Se utilizzi Customer Match con le vendite in negozio, consulta le Domande frequenti per ulteriori informazioni.
• Aggiunta Da UserList.lookalike_user_list a per la creazione di un simile di Google Cloud, un segmento di pubblico creato in base al segmento di pubblico di origine esistente fornito. I segmenti simili possono essere utilizzati in una campagna Demand Gen .

Campagne

• Aggiornamenti alle campagne Performance Max:

  • AssetGroupSignal ora supporta due tipi di indicatori che possono essere associati a un gruppo di asset per un targeting avanzato:
    • AssetGroupSignal.audience
      • Hai aggiunto Audience.scope e Audience.asset_group per limitare l'utilizzo dei segmenti di pubblico in un gruppo di asset specifico. È necessario impostare Audience.asset_group se e solo se Audience.scope è ASSET_GROUP.
    • AssetGroupSignal.search_theme
      • Aggiunta CriterionType.SEARCH_THEME per supportare questo nuovo tipo di criterio. Questo nuovo tipo di criterio può da utilizzare nelle campagne Performance Max per creare un AssetGroupSignal compilando il AssetGroupSignal.search_theme con un criterio SearchThemeInfo.
  • Aggiunta AssetGroupSignalOperation.exempt_policy_violation_keys per supportare la richiesta di esenzione durante l'aggiunta di indicatori dei gruppi di asset.
  • È stato aggiunto un nuovo elemento asset_group_top_combination_view per registrare gli asset con il rendimento migliore a livello di gruppo di asset.
  • Ora è possibile eseguire query su asset_group con i campi delle metriche per supportare il recupero del rendimento di una campagna Performance Max.
  • Nel PerformanceMaxUpgradeStatus, UPGRADE_ELIGIBLE rinominato in UPGRADE_ELIGIBLE.

• Per Demand Gen e Scoperta Campagne basate su CPA target, simulazioni di offerte basate su CPA target a livello di campagna (campaign_simulation.target_cpa_point_list.points) ora restituisce TargetCpaSimulationPoint.interactions anziché TargetCpaSimulationPoint.clicks

• È stato aggiunto BrandSuggestionService che può suggerire brand in base al prefisso del brand fornito e all'elenco escluso di brand. Questi brand possono essere usati per creare BRAND criterio, aggiunto a un set condiviso di BRANDS, e poi collegarli a una campagna creando un CampaignCriterion con brand_list impostata sul set condiviso. I criteri delle campagne possono essere scelti come target nelle campagne sulla rete di ricerca ed esclusi in campagne Performance Max.

  • Campi:
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • Enum:
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• Aggiunta Campaign.asset_automation_settings[] per mostrare lo stato dell'automazione di ogni tipo di asset.

• Sono stati aggiunti i seguenti valori alla sezione CampaignPrimaryStatusReason enum:

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

Conversioni

• Hai aggiunto CallConversion.consent e ClickConversion.consent all'assistenza fornendo il consenso. Consulta le nostre guida alle conversioni di chiamata e la guida alle conversioni dei clic per ulteriori informazioni i dettagli.
• Sono stati aggiunti i seguenti campi relativi a SKAdNetwork conversioni, disponibili quando si eseguono query customer o campaign:
  • Segmenti:
    • 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
  • Metriche:
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• metrics.sk_ad_network_conversions sostituito con metrics.sk_ad_network_installs
• Aggiunta del supporto per la diagnosi del caricamento delle conversioni offline
  • È stato spostato il offline_conversion_upload_client_summary da un campo della risorsa customer a un report di primo livello. Usa questa per ottenere dettagli utili sullo stato di caricamento delle conversioni, come numero di eventi riusciti, percentuale di successo e percentuale di errori.
    • Avvertimento: una conversione che viene caricata, ma genera un ConversionUploadError.CLICK_NOT_FOUND viene comunque conteggiato come riuscito, ma viene anche contrassegnato come OfflineConversionAlert.
  • È stato aggiunto job_id come parametro facoltativo per i seguenti tipi di richiesta, così puoi raggruppare logicamente più richieste di caricamento in un'unica domanda offerta di lavoro:
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • È stato aggiunto INVALID_JOB_ID ai seguenti errori:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • È stato sostituito INVALID_CONVERSION_ACTION con NO_CONVERSION_ACTION_FOUND e INVALID_CONVERSION_ACTION_TYPE nei seguenti errori:
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• Sono stati aggiunti tre report per supportare Android Privacy Sandbox su più reti attribuzione senza reindirizzamenti:
  • android_privacy_shared_key_google_campaign che contiene shared_campaign_key e alcuni campi che consentono di codificare la chiave.
  • android_privacy_shared_key_google_ad_group che contiene shared_ad_group_key e alcuni campi che consentono di codificare la chiave.
  • android_privacy_shared_key_google_network_type che contiene shared_network_type_key e alcuni campi che consentono di codificare la chiave.
• Aggiunta ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS Una ConversionActionOperation che tenta di utilizzare una delle attribuzione basata su regole deprecata modelli ora non riesce e restituisce questo errore. In precedenza, l'operazione non riusciva UNKNOWN errore.

Hotel e Viaggi

• Aggiunto il supporto per i seguenti campi in travel_activity_group_view e travel_activity_performance_view:
  • Segmenti:
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • Metriche:
    • 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

Annunci di Servizi locali

• È stato aggiunto LocalServicesSettings e le relative informazioni al report customer per restituire un acquisto Fornisce gli stati di licenza granulare e di assicurazione dell'inserzionista.
• Sono stati aggiunti i seguenti nuovi report per Locale Servizi:
  • local_services_lead contiene tutti i valori i dettagli relativi a Servizi locali Lead Google Ads come lead_charged, lead_type lead_status.
    • Enum:
      • LeadStatus
      • LeadType
  • local_services_lead_conversation contiene i dettagli delle conversazioni telefoniche e del messaggio, come conversation_channel, call_duration_millis e call_recording_url.
    • L'URL di registrazione delle chiamate è autenticato per il cliente target e i relativi account amministratore.
  • local_services_verification_artifact restituisce gli elementi di un inserzionista di Servizi locali, come il controllo dei precedenti, licenze aziendali e dati sulle assicurazioni aziendali. Eventuali documenti associati con licenza e assicurazione sono accessibili tramite un URL.
    • Enum:
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

Pianificazione

• Aggiunto il supporto per restituire Forecast.views e PlannedProductForecast.views per ReachPlanService.ListPlannableProducts per i tipi di prodotto applicabili.
• Supporto aggiunto per la restituzione PlannableTargeting.surface_targeting della ReachPlanService.ListPlannableProducts, che descrive le piattaforme disponibili per un prodotto.
• È stato aggiunto un nuovo elemento ReachPlanSurface enum.
• Aggiunto il supporto del targeting Target frequenza usando AdvancedProductTargeting.target_frequency_settings, che restituisce PlannedProductForecast.average_frequency.
• Aggiunta AudienceInsightsService.GenerateSuggestedTargetingInsights per restituire segmenti di pubblico suggeriti come target.
• Sono stati aggiunti i seguenti valori a ReachPlanError:
  • NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
  • NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED

Consigli

• Aggiunta RecommendationSubscriptionService che gestisce le sottoscrizioni ai suggerimenti:
  • Risorsa: RecommendationSubscription
  • Campo: MutateOperation.recommendation_subscription_operation
  • Enum: ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • Errori:
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• Sono stati aggiunti i seguenti tipi di consigli:
  • FORECASTING_SET_TARGET_CPA che consiglia di impostare un CPA target per le campagne che non ne hanno uno prima di un evento stagionale che si prevede aumenti per via del traffico.
  • SET_TARGET_CPA che consiglia di impostare un CPA target per le campagne che non ne hanno uno specificato.
  • SET_TARGET_ROAS che consiglia di impostare un ROAS target per le campagne che non ne hanno uno specificato.

Rapporti

• Sono state aggiunte le nuove metriche seguenti, su cui è possibile eseguire query campaign (disponibile per annunci display, video, discovery e campagne per app) e segments.device:
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

Shopping

• È stato rimosso ShoppingSetting.sales_country, i cui valori sono ora restituiti come ShoppingSetting.feed_label
  • Puoi continuare a utilizzare un account Merchant Center specifico feed di una campagna utilizzando il ShoppingSetting.feed_label . Deve essere impostato sul valore dell'etichetta del feed o sul paese di due lettere. codice usato in precedenza per ShoppingSetting.sales_country. Per ulteriori dettagli, consulta l'articolo di assistenza per i feed etichette.
• È stata rimossa la dipendenza delle categorie di prodotto da un codice paese nei report. L'insieme di ID categoria supportati non è cambiato.
  • Sono stati sostituiti i seguenti campi utilizzati in shopping_performance_view:
    • segments.product_bidding_category_level1 con segments.product_category_level1
    • segments.product_bidding_category_level2 con segments.product_category_level2
    • segments.product_bidding_category_level3 con segments.product_category_level3
    • segments.product_bidding_category_level4 con segments.product_category_level4
    • segments.product_bidding_category_level5 con segments.product_category_level5
  • product_bidding_category_constant sostituito con product_category_constant, che restituisce tutte le localizzazioni disponibili di una categoria in un campo ripetuto.
  • ListingDimensionInfo.product_bidding_category sostituito con ListingDimensionInfo.product_category
  • ListingGroupFilterDimension.product_bidding_category sostituito con ListingGroupFilterDimension.product_category
• Rimosso il supporto per l'aggiunta Campaign.shopping_setting per eseguire la ricerca campagne. Stai provando a creare una campagna sulla rete di ricerca con Campaign.shopping_setting o aggiungi Campaign.shopping_setting a un una campagna sulla rete di ricerca esistente ora si traduce OPERATION_NOT_PERMITTED_FOR_CONTEXT.
• Rimosso il supporto per l'aggiunta CampaignCriterion.listing_scope alle campagne sulla rete di ricerca. Tentativo di aggiungere CampaignCriterion.listing_scope a una campagna sulla rete di ricerca esistente ora si traduce OPERATION_NOT_PERMITTED_FOR_CONTEXT.
• Aggiunte le seguenti conversioni con carrello metriche:
  • 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
  • Tutte queste metriche sono selezionabili nei seguenti report:
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

Obiettivi unificati

• Aggiunta CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals per configurare gli obiettivi di acquisizione di clienti a livello di cliente.
  • Segnala: customer_lifecycle_goal
• Aggiunta CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals per configurare gli obiettivi di acquisizione di clienti a livello di campagna.
  • Segnala: campaign_lifecycle_goal
• Aggiunta CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
• Sono stati aggiunti i seguenti valori a ConversionGoalCampaignConfigError:
  • EMPTY_CONVERSION_GOALS
  • STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
  • PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES

Video

• Aggiunto il supporto per il targeting di Google TV a livello di campagna:
  • Aggiunta NetworkSettings.target_google_tv_network
  • Aggiunta AdNetworkType.GOOGLE_TV
• Aggiunto il supporto per il targeting di YouTube a livello di campagna:
  • Aggiunta NetworkSettings.target_youtube
  • In AdNetworkType, uniti YOUTUBE_WATCH e YOUTUBE_SEARCH in YOUTUBE.
  • Aggiunta CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE

Note di rilascio archiviate

Per consultare le note di rilascio archiviate, vedi Versioni ritirate.