Trasferimenti dei rapporti di Search Ads 360

BigQuery Data Transfer Service per Search Ads 360 consente di eseguire pianificare e gestire i job di caricamento ricorrenti per i report di Search Ads 360 e i dati di Google Cloud.

Report supportati

BigQuery Data Transfer Service per Search Ads 360 supporta i report di Search Ads 360 API v0:

• Report Search Ads 360 v0

Per informazioni su come i report di Search Ads 360 vengono trasformati Per tabelle e viste di BigQuery Data Transfer Service, consulta il report Search Ads 360 trasformazioni.

Opzione di segnalazione	Assistenza
Versione API supportata	v0
Pianificazione	Ogni giorno, nel momento in cui viene creato per la prima volta il trasferimento (impostazione predefinita) Puoi configurare l'ora del giorno.
Finestra di aggiornamento	Ultimi 7 giorni (impostazione predefinita) Configurabile fino a 30 giorni Snapshot delle tabelle delle corrispondenze vengono prese una volta al giorno e archiviate nella partizione per la data dell'ultima esecuzione. Gli snapshot della tabella delle corrispondenze non vengono aggiornati per i backfill o per i giorni di caricamento 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 Search Ads 360 account amministratore.

Per consultare la guida al trasferimento di Search Ads 360 che utilizza la vecchia API Search Ads 360 Reporting, consulta Trasferimenti di Search Ads 360 (ritirato).

Importazione dati da trasferimenti di Search Ads 360

Quando trasferisci i dati da Search Ads 360 a BigQuery, vengono caricati in tabelle BigQuery partizionate per data. La partizione della tabella in cui vengono caricati i dati corrisponde alla data da l'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 backfill in esecuzione non generano dati duplicati e le partizioni per altre date non sono interessate.

Limitazioni

• La frequenza massima che puoi configurare in Search Ads 360 il trasferimento per è una volta ogni 24 ore su 24. Per impostazione predefinita, un trasferimento inizia nel momento in cui crei trasferimento. Tuttavia, puoi configurare l'ora di inizio del trasferimento crea il trasferimento.
• BigQuery Data Transfer Service non supporta i trasferimenti incrementali durante un Trasferimento da Search Ads 360. Quando specifichi una data per un dato vengono trasferiti tutti i dati disponibili per quella data.

Prima di iniziare

Prima di creare un trasferimento da Search Ads 360:

• Verifica di aver completato tutte le azioni richieste per attivare il BigQuery Data Transfer Service.
• Crea un set di dati BigQuery Data Transfer Service per memorizzare i dati dei report di Search Ads 360.
• Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub, deve avere le autorizzazioni pubsub.topics.setIamPolicy. Pub/Sub le autorizzazioni non sono necessarie se hai appena configurato le notifiche via email. Per Per ulteriori informazioni, vedi Eseguire BigQuery Data Transfer Service notifiche.
• Abilitare l'accesso all'API Search Ads 360 Reporting nel tuo progetto.

Autorizzazioni obbligatorie

Assicurati che l'utente che crea il trasferimento abbia quanto segue richiesto autorizzazioni:

• BigQuery Data Transfer Service.

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

  Il ruolo IAM predefinito di bigquery.admin include bigquery.transfers.update, bigquery.datasets.update e Autorizzazioni bigquery.datasets.get. Per ulteriori informazioni Ruoli IAM in BigQuery Data Transfer Service, consulta Accesso controllo.

• Google Cloud

  • Autorizzazioni di serviceusage.services.use per scaricare i dati da Search Ads 360 del progetto.

  editor, owner e serviceusage.serviceUsageConsumer predefiniti I ruoli IAM includono serviceusage.services.use autorizzazioni aggiuntive. Per ulteriori informazioni sui ruoli IAM in Service Usage, consulta Controllo dell'accesso riferimento.

• Search Ads 360:

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

Creare un trasferimento di dati in Search Ads 360

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

Console

1. Vai alla pagina BigQuery nella console Google Cloud.

Vai alla pagina di BigQuery

