Trasferimenti dei rapporti di Search Ads 360

Il connettore BigQuery Data Transfer Service per Search Ads 360 consente di pianificare e gestire automaticamente i job di caricamento ricorrenti per i dati dei report di Search Ads 360.

Report supportati

BigQuery Data Transfer Service per Search Ads 360 supporta la versione 0 dell'API di reporting di Search Ads 360:

Per informazioni su come i report di Search Ads 360 vengono trasformati in tabelle e visualizzazioni di BigQuery Data Transfer Service, consulta Trasformazioni dei report di Search Ads 360.

Opzione di segnalazione Assistenza
Versione dell'API supportata

v0
Frequenza di ripetizione

Giornalmente, al momento della prima creazione del trasferimento dei dati (valore predefinito)

Puoi configurare l'ora del giorno.
Aggiorna finestra

Ultimi 7 giorni (valore predefinito)

Configurabile fino a 30 giorni

Gli snapshot delle tabelle delle corrispondenze vengono acquisiti una volta al giorno e archiviati nella partizione relativa alla data dell'ultima esecuzione. Gli snapshot della tabella delle corrispondenze non vengono aggiornati per i backfill o per i giorni caricati utilizzando la finestra di aggiornamento.
Durata massima del backfill

Nessun limite
Numero di ID cliente per account amministratore

2000

BigQuery Data Transfer Service supporta un massimo di 2000 ID cliente per ogni account amministratore Search Ads 360.

Per consultare la guida al trasferimento di Search Ads 360 che utilizza la precedente API Search Ads 360 Reporting, consulta Trasferimenti di Search Ads 360 (non più supportati).

Importazione dei dati dai trasferimenti di Search Ads 360

Quando trasferisci i dati da Search Ads 360 a BigQuery, questi vengono caricati nelle tabelle BigQuery partizionate per data. La partizione della tabella in cui vengono caricati i dati corrisponde alla data dell'origine dati. Se pianifichi più trasferimenti per la stessa data, BigQuery Data Transfer Service sovrascrive la partizione per quella data specifica con i dati più recenti. Più trasferimenti nello stesso giorno o l'esecuzione di backfill non generano dati duplicati e le partizioni per altre date non sono interessate.

Aggiornare le finestre

Una finestra di aggiornamento è il numero di giorni per i quali un trasferimento di dati recupera i dati quando si verifica un trasferimento di dati. Ad esempio, se la finestra di aggiornamento è di tre giorni e si verifica un trasferimento giornaliero, BigQuery Data Transfer Service recupera tutti i dati dalla tabella di origine degli ultimi tre giorni. In questo esempio, quando si verifica un trasferimento giornaliero, BigQuery Data Transfer Service crea una nuova partizione della tabella di destinazione BigQuery con una copia dei dati della tabella di origine del giorno corrente, quindi attiva automaticamente le esecuzioni di backfill per aggiornare le partizioni della tabella di destinazione BigQuery con i dati della tabella di origine degli ultimi due giorni. Le esecuzioni di backfill attivate automaticamente sovrascrivono o aggiornano in modo incrementale la tabella di destinazione BigQuery, a seconda che gli aggiornamenti incrementali siano supportati o meno nel connettore BigQuery Data Transfer Service.

Quando esegui un trasferimento dati per la prima volta, vengono recuperati tutti i dati di origine disponibili all'interno della finestra di aggiornamento. Ad esempio, se la finestra di aggiornamento è di tre giorni ed esegui il trasferimento dei dati per la prima volta, BigQuery Data Transfer Service recupera tutti i dati di origine entro tre giorni.

Le finestre di aggiornamento sono mappate al campo dell'API TransferConfig.data_refresh_window_days.

Per recuperare i dati al di fuori della finestra di aggiornamento, ad esempio i dati storici, o per recuperare i dati da eventuali interruzioni o lacune del trasferimento, puoi avviare o pianificare una esecuzione di backfill.

Limitazioni

  • La frequenza massima con cui puoi configurare un trasferimento di dati di Search Ads 360 è una volta ogni 24 ore. Per impostazione predefinita, un trasferimento inizia al momento della sua creazione. Tuttavia, puoi configurare l'ora di inizio del trasferimento dei dati quando crei il trasferimento.
  • BigQuery Data Transfer Service non supporta i trasferimenti incrementali dei dati durante un trasferimento di Search Ads 360. Quando specifichi una data per un trasferimento di dati, vengono trasferiti tutti i dati disponibili per quella data.

