Note di rilascio

v0 (2026-08-01)

Nuovi campi

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

v0 (2026-03-10)

Nuovi segmenti

Stiamo aggiungendo i seguenti segmenti:

v0 (2025-12-05)

Nuove metriche

Le seguenti metriche sono ora disponibili quando si esegue una query sulla campaign risorsa:

Stiamo aggiungendo le seguenti metriche di conversione con dati del carrello (CwCD):

Nuovi segmenti

Ora è possibile specificare la segmentazione per codice postale in una query. Per maggiori dettagli, 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 si esegue una 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 per utilizzare owner_customer_id per assicurarsi 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 (2025-06-12)

Questo aggiornamento include nuovi campi per la risorsa cliente. 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 MCC.

Espansione MCC

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

Quando questo parametro è abilitato, nella risposta vengono restituiti i dati di tutti gli account nella gerarchia degli account con customer_id come radice.

v0 (2024-11-08)

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 etichette ereditate o assegnate direttamente.

Nuove risorse

Visualizzazione della località dell'utente

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

Consulta i dettagli della risorsa user_location_view.

Per quanto riguarda i nuovi campi effective_labels, esistono 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 mapping. Assicurati di aggiornare la libreria client per sfruttare tutti questi cambiamenti.

Metriche aggiunte

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

Mapping dei campi ridefiniti

I mapping dei campi per dfaActions, dfaActionsCrossEnv, dfaRevenue, dfaRevenueCrossEnv, dfaTransactions, dfaTransactionsCrossEnv sono cambiati per alcuni report precedenti.

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 precedenti per cui è stato modificato il mapping 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

Per quanto riguarda i 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 (2024-08-23)

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 (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 maggiori dettagli, consulta segments.hour.

Per maggiori dettagli, consulta customer_manager_link.start_time

Aggiunta di MULTIMEDIA_AD a ad_group_ad.ad.type

Metriche e segmenti possono ora essere selezionati con il tipo MULTIMEDIA_AD. In questa versione non è supportata l'esecuzione di query sugli attributi specifici dei contenuti multimediali.

Aggiunta del tipo di campagna SOCIAL a campaign.advertising_channel_type e del sottotipo SOCIAL_FACEBOOK_TRACKING_ONLY a campaign.advertising_channel_sub_type

Metriche e segmenti ora possono essere selezionati con il tipo di campagna SOCIAL e il sottotipo SOCIAL_FACEBOOK_TRACKING_ONLY. In questa versione non è supportata l'esecuzione di query sugli attributi specifici di SOCIAL o SOCIAL_FACEBOOK_TRACKING_ONLY.

Aggiunta del supporto per average_quality_score

Per maggiori dettagli, consulta le metriche

v0 (2024-04-18)

Questo aggiornamento include la risorsa Accessible Bidding Strategy

Strategia di offerta accessibile

Rappresenta una visualizzazione delle strategie di offerta di proprietà del cliente e condivise con il cliente. A differenza di BiddingStrategy, questa risorsa include le strategie di proprietà dei gestori 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 (2024-02-12)

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

Colonne personalizzate

Ora è possibile specificare le colonne di conversione personalizzate e le colonne di formula personalizzate in una query. Per maggiori dettagli, consulta la documentazione relativa alle colonne personalizzate.

Variabili Floodlight personalizzate

Ora è possibile specificare le variabili Floodlight personalizzate in una query per le statistiche successive al 30/01/2024. Per maggiori dettagli, consulta la documentazione relativa alle 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

Consulta 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

Consulta i dettagli della risorsa asset_group_listing_group_filter.

Segnale 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 con 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 (2023-08-15)

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.

Set di asset del gruppo di annunci

Consulta i dettagli della risorsa ad_group_asset_set.

Asset

Consulta i dettagli della risorsa asset.

Set di asset

Consulta i dettagli della risorsa asset_set.

Asset del set di asset

Consulta i dettagli della risorsa asset_set_asset.

Asset della campagna

Consulta i dettagli della risorsa campaign_asset.

Set di asset della campagna

Consulta i dettagli della risorsa campaign_asset_set.

Asset del cliente

Consulta i dettagli della risorsa customer_asset.

Set 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.

Elenco dei clienti accessibili

Elenca tutti gli account accessibili utilizzando il metodo ListAccessibleCustomers

v0 (2023-05-15)

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

Visualizzazione del pubblico del gruppo di annunci

Consulta i dettagli della risorsa ad_group_audience_view.

Etichetta del criterio del gruppo di annunci

Consulta i dettagli della risorsa ad_group_criterion_label.

Etichetta del gruppo di annunci

Consulta i dettagli della risorsa ad_group_label.

Visualizzazione della fascia di età

Consulta i dettagli della risorsa age_range_view.

Criterio campagna

Consulta i dettagli della risorsa campaign_criterion.

Etichetta campagna

Consulta 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 della pagina web

Consulta i dettagli della risorsa webpage_view.

Etichetta

Consulta i dettagli della risorsa label.

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 quella 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 è progettato per recuperare più risorse in un'unica query. Le risorse su cui è possibile eseguire query includono:

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

  • 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 per campi, ad esempio i campi data. Scopri di più.