Questa pagina è stata tradotta dall'API Cloud Translation.

Note di rilascio

Versione 16 (21/02/2024)

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

Gestione dell'account

È stata eseguita la migrazione di advertising_partner da AccountLink a ProductLink e ProductLinkInvitation.
data_partner e google_ads rimossi da AccountLink.
È stato aggiunto IdentityVerificationService per gestire la verifica dell'inserzionista.
- StartIdentityVerification() viene utilizzato per avviare una sessione di verifica con l'elemento verification_program fornito. Crea una nuova sessione di verifica e restituisce una risposta vuota per una verifica creata correttamente.
  - Aggiunto IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION.
- GetIdentityVerification() può essere utilizzato per recuperare le informazioni di verifica, che restituisce diversi oggetti di IdentityVerification. Ogni 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 che contiene dettagli relativi alla sessione di verifica, tra cui:
    - program_status rappresenta lo stato corrente 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
Aggiunto AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT.

Asset

Modifiche a asset_group:
- Aggiunto il supporto per segmenti correlati al tempo, come segments.year e segments.month.
- Imposta campaign come risorsa attribuita anziché segmentare le risorse.

Campagne

Modifiche alle campagne Demand Gen:
- Aggiunto il supporto per l'impostazione di Campaign.shopping_setting a una campagna Demand Gen esistente.
- Aggiunto ShoppingSetting.disable_product_feed per disattivare il feed dei prodotti facoltativo delle campagne Demand Gen.
- Aggiunti Ad.demand_gen_product_ad e il corrispondente DemandGenProductAdInfo, disponibili per le campagne Demand Gen con un valore non null Campaign.shopping_setting.
Aggiunto ai seguenti campi a AdGroup per mostrare se il gruppo di annunci è pubblicato o i motivi per cui non viene pubblicato:
- primary_status
- primary_status_reasons
Aggiunto ai seguenti campi a AdGroupAd per mostrare 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

È stato aggiunto Experiment.sync_enabled per specificare se attivare la sincronizzazione nell'esperimento. Con la sincronizzazione attivata, le modifiche apportate alla campagna originale mentre l'esperimento è in esecuzione vengono copiate automaticamente nella campagna sperimentale.
Aggiunto ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE.
Aggiunto CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL.

Hotel e viaggi

Sono stati aggiunti i seguenti campi a ListingDimensionInfo per un annuncio di Cose da fare per consentire la creazione di gruppi di schede in base allo stato e alla città in cui è disponibile l'attività di viaggio:
- activity_state
- activity_city
Aggiunto il supporto per i seguenti segmenti a travel_activity_performance_view:

Servizi locali

Sono stati aggiunti LocalServicesVerificationArtifact.business_registration_check_verification_artifact e BusinessRegistrationCheckArtifact per consentire agli inserzionisti di monitorare l'avanzamento della procedura di verifica della registrazione dell'attività.
È 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.

Suggerimenti

È stato aggiunto RecommendationService.GenerateRecommendations() che restituisce consigli in base alle impostazioni specificate, come i tipi di consigli e i tipi di canali pubblicitari. Ciò è particolarmente utile durante la creazione delle campagne.
Aggiunto RecommendationMetrics.conversions_value.
Per le parole chiave consigliate con tipo di corrispondenza delle parole chiave non impostato è ora impostato il valore recommended_match_type su UNSPECIFIED anziché su UNKNOWN.
Sono stati aggiunti i seguenti tipi di consigli:
- MAXIMIZE_CONVERSION_VALUE_OPT_IN che consiglia di attivare la strategia di offerta Massimizza il valore di conversione
- 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 le campagne Performance Max.
- REFRESH_CUSTOMER_MATCH_LIST che consiglia di aggiornare un elenco di clienti che non è stato aggiornato negli 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 a livello di campagna o di cliente
- IMPROVE_DEMAND_GEN_AD_STRENGTH che consiglia di migliorare l'efficacia dell'annuncio nelle campagne Demand Gen

Shopping

Sono stati aggiunti CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT e CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS per fornire errori più dettagliati per le campagne Shopping collegate a un account Comparison Shopping Service Center.
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