1. Fai clic su Trasferimenti di 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, per Nome visualizzato, inserisci un nome del trasferimento, 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 pianificazione:

   • In Frequenza di ripetizione, scegli un'opzione per la frequenza di esecuzione del trasferimento. Se selezioni Giorni, fornisci un orario valido nel formato UTC.
     • Ore
     • Giorni
     • On demand
   • Se applicabile, seleziona Inizia ora o Inizia all'ora impostata. e specificare una data di inizio e un'ora di esecuzione.

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

   1. Nella sezione Dettagli 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 recupera le tabelle di mappatura ID.

   4. (Facoltativo) Nel campo Variabili Floodlight personalizzate, inserisci qualsiasi valore variabili Floodlight personalizzate da includere nel trasferimento. Le variabili Floodlight personalizzate devono essere di proprietà dell'account Search Ads 360 specificato dall'ID cliente nella configurazione di trasferimento. Questo parametro accetta input di stringa in È in un formato di array JSON e può supportare più attività Floodlight personalizzate come la codifica one-hot delle variabili categoriche. In ogni elemento dell'array JSON, i seguenti parametri sono obbligatori:

      • 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, allora un name non è obbligatorio.
      • name: il nome definito dall'utente delle variabili Floodlight personalizzate in Search Ads 360. Se hai specificato un name, il id non è obbligatorio.
      • cfv_field_name: l'esatto campo della variabile Floodlight personalizzata in base al tuo 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 BigQuery per includere 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: la colonna relativa alla facilità d'uso definita dall'utente . BigQuery Data Transfer Service aggiunge il suffisso dopo il nome del campo standard per differenziare i diversi tipi Variabili Floodlight. A seconda del caso d'uso, BigQuery Data Transfer Service genera un'istanza il nome della colonna:

        	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 qualsiasi colonne personalizzate da includere nel trasferimento. 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 stringa in formato JSON e può supportare più colonne. In ogni elemento JSON, i seguenti parametri sono obbligatori:

      • id: l'ID numerico della colonna personalizzata. Questo ID è assegnato Quando viene creata una colonna personalizzata. Se hai specificato un id, allora un name non è obbligatorio.
      • name: il nome definito dall'utente della colonna personalizzata in Search Ads 360. Se hai specificato un name, il id non è obbligatorio.
      • destination_table_name: un elenco di BigQuery per includere colonna personalizzata. Quando BigQuery Data Transfer Service recupera per queste tabelle, il trasferimento include la colonna personalizzata campo della query.
      • bigquery_column_name: il nome della colonna semplice definito dall'utente. Questo è il nome del campo della colonna personalizzata nella destinazione tabelle specificate in destination_table_name. Il nome della colonna deve seguire i requisiti di formato per i nomi delle colonne BigQuery ed essere univoci ad altri campi nello schema standard della tabella o 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 i valori separati da virgole elenco di tabelle da includere, ad esempio Campaign, AdGroup. Prefisso questo elenco con il carattere - per escludere determinate tabelle, ad esempio -Campaign, AdGroup. Tutte le tabelle sono incluse per impostazione predefinita.

   7. (Facoltativo) Per Aggiorna finestra, inserisci un valore compreso tra 1 e 30. In caso contrario impostata, la finestra di aggiornamento è impostata su 7 giorni per impostazione predefinita.

7. Nel menu Account di servizio, seleziona un account di servizio dagli account di servizio associati progetto Google Cloud. Puoi associare un account di servizio a il trasferimento anziché utilizzare le tue credenziali utente. Per maggiori informazioni informazioni sull'uso di account di servizio con i trasferimenti di dati, vedi Utilizzare gli account di servizio.

   • Se hai eseguito l'accesso con un'identità federata: per creare un trasferimento è necessario un account di servizio. Se hai firmato con un Account Google, poi l'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 abilitare le notifiche via email. Se attivi questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un trasferimento non va a buon fine.

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

9. Fai clic su Salva.

bq

Inserisci il comando bq mk e fornisci il flag di creazione del trasferimento: --transfer_config. Sono necessari 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 è specificato, viene utilizzato il progetto predefinito.
• --service_account_name: specifica un account di servizio da utilizzare per Search Ads 360 anziché al 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 è specificato, viene utilizzato il progetto predefinito.
• DATASET: il set di dati di destinazione per la configurazione del trasferimento.

• NAME: il nome visualizzato della configurazione di trasferimento. La Transfer name può essere qualsiasi valore che ti consenta di identificare il trasferimento se in un secondo momento.

• DATA_SOURCE: origine dati - search_ads.

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

