Pianificare un trasferimento di Facebook Ads

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Nota: per ricevere assistenza o fornire feedback per questa funzionalità, contatta [e-mail].

Il connettore BigQuery Data Transfer Service per Facebook Ads ti consente di pianificare e gestire automaticamente i job di caricamento ricorrenti da Facebook Ads in BigQuery.

Limitazioni

I trasferimenti di Inserzioni di Facebook sono soggetti alle seguenti limitazioni:

• L'intervallo di tempo minimo tra i trasferimenti ricorrenti di Facebook Ads è 24 ore su 24. L'intervallo predefinito per un bonifico periodico è di 24 ore.
• BigQuery Data Transfer Service for Facebook Ads supporta solo un set fisso di tabelle. I report personalizzati non sono supportati.
• I trasferimenti di annunci di Facebook hanno una durata massima di sei ore. R il trasferimento non va a buon fine se richiede più tempo di questa durata massima.
• I trasferimenti incrementali non sono supportati per AdInsights e AdInsightsActions tabelle. Quando crei un trasferimento di dati che include AdInsights e AdInsightsActions e hai specificato una data in Opzioni di pianificazione: tutti i dati disponibili per quella data sono trasferito.
• BigQuery Data Transfer Service supporta una finestra di aggiornamento di un giorno Tabelle AdInsights e AdInsightsActions. La finestra di aggiornamento si riferisce numero di giorni recuperati da un trasferimento di dati di origine dati. Quando esegui un trasferimento di dati per la prima volta, Data Transfer recupera tutti i dati di origine disponibili all'interno dell'aggiornamento finestra.

• Il token di accesso dell'utente di lunga durata richiesto per Facebook Ads i trasferimenti scadono dopo 60 giorni.

  Se il token di accesso dell'utente di lunga durata è scaduto, puoi ottenere quello nuovo accedendo ai dettagli del trasferimento e facendo clic su Modifica. Nella pagina di modifica del trasferimento, segui gli stessi passaggi nella Prerequisiti di Facebook Ads per generare un nuovo token di accesso dell'utente di lunga durata.

Importazione dati da trasferimenti di Facebook Ads

Quando trasferisci i dati da Facebook Ads a BigQuery, vengono caricati in tabelle BigQuery partizionate per data. La partizione della tabella in cui vengono caricati i dati corrisponde alla data da l'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 backfill in esecuzione non generano dati duplicati e le partizioni per altre date non sono interessate.

Per le tabelle AdInsights e AdInsightsAction, la partizione della tabella in cui vengono caricati i dati corrisponde alla data dell'origine dati.

Per le tabelle AdAccounts, gli snapshot vengono acquisiti una volta al giorno e archiviati della data di esecuzione dell'ultimo trasferimento. La finestra di aggiornamento non si applica a la tabella AdAccounts.

Prima di iniziare

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

Prerequisiti per Facebook Ads

Assicurati di disporre delle seguenti informazioni sugli annunci Facebook quando creando un trasferimento Facebook Ads.

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

Per ottenere un clientID e un clientSecret, esegui la seguenti passaggi:

1. Creare 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 il secret dell'app corrispondenti.

Per ottenere un token di accesso dell'utente di lunga durata, noto anche come 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 nel campo Refresh Token (Aggiorna token).

   

3. Fai clic sulla dashboard dell'app Facebook, quindi fai clic su Set up (Configura) nella sezione Facebook login for Business.

   

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. Si aprirà una pagina di autenticazione di Facebook.

   

6. Seleziona l'app per sviluppatori di 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. La Il token di accesso dell'utente di lunga durata è ora compilato nella configurazione di trasferimento.

I token di accesso degli utenti di lunga durata scadono dopo 60 giorni. Per informazioni su come per ottenere un nuovo token di accesso dell'utente di lunga durata, consulta Limitazioni.

Aggiorna alternative dei token

In alternativa, puoi fornire un token di aggiornamento durante la creazione di un trasferimento di dati se ne hai ottenuta una utilizzando uno dei seguenti metodi:

• Generare un token di accesso utente di lunga durata utilizzando l'API Graph. Le autorizzazioni ads_management, ads_read e business_management sono richiesto un token valido per il trasferimento.
• Genera un token utente di sistema. Un token utente di sistema consente di aggiungere manualmente asset, come gli account inserzionista, incluso nel trasferimento dei dati. Se un token utente di sistema è scaduto, devi aggiornare manualmente la configurazione di trasferimento con nuove credenziali. Inoltre puoi scegliere di creare un token che non scada quando crei un sistema token dell'utente. Per maggiori informazioni, vedi Token di accesso supportati.

Prerequisiti di BigQuery

• Verifica di aver completato tutte le azioni richieste per abilitare BigQuery Data Transfer Service.
• Crea un set di dati BigQuery per archiviare i dati.
• Se intendi configurare le notifiche di esecuzione del trasferimento per Pub/Sub, assicurati di disporre dell'autorizzazione Identity and Access Management (IAM) di pubsub.topics.setIamPolicy. Se configuri solo le notifiche via email, le autorizzazioni Pub/Sub non sono necessarie. Per ulteriori informazioni le informazioni, vedi Notifiche di esecuzione di BigQuery Data Transfer Service.

Ruoli BigQuery obbligatori

Per ottenere le autorizzazioni necessarie per creare un trasferimento, chiedi all'amministratore di concederti 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 vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare un trasferimento sono necessarie le seguenti autorizzazioni:

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

Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati e altri ruoli predefiniti.