È stato aggiunto update a CustomerLifecycleGoalOperation e CampaignLifecycleGoalOperation per rendere coerenti questi tipi di operazioni con gli altri tipi di operazioni nell'API.

Versione 15 (18/10/2023)

Nella versione 15 sono state introdotte le nuove funzionalità e gli aggiornamenti indicati di seguito.

Gestione dell'account

Se il tuo account è stato sospeso a causa di attività non autorizzate, customer.status e customer_client.status ora vengono restituiti come SUSPENDED. In precedenza, venivano restituiti come ENABLED.
Aggiunto il supporto per l'aggiunta e la rimozione di un collegamento tra un account Google Ads e un account Merchant Center:
- Aggiunti ProductLink.merchant_center e MerchantCenterIdentifier.
- Aggiunto LinkedProductType.MERCHANT_CENTER.
Sono stati aggiunti ProductLinkInvitationService e ProductLinkInvitation per supportare l'aggiornamento di un invito al collegamento inviato da altri prodotti, disponibile per gli account Hotel Center e Merchant Center.
MerchantCenterLinkService rimosso.
- Per collegare gli account Google Ads con gli account Merchant Center, utilizza ProductLinkInvitationService e ProductLinkService.
Rimozione di AccountLink.hotel_center e assistenza per l'aggiornamento degli inviti al collegamento dagli account Hotel Center utilizzando AccountLinkService.
- Per aggiornare un invito al collegamento da un account Hotel Center, utilizza ProductLinkInvitationService.

Asset

È stato sostituito ImageAdInfo.media_file con ImageAdInfo.image_asset per supportare l'aggiunta e la rimozione di immagini utilizzando gli asset. Di conseguenza, abbiamo rimosso anche MediaFileService, che non è più necessario.
Aggiunto ListingGroupFilterDimension.webpage per supportare la creazione di un filtro per il gruppo di schede in base a etichette personalizzate e sottostringhe degli URL.
- È stato sostituito anche AssetGroupListingGroupFilter.vertical con AssetGroupListingGroupFilter.listing_source e ListingGroupFilterListingSource
È stato aggiunto asset_group_asset.source per mostrare l'origine dell'asset del gruppo di asset.
Aggiunto ad_group_ad_asset_view.source per mostrare l'origine dell'asset annuncio del gruppo di annunci.

Segmenti di pubblico

Per Customer Match, è stato aggiunto CustomerMatchUserListMetadata.consent per supportare la fornitura di un consenso. A partire dal 6 marzo 2024, se il consenso manca per gli utenti del SEE, il valore del consenso viene determinato come se il consenso non fosse stato fornito. I dati degli utenti nel SEE senza consenso non verranno trattati e non potranno essere utilizzati per la personalizzazione degli annunci tramite Customer Match. Per ulteriori dettagli, consulta la nostra guida di Customer Match.
Per le vendite in negozio, è stato aggiunto UserData.consent per supportare la fornitura di un consenso. Per ulteriori dettagli, consulta la nostra guida alle vendite in negozio. Se utilizzi Customer Match con le vendite in negozio, consulta le Domande frequenti per ulteriori informazioni.
È stato aggiunto UserList.lookalike_user_list per supportare la creazione di un segmento simile, ovvero un segmento di pubblico creato in base al pubblico di origine esistente fornito. I segmenti simili possono essere utilizzati solo 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 il targeting migliorato:
  - AssetGroupSignal.audience
    - Sono stati aggiunti Audience.scope e Audience.asset_group per limitare l'utilizzo del pubblico a un gruppo di asset specifico. Audience.asset_group deve essere impostato se e solo se Audience.scope è ASSET_GROUP.
  - AssetGroupSignal.search_theme
    - È stato aggiunto CriterionType.SEARCH_THEME per supportare questo nuovo tipo di criterio. Questo nuovo tipo di criterio può essere utilizzato solo nelle campagne Performance Max per creare un AssetGroupSignal completando il AssetGroupSignal.search_theme con un criterio SearchThemeInfo.
