Note di rilascio

v0 (9/11/2026)

Nuovi segmenti

Stiamo aggiungendo i seguenti segmenti:

v0 (2026-08-01)

Nuovi campi

Stiamo aggiungendo synthetic_content_info alle risorse ad e asset, insieme al messaggio SyntheticContentInfo di supporto e agli enum SyntheticContentAttestationStatus e SyntheticContentSource.

v0 (10/03/2026)

Nuovi segmenti

Stiamo aggiungendo i seguenti segmenti:

v0 (2025-12-05)

Nuove metriche

Le seguenti metriche sono ora disponibili quando esegui query sulla risorsa campaign:

Stiamo aggiungendo le seguenti metriche sulle conversioni con dati del carrello (CwCD):

Nuovi segmenti

Ora è possibile specificare la segmentazione per codice postale in una query. Per saperne di più, consulta segments.geo_target_postal_code.

v0 (2025-11-10)

Nuovi campi URL

Stiamo aggiungendo

Nuove metriche per UserLocationView

Le seguenti metriche sono ora disponibili quando esegui query sulla risorsa user_location_view:

Correzione del nome della risorsa

Il pattern del nome della risorsa per le seguenti risorse di etichette effettive è stato corretto in modo da utilizzare owner_customer_id per garantire che contenga l'ID cliente proprietario dell'etichetta:

  • CampaignEffectiveLabel
  • AdGroupEffectiveLabel
  • CriterionEffectiveLabel (in AdGroupCriterionEffectiveLabel)
  • AdGroupAdEffectiveLabel

Esempio: il pattern per CampaignEffectiveLabel è cambiato da customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id} a customers/{owner_customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}.

v0 (12/06/2025)

Questo aggiornamento include nuovi campi per la risorsa customer. Assicurati di aggiornare la libreria client per sfruttare tutte queste modifiche.

Nuovi campi

Stiamo aggiungendo

per facilitare l'esplorazione della gerarchia degli account Search Ads 360.

v0 (2025-01-21)

Questo aggiornamento include un nuovo parametro per configurare l'espansione del Centro clienti.

Espansione del Centro clienti

Quando esegui una query su un bidding_strategy, ora puoi impostare un valore booleano (enable_mcc_expansion) nella sezione PARAMETERS.

Quando questo parametro è attivato, nella risposta vengono restituiti i dati di tutti gli account nella gerarchia degli account con root in customer_id.

v0 (2024-11-08)

Questo aggiornamento include nuovi campi e nuove risorse. Assicurati di aggiornare la libreria client per usufruire di tutte queste modifiche.

Nuovi campi

Stiamo aggiungendo ad_group_ad.effective_labels e ad_group_criterion.effective_labels.

Le etichette effettive sono etichette ereditate o assegnate direttamente.

Nuove risorse

Vista Località dell'utente

Se lo utilizzi con i segmenti geografici, puoi ottenere metriche relative a regione, area metropolitana e città.

Consulta i dettagli della risorsa user_location_view.

In relazione ai nuovi campi effective_labels, sono disponibili due nuove risorse che conservano i metadati dell'associazione tra le etichette effettive e ad_group_ad (ad_group_ad_effective_label) o ad_group_criterion (ad_group_criterion_effective_label).

v0 (2024-10-07)

Questo aggiornamento include nuove metriche, risorse, campi e alcune nuove definizioni di mappatura. Assicurati di aggiornare la libreria client per usufruire di tutte queste modifiche.

Metriche aggiunte

cross_device_conversions_by_conversion_date e cross_device_conversions_value_by_conversion_date sono compatibili con queste risorse: ad_group_ad, ad_group_audience_view, ad_group, bidding_strategy, campaign, customer, campaign_audience_view, keyword_view e shopping_performance_view.

Mappature dei campi ridefinite

Le mappature dei campi per dfaActions, dfaActionsCrossEnv, dfaRevenue, dfaRevenueCrossEnv, dfaTransactions, dfaTransactionsCrossEnv sono cambiate per alcuni report legacy.

Campo In passato Nuova definizione
dfaActions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaActionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date
dfaRevenue metrics.all_conversions_value - metrics.cross_device_conversions_value metrics.all_conversions_value_by_conversion_date - metrics.cross_device_conversions_value_by_conversion_date
dfaRevenueCrossEnv metrics.all_conversions_value metrics.all_conversions_value_by_conversion_date
dfaTransactions metrics.all_conversions - metrics.cross_device_conversions metrics.all_conversions_by_conversion_date - metrics.cross_device_conversions_by_conversion_date
dfaTransactionsCrossEnv metrics.all_conversions metrics.all_conversions_by_conversion_date