• PARAMETERS: i parametri per il trasferimento creato configurazione in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Tu deve fornire il parametro customer_id.

  • table_filter: specifica le tabelle da includere nel trasferimento. Se il flag non è specificato, sono incluse tutte le tabelle. Per includere solo tabelle specifiche, utilizza un elenco di valori separati da virgole (ad esempio, Ad, Campaign, AdGroup). Per escludere tabelle specifiche, anteponi il prefisso valori esclusi con un trattino (-) (ad es. utilizzando -Ad, Campaign, AdGroup esclude tutti e tre i valori).
  • custom_columns: specifica le colonne personalizzate nei report. Questo accetta input di stringa in formato array JSON e può supporta più colonne. In ogni elemento dell'array JSON, viene restituito parametri sono obbligatori:
    • 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 per includere la colonna personalizzata. Quando BigQuery Data Transfer Service recupera i dati per queste tabelle, il trasferimento include il campo della colonna personalizzata query.
    • CC_COLUMN: nome della colonna semplice definito dall'utente. Questo è il nome del campo della colonna personalizzata nelle tabelle di destinazione specificate in destination_table_name. Il nome della colonna deve seguire i requisiti di formato per i nomi delle colonne BigQuery e deve essere univoco rispetto ad altri campi dello schema standard della tabella o di altre colonne personalizzate.
  • custom_floodlight_variables: specifica le variabili Floodlight personalizzate nel trasferimento. Questo parametro accetta input di stringa in formato array JSON e può supportare più variabili Floodlight personalizzate. In ogni elemento dell'array JSON, viene restituito parametri sono obbligatori:
    • 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 tuo 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 l'articolo Metriche Floodlight personalizzate.
    • CFV_DESTINATION_TABLE: un elenco di tabelle BigQuery per includere la variabili Floodlight personalizzate. Quando BigQuery Data Transfer Service recupera i dati per queste tabelle, il trasferimento include le variabili Floodlight personalizzate query.
    • CFV_COLUMN_SUFFIX: nome della colonna semplice 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 il nome di una 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

Attenzione: non puoi configurare le notifiche utilizzando lo strumento a riga di comando.

Ad esempio, il seguente comando crea un'istanza Search Ads 360 trasferimento denominato My Transfer utilizzando l'ID cliente 6828088731 e il target mydataset. Il trasferimento specifica anche una variabile Floodlight personalizzata. La 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, viene visualizzato un messaggio simile al seguenti:

[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 la riga di comando.

Attenzione :quando crei un trasferimento di Search Ads 360 utilizzando lo strumento a riga di comando, la configurazione di trasferimento viene impostata utilizzando i valori predefiniti Programmazione (ogni 24 ore al momento della creazione) e Aggiorna finestra (0 - configura la finestra di aggiornamento predefinita di 7 giorni).

API

Utilizza la projects.locations.transferConfigs.create e fornisce un'istanza TransferConfig risorsa.

Attivare manualmente un trasferimento da Search Ads 360

Quando attivi manualmente un trasferimento Per Search Ads 360, le istantanee delle tabelle delle corrispondenze vengono acquisite una volta al giorno e archiviato per la data dell'ultima esecuzione. Quando attivi un trasferimento manuale, Gli snapshot delle tabelle 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 utilizzando singoli ID cliente:

• Non è necessario gestire più trasferimenti per generare report su più ID cliente.
• Le query tra clienti sono più semplici da scrivere perché tutte le query Gli ID sono archiviati nella stessa tabella.
• L'utilizzo degli account amministratore riduce la quota di carico di BigQuery Data Transfer Service problemi perché nello stesso job vengono caricati più ID cliente.

Per i clienti esistenti che hanno più Search Ads 360 specifici per l'ID cliente trasferimenti, ti consigliamo di passare a un account amministratore Search Ads 360. Per farlo:

1. Configurare un singolo trasferimento di Search Ads 360 nell'account amministratore o amministratore secondario livello.
2. Pianifica un backfill.
3. Disattiva i trasferimenti Search Ads 360 specifici per singoli ID cliente.

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

Nota: BigQuery Data Transfer Service estrae report per tutti gli ID cliente elencati, ma potresti non visualizzare gli ID cliente nei tuoi report se non riportano attività per il giorno richiesto.

Esempio

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

• 1234567890 - account amministratore radice
  • 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 e viene visualizzato in ogni report. Per maggiori informazioni informazioni sulla struttura dei report di Search Ads 360 in BigQuery Data Transfer Service, consulta Trasformazione dei report di Search Ads 360.

Configurazione di trasferimento per l'ID cliente 1234567890

Una configurazione di trasferimento per l'account amministratore principale (ID cliente 1234567890) genera esecuzioni di trasferimenti 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 account amministratore secondario 89)
• 9999 (tramite account amministratore secondario 89)
• 0000 (ID cliente individuale)

Configurazione di trasferimento per l'ID cliente 1234

Viene generata una configurazione di trasferimento per l'account amministratore secondario 123 (ID cliente 1234) esecuzioni di trasferimento 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 di trasferimento per l'ID cliente 567

Viene generata una configurazione di trasferimento per l'account amministratore secondario 567 (ID cliente 567) esecuzioni di trasferimento che includono i seguenti ID cliente:

• 5555
• 6666
• 7777

Configurazione di trasferimento per l'ID cliente 89

Viene generata una configurazione di trasferimento per l'account amministratore secondario 89 (ID cliente 89) esecuzioni di trasferimento che includono i seguenti ID cliente:

• 8888
• 9999

Configurazione di trasferimento per l'ID cliente 0000

Una configurazione di trasferimento per l'ID cliente 0000 genera esecuzioni di trasferimento che includi solo l'ID cliente individuale:

• 0000

Eseguire query sui dati

Quando vengono trasferiti in BigQuery Data Transfer Service, i dati vengono scritti alle tabelle partizionate in fase di importazione. Per saperne di più, consulta Introduzione alle tabelle partizionate.

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

Esempi di query di Search Ads 360

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

I seguenti sono esempi di query per iniziare a eseguire query sui tuoi dati di Search Ads 360 con BigQuery Data Transfer Service. Per ulteriori domande sulle possibili azioni con questi report, contatta il tuo rappresentante tecnico Search Ads 360.

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

Rendimento delle campagne

La seguente query di esempio analizza il rendimento della campagna Search Ads 360 nel passato 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: nome del set di dati
• CUSTOMER_ID: l'ID cliente Search Ads 360

Numero di parole chiave

La seguente query di esempio analizza le parole chiave in base alla campagna, al gruppo di annunci e alla parola chiave .

  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: nome del set di dati
• CUSTOMER_ID: l'ID cliente Search Ads 360

Tabelle di mappatura degli ID

Entità nel nuovo Search Ads 360, come clienti, campagne e gruppi di annunci, Avere uno spazio ID diverso. rispetto alla precedente esperienza Search Ads 360. Per il trasferimento da Search Ads 360 esistente agli utenti che vogliono combinare i dati della precedente esperienza Search Ads 360 con nuova API Search Ads 360, puoi utilizzare BigQuery Data Transfer Service per trasferire nelle tabelle di mappatura degli ID se fornisci un ID agenzia e un ID inserzionista validi nel campo e configurazione di trasferimento.

Entità supportate contiene due colonne, legacy_id e new_id, che specifica la mappatura degli ID rispettivamente per le entità nella vecchia e nella nuova versione di Search Ads 360. Per le entità AD, CAMPAIGN_costituite e costituite, un new_secondary_id è fornita anche in quanto 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

Nota: come per le tabelle delle corrispondenze, gli snapshot delle tabelle di mappatura ID vengono acquisiti una volta giorno e archiviato nella partizione per l'ultima data di esecuzione. Tabella di mappatura degli ID gli snapshot non vengono aggiornati per i backfill o per i giorni caricati con l'aggiornamento finestra.

Esempi di query

La seguente query utilizza le tabelle di mappatura degli ID per aggregare i dati per campagna le metriche nelle tabelle delle versioni precedenti e nuove di Search Ads 360 vengono trasferite 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: 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 il nuovo Search Ads 360 tavola
• OLD_DATA_DATE: la data dei dati relativi all'ultimo periodo Tabella di Search Ads 360

La seguente query utilizza le tabelle di mappatura degli ID per aggregare i dati per campagna le metriche nelle tabelle delle versioni precedenti e nuove di Search Ads 360 vengono trasferite 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: 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 il nuovo Search Ads 360 tavola
• OLD_DATA_DATE: la data dei dati relativi all'ultimo Tabella di Search Ads 360

Potenziali problemi di quota

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

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

• Configurare un progetto separato per BigQuery Data Transfer Service. Un progetto incrociato il join di tabella 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 richiedere una quota aggiuntiva.