Caricare i dati pubblicitari di Google Ads in BigQuery

È possibile caricare i dati da Google Ads (precedentemente noto come Google AdWords) in BigQuery utilizzando il connettore BigQuery Data Transfer Service per Google Ads. Con BigQuery Data Transfer Service, puoi pianificare job di trasferimento ricorrenti che aggiungono i dati più recenti di Google Ads a BigQuery.

Per informazioni sulle recenti modifiche alle origini dati, consulta il log delle modifiche alle origini dati di BigQuery Data Transfer Service.

Panoramica del connettore

BigQuery Data Transfer Service per il connettore Google Ads supporta le seguenti opzioni per il trasferimento dei dati.

Opzioni di trasferimento dei dati	Assistenza
Report supportati	Il connettore Google Ads supporta il trasferimento dei dati dai report in API Google Ads v23. Per informazioni su come i report Google Ads vengono trasformati in tabelle e viste BigQuery, consulta Trasformazione dei report Google Ads.
Frequenza di ripetizione	Il connettore Google Ads supporta i trasferimenti giornalieri di dati. Per impostazione predefinita, i trasferimenti di dati vengono pianificati al momento della creazione. Puoi configurare l'ora del trasferimento dei dati quando configuri il trasferimento dei dati.
Finestra di aggiornamento	Puoi pianificare i trasferimenti di dati per recuperare i dati pubblicitari di Google Ads fino a 30 giorni prima dell'esecuzione del trasferimento. Puoi configurare la durata della finestra di aggiornamento quando configuri il trasferimento dei dati. Per impostazione predefinita, il connettore Google Ads ha una finestra di aggiornamento di 7 giorni. Per ulteriori informazioni, vedi Finestre di aggiornamento. Gli snapshot delle tabelle delle corrispondenze vengono creati una volta al giorno e archiviati nella partizione per la data dell'ultima esecuzione. Gli snapshot della tabella delle corrispondenze non vengono aggiornati per i backfill o per i giorni caricati utilizzando la finestra di aggiornamento.
Disponibilità dei dati di backfill	Esegui un backfill dei dati per recuperare i dati al di fuori del trasferimento programmato. Puoi recuperare i dati fino a quando la policy di conservazione dei dati dell'origine dati lo consente. Per informazioni sulla politica di conservazione dei dati per Google Ads, vedereNormativa di conservazione dei dati di Google Ads.
Numero di ID cliente per account amministratore	8000 BigQuery Data Transfer Service supporta un massimo di 8000 ID cliente per ogni account amministratore Google Ads (MCC).

Per mappare i report Google Ads a ciò che vedi nella UI di Google Ads, consulta Mappare i report alla UI di Google Ads.

Acquisizione dei dati dai trasferimenti di Google Ads

Quando trasferisci i dati da Google Ads a BigQuery, i dati 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 l'esecuzione di backfill non comportano la duplicazione dei dati e le partizioni per altre date non vengono interessate.

Aggiorna finestre

Una finestra di aggiornamento è il numero di giorni in cui un trasferimento di dati recupera i dati quando si verifica un trasferimento di dati. Ad esempio, se la finestra di aggiornamento è di tre giorni e si verifica un trasferimento giornaliero, BigQuery Data Transfer Service recupera tutti i dati dalla tabella di origine degli ultimi tre giorni. In questo esempio, quando si verifica un trasferimento giornaliero, BigQuery Data Transfer Service crea una nuova partizione della tabella di destinazione BigQuery con una copia dei dati della tabella di origine del giorno corrente, quindi attiva automaticamente le esecuzioni di backfill per aggiornare le partizioni della tabella di destinazione BigQuery con i dati della tabella di origine degli ultimi due giorni. Le esecuzioni di backfill attivate automaticamente sovrascriveranno o aggiorneranno in modo incrementale la tabella di destinazione BigQuery, a seconda che gli aggiornamenti incrementali siano supportati o meno dal connettore di BigQuery Data Transfer Service.

Quando esegui un trasferimento di dati per la prima volta, il trasferimento di dati recupera tutti i dati di origine disponibili all'interno della finestra di aggiornamento. Ad esempio, se la finestra di aggiornamento è di tre giorni ed esegui il trasferimento dei dati per la prima volta, BigQuery Data Transfer Service recupera tutti i dati di origine entro tre giorni.

