Trasferimenti dei rapporti di Search Ads 360
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 l'API Search Ads 360 Reporting v0:
Per informazioni su come i report di Search Ads 360 vengono trasformati in tabelle e viste di BigQuery Data Transfer Service, consulta Trasformazioni dei report di Search Ads 360.
Opzione di segnalazione | Assistenza |
---|---|
Versione API supportata | |
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 Gli snapshot delle tabelle delle corrispondenze vengono acquisiti una volta al giorno e archiviati nella partizione per l'ultima data di esecuzione. Gli snapshot delle tabelle delle corrispondenze non vengono aggiornati per i backfill o per i giorni caricati tramite 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 di reporting di Search Ads 360, 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, questi vengono caricati in 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 backfill in esecuzione non generano dati duplicati e le partizioni per altre date non sono interessate.Limitazioni
- La frequenza massima per cui puoi configurare un trasferimento in Search Ads 360 è una volta ogni 24 ore. Per impostazione predefinita, un trasferimento inizia nel momento in cui viene creato. Tuttavia, puoi configurare l'ora di inizio del trasferimento quando crei il trasferimento.
- BigQuery Data Transfer Service non supporta i trasferimenti incrementali durante un trasferimento da Search Ads 360. Se 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 Search Ads 360:
- Verifica di aver completato tutte le azioni richieste per abilitare BigQuery Data Transfer Service.
- Crea un set di dati BigQuery Data Transfer Service per archiviare i dati dei report di Search Ads 360.
- Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub, devi disporre delle autorizzazioni
pubsub.topics.setIamPolicy
. Le autorizzazioni Pub/Sub non sono necessarie se configuri solo le notifiche via email. Per ulteriori informazioni, consulta Notifiche di esecuzione di BigQuery Data Transfer Service. - Attiva l'accesso all'API Search Ads 360 Reporting nel tuo progetto.
Autorizzazioni obbligatorie
Assicurati che l'utente che crea il trasferimento disponga delle seguenti autorizzazioni obbligatorie:
BigQuery Data Transfer Service.
bigquery.transfers.update
autorizzazioni per creare il trasferimento.- Entrambe le autorizzazioni
bigquery.datasets.get
ebigquery.datasets.update
sul set di dati di destinazione.
Il ruolo IAM predefinito di
bigquery.admin
include le autorizzazionibigquery.transfers.update
,bigquery.datasets.update
ebigquery.datasets.get
. Per ulteriori informazioni sui ruoli IAM in BigQuery Data Transfer Service, consulta Controllo dell'accesso.Google Cloud
serviceusage.services.use
di autorizzazioni per scaricare dati da Search Ads 360 nel progetto.
I ruoli IAM predefiniti
editor
,owner
eserviceusage.serviceUsageConsumer
includono le autorizzazioniserviceusage.services.use
. Per ulteriori informazioni sui ruoli IAM in Service Usage, consulta Riferimento per il controllo dell'accesso.Search Ads 360:
- Accesso in lettura all'ID cliente o all'account amministratore di Search Ads 360 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 del tuo ID cliente Search Ads 360 o dell'account amministratore. Seleziona una delle seguenti opzioni:
Console
- Vai alla pagina BigQuery nella console Google Cloud.
Fai clic su
Trasferimenti di dati.Fai clic su
Crea trasferimento.Nella sezione Tipo di origine, per Origine, scegli Search Ads 360.
Nella sezione Nome configurazione trasferimento, in Nome visualizzato, inserisci un nome per il trasferimento, ad esempio
My Transfer
. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento, qualora dovessi modificarlo in un secondo momento.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 fornisci una data di inizio e un'ora di esecuzione.
- In Frequenza di ripetizione, scegli un'opzione per la frequenza di esecuzione del trasferimento. Se selezioni Giorni, fornisci un orario valido nel formato UTC.
Nella sezione Impostazioni di destinazione, per Set di dati, seleziona il set di dati che hai creato per archiviare i tuoi dati.
Nella sezione Dettagli origine dati:
In ID cliente, inserisci il tuo ID cliente Search Ads 360:
(Facoltativo) Inserisci un ID agenzia e un ID inserzionista per recuperare le tabelle di mappatura ID.
(Facoltativo) Nel campo Variabili Floodlight personalizzate, inserisci eventuali 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 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 valoreid
, non è necessario unname
.name
: il nome definito dall'utente delle variabili Floodlight personalizzate in Search Ads 360. Se hai specificato unname
, ilid
non è obbligatorio.cfv_field_name
: il nome esatto del campo della variabile Floodlight personalizzata in base al caso d'uso. I valori supportati sonoconversion_custom_metrics
,conversion_custom_dimensions
,raw_event_conversion_metrics
eraw_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 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 un nome di colonna BigQuery come il seguente: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" }]
(Facoltativo) Nel campo Colonne personalizzate, inserisci le 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 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 valoreid
, non è necessario unname
.name
: il nome definito dall'utente della colonna personalizzata in Search Ads 360. Se hai specificato unname
, ilid
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 nella query il campo della colonna personalizzata.bigquery_column_name
: nome della colonna semplice definito dall'utente. Questo è il nome del campo della colonna personalizzata nelle tabelle di destinazione specificate indestination_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.
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" }]
(Facoltativo) Nel campo Filtro tabella, inserisci un elenco separato da virgole di tabelle da includere, ad esempio
Campaign, AdGroup
. Aggiungi a questo elenco il prefisso-
per escludere determinate tabelle, ad esempio-Campaign, AdGroup
. Tutte le tabelle sono incluse per impostazione predefinita.(Facoltativo) Per Aggiorna finestra, inserisci un valore compreso tra 1 e 30. Se non viene configurato, la finestra di aggiornamento è di 7 giorni per impostazione predefinita.
Nel menu Account di servizio, seleziona un account di servizio dagli account di servizio associati al tuo progetto Google Cloud. Puoi associare un account di servizio al trasferimento anziché utilizzare le tue credenziali utente. Per ulteriori informazioni sull'utilizzo di account di servizio con trasferimenti di dati, vedi Utilizzare account di servizio.
- Se hai eseguito l'accesso con un'identità federata, sarà 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.
(Facoltativo) Nella sezione Opzioni di notifica:
Fai clic sul pulsante di attivazione/disattivazione per abilitare le notifiche via email. Quando abiliti 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 dell'argomento o fai clic su Crea un argomento. Questa opzione configura le notifiche di Pub/Sub per il trasferimento.
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 viene specificato, viene usato il progetto predefinito.--service_account_name
: specifica un account di servizio da utilizzare per l'autenticazione dei trasferimenti di Search Ads 360 al posto del 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 usato il progetto predefinito.
- DATASET: il set di dati di destinazione per la configurazione del trasferimento.
NAME: il nome visualizzato della configurazione di trasferimento. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento, se devi modificarlo in un secondo momento.
DATA_SOURCE: origine dati -
search_ads
.(Facoltativo) SERVICE_ACCOUNT_NAME: il nome dell'account di servizio utilizzato per autenticare il trasferimento. L'account di servizio deve essere di proprietà dello stesso
project_id
utilizzato per creare il trasferimento e deve avere tutte le autorizzazioni richieste.PARAMETERS: i parametri per la configurazione di trasferimento creata in formato JSON. Ad esempio:
--params='{"param":"param_value"}'
. Devi fornire il parametrocustomer_id
.table_filter
: specifica le tabelle da includere nel trasferimento. Se il flag non viene specificato, vengono 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, aggiungi un trattino (-
) davanti ai valori esclusi. Ad esempio, se utilizzi-Ad, Campaign, AdGroup
vengono esclusi tutti e tre i valori.custom_columns
: specifica le colonne personalizzate nei report. Questo parametro accetta input di stringa 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 include nella query il campo della colonna personalizzato.
- 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 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 tuo caso d'uso. I valori supportati sono
conversion_custom_metrics
,conversion_custom_dimensions
,raw_event_conversion_metrics
eraw_event_conversion_dimensions
. Per ulteriori informazioni, consulta l'articolo Metriche Floodlight personalizzate. - CFV_DESTINATION_TABLE: 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.
- 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
Ad esempio, il seguente comando crea un trasferimento in 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 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 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 da 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 delle tabelle delle corrispondenze 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 degli ID cliente individuali:
- Non è necessario gestire più trasferimenti per generare report su più ID cliente.
- Le query tra clienti sono più semplici da scrivere perché tutti gli ID cliente sono archiviati nella stessa tabella.
- L'utilizzo degli account amministratore riduce i problemi di quota di carico di BigQuery Data Transfer Service perché più ID cliente vengono caricati nello stesso job.
Per i clienti esistenti con più trasferimenti Search Ads 360 specifici per ID cliente, consigliamo di passare a un account amministratore Search Ads 360. Per farlo:
- Configura un singolo trasferimento di Search Ads 360 a livello di account amministratore o amministratore secondario.
- Pianifica un backfill.
- 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 Visualizzare come gli account sono collegati all'account amministratore.
Esempio
Il seguente elenco mostra gli ID cliente collegati a determinati account amministratore Search Ads 360:
- 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
- 1234 - Account amministratore secondario
Ogni ID cliente è collegato a un account amministratore e 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.
Configurazione di trasferimento per l'ID cliente 1234567890
Una configurazione di trasferimento per l'account amministratore principale (ID cliente 1234567890) genera esecuzioni di trasferimento 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
Una configurazione di trasferimento per l'account amministratore secondario 123 (ID cliente 1234) genera esecuzioni del 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
Una configurazione di trasferimento per l'account amministratore secondario 567 (ID cliente 567) genera esecuzioni del trasferimento che includono i seguenti ID cliente:
- 5555
- 6666
- 7777
Configurazione di trasferimento per l'ID cliente 89
Una configurazione di trasferimento per l'account amministratore secondario 89 (ID cliente 89) genera esecuzioni del 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 includono solo l'ID cliente individuale:
- 0000
Eseguire query sui dati
Quando vengono trasferiti in BigQuery Data Transfer Service, i dati vengono scritti in tabelle partizionate per data di importazione. Per saperne di più, consulta Introduzione alle tabelle partizionate.
Se esegui una query direttamente sulle tabelle anziché utilizzare le viste generate automaticamente, devi utilizzare la pseudo-colonna _PARTITIONTIME
nella query. Per maggiori 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. Puoi anche visualizzare le query in uno strumento di visualizzazione come Looker Studio.
Le seguenti query sono esempi per iniziare a eseguire query sui tuoi 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 Search Ads 360.
Se esegui una query direttamente sulle tabelle anziché utilizzare le viste generate automaticamente, devi utilizzare la pseudo-colonna _PARTITIONTIME
nella query. Per maggiori informazioni,
consulta Esecuzione di query su tabelle partizionate.
Rendimento delle campagne
La seguente query di esempio analizza il rendimento della campagna Search Ads 360 per gli 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
: nome del set di datiCUSTOMER_ID
: l'ID cliente Search Ads 360
Numero di parole chiave
La seguente query di esempio analizza le parole chiave in base allo stato della campagna, del gruppo di annunci e della 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 datiCUSTOMER_ID
: l'ID cliente Search Ads 360
Tabelle di mappatura degli ID
Le entità nella nuova esperienza Search Ads 360, come clienti, campagne e gruppi di annunci, hanno uno spazio ID diverso rispetto al precedente Search Ads 360. Per gli utenti trasferiti di Search Ads 360 esistenti che vogliono combinare dati dalla precedente esperienza Search Ads 360 con la nuova API Search Ads 360, puoi utilizzare BigQuery Data Transfer Service per trasferire le tabelle di mappatura ID se fornisci un ID agenzia e un ID inserzionista validi nella configurazione di trasferimento.
Le entità supportate
contengono due colonne, legacy_id
e new_id
, che specificano la mappatura degli ID
per le entità, rispettivamente, nella vecchia e nella nuova versione di Search Ads 360.
Per le entità AD, CAMPAIGN_criteri ed cost, viene fornito anche un new_secondary_id
, 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
Esempi di query
La seguente query utilizza le tabelle di mappatura degli ID per aggregare le metriche per campagna nelle tabelle dei trasferimenti di Search Ads 360 precedenti e del nuovo 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
: nome del set di datiCUSTOMER_ID
: l'ID cliente Search Ads 360ADVERTISER_ID
: l'ID inserzionista Search Ads 360NEW_DATA_DATE
: la data dei dati per la tabella del nuovo Search Ads 360OLD_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 nelle tabelle dei trasferimenti di Search Ads 360 precedenti e del nuovo 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
: nome del set di datiCUSTOMER_ID
: l'ID cliente Search Ads 360ADVERTISER_ID
: l'ID inserzionista Search Ads 360NEW_DATA_DATE
: la data dei dati per la tabella del nuovo Search Ads 360OLD_DATA_DATE
: la data dei dati della tabella Search Ads 360 precedente
Potenziali problemi di quota
L'API di reporting 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, prendi in considerazione queste opzioni:
Configurare un progetto separato per BigQuery Data Transfer Service. Un join di 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 fromproject-B.data_set_b.table_name_b
) b on a.item1 = b.item3Contatta l'assistenza di Search Ads 360 e richiedi una quota aggiuntiva.