Elenco dei report legacy che hanno modificato la mappatura dei campi

Nuovi campi

Stiamo aggiungendo campaign.effective_labels e ad_group.effective_labels.

Le etichette effettive sono etichette ereditate o assegnate direttamente.

Nuove risorse

In relazione ai nuovi campi effective_labels, le nuove risorse conservano i metadati dell'associazione tra le etichette effettive e la campagna (campaign_effective_label) o l'ad_group (ad_group_effective_label).

v0 (23/08/2024)

In questo aggiornamento, i metadati delle colonne personalizzate aggiungono il campo renderType.

Consulta i dettagli di CustomColumnRenderType.

È stato aggiunto un nuovo campo owner_customer_id alle risorse campaign_label, ad_group_label, ad_group_ad_label e ad_group_criterion_label.

Assicurati di aggiornare la libreria client per usufruire di questi nuovi campi.

v0 (2024-08-01)

Questo aggiornamento include la segmentazione oraria e diversi nuovi campi

Segmentazione oraria

Ora è possibile specificare la segmentazione oraria in una query. Per saperne di più, consulta segments.hour.

Per saperne di più, consulta customer_manager_link.start_time

Aggiunto MULTIMEDIA_AD a ad_group_ad.ad.type

Ora è possibile selezionare metriche e segmenti con il tipo MULTIMEDIA_AD. L'esecuzione di query su attributi specifici per i contenuti multimediali non è supportata in questa versione.

Aggiunto il tipo di campagna SOCIAL a campaign.advertising_channel_type e il sottotipo SOCIAL_FACEBOOK_TRACKING_ONLY a campaign.advertising_channel_sub_type

Ora è possibile selezionare metriche e segmenti con il tipo di campagna SOCIAL e il sottotipo SOCIAL_FACEBOOK_TRACKING_ONLY. L'esecuzione di query su attributi specifici di SOCIAL o SOCIAL_FACEBOOK_TRACKING_ONLY non è supportata in questa versione.

Aggiunto il supporto per average_quality_score

Visualizza altri dettagli nelle metriche

v0 (18/04/2024)

Questo aggiornamento include la risorsa Accessible Bidding Strategy

Strategia di offerta accessibile

Rappresenta una visualizzazione di BiddingStrategies di proprietà del cliente e condivisa con quest'ultimo. A differenza di BiddingStrategy, questa risorsa include le strategie di proprietà degli amministratori del cliente e condivise con questo cliente, oltre alle strategie di proprietà di questo cliente. Questa risorsa non fornisce metriche ed espone solo un sottoinsieme limitato di attributi BiddingStrategy.

Consulta i dettagli della risorsa accessible_bidding_strategy.

v0 (12/02/2024)

Questo aggiornamento include l'accesso alle colonne personalizzate e alle variabili Floodlight personalizzate

Colonne personalizzate

Ora è possibile specificare le colonne conversioni personalizzate e le colonne formula personalizzate in una query. Per saperne di più, consulta la documentazione sulle colonne personalizzate.

Variabili Floodlight personalizzate

Ora è possibile specificare le variabili Floodlight personalizzate in una query per le statistiche successive al 30/01/2024. Per saperne di più, consulta la documentazione sulle variabili Floodlight personalizzate.

v0 (2023-11-09)

Questo aggiornamento include le seguenti risorse. Visita i link per visualizzare i campi su cui è possibile eseguire query per queste risorse, nonché le metriche e le segmentazioni che possono essere utilizzate con queste risorse.

Gruppo di asset

Visualizza i dettagli della risorsa asset_group.

Asset del gruppo di asset

Consulta i dettagli della risorsa asset_group_asset.

Filtro del gruppo di schede in un gruppo di asset

Consulta i dettagli della risorsa asset_group_listing_group_filter.

Indicatore del gruppo di asset

Consulta i dettagli della risorsa asset_group_signal.

Visualizzazione delle combinazioni principali del gruppo di asset

Consulta i dettagli della risorsa asset_group_top_combination_view.

Visualizzazione delle vendite dei dati del carrello

Consulta i dettagli della risorsa cart_data_sales_view.

Conversione

Consulta i dettagli della risorsa conversion.

Visualizzazione del rendimento di Shopping