Per recuperare i dati al di fuori della finestra di aggiornamento, come i dati storici, o per recuperare i dati da eventuali interruzioni o lacune di trasferimento, è possibile avviare o pianificare un'esecuzione di backfill.

Limitazioni

• La frequenza massima per cui è possibile configurare un trasferimento dati per Google Ads è di una volta ogni 24 ore. Per impostazione predefinita, un trasferimento inizia al momento della creazione del trasferimento. Tuttavia, puoi configurare l'ora di inizio del trasferimento quando crei il trasferimento.
• Il BigQuery Data Transfer Service non supporta i trasferimenti di dati incrementali durante un trasferimento da Google Ads. Quando si specifica una data per un trasferimento dati, vengono trasferiti tutti i dati disponibili per quella data.

Prima di iniziare

Prima di creare un trasferimento dei dati di Google Ads:

• Verifica di aver completato tutte le azioni necessarie per attivare BigQuery Data Transfer Service.
• Crea un set di dati BigQuery Data Transfer Service per archiviare i dati di Google Ads.
• Se intendi configurare le notifiche di esecuzione dei trasferimenti per Pub/Sub, assicurati di disporre dell'autorizzazione pubsub.topics.setIamPolicy. Le autorizzazioni Pub/Sub non sono necessarie se si configurano le notifiche via e-mail. Per saperne di più, consulta Notifiche di esecuzione di BigQuery Data Transfer Service.

Autorizzazioni obbligatorie

Assicurati di aver concesso le seguenti autorizzazioni.

Ruoli BigQuery richiesti

Per ottenere le autorizzazioni necessarie per creare un trasferimento di dati BigQuery Data Transfer Service, chiedi all'amministratore di concederti il ruolo IAM BigQuery Admin (roles/bigquery.admin) nel tuo progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare un trasferimento di dati BigQuery Data Transfer Service. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare un trasferimento di dati di BigQuery Data Transfer Service sono necessarie le seguenti autorizzazioni:

• Autorizzazioni BigQuery Data Transfer Service:
  • bigquery.transfers.update
  • bigquery.transfers.get
• Autorizzazioni BigQuery:
  • bigquery.datasets.get
  • bigquery.datasets.getIamPolicy
  • bigquery.datasets.update
  • bigquery.datasets.setIamPolicy
  • bigquery.jobs.create

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per saperne di più, vedi Concedere l'accesso a bigquery.admin.

Ruoli Google Ads richiesti

Devi concedere l'accesso in lettura all'ID cliente Google Ads o all'account amministratore (Centro clienti) utilizzato nella configurazione del trasferimento. Quando crei una nuova configurazione di trasferimento autorizzata con le credenziali di un singolo utente, devi attivare la verifica in due passaggi.

Per autorizzare un account di servizio per il trasferimento dei dati Google Ads, ti consigliamo di concedere all'account di servizio l'accesso diretto all'account Google Ads. Per ulteriori informazioni, consulta Autorizzazione con accesso diretto all'account. I requisiti di autenticazione a più fattori (MFA), come la verifica in due passaggi, non sono necessari per le configurazioni di trasferimento autorizzate con i service account.

Crea trasferimento dati pubblicitari Google Ads

Per creare un trasferimento dei dati per i report Google Ads, devi disporre del tuo ID cliente Google Ads o del tuo account amministratore (Centro clienti). Per informazioni sul recupero dell'ID cliente Google Ads, consulta Trovare l'ID cliente.

Per creare un trasferimento dei dati per i report di Google Ads, seleziona una delle seguenti opzioni:

Console

1. Vai alla pagina Trasferimenti di dati nella console Google Cloud .

   Vai a Trasferimenti dati

2. Fai clic su Crea trasferimento.

3. Nella sezione Tipo di origine, scegli Google Ads per Origine.