Prima di iniziare

Prima di creare un trasferimento di dati di Search Ads 360:

Autorizzazioni obbligatorie

Assicurati che l'utente che crea il trasferimento di dati disponga delle seguenti autorizzazioni obbligatorie:

  • BigQuery Data Transfer Service:

    • bigquery.transfers.update per creare il trasferimento di dati.
    • Entrambe le autorizzazioni bigquery.datasets.get e bigquery.datasets.update sul set di dati di destinazione.

    Il ruolo IAM predefinito bigquery.admin include le autorizzazioni bigquery.transfers.update, bigquery.datasets.update e bigquery.datasets.get. Per saperne di più sui ruoli IAM in BigQuery Data Transfer Service, consulta Controllo dell'accesso.

  • Google Cloud:

    • serviceusage.services.use per scaricare i dati da Search Ads 360 sul progetto.

    I ruoli IAM predefiniti editor, owner e serviceusage.serviceUsageConsumer includono le autorizzazioni serviceusage.services.use. Per ulteriori informazioni sui ruoli IAM in Service Usage, consulta la documentazione di riferimento sul controllo dell'accesso.

  • Search Ads 360:

    • Accesso in lettura all'ID cliente o all'account amministratore Search Ads 360 utilizzato nella configurazione del trasferimento.

Creare un trasferimento di dati di Search Ads 360

Per creare un trasferimento di dati per i report di Search Ads 360, devi disporre del tuo ID cliente o dell'account amministratore Search Ads 360. Seleziona una delle seguenti opzioni:

Console

  1. Vai alla pagina Trasferimenti dati nella console Google Cloud.

    Vai a Trasferimenti dati

  2. Fai clic su Crea trasferimento.

  3. Nella sezione Tipo di origine, per Origine, scegli Search Ads 360.

  4. Nella sezione Nome configurazione di trasferimento, in Nome visualizzato, inserisci un nome per il trasferimento dei dati, ad esempio My Transfer. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.

  5. Nella sezione Opzioni di programmazione:

    • Per Frequenza di ripetizione, scegli un'opzione per la frequenza con cui eseguire il trasferimento di dati. Se selezioni Giorni, specifica un'ora valida in UTC.
      • Ore
      • Giorni
      • On demand
    • Se applicabile, seleziona Inizia ora o Inizia all'ora impostata e fornisci una data di inizio e un'ora di esecuzione.

  6. Nella sezione Impostazioni di destinazione, per Set di dati, seleziona il set di dati che hai creato per archiviare i dati.

    1. Nella sezione Dettagli dell'origine dati:

    2. In ID cliente, inserisci il tuo ID cliente Search Ads 360:

    3. (Facoltativo) Inserisci sia un ID agenzia sia un ID inserzionista per recuperare le tabelle di mappatura degli ID.

    4. (Facoltativo) Nel campo Variabili Floodlight personalizzate, inserisci eventuali variabili Floodlight personalizzate da includere nel trasferimento dei dati. Le variabili Floodlight personalizzate devono essere di proprietà dell'account Search Ads 360 specificato dall'ID cliente nella configurazione del trasferimento. Questo parametro accetta input di stringhe in formato array JSON e può supportare più variabili Floodlight personalizzate. In ogni elemento dell'array JSON, sono obbligatori i seguenti parametri:

      • id: l'ID numerico della variabile Floodlight personalizzata. Questo ID viene assegnato quando viene creata una variabile Floodlight personalizzata in Search Ads 360. Se hai specificato un id, un name non è obbligatorio.
      • name: il nome definito dall'utente delle variabili Floodlight personalizzate in Search Ads 360. Se hai specificato un name, un id non è obbligatorio.
      • cfv_field_name: il nome esatto del campo della variabile Floodlight personalizzata in base al caso d'uso. I valori supportati sono conversion_custom_metrics, conversion_custom_dimensions, raw_event_conversion_metrics e raw_event_conversion_dimensions.
      • destination_table_name: un elenco di tabelle BigQuery in cui includere le variabili Floodlight personalizzate. Quando BigQuery Data Transfer Service recupera i dati per queste tabelle, il trasferimento include le variabili Floodlight personalizzate nella query.

      • bigquery_column_name_suffix: il nome della colonna facile da usare definito dall'utente. BigQuery Data Transfer Service aggiunge il suffisso dopo il nome del campo standard per differenziare le diverse variabili Floodlight personalizzate. A seconda del caso d'uso, BigQuery Data Transfer Service genera un nome di colonna BigQuery come segue:

        Variabili Floodlight personalizzate come metriche e segmenti Variabili Floodlight personalizzate come attributi evento non elaborati nella risorsa di conversione
        metrics metrics_conversion_custom_metrics_bigquery_column_name_suffix metrics_raw_event_conversion_metrics_bigquery_column_name_suffix
        dimension segments_conversion_custom_dimensions_bigquery_column_name_suffix segments_raw_event_conversion_dimensions_bigquery_column_name_suffix

      Di seguito è riportato un esempio di voce Variabile Floodlight personalizzata che specifica due variabili Floodlight personalizzate:

      [{
  "id": "1234",
  "cfv_field_name": "raw_event_conversion_metrics",
  "destination_table_name": ["Conversion"],
  "bigquery_column_name_suffix": "suffix1"
},{
  "name": "example name",
  "cfv_field_name": "conversion_custom_metrics",
  "destination_table_name": ["AdGroupConversionActionAndDeviceStats","CampaignConversionActionAndDeviceStats"],
  "bigquery_column_name_suffix": "suffix2"
}]

    5. (Facoltativo) Nel campo Colonne personalizzate, inserisci eventuali colonne personalizzate da includere nel trasferimento dei dati. Le colonne personalizzate devono essere di proprietà dell'account Search Ads 360 specificato dall'ID cliente nella configurazione del trasferimento. Questo campo accetta input di stringhe in formato array JSON e può supportare più colonne. In ogni elemento dell'array JSON sono obbligatori i seguenti parametri:

      • id: l'ID numerico della colonna personalizzata. Questo ID viene assegnato quando viene creata una colonna personalizzata. Se hai specificato un id, un name non è obbligatorio.
      • name: il nome definito dall'utente della colonna personalizzata in Search Ads 360. Se hai specificato un name, un id non è obbligatorio.
      • destination_table_name: un elenco di tabelle BigQuery in cui includere la colonna personalizzata. Quando BigQuery Data Transfer Service recupera i dati per queste tabelle, il trasferimento include il campo della colonna personalizzata nella query.
      • bigquery_column_name: il nome della colonna facile da usare definito dall'utente. Si tratta del nome del campo della colonna personalizzata nelle tabelle di destinazione specificate in destination_table_name. Il nome della colonna deve rispettare i requisiti di formato per i nomi delle colonne BigQuery e deve essere univoco rispetto agli altri campi nello schema standard della tabella o in altre colonne personalizzate.

      Di seguito è riportato un esempio di voce Colonne personalizzate che specifica due colonne personalizzate:

        [{
    "id": "1234",
    "destination_table_name": ["Conversion"],
    "bigquery_column_name": "column1"
  },{
    "name": "example name",
    "destination_table_name": ["AdGroupStats","CampaignStats"],
    "bigquery_column_name": "column2"
  }]

    6. (Facoltativo) Nel campo Filtro tabella, inserisci un elenco di tabelle da includere separato da virgole, ad esempio Campaign, AdGroup. Prefissa questo elenco con il carattere - per escludere determinate tabelle, ad esempio -Campaign, AdGroup. Per impostazione predefinita, sono incluse tutte le tabelle.

    7. (Facoltativo) Per Finestra di aggiornamento, inserisci un valore compreso tra 1 e 30. Se non viene impostato, la finestra di aggiornamento predefinita è di 7 giorni.

  7. Nel menu Account di servizio, seleziona un account di servizio tra quelli associati al tuo progetto Google Cloud. Puoi associare un account di servizio al trasferimento anziché utilizzare le credenziali utente. Per ulteriori informazioni sull'utilizzo degli account di servizio con i trasferimenti di dati, consulta Utilizzare gli account di servizio.

    • Se hai eseguito l'accesso con un'identità federata, è necessario un account di servizio per creare un trasferimento. Se hai eseguito l'accesso con un Account Google, un account di servizio per il trasferimento è facoltativo.
    • L'account di servizio deve disporre delle autorizzazioni richieste.

  8. (Facoltativo) Nella sezione Opzioni di notifica:

    • Fai clic sul pulsante di attivazione/disattivazione per attivare le notifiche via email. Se attivi questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un'esecuzione del trasferimento non va a buon fine.

    • Fai clic sul pulsante di attivazione/disattivazione per attivare le notifiche Pub/Sub. In Seleziona un argomento Cloud Pub/Sub, scegli il nome dell'argomento o fai clic su Crea un argomento. Questa opzione configura le notifiche di esecuzione di Pub/Sub per il trasferimento.

  9. Fai clic su Salva.