Consulta i dettagli della risorsa shopping_performance_view.

Visita

Consulta i dettagli della risorsa visit.

v0 (15/08/2023)

Questo aggiornamento include le seguenti risorse e un nuovo parametro per configurare la conversione di valuta per le metriche.

Visita i link per visualizzare i campi su cui è possibile eseguire query per queste risorse, nonché le metriche e le segmentazioni che possono essere utilizzate con queste risorse.

Asset del gruppo di annunci

Consulta i dettagli della risorsa ad_group_asset.

Insieme di asset del gruppo di annunci

Consulta i dettagli della risorsa ad_group_asset_set.

Asset

Consulta i dettagli della risorsa asset.

Insieme di asset

Visualizza i dettagli dell'insieme di asset asset_set.

Asset dell'insieme di asset

Consulta i dettagli della risorsa asset_set_asset.

Asset della campagna

Consulta i dettagli della risorsa campaign_asset.

Insieme di asset della campagna

Consulta i dettagli della risorsa campaign_asset_set.

Asset del cliente

Consulta i dettagli della risorsa customer_asset.

Insieme di asset del cliente

Consulta i dettagli della risorsa customer_asset_set.

Conversione di valute

È possibile specificare la valuta per il calcolo delle metriche utilizzando metrics_currency nella sezione PARAMETERS.

Elenca i clienti accessibili

Elenca tutti gli account accessibili utilizzando il metodo ListAccessibleCustomers.

v0 (15/05/2023)

Questo aggiornamento include la seguente risorsa. Visita i link per visualizzare i campi su cui è possibile eseguire query per questa risorsa, nonché le metriche e le segmentazioni che possono essere utilizzate con questa risorsa.

Annuncio del gruppo di annunci

Consulta i dettagli della risorsa ad_group_ad.

v0 (2023-04-06)

Questo aggiornamento include le seguenti risorse. Visita i link per visualizzare i campi su cui è possibile eseguire query per ogni risorsa, nonché le metriche e le segmentazioni che possono essere utilizzate con la risorsa.

Visualizzazione del segmento di pubblico del gruppo di annunci

Consulta i dettagli della risorsa ad_group_audience_view.

Etichetta criterio del gruppo di annunci

Consulta i dettagli della risorsa ad_group_criterion_label.

Etichetta gruppo di annunci

Consulta i dettagli della risorsa ad_group_label.

Visualizzazione della fascia d'età

Consulta i dettagli della risorsa age_range_view.

Criterio campagna

Consulta i dettagli della risorsa campaign_criterion.

Etichetta campagna

Visualizza i dettagli della risorsa campaign_label

Visualizzazione dei termini di ricerca degli annunci dinamici della rete di ricerca

Consulta i dettagli della risorsa dynamic_search_ads_search_term_view.

Visualizzazione di pagina web

Consulta i dettagli della risorsa webpage_view.

Etichetta

Consulta i dettagli della risorsa etichetta.

v0 (2022-12-05)

La versione v0 include le seguenti risorse e i seguenti servizi. Visita i link per visualizzare i campi su cui è possibile eseguire query per ogni risorsa, nonché le metriche e le segmentazioni che possono essere utilizzate con la risorsa.

Gruppo di annunci

Consulta i dettagli della risorsa ad_group.

Offerte

Consulta i dettagli della risorsa bidding_strategy.

Campagne

Consulta i dettagli della risorsa campaign.

Azione di conversione

Consulta i dettagli della risorsa conversion_action.

Cliente

Consulta i dettagli della risorsa customer.

Parola chiave

Consulta i dettagli della risorsa keyword_view.

Product Group

Consulta i dettagli della risorsa product_group_view.

SearchAds360FieldService

  • SearchAds360FieldService fornisce un catalogo di tutti i campi su cui è possibile eseguire query. I metadati di questi campi includono descrizioni, tipi e compatibilità con altri campi. Scopri di più.

SearchAds360Service

  • SearchAds360Service è destinato al recupero di più risorse in una singola query. Le risorse su cui è possibile eseguire query includono:

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • Le metriche come impressioni e clic possono essere recuperate anche utilizzando SearchAds360Service per queste risorse:

    • AdGroup
    • BiddingStrategy
    • Campaign
    • ConversionAction
    • Customer
    • Keyword
    • ProductGroup

  • SearchAds360Service consente la segmentazione in base ai campi, ad esempio i campi data. Scopri di più.