Pianifica un trasferimento di Facebook Ads

BigQuery Data Transfer Service per Facebook Ads consente di pianificare e gestire automaticamente i job di caricamento ricorrenti da Facebook Ads a BigQuery.

Limitazioni

I trasferimenti di Facebook Ads sono soggetti alle seguenti limitazioni:

  • L'intervallo minimo tra trasferimenti ricorrenti di Facebook Ads è di 15 minuti. L'intervallo predefinito per un bonifico ricorrente è di 24 ore.
  • BigQuery Data Transfer Service per Facebook Ads supporta solo un set fisso di tabelle. I report personalizzati non sono supportati.
  • I trasferimenti di Facebook Ads hanno una durata massima di sei ore. Un trasferimento non va a buon fine se dura più di questa durata massima.
  • I trasferimenti incrementali non sono supportati.
  • BigQuery Data Transfer Service supporta il trasferimento di dati da un massimo di un giorno (ieri) alle tabelle AdInsights e AdInsightsActions.

Prima di iniziare

Le seguenti sezioni descrivono i passaggi da seguire prima di creare un trasferimento di Facebook Ads.

Prerequisiti di Facebook Ads

Quando crei un trasferimento di Facebook Ads, assicurati di disporre delle seguenti informazioni su Facebook Ads.

Parametri di Facebook Ads Descrizione
clientID Il nome dell'ID app del client OAuth 2.0.
clientSecret Il secret dell'app per il client OAuth 2.0.
refreshToken Token di accesso dell'utente di lunga durata, noto anche come token di aggiornamento.

Per ottenere un clientID e un clientSecret, svolgi i seguenti passaggi:

  1. Crea un'app per sviluppatori Facebook con il tipo di app Business.
  2. Nella dashboard dell'app Facebook, fai clic su Impostazioni app > Base e trova l'ID e l'app secret corrispondenti all'app.

Per ottenere un token di accesso utente di lunga durata, chiamato anche token di aggiornamento, segui questi passaggi:

  1. Nella console Google Cloud, segui i passaggi per creare un trasferimento di Facebook Ads.

  2. Nella sezione Dettagli origine dati, copia l'URI di reindirizzamento elencato dopo il campo Aggiorna token.

    Copia l'URI di reindirizzamento

  3. Fai clic sulla dashboard dell'app Facebook, quindi su Imposta nella sezione Accesso a Facebook per le aziende.

    Configura le impostazioni per l'accesso a Facebook per le aziende

  4. Nella pagina Impostazioni, inserisci l'URL di reindirizzamento nel campo URI di reindirizzamento OAuth validi e fai clic su Salva.

  5. Torna alla console Google Cloud. Nella sezione Dettagli origine dati, fai clic su Autorizza. Verrai reindirizzato alla pagina di autenticazione di Facebook.

    Generare un token di accesso utente di lunga durata

  6. Seleziona l'app per sviluppatori Facebook per autorizzare l'account che si connette a BigQuery Data Transfer Service.

  7. Al termine, fai clic su OK per tornare alla console Google Cloud. Il token di accesso a lunga durata ora viene inserito nella configurazione di trasferimento.

In alternativa, puoi generare un token di accesso utente di lunga durata utilizzando l'API Graph. Per un token valido per il trasferimento sono necessarie le autorizzazioni ads_management, ads_read e business_management.

I token di accesso utente di lunga durata scadono dopo 60 giorni.

Prerequisiti BigQuery

Ruoli BigQuery obbligatori

Per ottenere le autorizzazioni necessarie per creare un trasferimento, chiedi all'amministratore di concederti il ruolo IAM Amministratore BigQuery (roles/bigquery.admin). Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare un trasferimento. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per creare un trasferimento sono necessarie le seguenti autorizzazioni:

  • bigquery.transfers.update per l'utente
  • bigquery.datasets.get sul set di dati di destinazione
  • bigquery.datasets.update sul set di dati di destinazione

Potresti anche essere in grado di ottenere queste autorizzazioni con i ruoli personalizzati o altri ruoli predefiniti.

Crea un trasferimento di dati Facebook Ads

Seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud, vai alla pagina BigQuery Studio.

    Vai a BigQuery Studio

  2. Fai clic su Trasferimenti di dati > Crea un trasferimento.

  3. Nella sezione Tipo di origine, per Origine, seleziona Facebook Ads.

  4. Nella sezione Nome configurazione di trasferimento, in Nome visualizzato, inserisci un nome per il trasferimento.

  5. Nella sezione Opzioni di pianificazione, procedi nel seguente modo:

    • Nell'elenco Frequenza di ripetizione, seleziona un'opzione per specificare la frequenza di esecuzione di questo trasferimento. Per specificare una frequenza di ripetizione personalizzata, seleziona Personalizzata. Se selezioni On demand, questo trasferimento viene eseguito quando attivi manualmente il trasferimento.

    • Se applicabile, seleziona Inizia ora o Inizia all'ora impostata e specifica una data di inizio e un'ora di esecuzione.

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

  7. Nella sezione Dettagli origine dati, procedi nel seguente modo:

    • In ID client, inserisci l'ID app.
    • In Client secret, inserisci il secret dell'app.
    • In Aggiorna token, inserisci l'ID token di accesso utente di lunga durata facendo clic su Autorizza.

    Per informazioni sul recupero di questi valori, consulta i prerequisiti di Facebook Ads.

  8. (Facoltativo) Nel menu Account di servizio, seleziona un account di servizio tra quelli associati al tuo progetto Google Cloud. L'account di servizio selezionato deve disporre dei ruoli richiesti per eseguire questo trasferimento.

    Se hai eseguito l'accesso con un'identità federata, è 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.

    Per ulteriori informazioni sull'utilizzo degli account di servizio con il trasferimento di dati, vedi Utilizzare gli account di servizio.

  9. (Facoltativo) Nella sezione Opzioni di notifica, segui questi passaggi:

    • Per abilitare le notifiche via email, fai clic sul pulsante di attivazione/disattivazione Notifica via email. Abilitando questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un'esecuzione del trasferimento non va a buon fine.
    • Per abilitare le notifiche dell'esecuzione del trasferimento di Pub/Sub per questo trasferimento, fai clic sul pulsante di attivazione/disattivazione Notifiche Pub/Sub. Puoi selezionare il nome dell'argomento o fare clic su Crea un argomento per crearne uno.

  10. Fai clic su Salva.

Quando viene eseguito questo trasferimento, BigQuery Data Transfer Service completa automaticamente le seguenti tabelle.

Nome tabella Descrizione
AdAccounts Gli account pubblicitari disponibili per un utente.
AdInsights Report Informazioni annunci per tutti gli account annuncio.
AdInsightsActions Report sulle azioni di Statistiche sugli annunci per tutti gli account annuncio.

bq

Inserisci il comando bq mk e fornisci il flag di creazione del trasferimento --transfer_config:

bq mk \
    --transfer_config \
    --project_id=PROJECT_ID \
    --data_source=DATA_SOURCE \
    --display_name=DISPLAY_NAME \
    --target_dataset=DATASET \
    --params='PARAMETERS'

Dove:

  • PROJECT_ID (facoltativo): il tuo ID progetto Google Cloud. Se non viene fornito il valore --project_id per specificare un progetto specifico, viene utilizzato il progetto predefinito.
  • DATA_SOURCE: l'origine dati, ad esempio facebook-ads.
  • DISPLAY_NAME: il nome visualizzato per la configurazione di trasferimento. Il nome del trasferimento può essere qualsiasi valore che ti consenta di identificare il trasferimento se devi modificarlo in seguito.
  • DATASET: il set di dati di destinazione per la configurazione di trasferimento.
  • PARAMETERS: i parametri per la configurazione di trasferimento creata in formato JSON. Ad esempio: --params='{"param":"param_value"}'. Di seguito sono riportati i parametri per un trasferimento di Facebook Ads:
    • connector.authentication.oauth.clientId: il nome dell'ID app per il client OAuth 2.0.
    • connector.authentication.oauth.clientSecret: il segreto dell'app per il client OAuth 2.0.
    • connector.authentication.oauth.refreshToken: l'ID del token di lunga durata.

Ad esempio, il seguente comando crea un trasferimento di Facebook Ads nel progetto predefinito con tutti i parametri richiesti:

    bq mk 

        --transfer_config 

        --target_dataset=mydataset 

        --data_source=facebook_ads 

        --display_name='My Transfer' 

        --params='{"connector.authentication.oauth.clientId": "1650000000",
            "connector.authentication.oauth.clientSecret":"TBA99550",
            "connector.authentication.oauth.refreshToken":"abcdef"}'

API

Utilizza il metodo projects.locations.transferConfigs.create e fornisci un'istanza della risorsa TransferConfig.

Risolvere i problemi di configurazione del trasferimento

In caso di problemi durante la configurazione di un trasferimento di Facebook Ads, controlla la scheda Azioni richieste nella dashboard di Facebook App per individuare eventuali elementi che richiedono attenzione.

Prezzi

Non è previsto alcun costo per il trasferimento dei dati di Facebook Ads in BigQuery mentre questa funzionalità è in Anteprima.

Passaggi successivi