Questa pagina è stata tradotta dall'API Cloud Translation.

Trasferimenti di Search Ads 360 (obsoleto)

BigQuery Data Transfer Service per Search Ads 360 (noto in precedenza 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 supporta attualmente le seguenti opzioni di generazione di report:

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	v2
Pianificazione	Ogni giorno, alla prima creazione del 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 in base alla data di esecuzione più recente. Gli snapshot delle tabelle delle corrispondenze NON vengono aggiornati per i backfill o per i giorni caricati 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 limiti al numero di giorni che possono essere richiesti in un singolo backfill. Per informazioni sui backfill, consulta Configurare un backfill.

Prima di iniziare

Prima di creare un trasferimento in 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 hai solo configurato 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 richieste:

BigQuery Data Transfer Service:
- bigquery.transfers.update autorizzazioni per creare il trasferimento
- Autorizzazioni bigquery.datasets.get e bigquery.datasets.update per il 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 ulteriori informazioni sui ruoli IAM in BigQuery Data Transfer Service, consulta Controllo dell'accesso.
Google Cloud:
- serviceusage.services.use autorizzazioni per scaricare dati da Search Ads 360 nel 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 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 del trasferimento. Per ulteriori informazioni, consulta Creare un Account Google e ottenere le autorizzazioni di SA360.

Configurare un trasferimento di dati in Search Ads 360

La configurazione di un trasferimento di dati per i report di Search Ads 360 richiede quanto segue:

Agency ID (ID agenzia): l'ID agenzia di Google Search Ads 360. Per informazioni su come recuperare l'ID agenzia di Search Ads 360, consulta Creare un Account Google e ottenere le autorizzazioni di SA360.
Advertiser ID: il tuo ID inserzionista Google Search Ads 360. Per informazioni su come recuperare l'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.

Vai alla pagina BigQuery
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 ti consenta di identificare facilmente il trasferimento se devi modificarlo in un secondo momento.
- Nella sezione Opzioni di pianificazione:
  - Per Frequenza di ripetizione, scegli un'opzione per la frequenza di esecuzione del trasferimento. Se selezioni Giorni, fornisci un orario valido nel fuso orario UTC.
    - Orari
    - Giorni
    - On demand
  - Se applicabile, seleziona Inizia ora o Inizia all'ora impostata e specifica una data di inizio e un'ora di esecuzione.
- Nella sezione Impostazioni destinazione, per Set di dati di destinazione, scegli il set di dati che hai creato per archiviare i dati.
- Nella sezione Dettagli origine dati:
  - In ID agenzia, inserisci il tuo ID agenzia.
  - In ID inserzionista, inserisci l'ID inserzionista.
  - Seleziona Includi gli elementi rimossi per includere le entità e le metriche rimosse da trasferire.
  - (Facoltativo) In Filtro tabella, lascia vuoto questo campo per caricare tutte le tabelle. Per importare dati solo per alcune delle tabelle supportate, elenca il prefisso nome di tali tabelle, separato da spazi vuoti. Esempio: Account AccountDeviceStats AccountFloodlightAndDeviceStats. Per informazioni su tutti i nomi delle tabelle supportati, consulta Trasformazione dei report di Search Ads 360.
  - (Facoltativo) Per 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, denominali in formato JSON, come nell'esempio seguente:
    - ```
    [{
      "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 nell'elenco JSON, includi quanto segue:
  - cfv_name è il nome semplice 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 metric o dimension. Abbinalo a come imposti la variabile Floodlight personalizzata nell'interfaccia utente di Search Ads 360.
  - campaign_manager_type deve essere number o string. Abbinalo a come imposti la variabile Floodlight personalizzata impostata nell'interfaccia utente di Search Ads 360.
  - destination_table_name è il prefisso del nome o un elenco di prefissi del nome 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 rispettare 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 l'esecuzione di 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 configura le notifiche di esecuzione 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 richiesti anche i seguenti flag:

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

Puoi anche fornire il flag --project_id per specificare un particolare progetto. 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 di trasferimento.
name è il nome visualizzato per la configurazione di trasferimento. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare facilmente il trasferimento se devi 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 parametri advertiser_id e agency_id. Se lo desideri, puoi impostare i seguenti parametri:
- (Facoltativo) Imposta table_filter per importare i dati solo per alcune delle tabelle supportate; elenca il prefisso nome di queste tabelle, separate da spazi vuoti. Esempio: Account AccountDeviceStats AccountFloodlightAndDeviceStats. Per informazioni su tutti i nomi delle tabelle supportati, consulta Trasformazione dei report di Search Ads 360.
- (Facoltativo) Imposta custom_floodlight_variables per importare le variabili Floodlight personalizzate che hai creato in Search Ads 360, denominali 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 nell'elenco JSON, includi quanto segue:
  - cfv_name è il nome semplice 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 metric o dimension. Abbinalo a come imposti la variabile Floodlight personalizzata nell'interfaccia utente di Search Ads 360.
  - campaign_manager_type deve essere number o string. Abbinalo a come imposti la variabile Floodlight personalizzata impostata 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 rispettare i requisiti di formato per i nomi delle colonne BigQuery.
- (Facoltativo) Imposta include_removed_entities su true per includere le entità e le metriche rimosse da trasferire.
data_source è l'origine dati, doubleclick_search.

Ad esempio, il seguente comando crea un trasferimento di Search Ads 360 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 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 l'ultima data di esecuzione. 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 hai problemi di configurazione del trasferimento, consulta Risolvere i problemi di configurazione del trasferimento di BigQuery Data Transfer Service.

Esegui query sui dati

Quando i dati vengono trasferiti in BigQuery Data Transfer Service, vengono scritti in tabelle partizionate per data 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 ulteriori informazioni, consulta Esecuzione di query sulle 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 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 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. Per ulteriori informazioni, consulta Richiesta di quota aggiuntiva.