- È stato aggiunto AssetGroupSignalOperation.exempt_policy_violation_keys per supportare la richiesta di esenzione durante l'aggiunta di indicatori sui 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.
- In PerformanceMaxUpgradeStatus, il nome UPGRADE_ELIGIBLE è stato cambiato in UPGRADE_ELIGIBLE.
Per le campagne Demand Gen e discovery CPA target, le simulazioni di offerte basate su CPA target a livello di campagna (campaign_simulation.target_cpa_point_list.points) restituiscono ora TargetCpaSimulationPoint.interactions anziché TargetCpaSimulationPoint.clicks.
È stato aggiunto l'elemento BrandSuggestionService che può suggerire brand in base al prefisso del brand fornito e all'elenco di brand esclusi. Questi brand possono essere utilizzati per creare un criterio BRAND, aggiunto a un set condiviso BRANDS e poi associati a una campagna creando un CampaignCriterion con brand_list impostato sul set condiviso. I criteri delle campagne possono essere scelti come target rispettivamente nelle campagne sulla rete di ricerca ed esclusi nelle campagne Performance Max.
- Campi:
  - SharedCriterion.brand
  - CampaignCriterion.brand_list
- Enum:
  - SharedSetType.BRANDS
  - CriterionType.BRAND_LIST
Aggiunto Campaign.asset_automation_settings[] per mostrare lo stato dell'automazione di ogni tipo di asset.
Sono stati aggiunti i seguenti valori all'enumerazione CampaignPrimaryStatusReason:
- NO_ASSET_GROUPS
- ASSET_GROUPS_PAUSED

Conversioni

Sono stati aggiunti CallConversion.consent e ClickConversion.consent per supportare la fornitura di un consenso. Per ulteriori dettagli, consulta la nostra guida alle conversioni di chiamata e la guida alle conversioni dei clic.
Sono stati aggiunti i seguenti campi relativi alle conversioni di SKAdNetwork, disponibili quando esegui query su queste conversioni con customer o campaign:
- Segmenti:
- Metriche:
  - metrics.sk_ad_network_total_conversions
  - metrics.sk_ad_network_installs
metrics.sk_ad_network_conversions sostituito con metrics.sk_ad_network_installs.
Aggiunto il supporto per diagnosticare il caricamento delle conversioni offline
- Elemento offline_conversion_upload_client_summary spostato da un campo nella risorsa customer a un report di primo livello. Utilizza questo report per ottenere dettagli utili sullo stato di caricamento delle conversioni, come il conteggio degli eventi riusciti, la percentuale di successo e la percentuale di errori.
  - Avvertimento: una conversione che viene caricata ma genera un errore ConversionUploadError.CLICK_NOT_FOUND viene comunque conteggiata come riuscita, ma viene anche contrassegnata come OfflineConversionAlert.
- job_id aggiunto come parametro facoltativo per i seguenti tipi di richieste, in modo da poter raggruppare logicamente più richieste di caricamento in un unico job concettuale:
  - UploadConversionAdjustmentsRequest
  - UploadClickConversionsRequest
- L'elemento INVALID_JOB_ID è stato aggiunto ai seguenti errori:
  - ConversionAdjustmentUploadError
  - ConversionUploadError
- INVALID_CONVERSION_ACTION sostituito con NO_CONVERSION_ACTION_FOUND e INVALID_CONVERSION_ACTION_TYPE nei seguenti errori:
  - ConversionAdjustmentUploadError
  - ConversionUploadError
Sono stati aggiunti tre report per supportare l'attribuzione su più reti di Privacy Sandbox di Android senza reindirizzamenti:
- android_privacy_shared_key_google_campaign che contiene shared_campaign_key e alcuni campi utili per codificare la chiave.
- android_privacy_shared_key_google_ad_group che contiene shared_ad_group_key e alcuni campi utili per codificare la chiave.
- android_privacy_shared_key_google_network_type che contiene shared_network_type_key e alcuni campi utili per codificare la chiave.
Aggiunto ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS. Un ConversionActionOperation che tenta di utilizzare uno dei modelli di attribuzione basata su regole deprecati ora non riesce e genera questo errore. In precedenza, l'operazione non riusciva con un errore UNKNOWN.

Hotel e viaggi

Aggiunto il supporto per i seguenti campi in travel_activity_group_view e travel_activity_performance_view:
- Segmenti:
- Metriche:

Annunci di Servizi locali