bq

Inserisci il comando bq mk e specifica il flag di creazione del trasferimento: --transfer_config. Sono obbligatori anche i seguenti flag:

  • --data_source
  • --target_dataset
  • --display_name
  • --params

I seguenti flag sono facoltativi:

  • --project_id: specifica il progetto da utilizzare. Se il flag non viene specificato, viene utilizzato il progetto predefinito.
  • --service_account_name: specifica un account di servizio da utilizzare per l'autenticazione del trasferimento di Search Ads 360 anziché il tuo account utente.
bq mk \
--transfer_config \
--project_id=PROJECT_ID \
--target_dataset=DATASET \
--display_name=NAME \
--data_source=DATA_SOURCE \
--service_account_name=SERVICE_ACCOUNT_NAME \
--params='{PARAMETERS,"custom_columns":"[{\"id\": \"CC_ID\",\"destination_table_name\": [\"CC_DESTINATION_TABLE\"],\"bigquery_column_name\": \"CC_COLUMN\"}]","custom_floodlight_variables":"[{\"id\": \"CFV_ID\",\"cfv_field_name\": [\"CFV_FIELD_NAME\"],\"destination_table_name\": [\"CFV_DESTINATION_TABLE\"],\"bigquery_column_name_suffix\": \"CFV_COLUMN_SUFFIX\"}]"}'

