Questa pagina è stata tradotta dall'API Cloud Translation.

Trasferimenti dei rapporti Search Ads 360 (non più supportati)

BigQuery Data Transfer Service per Search Ads 360 (precedentemente noto come DoubleClick Search) ti consente di pianificare e gestire automaticamente i job di caricamento ricorrenti per la Ricerca Dati dei report di Ads 360.

Report supportati

BigQuery Data Transfer Service per Search Ads 360 attualmente supporta le seguenti funzionalità: opzioni dei report:

Per informazioni su come i report di Search Ads 360 vengono per le tabelle e le 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, 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 memorizzati la partizione per l'ultima data di esecuzione. Gli snapshot delle tabelle delle corrispondenze NON sono aggiornato 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 dati noti di conservazione, BigQuery Data Transfer Service prevede dei limiti su come è possibile richiedere molti giorni in un singolo backfill. Per informazioni su per i backfill, consulta Configurare un backfill.

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 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 maggiori informazioni le informazioni, vedi 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 abbia quanto segue richiesto autorizzazioni:

BigQuery Data Transfer Service.
- bigquery.transfers.update autorizzazioni per creare il trasferimento
- Autorizzazioni bigquery.datasets.get e bigquery.datasets.update attive il set di dati di destinazione
Il ruolo IAM predefinito bigquery.admin include bigquery.transfers.update, bigquery.datasets.update e Autorizzazioni bigquery.datasets.get. Per ulteriori informazioni sui ruoli IAM in BigQuery Data Transfer Service, consulta Controllo dell'accesso.
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 le autorizzazioni serviceusage.services.use. Per 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 di Google Search Ads 360 e ID inserzionista utilizzato nella configurazione del trasferimento. Per maggiori informazioni le informazioni, vedi Crea un Account Google e ottieni 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 su recupera l'ID agenzia Search Ads 360, consulta Crea un Account Google e ottieni 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 Crea un Account Google e ottieni 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 di 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 di trasferimento, per Nome visualizzato, inserisci un nome del trasferimento, ad esempio My Transfer. Il nome del trasferimento può essere qualsiasi valore che consenta di identificare facilmente il trasferimento se necessario per 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 specificare 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 tuoi 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 metriche da trasferire.
  - (Facoltativo) Per Filtro tabella, lascia vuoto questo campo per caricare tutti tabelle. Per importare i dati solo per alcune delle tabelle supportate, elenca il prefisso del nome di queste tabelle, separate da uno spazio vuoto. Esempio: Account AccountDeviceStats AccountFloodlightAndDeviceStats. Consulta Trasformazione dei report di Search Ads 360 per tutti i nomi di tabella supportati.
  - (Facoltativo) Per le variabili Floodlight personalizzate, lascia questo campo. vuoto per importare solo le colonne predefinite Trasformazione dei report di Search Ads 360.
    Per importare le variabili Floodlight personalizzate che hai creato negli annunci della rete di ricerca 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 nell'elenco JSON, includi quanto segue:
  - cfv_name è il "amichevole" il nome specificato al momento della il variabile Floodlight personalizzata è stato creato in Campaign Manager. Il nome descrittivo viene visualizzato anche nell'interfaccia utente di Search Ads 360 quando configurare dimensioni e metriche personalizzate.
  - cfv_type deve essere metrica o dimensione. Fai in modo che corrisponda al modo in cui configuri la variabile Floodlight personalizzata nell'interfaccia utente di Search Ads 360.
  - campaign_manager_type deve essere number o string. Fai in modo che corrisponda al modo in cui configuri Variabile Floodlight configurata nell'interfaccia utente di Search Ads 360.
  - destination_table_name è il prefisso del nome o un elenco di i prefissi della tabella di destinazione da aggiungere a cui assegnare la variabile Floodlight personalizzata. Esempio: AccountDeviceStats, [AdDeviceStats,CampaignFloodtlightAndDeviceStats].
  - bigquery_column_name è il nome della colonna personalizzato che contiene in BigQuery, tabella di destinazione. Il nome della colonna deve seguire le 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. Se attivi questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un trasferimento non va a buon fine.
  - Per Seleziona un argomento Pub/Sub, scegli l'argomento o fai clic su Crea un argomento. Questa opzione configura l'esecuzione delle notifiche in 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 una determinata 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 del trasferimento.
name è il nome visualizzato della configurazione di trasferimento. La Transfer name può essere qualsiasi valore che consenta di identificare facilmente se devi modificarlo in un secondo momento.
parameters contiene i parametri per il trasferimento creato configurazione in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Per Search Ads 360, devi fornire i advertiser_id e agency_id parametri. Facoltativamente, puoi impostare i seguenti parametri:
- (Facoltativo) Imposta table_filter per importare i dati solo per alcuni dei tabelle supportate, elenca il prefisso del nome di queste tabelle, separato da uno spazio vuoto. Esempio: Account AccountDeviceStats AccountFloodlightAndDeviceStats. Consulta Trasformazione dei report di Search Ads 360 per tutti i nomi di tabella supportati.
- (Facoltativo) Imposta custom_floodlight_variables per importare le attività Floodlight personalizzate Variabili che hai creato in Search Ads 360: denomina questi campi in 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",
    "bigquery_column_name": "custom_column_name_2"
  }]
```
- Per ogni elemento nell'elenco JSON, includi quanto segue:
  - cfv_name è il "amichevole" il nome specificato al momento della il variabile Floodlight personalizzata è stato creato in Campaign Manager. Il nome descrittivo viene visualizzato anche nell'interfaccia utente di Search Ads 360 quando configurare dimensioni e metriche personalizzate.
  - cfv_type deve essere metrica o dimensione. Fai in modo che corrisponda al modo in cui configuri la variabile Floodlight personalizzata nell'interfaccia utente di Search Ads 360.
  - campaign_manager_type deve essere number o string. Fai in modo che corrisponda al modo in cui configuri Variabile Floodlight configurata nell'interfaccia utente di Search Ads 360.
  - destination_table_name è il prefisso del nome tabella di destinazione a cui vuoi aggiungere il tag Floodlight personalizzato a cui assegnare la variabile. Esempio: AccountDeviceStats.
  - bigquery_column_name è il nome della colonna personalizzato che contiene in BigQuery, tabella di destinazione. Il nome della colonna deve seguire le requisiti di formato per i nomi delle colonne BigQuery.
- (Facoltativo) Imposta include_removed_entities su true per includere le entità rimosse e metriche da trasferire.
data_source è l'origine dati: doubleclick_search.

Ad esempio, il seguente comando crea un trasferimento di Search Ads denominato My Transfer con ID inserzionista 123, ID agenzia 123 e set di dati target 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 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.

API

Utilizza la projects.locations.transferConfigs.create e fornisce un'istanza del metodo 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 la 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 riscontri problemi durante la configurazione del trasferimento, vedi 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 vengono scritte in tabelle partizionate in fase di importazione. Per ulteriori informazioni, vedi 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.

Potenziali problemi di quota

L'API Google 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 mentre per altri servizi entrambi condivideranno la quota e, raggiungere il limite di quota in entrambi i servizi.

Per evitare questo potenziale problema e non influire sui flussi di lavoro esistenti, 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

Contatto Assistenza per Search Ads 360 e richiedere una quota aggiuntiva. Per ulteriori informazioni, vedi Richiedi quota aggiuntiva.