Sono stati aggiunti LocalServicesSettings e i relativi campi al report customer per restituire gli stati di assicurazione e di licenza granulari di un inserzionista di Servizi locali.
Sono stati aggiunti i seguenti nuovi report per i Servizi locali:
- local_services_lead contiene tutti i dettagli relativi ai lead di annunci di Servizi locali, come lead_charged, lead_type e lead_status.
  - Enum:
    - LeadStatus
    - LeadType
- local_services_lead_conversation contiene dettagli del messaggio e della conversazione telefonica, come conversation_channel, call_duration_millis, call_recording_url.
  - L'URL di registrazione delle chiamate è autenticato rispetto all'account del cliente di destinazione e ai relativi account amministratore.
- local_services_verification_artifact restituisce gli elementi di un inserzionista di Servizi locali, come il controllo dei precedenti, le licenze aziendali e i dati assicurativi aziendali. È possibile accedere a tutti i documenti associati alla licenza e all'assicurazione tramite un URL.
  - Enum:

Pianificazione

È stata aggiunta l'assistenza per restituire Forecast.views e PlannedProductForecast.views per ReachPlanService.ListPlannableProducts per i tipi di prodotto applicabili.
È stato aggiunto il supporto per restituire PlannableTargeting.surface_targeting per ReachPlanService.ListPlannableProducts, che descrive le piattaforme disponibili per un prodotto.
È stata aggiunta una nuova enumerazione ReachPlanSurface.
Aggiunto il supporto per il targeting della frequenza target utilizzando AdvancedProductTargeting.target_frequency_settings, che restituisce PlannedProductForecast.average_frequency.
Aggiunto AudienceInsightsService.GenerateSuggestedTargetingInsights per restituire segmenti di pubblico disponibili per il targeting suggeriti.
Sono stati aggiunti i seguenti valori a ReachPlanError:
- NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
- NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED

Suggerimenti

Aggiunta di RecommendationSubscriptionService che gestisce le iscrizioni ai consigli:
- 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 specificato uno, prima di un evento stagionale per cui si prevede un aumento del traffico.
- SET_TARGET_CPA che consiglia di impostare un CPA target per le campagne per le quali non è stato specificato un CPA.
- SET_TARGET_ROAS che consiglia di impostare un ROAS target per le campagne che non ne hanno specificato uno.

Report

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

Shopping

È stato rimosso ShoppingSetting.sales_country, i cui valori ora vengono restituiti come ShoppingSetting.feed_label.
- Puoi continuare a utilizzare un feed di Merchant Center specifico per una campagna, utilizzando il campo ShoppingSetting.feed_label. Deve essere impostato sul valore dell'etichetta del feed o sul codice paese di due lettere usato in precedenza per ShoppingSetting.sales_country. Per ulteriori dettagli, consulta l'articolo del Centro assistenza per le etichette dei feed.
È 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
- È stato sostituito product_bidding_category_constant 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.
È stato rimosso il supporto per l'aggiunta di Campaign.shopping_setting alle campagne sulla rete di ricerca. Se provi a creare una campagna sulla rete di ricerca con Campaign.shopping_setting o ad aggiungere Campaign.shopping_setting a una campagna sulla rete di ricerca esistente, ora il risultato sarà OPERATION_NOT_PERMITTED_FOR_CONTEXT.
Rimosso il supporto per l'aggiunta di CampaignCriterion.listing_scope alle campagne sulla rete di ricerca. Se provi ad aggiungere CampaignCriterion.listing_scope a una campagna sulla rete di ricerca esistente, ora generi OPERATION_NOT_PERMITTED_FOR_CONTEXT.
Sono state aggiunte le seguenti metriche relative alle conversioni con dati del carrello:

Obiettivi unificati

Aggiunto CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals per la configurazione degli obiettivi di acquisizione clienti a livello di cliente.
- Segnala: customer_lifecycle_goal
Aggiunto CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals per la configurazione degli obiettivi di acquisizione dei clienti a livello di campagna.
- Segnala: campaign_lifecycle_goal
Aggiunto 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:
- Aggiunto NetworkSettings.target_google_tv_network
- Aggiunto AdNetworkType.GOOGLE_TV.
Aggiunto il supporto per il targeting di YouTube a livello di campagna:
- Aggiunto NetworkSettings.target_youtube
- In AdNetworkType, sono state unite YOUTUBE_WATCH e YOUTUBE_SEARCH in YOUTUBE.
- Aggiunto CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE.