Dove:

  • PROJECT_ID (Facoltativo): specifica il progetto da utilizzare. Se il flag non viene specificato, viene utilizzato il progetto predefinito.
  • DATASET: il set di dati di destinazione per la configurazione del trasferimento.

  • NAME: il nome visualizzato per la configurazione del trasferimento. Il nome del trasferimento di dati può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.

  • DATA_SOURCE: l'origine dati search_ads.

  • SERVICE_ACCOUNT_NAME (Facoltativo): il nome dell'account di servizio utilizzato per autenticare il trasferimento di dati. L'account di servizio deve essere di proprietà dello stesso project_id utilizzato per creare il trasferimento e deve disporre di tutte le autorizzazioni richieste.

  • PARAMETERS: i parametri per la configurazione del trasferimento creata in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Devi fornire il parametro customer_id.

    • table_filter: specifica le tabelle da includere nel trasferimento dei dati. Se il flag non viene specificato, vengono incluse tutte le tabelle. Per includere solo determinate tabelle, utilizza un elenco di valori separati da virgole (ad es. Ad, Campaign, AdGroup). Per escludere tabelle specifiche, anteponi ai valori esclusi un trattino (-) (ad es. l'utilizzo di -Ad, Campaign, AdGroup esclude tutti e tre i valori).
    • custom_columns: specifica le colonne personalizzate per i report. Questo parametro accetta input di stringhe in formato array JSON e può supportare più colonne. In ogni elemento dell'array JSON sono obbligatori i seguenti parametri:
      • CC_ID: l'ID numerico della colonna personalizzata. Questo ID viene assegnato quando viene creata una colonna personalizzata.
      • CC_DESTINATION_TABLE: un elenco di tabelle BigQuery in cui includere la colonna personalizzata. Quando BigQuery Data Transfer Service recupera i dati per queste tabelle, il trasferimento dei dati include il campo della colonna personalizzata nella query.
      • CC_COLUMN: il nome della colonna facile da usare definito dall'utente. Si tratta del nome del campo della colonna personalizzata nelle tabelle di destinazione specificate in destination_table_name. Il nome della colonna deve rispettare i requisiti di formato per i nomi delle colonne BigQuery e deve essere univoco rispetto ad altri campi nello schema standard della tabella o in altre colonne personalizzate.
    • custom_floodlight_variables: specifica le variabili Floodlight personalizzate nel trasferimento. Questo parametro accetta input di stringhe in formato array JSON e può supportare più variabili Floodlight personalizzate. In ogni elemento dell'array JSON sono obbligatori i seguenti parametri:
      • CFV_ID: l'ID numerico della variabile Floodlight personalizzata. Questo ID viene assegnato quando viene creata una variabile Floodlight personalizzata in Search Ads 360.
      • CFV_FIELD_NAME: il nome esatto del campo della variabile Floodlight personalizzata in base al caso d'uso. I valori supportati sono conversion_custom_metrics, conversion_custom_dimensions, raw_event_conversion_metrics e raw_event_conversion_dimensions. Per ulteriori informazioni, consulta Metriche Floodlight personalizzate.
      • CFV_DESTINATION_TABLE: un elenco di tabelle BigQuery in cui includere le variabili di Floodlight personalizzate. Quando BigQuery Data Transfer Service recupera i dati per queste tabelle, il trasferimento dei dati include le variabili Floodlight personalizzate nella query.
      • CFV_COLUMN_SUFFIX: il nome della colonna facile da usare definito dall'utente. BigQuery Data Transfer Service aggiunge il suffisso dopo il nome del campo standard per distinguere le diverse variabili Floodlight personalizzate. A seconda del caso d'uso, BigQuery Data Transfer Service genera un nome di colonna BigQuery come segue:
    Variabili Floodlight personalizzate come metriche e segmenti Variabili Floodlight personalizzate come attributi evento non elaborati nella risorsa di conversione
    metrics metrics_conversion_custom_metrics_bigquery_column_name_suffix metrics_raw_event_conversion_metrics_bigquery_column_name_suffix
    dimension segments_conversion_custom_dimensions_bigquery_column_name_suffix segments_raw_event_conversion_dimensions_bigquery_column_name_suffix

Ad esempio, il seguente comando crea un trasferimento di dati di Search Ads 360 denominato My Transfer utilizzando l'ID cliente 6828088731 e il set di dati di destinazione mydataset. Il trasferimento specifica anche una variabile Floodlight personalizzata. Il trasferimento dei dati viene creato nel progetto predefinito:

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--data_source=search_ads \
--params='{"customer_id":"6828088731", "custom_floodlight_variables":"[{\"id\": \"9876\", \"cfv_field_name\": \"raw_event_conversion_metrics\", \"destination_table_name\": [\"Conversion\"],\"bigquery_column_name_suffix\": \"suffix1\" }]"}'

La prima volta che esegui il comando, ricevi un messaggio simile al seguente:

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

Segui le istruzioni nel messaggio e incolla il codice di autenticazione nella riga di comando.

API

Utilizza il metodo projects.locations.transferConfigs.create e fornisci un'istanza della risorsa TransferConfig.

Attivare manualmente un trasferimento di Search Ads 360

Quando attivi manualmente un trasferimento per Search Ads 360, gli snapshot delle tabelle delle corrispondenze vengono acquisiti una volta al giorno e archiviati nella partizione per la data dell'ultima esecuzione. Quando attivi un trasferimento manuale, gli snapshot di Match Table per le seguenti tabelle non vengono aggiornati:

  • Account
  • Annuncio
  • AdGroup
  • AdGroupCriterion
  • Qualsiasi tabella di mappatura degli ID
  • Asset
  • BidStrategy
  • Campagna
  • CampaignCriterion
  • ConversionAction
  • Parola chiave
  • NegativeAdGroupKeyword
  • NegativeAdGroupCriterion
  • NegativeCampaignKeyword
  • NegativeCampaignCriterion
  • ProductGroup

Supporto per gli account amministratore Search Ads 360

L'utilizzo degli account amministratore Search Ads 360 offre diversi vantaggi rispetto all'utilizzo di singoli ID cliente:

  • Non è necessario gestire più trasferimenti di dati per generare report su più ID cliente.
  • Le query tra clienti sono più semplici da scrivere perché tutti gli ID cliente sono memorizzati nella stessa tabella.
  • L'utilizzo degli account amministratore riduce i problemi relativi alla quota di caricamento di BigQuery Data Transfer Service perché più ID cliente vengono caricati nello stesso job.

Per i clienti esistenti che hanno più trasferimenti di dati di Search Ads 360 specifici per ID cliente, consigliamo di passare a un account amministratore Search Ads 360. Per farlo, segui questi passaggi:

  1. Configura un singolo trasferimento dei dati di Search Ads 360 a livello di account amministratore o amministratore secondario.
  2. Pianifica un backfill.
  3. Disattiva i singoli trasferimenti di Search Ads 360 specifici per ID cliente.

Per saperne di più sugli account amministratore di Search Ads 360, consulta Informazioni sugli account amministratore nel nuovo Search Ads 360 e Scopri come gli account sono collegati al tuo account amministratore.

Esempio

Il seguente elenco mostra gli ID cliente collegati a determinati account amministratore Search Ads 360:

  • 1234567890 - account amministratore principale
    • 1234 - account amministratore secondario
      • 1111 - ID cliente
      • 2222 - ID cliente
      • 3333 - ID cliente
      • 4444 - ID cliente
      • 567 - account amministratore secondario
        • 5555 - ID cliente
        • 6666 - ID cliente
        • 7777 - ID cliente
    • 89 - account amministratore secondario
      • 8888 - ID cliente
      • 9999 - ID cliente
    • 0000 - ID cliente

Ogni ID cliente collegato a un account amministratore viene visualizzato in ogni report. Per ulteriori informazioni sulla struttura dei report di Search Ads 360 in BigQuery Data Transfer Service, consulta Trasformazione dei report di Search Ads 360.

Trasferisci la configurazione per l'ID cliente 1234567890

Una configurazione di trasferimento per l'account amministratore principale (ID cliente 1234567890) genera esecuzioni di trasferimento dati che includono i seguenti ID cliente:

  • 1111 (tramite l'account amministratore secondario 1234)
  • 2222 (tramite l'account amministratore secondario 1234)
  • 3333 (tramite l'account amministratore secondario 1234)
  • 4444 (tramite l'account amministratore secondario 1234)
  • 5555 (tramite l'account amministratore secondario 567 e l'account amministratore secondario 1234)
  • 6666 (tramite l'account amministratore secondario 567 e l'account amministratore secondario 1234)
  • 7777 (tramite l'account amministratore secondario 567 e l'account amministratore secondario 1234)
  • 8888 (tramite l'account amministratore secondario 89)
  • 9999 (tramite l'account amministratore secondario 89)
  • 0000 (ID cliente individuale)

Trasferisci la configurazione per l'ID cliente 1234

Una configurazione di trasferimento per l'account amministratore secondario 123 (ID cliente 1234) genera esecuzioni di trasferimento dei dati che includono i seguenti ID cliente:

  • 1111
  • 2222
  • 3333
  • 4444
  • 5555 (tramite l'account amministratore secondario 567)
  • 6666 (tramite l'account amministratore secondario 567)
  • 7777 (tramite l'account amministratore secondario 567)

Configurazione del trasferimento per l'ID cliente 567

Una configurazione di trasferimento per l'account amministratore secondario 567 (ID cliente 567) genera esecuzioni di trasferimento dei dati che includono i seguenti ID cliente:

  • 5555
  • 6666
  • 7777

Trasferisci la configurazione per l'ID cliente 89

Una configurazione di trasferimento per l'account amministratore secondario 89 (ID cliente 89) genera esecuzioni di trasferimento dei dati che includono i seguenti ID cliente:

  • 8888
  • 9999

Configurazione del trasferimento per l'ID cliente 0000

Una configurazione di trasferimento per l'ID cliente 0000 genera esecuzioni di trasferimento di dati che includono solo il singolo ID cliente:

  • 0000

Esegui query sui dati

Quando vengono trasferiti a BigQuery Data Transfer Service, i tuoi dati vengono scritti in tabelle partizionate per data di importazione. Per ulteriori informazioni, consulta Introduzione alle tabelle partizionate.

Se esegui query direttamente sulle tabelle anziché utilizzare le viste generate automaticamente, devi utilizzare la pseudocolonna _PARTITIONTIME nella query. Per ulteriori informazioni, consulta Esecuzione di query sulle tabelle partizionate.

Query di esempio di Search Ads 360

Puoi utilizzare le seguenti query di esempio di Search Ads 360 per analizzare i dati trasferiti. Puoi anche visualizzare le query in uno strumento di visualizzazione come Looker Studio.

Le seguenti query sono esempi per iniziare a eseguire query sui dati di Search Ads 360 con BigQuery Data Transfer Service. Per ulteriori domande su cosa puoi fare con questi report, contatta il tuo rappresentante tecnico di Search Ads 360.

Se esegui query direttamente sulle tabelle anziché utilizzare le viste generate automaticamente, devi utilizzare la pseudocolonna _PARTITIONTIME nella query. Per ulteriori informazioni, consulta Esecuzione di query sulle tabelle partizionate.

Rendimento delle campagne

La seguente query di esempio analizza il rendimento delle campagne Search Ads 360 negli ultimi 30 giorni.

SELECT
  c.customer_id,
  c.campaign_name,
  c.campaign_status,
  SUM(cs.metrics_clicks) AS Clicks,
  (SUM(cs.metrics_cost_micros) / 1000000) AS Cost,
  SUM(cs.metrics_impressions) AS Impressions
FROM
  `DATASET.sa_Campaign_CUSTOMER_ID` c
LEFT JOIN
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
ON
  (c.campaign_id = cs.campaign_id
  AND cs._DATA_DATE BETWEEN
  DATE_ADD(CURRENT_DATE(), INTERVAL -31 DAY) AND DATE_ADD(CURRENT_DATE(), INTERVAL -1 DAY))
WHERE
  c._DATA_DATE = c._LATEST_DATE
GROUP BY
  1, 2, 3
ORDER BY
  Impressions DESC

Sostituisci quanto segue:

  • DATASET: il nome del set di dati
  • CUSTOMER_ID: l'ID cliente Search Ads 360

Conteggio delle parole chiave

La seguente query di esempio analizza le parole chiave per campagna, gruppo di annunci e stato.

  SELECT
    c.campaign_status AS CampaignStatus,
    a.ad_group_status AS AdGroupStatus,
    k.ad_group_criterion_status AS KeywordStatus,
    k.ad_group_criterion_keyword_match_type AS KeywordMatchType,
    COUNT(*) AS count
  FROM
    `DATASET.sa_Keyword_CUSTOMER_ID` k
    JOIN
    `DATASET.sa_Campaign_CUSTOMER_ID` c
  ON
    (k.campaign_id = c.campaign_id AND k._DATA_DATE = c._DATA_DATE)
  JOIN
    `DATASET.sa_AdGroup_CUSTOMER_ID` a
  ON
    (k.ad_group_id = a.ad_group_id AND k._DATA_DATE = a._DATA_DATE)
  WHERE
    k._DATA_DATE = k._LATEST_DATE
  GROUP BY
    1, 2, 3, 4

Sostituisci quanto segue:

  • DATASET: il nome del set di dati
  • CUSTOMER_ID: l'ID cliente Search Ads 360

Tabelle di mappatura degli ID

Le entità nel nuovo Search Ads 360, come clienti, campagne e gruppi di annunci, hanno un spazio ID diverso rispetto al precedente Search Ads 360. Gli utenti esistenti di Search Ads 360 che vogliono combinare i dati della precedente esperienza con la nuova API Search Ads 360 possono utilizzare BigQuery Data Transfer Service per trasferire le tabelle di mappatura degli ID se forniscono un ID agenzia e un ID inserzionista validi nella configurazione del trasferimento.

Le entità supportate contengono due colonne, legacy_id e new_id, che specificano la mappatura degli ID per le entità rispettivamente nella versione precedente e in quella nuova di Search Ads 360. Per le entità AD, CAMPAIGN_CRITERION e CRITERION viene fornito anche un valore new_secondary_id, poiché queste entità non hanno ID univoci a livello globale nel nuovo Search Ads 360. Di seguito è riportato un elenco di tabelle di mappatura degli ID.

  • IdMapping_AD
  • IdMapping_AD_GROUP
  • IdMapping_CAMPAIGN
  • IdMapping_CAMPAIGN_CRITERION
  • IdMapping_CAMPAIGN_GROUP
  • IdMapping_CAMPAIGN_GROUP_PERFORMANCE_TARGET
  • IdMapping_CRITERION
  • IdMapping_CUSTOMER
  • IdMapping_FEED_ITEM
  • IdMapping_FEED_TABLE

Esempi di query

La seguente query utilizza le tabelle di mappatura degli ID per aggregare le metriche per campagna tra le tabelle dei trasferimenti di dati del nuovo e del precedente Search Ads 360 nel nuovo spazio ID.

SELECT CustomerID, CampaignID, Sum(Clicks), Sum(Cost) FROM
(SELECT
  cs.customer_id AS CustomerID,
  cs.campaign_id AS CampaignID,
  cs.metrics_clicks AS Clicks,
  cs.metrics_cost_micros / 1000000 AS Cost
FROM
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
WHERE cs._DATA_DATE = 'NEW_DATA_DATE'
UNION ALL
SELECT
  customer_id_mapping.new_id AS CustomerID,
  campaign_id_mapping.new_id AS CampaignID,
  cs.clicks AS Clicks,
  cs.cost AS Cost
FROM
  `DATASET.CampaignStats_ADVERTISER_ID` cs
LEFT JOIN
  `DATASET.IdMapping_CUSTOMER_ADVERTISER_ID` customer_id_mapping
ON cs.accountId = customer_id_mapping.legacy_id
LEFT JOIN
  `DATASET.IdMapping_CAMPAIGN_ADVERTISER_ID` campaign_id_mapping
ON cs.campaignId = campaign_id_mapping.legacy_id
WHERE cs._DATA_DATE = 'OLD_DATA_DATE')
GROUP BY
1, 2
ORDER BY
1, 2

Sostituisci quanto segue:

  • DATASET: il nome del set di dati
  • CUSTOMER_ID: l'ID cliente Search Ads 360
  • ADVERTISER_ID: l'ID inserzionista Search Ads 360
  • NEW_DATA_DATE: la data dei dati per la tabella del nuovo Search Ads 360
  • OLD_DATA_DATE: la data dei dati della tabella Search Ads 360 precedente

La seguente query utilizza le tabelle di mappatura degli ID per aggregare le metriche per campagna tra le tabelle dei trasferimenti di dati del nuovo e del precedente Search Ads 360 nello spazio ID precedente.

SELECT CustomerID, CampaignID, Sum(Clicks), Sum(Cost) FROM
(SELECT
  customer_id_mapping.legacy_id AS CustomerID,
  campaign_id_mapping.legacy_id AS CampaignID,
  cs.metrics_clicks AS Clicks,
  cs.metrics_cost_micros / 1000000 AS Cost
FROM
  `DATASET.sa_CampaignStats_CUSTOMER_ID` cs
LEFT JOIN
  `DATASET.IdMapping_CUSTOMER_ADVERTISER_ID` customer_id_mapping
ON cs.customer_id = customer_id_mapping.new_id
LEFT JOIN
  `DATASET.IdMapping_CAMPAIGN_ADVERTISER_ID` campaign_id_mapping
ON cs.campaign_id = campaign_id_mapping.new_id
WHERE cs._DATA_DATE = 'NEW_DATA_DATE'
UNION ALL
SELECT
  CAST(accountId AS INT) AS CustomerID,
  CAST(campaignId AS INT) AS CampaignID,
  cs.clicks AS Clicks,
  cs.cost AS Cost
FROM
  `DATASET.CampaignStats_ADVERTISER_ID` cs
WHERE cs._DATA_DATE = 'OLD_DATA_DATE')
GROUP BY
1, 2
ORDER BY
1, 2

Sostituisci quanto segue:

  • DATASET: il nome del set di dati
  • CUSTOMER_ID: l'ID cliente Search Ads 360
  • ADVERTISER_ID: l'ID inserzionista Search Ads 360
  • NEW_DATA_DATE: la data dei dati per la tabella del nuovo Search Ads 360
  • OLD_DATA_DATE: la data dei dati della tabella Search Ads 360 precedente

Potenziali problemi relativi alle quote

L'API di generazione di report di Search Ads 360 assegna una quota giornaliera per il numero di richieste che il progetto Google può inviare. Se utilizzi un progetto per BigQuery Data Transfer Service e altri servizi, tutti i servizi condividono la stessa quota e possono potenzialmente raggiungere il limite di quota in qualsiasi servizio.

Per evitare questo potenziale problema senza influire sui flussi di lavoro esistenti, valuta queste opzioni:

  • Configura un progetto separato per BigQuery Data Transfer Service. Un join tra tabelle tra progetti potrebbe avere il seguente aspetto: 

      #standardSQL
  select count(a.item1)
  from (select item1, item2 from project-A.data_set_a.table_name_a) a
  inner join
  (select item3, item4 from project-B.data_set_b.table_name_b) b
  on a.item1 = b.item3

  • Contatta l'assistenza di Search Ads 360 e richiedi una quota aggiuntiva.