Note di rilascio

v0 (10/11/2025)

Nuovi campi URL

Stiamo aggiungendo

Nuove metriche per UserLocationView

Ora sono disponibili le seguenti metriche quando esegui query sulla risorsa user_location_view:

Correzione del nome della risorsa

Il pattern del nome risorsa per le seguenti risorse di etichette effettive è stato corretto per 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 tutti questi cambiamenti.

Nuovi campi

Stiamo aggiungendo

per facilitare l'attraversamento 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 MCC

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 di account con radice in customer_id.

v0 (08/11/2024)

Questo aggiornamento include nuovi campi e nuove risorse. Assicurati di aggiornare la libreria client per sfruttare tutti questi cambiamenti.

Nuovi campi

Stiamo aggiungendo ad_group_ad.effective_labels e ad_group_criterion.effective_labels.

Le etichette effettive sono quelle ereditate o assegnate direttamente.

Nuove risorse

Visualizzazione della posizione 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, esistono due nuove risorse che conservano i metadati dell'associazione tra le etichette effettive e l'annuncio del gruppo di annunci (ad_group_ad_effective_label) o il criterio del gruppo di annunci (ad_group_criterion_effective_label).

v0 (07/10/2024)

Questo aggiornamento include nuove metriche, risorse, campi e alcune nuove definizioni di mapping. Assicurati di aggiornare la libreria client per sfruttare al meglio 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 campi ridefinite

I mapping dei campi per dfaActions, dfaActionsCrossEnv, dfaRevenue, dfaRevenueCrossEnv, dfaTransactions, dfaTransactionsCrossEnv sono cambiati 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 campi

Nuovi campi

Stiamo aggiungendo campaign.effective_labels e ad_group.effective_labels.

Le etichette effettive sono quelle 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 il gruppo di annunci (ad_group_effective_label).

v0 (23/08/2024)

In questo aggiornamento, i metadati della colonna personalizzata 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 sfruttare questi nuovi campi.

v0 (01/08/2024)

Questo aggiornamento include la segmentazione oraria e diversi nuovi campi

Segmentazione oraria

Ora è possibile specificare la segmentazione oraria in una query. Visualizza maggiori dettagli in segments.hour.

Visualizza maggiori dettagli in customer_manager_link.start_time

Aggiunta di MULTIMEDIA_AD a ad_group_ad.ad.type

Ora è possibile selezionare metriche e segmenti con il tipo MULTIMEDIA_AD. L'interrogazione di 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'interrogazione di attributi specifici SOCIAL o SOCIAL_FACEBOOK_TRACKING_ONLY non è supportata in questa versione.

Aggiunto il supporto per average_quality_score

Per ulteriori dettagli, consulta le metriche.

v0 (18/04/2024)

Questo aggiornamento include la risorsa Strategia di offerta accessibile

Strategia di offerta accessibile

Rappresenta una visualizzazione delle strategie di offerta di proprietà del cliente e condivise con lui. 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 degli attributi BiddingStrategy.

Consulta i dettagli della risorsa accessible_bidding_strategy.

v0 (12/02/2024)

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

Colonne personalizzate

Ora le colonne conversioni personalizzate e le colonne formula personalizzate possono essere specificate in una query. Per ulteriori dettagli, consulta la documentazione relativa alle colonne personalizzate.

Variabili Floodlight personalizzate

Ora le variabili Floodlight personalizzate possono essere specificate in una query per le statistiche successive al 30/01/2024. Per ulteriori dettagli, consulta la documentazione sulle variabili Floodlight personalizzate.

v0 (09/11/2023)

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

Gruppo di asset

Visualizza i dettagli della risorsa asset_group.

Asset del gruppo di asset

Consulta i dettagli della risorsa asset_group_asset.

Filtro dell'elenco di gruppo degli asset

Visualizza i dettagli della risorsa asset_group_listing_group_filter.

Indicatore del gruppo di asset

Consulta i dettagli della risorsa asset_group_signal.

Visualizzazione della combinazione principale del gruppo di asset

Consulta i dettagli della risorsa asset_group_top_combination_view.

Visualizzazione vendite dei dati del carrello

Consulta i dettagli della risorsa cart_data_sales_view.

Conversione

Visualizza i dettagli della risorsa conversione.

Visualizzazione del rendimento di Shopping

Visualizza i dettagli della risorsa shopping_performance_view.

Visita

Consulta i dettagli della risorsa visita.

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 e le metriche e le segmentazioni che possono essere utilizzate.

Asset del gruppo di annunci

Visualizza i dettagli della risorsa ad_group_asset.

Set di asset del gruppo di annunci

Visualizza i dettagli della risorsa ad_group_asset_set.

Asset

Visualizza i dettagli delle risorse asset.

Set di asset

Consulta i dettagli della risorsa asset_set.

Asset dell'insieme

Visualizza i dettagli della risorsa asset_set_asset.

Asset della campagna

Visualizza i dettagli della risorsa campaign_asset.

Set di asset della campagna

Visualizza i dettagli della risorsa campaign_asset_set.

Asset del cliente

Visualizza i dettagli della risorsa customer_asset.

Set di asset del cliente

Visualizza 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 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 che possono essere interrogati per questa risorsa e le metriche e le segmentazioni che possono essere utilizzate.

Annuncio del gruppo di annunci

Visualizza i dettagli della risorsa ad_group_ad.

v0 (06/04/2023)

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 quella 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 pagina web

Visualizza 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 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 quella risorsa.

Gruppo di annunci

Consulta i dettagli della risorsa ad_group.

Offerte

Consulta i dettagli della risorsa bidding_strategy.

Campagne

Visualizza i dettagli delle risorse della campagna.

Azione di conversione

Visualizza i dettagli della risorsa conversion_action.

Cliente

Visualizza i dettagli della risorsa cliente.

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 è pensato per recuperare più risorse in una singola query. Le risorse su cui è possibile eseguire query includono:

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

  • È possibile recuperare anche le metriche, come impressioni e clic, utilizzando SearchAds360Service per queste risorse:

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

  • SearchAds360Service consente la segmentazione per campi, come i campi data. Scopri di più.