v14.1.0 (9/08/2023)

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

Gestione dell'account

Customer.customer_agreement_setting che indica se il cliente ha accettato i Termini di servizio del modulo per i lead

Asset

Nuovi campi in AssetGroup per mostrare se il gruppo di asset viene pubblicato o i motivi per cui non viene pubblicato:
- primary_status
- primary_status_reasons
Nuovi campi in AssetGroupAsset per mostrare se l'asset del gruppo di asset è pubblicato o i motivi per cui non viene pubblicato:
- primary_status
- primary_status_details
- primary_status_reasons
Nuovi valori nell'enum di CallToActionType:
- BUY_NOW
- DONATE_NOW
- ORDER_NOW
- PLAY_NOW
- SEE_MORE
- START_NOW
- VISIT_SITE
- WATCH_NOW
Nuovi valori nell'enumerazione AssetLinkError:
- CUSTOMER_NOT_VERIFIED
- UNSUPPORTED_CALL_TO_ACTION
- PAGE_FEED_INVALID_LABEL_TEXT

Fatturazione

Nuovi campi in Invoice e AccountSummary:
- export_charge_subtotal_amount_micros
- export_charge_tax_amount_micros
- export_charge_total_amount_micros

Campagne

Nuovi valori nell'enumerazione di CampaignPrimaryStatusReason:
- HAS_ASSET_GROUPS_DISAPPROVED
- HAS_ASSET_GROUPS_LIMITED_BY_POLICY
- MOST_ASSET_GROUPS_UNDER_REVIEW
(Solo account inclusi nella lista consentita) DiscoveryCampaignSettings con upgraded_targeting:
- Se il criterio upgraded_targeting è impostato su true, puoi aggiungere una località e una lingua come criterio del gruppo di annunci

Criteri

Nuovo valore di enum: CriterionError.INVALID_DETAILED_DEMOGRAPHIC
(Solo account inclusi nella lista consentita) Supporto per l'aggiunta di LanguageInfo e LocationInfo come AdGroupCriterion:
- Questa opzione è disponibile solo per una campagna discovery in cui è stato attivato il targeting aggiornato

Esperimenti

Nuovi valori nell'enumerazione ExperimentError:
- DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
- CANNOT_REMOVE_IN_CREATION_EXPERIMENT
- CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES

Suggerimenti

Nuovi tipi di consigli:
- PerformanceMaxOptInRecommendation che consiglia di creare la prima campagna Performance Max nell'account.
- ImprovePerformanceMaxAdStrengthRecommendation che consiglia di migliorare l'efficacia del gruppo di asset di una campagna Performance Max
- MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation che consiglia di eseguire la migrazione a Performance Max di una campagna di annunci dinamici della rete di ricerca

Report

Nuove metriche e nuovi segmenti relativi ai clienti nuovi e di ritorno:
Nuove visualizzazioni customer_search_term_insight e campaign_search_term_insight :
- metrics.search_volume mostra l'intervallo di volume per una categoria di insight sui termini di ricerca

Shopping

Nuovi campi per i gruppi di schede:
- ListingGroupInfo.path
- AssetGroupListingGroupFilter.path
Nuovo campo: ShoppingSetting.advertising_partner_ids
Nuovi valori nell'enumerazione CampaignError:
- NOT_LINKED_ADVERTISING_PARTNER
- INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS

Video

(Solo account inclusi nella lista consentita) AdType.DISCOVERY_VIDEO_RESPONSIVE_AD e i corrispondenti DiscoveryVideoResponsiveAdInfo

Versione 14 (7/06/2023)

Nella versione 14 sono state introdotte le nuove funzionalità e gli aggiornamenti indicati di seguito.

Campagne

Hai aggiunto CampaignBudgetError.BUDGET_AMOUNT_MUST_BE_UNSET_FOR_CUSTOM_BUDGET_PERIOD

Conversioni

