Trasferimenti dei rapporti Search Ads 360 (non più supportati)
BigQuery Data Transfer Service per Search Ads 360 (precedentemente noto come DoubleClick Search) 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 attualmente supporta le seguenti opzioni per i report:
- Report sull'account Search Ads 360
- Report sugli annunci di Search Ads 360
- Report Inserzionista Search Ads 360
- Report Gruppo di annunci di Search Ads 360
- Report adGroupTarget di Search Ads 360
- Report sulla strategia di offerta di Search Ads 360
- Report sulle campagne Search Ads 360
- Report sul target della campagna Search Ads 360
- Report sulle conversioni di Search Ads 360
- Report FeedItem di Search Ads 360
- Report FloodlightActivity di Search Ads 360
- Report sulle parole chiave di Search Ads 360
- Report Search Ads 360 negativeAdGroupKeyword
- Report Search Ads 360 negativeAdGroupTarget
- Report Parola chiave campagna esclusa di Search Ads 360
- Report negativeCampaignTarget di Search Ads 360
- Report sul prodotto pubblicizzato di Search Ads 360
- Report Gruppo di prodotti di Search Ads 360
- Report ProductLeadAndCrossSell di Search Ads 360
- Report sulle visite di Search Ads 360
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 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 la data di esecuzione più recente. Gli snapshot delle tabelle delle corrispondenze NON vengono aggiornati per i backfill o per i giorni di caricamento tramite la finestra di aggiornamento. Per informazioni su quali tabelle delle corrispondenze non vengono aggiornate dalla finestra di aggiornamento, consulta Configurare un backfill. |
Durata massima del backfill | Nessun limite Sebbene Search Ads 360 non abbia limiti noti di conservazione dei dati, BigQuery Data Transfer Service prevede dei limiti sul numero di giorni che è possibile richiedere in un singolo backfill. Per informazioni sui backfill, consulta Configurare un backfill. |
Prima di iniziare
Prima di creare un trasferimento Search Ads 360:
- Verifica di aver completato tutte le azioni necessarie per abilitare BigQuery Data Transfer Service.
- Crea un set di dati BigQuery Data Transfer Service per archiviare i dati 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 nel tuo progetto.
Autorizzazioni obbligatorie
Assicurati che la persona 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.Google Search Ads 360: accesso in lettura all'ID agenzia e all'ID inserzionista di Google Search Ads 360 utilizzati nella configurazione di trasferimento. Per scoprire di più, consulta Creare un Account Google e ottenere le autorizzazioni di SA360.
Configurare un trasferimento di dati in Search Ads 360
L'impostazione di un trasferimento di dati per i report di Search Ads 360 richiede:
- ID agenzia: l'ID agenzia Google Search Ads 360. Per informazioni sul recupero del tuo ID agenzia Search Ads 360, consulta Creare un Account Google e ottenere le autorizzazioni di SA360.
- ID inserzionista: il tuo ID inserzionista Google Search Ads 360. Per informazioni sul recupero dell'ID inserzionista Search Ads 360, consulta Creare un Account Google e ottenere le autorizzazioni di SA360.
Per creare un trasferimento di dati per i report di Search Ads 360:
Console
Vai alla pagina BigQuery nella console Google Cloud.
Fai clic su Trasferimenti.
Fai clic su Crea trasferimento.
Nella pagina Crea trasferimento:
Nella sezione Tipo di origine, per Origine, scegli Search Ads 360 (in precedenza DoubleClick Search).
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 consenta di identificare facilmente il trasferimento qualora fosse necessario 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.
Nella sezione Impostazioni destinazione, per Set di dati di destinazione, scegli il set di dati creato per archiviare i dati.
Nella sezione Dettagli origine dati:
- In ID agenzia, inserisci il tuo ID agenzia.
- In ID inserzionista, inserisci il tuo ID inserzionista.
- Seleziona Includi elementi rimossi per includere le entità rimosse e le metriche da trasferire.
(Facoltativo) Per Filtro tabella, lascia vuoto questo campo per caricare tutte le tabelle. Per importare i dati solo per alcune delle tabelle supportate, indica i prefissi dei nomi delle tabelle, separati da uno spazio vuoto. Esempio:
Account AccountDeviceStats AccountFloodlightAndDeviceStats
. Consulta Trasformazione dei report di Search Ads 360 per tutti i nomi delle tabelle supportati.(Facoltativo) Per le Variabili Floodlight personalizzate, lascia vuoto questo campo per importare solo le colonne predefinite nella trasformazione dei report di Search Ads 360.
Per importare le variabili Floodlight personalizzate che hai creato in Search Ads 360, denomina questi campi in formato JSON, come in questo esempio:[{ "cfv_name": "variable_name", "cfv_type": "metric or dimension", "campaign_manager_type": "number or string", "destination_table_name": "table_name", "bigquery_column_name": "custom_column_name" },{ "cfv_name": "variable_name_2", "cfv_type": "metric or dimension", "campaign_manager_type": "number or string", "destination_table_name": ["table_name_2","table_name_3"], "bigquery_column_name": "custom_column_name_2" }]
- Per ogni elemento dell'elenco JSON, includi quanto segue:
- cfv_name è il nome "descrittivo" specificato al momento della creazione della variabile Floodlight personalizzata in Campaign Manager. Il nome descrittivo viene visualizzato anche nell'interfaccia utente di Search Ads 360 durante la configurazione di dimensioni e metriche personalizzate.
- cfv_type deve essere metrica o dimensione. Fai in modo che corrisponda a come hai impostato la variabile Floodlight personalizzata nell'interfaccia utente di Search Ads 360.
- campaign_manager_type deve essere number o string. Associa questo valore a come configuri la variabile Floodlight personalizzata nell'interfaccia utente di Search Ads 360.
- destination_table_name è il prefisso nome o un elenco di prefissi della tabella di destinazione a cui vuoi aggiungere la variabile Floodlight personalizzata.
Esempio:
AccountDeviceStats
,[AdDeviceStats,CampaignFloodtlightAndDeviceStats]
. - bigquery_column_name è il nome della colonna che questa variabile Floodlight personalizzata avrà nella tabella di destinazione BigQuery. Il nome della colonna deve seguire i requisiti di formato per i nomi delle colonne BigQuery.
(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.
- In Seleziona un argomento Pub/Sub, scegli il nome dell'argomento o fai clic su Crea un argomento. Questa opzione consente di configurare 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
Puoi anche fornire il flag --project_id
per specificare un
progetto specifico. Se --project_id
non è specificato, viene utilizzato il progetto predefinito.
bq mk \ --transfer_config \ --project_id=project_id \ --target_dataset=dataset \ --display_name=name \ --params='parameters' \ --data_source=data_source
Dove:
- project_id è l'ID progetto.
- 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 consenta di identificare facilmente il trasferimento qualora fosse necessario modificarlo in un secondo momento.
parameters contiene i parametri per la configurazione di trasferimento creata in formato JSON. Ad esempio:
--params='{"param":"param_value"}'
. Per Search Ads 360, devi fornire i parametriadvertiser_id
eagency_id
. Facoltativamente, puoi impostare i seguenti parametri:- (Facoltativo) Imposta
table_filter
per importare i dati solo per alcune tabelle supportate. Indica il prefisso del nome di queste tabelle, separandolo con uno spazio vuoto. Esempio:Account AccountDeviceStats AccountFloodlightAndDeviceStats
. Consulta Trasformazione dei report di Search Ads 360 per tutti i nomi delle tabelle supportati. - (Facoltativo) Imposta
custom_floodlight_variables
per importare le variabili Floodlight personalizzate che hai creato in Search Ads 360, denomina questi campi in formato JSON, come in questo esempio:[{ "cfv_name": "variable_name", "cfv_type": "metric or dimension", "campaign_manager_type": "number or string", "destination_table_name": "table_name", "bigquery_column_name": "custom_column_name" },{ "cfv_name": "variable_name_2", "cfv_type": "metric or dimension", "campaign_manager_type": "number or string", "destination_table_name": "table_name_2", "bigquery_column_name": "custom_column_name_2" }]
- Per ogni elemento dell'elenco JSON, includi quanto segue:
- cfv_name è il nome "descrittivo" specificato al momento della creazione della variabile Floodlight personalizzata in Campaign Manager. Il nome descrittivo viene visualizzato anche nell'interfaccia utente di Search Ads 360 durante la configurazione di dimensioni e metriche personalizzate.
- cfv_type deve essere metrica o dimensione. Fai in modo che corrisponda a come hai impostato la variabile Floodlight personalizzata nell'interfaccia utente di Search Ads 360.
- campaign_manager_type deve essere number o string. Associa questo valore a come configuri la variabile Floodlight personalizzata nell'interfaccia utente di Search Ads 360.
- destination_table_name è il prefisso del nome della tabella di destinazione a cui vuoi aggiungere la variabile Floodlight personalizzata. Esempio:
AccountDeviceStats
. - bigquery_column_name è il nome della colonna che questa variabile Floodlight personalizzata avrà nella tabella di destinazione BigQuery. Il nome della colonna deve seguire i requisiti di formato per i nomi delle colonne BigQuery.
- (Facoltativo) Imposta
include_removed_entities
su true per includere le entità rimosse e le metriche da trasferire.
- (Facoltativo) Imposta
data_source è l'origine dati:
doubleclick_search
.
Ad esempio, il seguente comando crea un trasferimento Search Ads denominato My Transfer
utilizzando l'ID inserzionista 123
, l'ID agenzia 123
e il set di dati di destinazione mydataset
. Il trasferimento viene creato nel progetto predefinito:
bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"agency_id":"123", "advertiser_id":"123","include_removed_entities":"true"}' \
--data_source=doubleclick_search
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, le istantanee delle tabelle delle corrispondenze vengono acquisite una volta al giorno e archiviate nella partizione per la data di esecuzione più recente. Quando pianifichi un trasferimento manuale, gli snapshot delle tabelle delle corrispondenze per le seguenti tabelle non vengono aggiornati:
- Account
- Annuncio
- Inserzionista
- AdGroup
- AdGroupTarget
- BidStrategy
- Campagna
- CampaignTarget
- FeedItem
- FloodlightActivity
- Parola chiave
- NegativeAdGroupKeyword
- NegativeAdGroupTarget
- NegativeCampaignKeyword
- NegativeCampaignTarget
- ProductAdvertised
- ProductGroup
- ProductLeadAndCrossSellFloodlightStats
- Video
- Posizionamento
- Video
Risolvere i problemi di configurazione del trasferimento di Search Ads 360
Se riscontri problemi durante la configurazione del trasferimento, consulta Risoluzione dei problemi di configurazione del trasferimento di BigQuery Data Transfer Service.
Eseguire query sui dati
Quando vengono trasferiti in BigQuery Data Transfer Service, i dati vengono scritti in tabelle partizionate in fase di importazione. Per ulteriori informazioni, 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.
Potenziali problemi di quota
L'API Google Search Ads 360 assegna una quota giornaliera per il numero di richieste che un progetto Google può inviare. Se utilizzi un solo progetto per BigQuery Data Transfer Service e per altri servizi, entrambi i servizi condivideranno la quota e raggiungeranno potenzialmente il limite di quota in entrambi i servizi.
Per evitare questo potenziale problema e non influire sui flussi di lavoro esistenti, prendi in considerazione queste opzioni:
Configurare un progetto separato per BigQuery Data Transfer Service.
Esempio di unione di tabelle tra progetti:
#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 Search Ads 360 e richiedi una quota aggiuntiva. Per maggiori informazioni, consulta Richiedere una quota aggiuntiva.