4. Nella sezione Dettagli origine dati:

   1. In ID cliente, inserisci il tuo ID cliente Google Ads.
   2. In Tipo di report, seleziona Standard o Personalizzato.
      • Se hai selezionato Standard, il trasferimento include il set standard di report e campi descritto in Trasformazione dei report di Google Ads.
        • (Facoltativo) Seleziona le opzioni in modo da escludere gli elementi rimossi o disattivati e includere le nuove tabelle di Google Ads.
        • (Facoltativo) Inserisci un elenco separato da virgole delle tabelle da includere, ad esempio Campaign, AdGroup. In questo elenco, inserisci come prefisso il carattere - per escludere determinate tabelle, ad esempio -Campaign, AdGroup. Per impostazione predefinita, sono incluse tutte le tabelle.
        • (Facoltativo) Seleziona l'opzione per includere le tabelle specifiche per i report PMax. Per ulteriori informazioni sull'assistenza PMax, consulta l'Assistenza PMax.
        • (Facoltativo) Per Finestra di aggiornamento, inserisci un valore compreso tra 1 e 30.
      • Se hai selezionato Personalizzato, inserisci una tabella di output e una query Google Ads per ogni report personalizzato da includere in questo trasferimento.
        • (Facoltativo) Fai clic su Aggiungi query per aggiungere un nuovo report personalizzato.
        • (Facoltativo) Per Finestra di aggiornamento, inserisci un valore compreso tra 1 e 30.

5. Nella sezione Impostazioni destinazione, per Set di dati, seleziona il set di dati che hai creato per archiviare i dati.

6. Nella sezione Nome configurazione di trasferimento, per Nome visualizzato, inserisci un nome per il trasferimento di dati, 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.

7. Nella sezione Opzioni di pianificazione:

   • Per Frequenza di ripetizione, scegli un'opzione per la frequenza con cui eseguire il trasferimento di dati. Se selezioni Giorni, specifica un'ora valida nel fuso orario 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.

8. Nel menu Account di servizio, seleziona un account di servizio dagli account di servizio associati al tuo Google Cloud progetto. Puoi associare un account di servizio al trasferimento di dati anziché utilizzare le tue credenziali utente. Per ulteriori informazioni sull'utilizzo dei service account con i trasferimenti di dati, consulta Utilizza i service account.

   • Se hai eseguito l'accesso con un'identità federata, è necessario un service account per creare un trasferimento. Se hai eseguito l'accesso con un Account Google, il service account per il trasferimento è facoltativo.
   • Il service account deve disporre delle autorizzazioni richieste.

9. (Facoltativo) Nella sezione Opzioni di notifica:

   • Fai clic sul pulsante di attivazione/disattivazione per abilitare le notifiche via email. Quando attivi questa opzione, l'amministratore del trasferimento riceve una notifica via email quando l'esecuzione di un trasferimento non riesce.
   • Fai clic sul pulsante di attivazione/disattivazione per abilitare le notifiche Pub/Sub. In Seleziona un argomento Cloud Pub/Sub, scegli il nome dell'argomento o fai clic su Crea un argomento. Questa opzione configura l'esecuzione delle notifiche di Pub/Sub in relazione al trasferimento.

10. Fai clic su Salva.

bq

Inserisci ilbq mk comando e fornire il flag di creazione del trasferimento —--transfer_config. Sono necessari anche i seguenti flag:

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

Le seguenti bandiere sono facoltative:

• --project_id: Specifica quale progetto utilizzare. Se il flag non è specificato, viene utilizzato il progetto predefinito.
• --table_filter: specifica le tabelle da includere nel trasferimento dei dati. Se il flag non viene specificato, vengono incluse tutte le tabelle. Per includere solo tabelle specifiche, utilizza un elenco separato da virgole (ad esempio Ad, Campaign, AdGroup). Per escludere tabelle specifiche, anteponi ai valori un trattino (-) (ad esempio -Ad, Campaign, AdGroup).
• --schedule: specifica la frequenza di esecuzione della query. Se non specifichi --schedule, il valore predefinito è every 24 hours. Per informazioni sulla sintassi della pianificazione, vedere Formattazione della pianificazione.
• --refresh_window_days: specifica la finestra di aggiornamento per una configurazione di trasferimento in giorni. Il valore predefinito è 7.
• --service_account_name: Specifica un account di servizio da utilizzare per l'autenticazione del trasferimento di Google Ads al posto del tuo account utente.
• --include_pmax: Specificare true per includere le tabelle specifiche dei report PMax. Il valore predefinito è false. Per ulteriori informazioni sul supporto PMax, vedere Supporto PMax