Creare 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 Inserzioni di Facebook.

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

5. Nella sezione Opzioni di pianificazione, segui questi passaggi:

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

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

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

7. Nella sezione Dettagli origine dati:

   • In Client ID, inserisci l'ID app.
   • In Client secret, inserisci il secret dell'app.

   • In Aggiorna token, inserisci l'ID token di accesso dell'utente di lunga durata utilizzando facendo clic su Autorizza. In alternativa, se disponi già di un token di aggiornamento o di un token utente di sistema, puoi inserire il token di aggiornamento direttamente in questo campo.

     Per informazioni sul recupero di un token di accesso utente di lunga durata, consulta i prerequisiti di Facebook Ads.

8. (Facoltativo) Nel menu Account di servizio, seleziona un account di servizio dagli account di servizio associati progetto Google Cloud. Il servizio selezionato l'account deve disporre dei ruoli richiesti per eseguire questa trasferimento.

   Se hai eseguito l'accesso con un'identità federata: per creare un trasferimento è necessario un account di servizio. Se hai firmato con un Account Google, poi l'account di servizio per il trasferimento è facoltativo.

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

9. (Facoltativo) Nella sezione Opzioni di notifica, procedi nel seguente modo:

   • Per attivare le notifiche via email, fai clic su Notifica email pulsante di attivazione/disattivazione. Quando abiliti questa opzione, l'amministratore dei trasferimenti riceve una notifica via email quando un trasferimento non va a buon fine.
   • Per attivare Notifiche di esecuzione del trasferimento di Pub/Sub per questo trasferimento, fai clic sull'opzione di attivazione/disattivazione Notifiche Pub/Sub. Tu puoi selezionare argomento personalizzato oppure fai clic su Crea un argomento per crearne uno.

10. Fai clic su Salva.

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

Nome tabella	Descrizione
AdAccounts	Gli account inserzionista disponibili per un utente.
AdInsights	Report Informazioni annunci per tutti gli account inserzionista.
AdInsightsActions	Report sulle azioni delle informazioni sugli annunci per tutti gli account inserzionista.

bq

Inserisci il comando bq mk. e fornire 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:

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

Ad esempio, il seguente comando crea un trasferimento di Facebook Ads nella 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 la projects.locations.transferConfigs.create e fornisce un'istanza del metodo TransferConfig risorsa.

Risolvere i problemi di configurazione del trasferimento

Se riscontri problemi durante l'impostazione di un trasferimento di Facebook Ads, prova il i seguenti passaggi per la risoluzione dei problemi:

• Controlla se il token di accesso utente è scaduto utilizzando Facebook Access Token Debugger. Accesso utente di lunga durata scadono dopo 60 giorni. Se il token di accesso dell'utente di lunga durata è scaduto, vai ai dettagli del trasferimento e fai clic su Modifica per modificarlo. configurazione. Nella pagina di modifica del trasferimento, segui gli stessi passaggi nella Prerequisiti di Facebook Ads per generarne uno nuovo.
• Verifica che il token di accesso dell'utente di lunga durata sia generato con i token richiesti autorizzazioni - ads_management, ads_read e business_management. In caso contrario, segui i passaggi nei prerequisiti di Facebook Ads per generare un nuovo token di accesso dell'utente di lunga durata.
• Controlla la scheda Azioni richieste nella Dashboard dell'app Facebook per qualsiasi elemento che richiedono attenzione.

Potresti riscontrare i seguenti messaggi di errore relativi al limite di frequenza dell'API Meta errori:

Errore: There have been too many calls from this ad-account. Wait a bit and try again.

Soluzione: controlla che non esistano flussi di lavoro paralleli che utilizzano le stesse app o credenziali. Se questi errori persistono, prova a eseguire l'upgrade delle autorizzazioni ad accesso avanzato. per avere una quota maggiore di limitazione di frequenza. Per ulteriori informazioni, consulta la sezione Limitazione di frequenza dell'API di marketing.

Messaggi relativi alle metriche di monitoraggio comuni

Puoi anche controllare le metriche di monitoraggio di BigQuery Data Transfer Service. per determinare la causa di un errore di trasferimento. Nella tabella seguente sono elencati alcuni messaggi ERROR_CODE comuni per i trasferimenti di Facebook Ads.

Errore	Descrizione
INVALID_ARGUMENT	La configurazione fornita non è valida
PERMISSION_DENIED	Le credenziali non sono valide
UNAUTHENTICATED	È richiesta l'autenticazione
SERVICE_UNAVAILABLE	Al momento il servizio non è in grado di gestire questo trasferimento
DEADLINE_EXCEEDED	Il trasferimento non è stato completato entro la durata massima di sei ore
NOT_FOUND	Impossibile trovare una risorsa richiesta
INTERNAL	Un altro problema ha causato il mancato funzionamento del connettore
RESOURCE_EXHAUSTED	È stata esaurita una quota o un limite dell'origine dati

Prezzi

Non è previsto alcun costo per trasferire i dati di Facebook Ads in BigQuery mentre questa funzionalità è in Anteprima.

Passaggi successivi

• Scopri di più sulle BigQuery Data Transfer Service.
• Scopri di più sull'utilizzo dei trasferimenti. come la visualizzazione delle configurazioni e della cronologia delle esecuzioni.
• Scopri come caricare i dati con operazioni cross-cloud.