Aggiunto il supporto per identificare le conversioni di Google Analytics e determinare se una conversione è importata da una proprietà Universal Analytics o GA4:
- Sono stati aggiunti i seguenti valori a ConversionActionType:
  - UNIVERSAL_ANALYTICS_GOAL
  - UNIVERSAL_ANALYTICS_TRANSACTION
  - GOOGLE_ANALYTICS_4_CUSTOM
  - GOOGLE_ANALYTICS_4_PURCHASE
- Hai aggiunto ConversionAction.google_analytics_4_settings
È stato aggiunto Customer.offline_conversion_client_summaries, che riassume lo stato e le informazioni diagnostiche relativi ai caricamenti e agli aggiustamenti delle conversioni offline del cliente.
- Enum
  - OfflineEventUploadClient:
    - GOOGLE_ADS_API
    - GOOGLE_ADS_WEB_CLIENT
    - ADS_DATA_CONNECTOR
  - OfflineConversionDiagnosticStatus:
    - EXCELLENT
    - GOOD
    - NEEDS_ATTENTION
    - NO_RECENT_UPLOAD
È stato aggiunto job_id alle risposte restituite da ConversionAdjustmentUploadService.UploadConversionAdjustments e ConversionUploadService.UploadClickConversions per associare una risposta a un OfflineConversionUploadSummary.job_id.

Criteri

Aggiunto il supporto per il recupero, la creazione e l'aggiornamento delle parole chiave escluse a livello di account:
- Campi:
  - CustomerNegativeCriterion.negative_keyword_list
- Enum:
  - CriterionType.NEGATIVE_KEYWORD_LIST
  - SharedSetType.ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
  - ResourceLimitType
    - SHARED_SETS_PER_ACCOUNT_FOR_ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
    - ACCOUNT_LEVEL_NEGATIVE_KEYWORDS_PER_SHARED_SET
- Errori:
  - CriterionError
    - NEGATIVE_KEYWORD_SHARED_SET_DOES_NOT_EXIST
    - CANNOT_ADD_REMOVED_NEGATIVE_KEYWORD_SHARED_SET
    - CANNOT_HAVE_MULTIPLE_NEGATIVE_KEYWORD_LIST_PER_ACCOUNT
    - CUSTOMER_CANNOT_ADD_CRITERION_OF_THIS_TYPE
Hai aggiunto CriterionError.CANNOT_TARGET_SIMILAR_USER_LIST

Hotel Ads

Rinominato SuggestTravelAssetsRequest.place_id in SuggestTravelAssetsRequest.place_ids

Pianificazione

I seguenti metodi sono stati rimossi da KeywordPlanService:
- GenerateForecastCurve
- GenerateForecastMetrics
- GenerateForecastTimeSeries
- GenerateHistoricalMetrics
È stato aggiunto KeywordPlanIdeaService.GenerateKeywordForecastMetrics per supportare la generazione di metriche di previsione delle campagne basate su parole chiave senza dover prima creare un piano per le parole chiave.
Rimosso il supporto per il recupero del report campaign_criterion_simulation
Aggiunto il supporto per YOUTUBE_DYNAMIC_LINEUP come dimensione in AudienceInsightsService.ListAudienceInsightsAttributes.
Aggiunto DynamicLineupAttributeMetadata.sample_channels, utilizzato nelle risposte GenerateAudienceCompositionInsights per fornire canali di esempio nelle selezioni.

Suggerimenti

È stato aggiunto DynamicImageExtensionOptInRecommendation che consiglia di attivare le estensioni immagine dinamiche nell'account
È stato aggiunto LowerTargetRoasRecommendation che consiglia di ridurre il ROAS target
È stato aggiunto RaiseTargetCpaRecommendation che consiglia di aumentare il CPA target
Hai aggiunto ResponsiveSearchAdAssetRecommendation.current_ad

Report

Sono stati aggiunti i seguenti valori a ServedAssetFieldType, disponibili su ad_group_ad_asset_view.pinned_field:
- SITELINK
- CALL
- MOBILE_APP
- CALLOUT
- STRUCTURED_SNIPPET
- PRICE
- PROMOTION
- AD_IMAGE
- LEAD_FORM
- BUSINESS_LOGO

Note di rilascio archiviate

Consulta Versioni obsolete per le note di rilascio archiviate.