bq mk \
--transfer_config \
--project_id=PROJECT_ID \
--target_dataset=DATASET \
--display_name=NAME \
--params='PARAMETERS' \
--data_source=DATA_SOURCE \
--table_filter=TABLES \
--schedule=SCHEDULE \
--refresh_window_days=REFRESH_DAYS \
--service_account_name=SERVICE_ACCOUNT_NAME \
--include_pmax=PMAX_ENABLE

Dove:

• PROJECT_ID è l'ID progetto.
• DATASET è il set di dati di destinazione per la configurazione del trasferimento dei dati.
• NAME è il nome visualizzato per la configurazione del trasferimento dati. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in un secondo momento.
• PARAMETERS contiene i seguenti parametri JSON per la configurazione del trasferimento: --params='{"param":"param_value"}'.
  • customer_id: inserisci il tuo ID cliente Google Ads nel formato 1231231234 o 123-123-1234. Questo campo è obbligatorio.
  • custom_report_table_names (facoltativo): un elenco di nomi di tabelle per i report personalizzati inclusi in questo trasferimento. Questo elenco corrisponde alle query in custom_report_queries. La lunghezza di questa lista deve corrispondere alla lunghezza della lista in custom_report_queries.
  • custom_report_queries (facoltativo): un elenco di query Google Ads Query Language (GAQL) per i report personalizzati inclusi in questo trasferimento. Questo elenco corrisponde ai nomi in custom_report_table_names. La lunghezza di questa lista deve corrispondere alla lunghezza della lista in custom_report_table_names.
  • exclude_removed_items (facoltativo): imposta questo parametro su true per impedire il trasferimento di entità e metriche rimosse o disabilitate.
• DATA_SOURCE è l'origine dati: google_ads.
• TABLES è l'elenco di tabelle separate da virgole da includere o escludere dal trasferimento dati.
• SCHEDULE indica la frequenza con cui si desidera eseguire la query. Se --schedule non è specificato, l'impostazione predefinita è ogni 24 ore, a partire dal momento in cui viene creato il trasferimento.
• REFRESH_DAYS è un numero intero che specifica la finestra di aggiornamento per una configurazione del trasferimento in giorni. Il valore predefinito è 7.
• SERVICE_ACCOUNT_NAME è il nome del 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 disporre di tutte le autorizzazioni richieste.
• PMAX_ENABLE: specifica true per includere le tabelle specifiche per i report PMax. Il valore predefinito è false. Per ulteriori informazioni sul supporto PMax, vedere Supporto PMax

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

Ad esempio, il seguente comando crea un trasferimento dei dati Google Ads denominato My Transfer utilizzando l'ID cliente 123-123-1234 e il set di dati di destinazione mydataset. Il trasferimento dei dati viene creato nel progetto predefinito:

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"customer_id":"123-123-1234","exclude_removed_items":"true"}' \
--data_source=google_ads

La prima volta che esegui il comando, ricevi un messaggio come il 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.

Java

Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di BigQuery per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API BigQuery Java.

Per eseguire l'autenticazione in BigQuery, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.

import com.google.api.gax.rpc.ApiException;
import com.google.cloud.bigquery.datatransfer.v1.CreateTransferConfigRequest;
import com.google.cloud.bigquery.datatransfer.v1.DataTransferServiceClient;
import com.google.cloud.bigquery.datatransfer.v1.ProjectName;
import com.google.cloud.bigquery.datatransfer.v1.TransferConfig;
import com.google.protobuf.Struct;
import com.google.protobuf.Value;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

// Sample to create ads(formerly AdWords) transfer config
public class CreateAdsTransfer {

  public static void main(String[] args) throws IOException {
    // TODO(developer): Replace these variables before running the sample.
    final String projectId = "MY_PROJECT_ID";
    String datasetId = "MY_DATASET_ID";
    // the customer_id only allows digits and hyphen ('-').
    String customerId = "012-345-6789";
    String refreshWindow = "100";
    Map<String, Value> params = new HashMap<>();
    params.put("customer_id", Value.newBuilder().setStringValue(customerId).build());
    params.put("refreshWindow", Value.newBuilder().setStringValue(refreshWindow).build());
    TransferConfig transferConfig =
        TransferConfig.newBuilder()
            .setDestinationDatasetId(datasetId)
            .setDisplayName("Your Ads Transfer Config Name")
            .setDataSourceId("adwords")
            .setParams(Struct.newBuilder().putAllFields(params).build())
            .build();
    createAdsTransfer(projectId, transferConfig);
  }

  public static void createAdsTransfer(String projectId, TransferConfig transferConfig)
      throws IOException {
    try (DataTransferServiceClient client = DataTransferServiceClient.create()) {
      ProjectName parent = ProjectName.of(projectId);
      CreateTransferConfigRequest request =
          CreateTransferConfigRequest.newBuilder()
              .setParent(parent.toString())
              .setTransferConfig(transferConfig)
              .build();
      TransferConfig config = client.createTransferConfig(request);
      System.out.println("Ads transfer created successfully :" + config.getName());
    } catch (ApiException ex) {
      System.out.print("Ads transfer was not created." + ex.toString());
    }
  }
}

Attivare manualmente un trasferimento da Google Ads

Quando tuattivare manualmente un trasferimento Per Google Ads, vengono scattate istantanee delle tabelle di corrispondenza una volta al giorno e memorizzate nella partizione relativa all'ultima data di esecuzione. Quando attivi un trasferimento manuale, gli snapshot della tabella di corrispondenza per le seguenti tabelle non vengono aggiornati:

• Annuncio
• AdGroup
• AdGroupAudience
• AdGroupBidModifier
• AdGroupAdLabel
• AdGroupCriterion
• AdGroupCriterionLabel
• AdGroupLabel
• AgeRange
• Asset
• AssetGroup
• AssetGroupAsset
• AssetGroupListingGroupFilter
• AssetGroupSignal
• Pubblico
• BidGoal
• Budget
• Campagna
• CampaignAudience
• CampaignCriterion
• CampaignLabel
• Cliente
• Genere
• Parola chiave
• LocationBasedCampaignCriterion
• ParentalStatus
• Posizionamento
• Video

Report personalizzati

Il connettore BigQuery Data Transfer Service per Google Ads supporta anche l'utilizzo di report personalizzati tramite query Google Ads Query Language (GAQL) nella configurazione del trasferimento di Google Ads. Questi report personalizzati acquisiscono i dati da tutte le risorse disponibili nella versione dell'API Google Ads supportata da BigQuery Data Transfer Service. Per ulteriori informazioni sull'utilizzo e la convalida di una query GAQL, consulta Google Ads Query Builder.

Puoi specificare report personalizzati quando crei un trasferimento Google Ads.

Limitazioni dei report personalizzati

I report personalizzati con il connettore Google Ads sono soggetti alle seguenti limitazioni:

• Il connettore Google Ads non supporta le clausole WHERE, ORDER BY, LIMIT e PARAMETERS. La query GAQL deve essere nel formato simile al seguente: SELECT FIELD_NAME, FIELD_NAME,... FROM RESOURCE_NAME.
• Il connettore Google Ads aggiunge automaticamente WHERE segments.date = run_date quando nella query è presente un segmento di date principale (ad esempio segments.date, segments.week, segments.month, segments.quarter, segments.year). Ciò può causare la restituzione di un errore da parte del Google Ads Query Validator, ad esempio, The filtering conditions in the WHERE clause must combine to form a valid, finite date range composed of the core date segments .... Puoi ignorare questi errori.
• Le query GAQL senza un campo segments.date agiscono come tabelle di corrispondenza, che vengono aggiornate solo una volta al giorno e non sono supportate nelle esecuzioni di backfill. Se si desidera inserire dati preesistenti, è necessario includere un campo segments.date nella query GAQL.
• Il connettore Google Ads supporta fino a 100 report personalizzati in un singolo trasferimento.
• Quando si utilizzano campi segmentati (ad esempio, segments.ad_network_type o segments.device) in una query personalizzata, l'API Google Ads esclude le campagne che hanno zero impressioni.

Campagne Performance Max (PMax)

Il connettore Google Ads consente di esportare i dati delle campagne PMax. È necessario selezionare la casella di controllo Includi tabelle della campagna PMax quando si crea un trasferimento di dati, poiché i dati PMax non vengono esportati per impostazione predefinita.

L'inclusione dei dati di Performance Max rimuove i campi ad_group da alcune tabelle e include nuove tabelle. Non puoi includere i campi ad_group perché l'API Google Ads filtra i dati Performance Max.

Le seguenti tabelle escludono le colonne correlate a ad_group quando è selezionata la casella di controllo Includi tabelle delle campagne Performance Max:

• GeoStats
• GeoConversionStats
• ShoppingProductConversionStats
• ShoppingProductStats
• LocationsUserLocationsStats

Le seguenti tabelle vengono aggiunte quando si seleziona la casella di controllo Includi tabelle della campagna PMax:

• Asset
• AssetGroup
• AssetGroupAsset
• AssetGroupListingGroupFilter
• AssetGroupSignal
• Pubblico
• AssetGroupProductGroupStats
• CampaignAssetStats

Assistenza per gli account amministratore Google Ads

I clienti esistenti che hanno più trasferimenti Google Ads specifici per l'ID cliente sono invitati a configurare un singolo trasferimento Google Ads a livello di account amministratore (Centro clienti), pianificare un backfill e disattivare i trasferimenti Google Ads specifici per l'ID cliente.

L'utilizzo degli account Google Ads Manager offre diversi vantaggi rispetto all'utilizzo di ID cliente individuali:

• Non è più necessario gestire più trasferimenti di dati per generare report su più ID cliente.
• Le query tra clienti sono molto più semplici da scrivere perché tutti gli ID cliente sono memorizzati nella stessa tabella.
• L'utilizzo dei Centri clienti riduce i problemi di quota di caricamento di BigQuery Data Transfer Service perché più ID cliente vengono caricati nello stesso job.

Per ulteriori informazioni sugli account di gestione di Google Ads (MCC), consulta Utilizzo degli account gestiti e Informazioni sul collegamento degli account al tuo account di gestione.

Nota: Il servizio di trasferimento dati di BigQuery estrae report per tutti gli ID cliente elencati, ma potresti non visualizzare gli ID cliente nei tuoi report se non segnalano attività per il giorno richiesto o se l'account è inattivo quando viene eseguita l'esecuzione del trasferimento.

Esempio

Il seguente elenco mostra gli ID cliente collegati a specifici account di Gestione inserzioni Google:

• 1234567890 — account amministratore root
  • 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 viene visualizzato in ogni report. Per saperne di più sulla struttura dei report di Google Ads in BigQuery Data Transfer Service, consulta Trasformazione dei report di Google Ads.

Configurazione del trasferimento per l'ID cliente 1234567890

Una configurazione del trasferimento per l'account amministratore principale (ID cliente 1234567890) genererebbe esecuzioni del trasferimento di dati 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 account amministratore secondario 567 e account amministratore secondario 1234)
• 6666 (tramite l'account amministratore secondario 567 e l'account amministratore secondario 1234)
• 7777 (tramite account amministratore secondario 567 e account amministratore secondario 1234)
• 8888 (tramite l'account amministratore secondario 89)
• 9999 (tramite l'account amministratore secondario 89)
• 0000 (ID cliente individuale)

Configurazione del trasferimento per l'ID cliente 1234

Una configurazione di trasferimento per l'account amministratore secondario 123 (ID cliente 1234) genererebbe esecuzioni di trasferimento dei dati che includono i seguenti ID cliente:

• 1111
• 2222
• 3333
• 4444
• 5555 (tramite account amministratore secondario 567)
• 6666 (tramite l'account amministratore secondario 567)
• 7777 (tramite l'account amministratore secondario 567)

Configurazione del trasferimento per l'ID cliente 567

Una configurazione di trasferimento per l'account del sotto-gestore 567 (ID cliente 567) genererebbe cicli di trasferimento dati che includono i seguenti ID cliente:

• 5555
• 6666
• 7777

Configurazione del trasferimento per l'ID cliente 89

Una configurazione di trasferimento per l'account amministratore secondario 89 (ID cliente 89) genererebbe esecuzioni di trasferimento dei dati che includono i seguenti ID cliente:

• 8888
• 9999

Configurazione del trasferimento per l'ID cliente 0000

Una configurazione di trasferimento per l'ID cliente 0000 genererebbe cicli di trasferimento dati che includono solo il singolo ID cliente:

• 0000

Eseguire la migrazione dei dati pubblicitari di Google Ads ai Centri clienti

Per eseguire la migrazione dei dati Google Ads esistenti in BigQuery Data Transfer Service alla struttura MCC, puoi configurare un backfill per aggiungere i dati esistenti alle tabelle create dalla configurazione del trasferimento collegata all'account amministratore. Tieni presente che quando pianifichi un riempimento, le tabelle delle corrispondenze non vengono aggiornate.

Risolvere i problemi di configurazione del trasferimento da Google Ads

Se riscontri problemi durante la configurazione del trasferimento dei dati, consulta la sezione Problemi di trasferimento di Google Ads in Risoluzione dei problemi relativi alle configurazioni di trasferimento.

Eseguire query sui dati

Quando vengono trasferiti a BigQuery Data Transfer Service, i tuoi dati vengono scritti in tabelle partizionate per data di importazione. Per ulteriori informazioni, consulta Introduzione alle tabelle partizionate.

Se esegui query direttamente sulle tabelle anziché utilizzare le viste generate automaticamente, devi utilizzare la pseudocolonna _PARTITIONTIME nella query. Per maggiori informazioni, consulta la pagina Esecuzione di query sulle tabelle partizionate.

Query di esempio di Google Ads

È possibile utilizzare le seguenti query di esempio di Google Ads per analizzare i dati trasferiti. Puoi anche utilizzare le query in uno strumento di visualizzazione come Data Studio. Queste query sono fornite per aiutarti a iniziare a interrogare i tuoi dati di Google Ads con BigQuery Data Transfer Service. Per ulteriori domande su come utilizzare questi report, contatta il tuo referente tecnico di Google Ads.

Se esegui query direttamente sulle tabelle anziché utilizzare le viste generate automaticamente, devi utilizzare la pseudocolonna _PARTITIONTIME nella query. Per ulteriori informazioni, vedere Interrogazione di tabelle partizionate.

Prestazioni della campagna

La seguente query di esempio analizza le prestazioni delle campagne Google Ads degli ultimi 30 giorni.

Console

SELECT
  c.customer_id,
  c.campaign_name,
  c.campaign_status,
  SUM(cs.metrics_impressions) AS Impressions,
  SUM(cs.metrics_interactions) AS Interactions,
  (SUM(cs.metrics_cost_micros) / 1000000) AS Cost
FROM
  `DATASET.ads_Campaign_CUSTOMER_ID` c
LEFT JOIN
  `DATASET.ads_CampaignBasicStats_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

bq

  bq query --use_legacy_sql=false '
  SELECT
    c.customer_id,
    c.campaign_name,
    c.campaign_status,
    SUM(cs.metrics_impressions) AS Impressions,
    SUM(cs.metrics_interactions) AS Interactions,
    (SUM(cs.metrics_cost_micros) / 1000000) AS Cost
  FROM
    `DATASET.ads_Campaign_CUSTOMER_ID` c
  LEFT JOIN
    `DATASET.ads_CampaignBasicStats_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: il nome del dataset creato per memorizzare la tabella trasferita
• CUSTOMER_ID: il tuo ID cliente di Google Ads.

Conteggio delle parole chiave

La seguente query di esempio analizza le parole chiave in base a campagna, gruppo di annunci e stato della parola chiave. Questa query utilizza la funzione KeywordMatchType. I tipi di corrispondenza delle parole chiave consentono di controllare le ricerche che attivano la pubblicazione dell'annuncio. Per saperne di più sulle opzioni di corrispondenza delle parole chiave, consulta Informazioni sulle opzioni di corrispondenza delle parole chiave.

Console

  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.ads_Keyword_CUSTOMER_ID` k
    JOIN
    `DATASET.ads_Campaign_CUSTOMER_ID` c
  ON
    (k.campaign_id = c.campaign_id AND k._DATA_DATE = c._DATA_DATE)
  JOIN
    `DATASET.ads_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

bq

  bq query --use_legacy_sql=false '
  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.ads_Keyword_CUSTOMER_ID` k
  JOIN
    `DATASET.ads_Campaign_CUSTOMER_ID` c
  ON
    (k.campaign_id = c.campaign_id AND k._DATA_DATE = c._DATA_DATE)
  JOIN
    `DATASET.ads_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: il nome del dataset creato per memorizzare la tabella trasferita
• CUSTOMER_ID: il tuo ID cliente di Google Ads.