Programar uma transferência dos Anúncios do Facebook
Com o serviço de transferência de dados do BigQuery para anúncios do Facebook, você programa e gerencia automaticamente jobs de carregamento recorrentes dos anúncios do Facebook no BigQuery.
Limitações
As transferências de Anúncios do Facebook estão sujeitas às seguintes limitações:
- O tempo mínimo de intervalo entre transferências recorrentes dos Anúncios do Facebook é de 15 minutos. O intervalo padrão para uma transferência recorrente é 24 horas.
- O serviço de transferência de dados do BigQuery para anúncios do Facebook só é compatível com um conjunto fixo de tabelas. Não há suporte para relatórios personalizados.
- As transferências de Anúncios do Facebook têm uma duração máxima de seis horas. Uma transferência falhará se demorar mais do que essa duração máxima.
- Transferências incrementais não são aceitas.
- O serviço de transferência de dados do BigQuery aceita a transferência de dados de até um dia (ontem) para as tabelas
AdInsights
eAdInsightsActions
.
Antes de começar
As seções a seguir descrevem as etapas que você precisa seguir antes de criar uma transferência dos Anúncios do Facebook.
Pré-requisitos dos Anúncios do Facebook
Verifique se você tem as seguintes informações dos Anúncios do Facebook ao criar uma transferência de Anúncios do Facebook.
Parâmetros dos Anúncios do Facebook | Descrição |
---|---|
clientID |
O nome do ID do app para o cliente OAuth 2.0. |
clientSecret |
A chave secreta do app para o cliente OAuth 2.0. |
refreshToken |
O token de acesso do usuário de longa duração, também conhecido como token de atualização. |
Para conseguir um clientID
e um clientSecret
, siga
estas etapas:
- Crie um app de desenvolvedor do Facebook
com o tipo de app
Business
. - No painel do Aplicativo do Facebook, clique em Configurações do aplicativo > Básico e encontre o ID do aplicativo. e o secret do app que corresponde ao app.
Para conseguir um token de acesso do usuário de longa duração, também conhecido como token de atualização, execute as seguintes etapas:
No console do Google Cloud, continue com as etapas para criar uma transferência dos Anúncios do Facebook.
Na seção Detalhes da fonte de dados, copie o URI de redirecionamento listado após o campo Atualizar token.
Clique no painel do Aplicativo do Facebook e em Configurar na seção Login do Facebook para empresas.
Na página Configurações, insira o URL de redirecionamento no campo URIs de redirecionamento OAuth válidos e clique em Salvar.
Volte para o console do Google Cloud. Na seção Detalhes da fonte de dados, clique em Autorizar. Você será redirecionado para uma página de autenticação do Facebook.
Selecione o aplicativo de desenvolvedor do Facebook para autorizar a conta que se conecta com o serviço de transferência de dados do BigQuery.
Quando terminar, clique em Ok para retornar ao console do Google Cloud. O token de acesso de longa duração agora é preenchido na configuração de transferência.
Como alternativa, você pode gerar um token de acesso do usuário de longa duração usando a API Graph.
As permissões ads_management
, ads_read
e business_management
são
necessárias para um token válido para a transferência.
Os tokens de acesso do usuário de longa duração expiram após 60 dias.
Pré-requisitos do BigQuery
- Verifique se você realizou todas as ações necessárias para ativar o serviço de transferência de dados do BigQuery.
- Crie um conjunto de dados do BigQuery para armazenar os dados.
- Se quiser configurar notificações de execução de transferência do Pub/Sub,
verifique se você tem a permissão
pubsub.topics.setIamPolicy
do Identity and Access Management (IAM). Se você só configura notificações por e-mail, as permissões do Pub/Sub não são necessárias. Para mais informações, consulte Notificações de execução do serviço de transferência de dados do BigQuery.
Papéis obrigatórios do BigQuery
Para receber as permissões necessárias para criar um conjunto de dados federado,
peça ao administrador para conceder a você o papel do IAM
Administrador do BigQuery (roles/bigquery.admin
).
Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.
Esse papel predefinido contém as permissões necessárias para criar uma transferência. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As seguintes permissões são necessárias para criar uma transferência:
-
bigquery.transfers.update
do usuário -
bigquery.datasets.get
no conjunto de dados de destino -
bigquery.datasets.update
no conjunto de dados de destino
Essas permissões também podem ser concedidas com papéis personalizados ou outros papéis predefinidos.
Criar uma transferência de dados dos Anúncios do Facebook
Selecione uma das seguintes opções:
Console
No console do Google Cloud, acesse a página BigQuery Studio.
Clique em Transferências de dados > Criar uma transferência.
Na seção Tipo de origem, em Origem, selecione Anúncios do Facebook.
No campo Nome de exibição, na seção Nome de configuração da transferência, insira um nome para a transferência.
Na seção Opções de programação, realize estas ações:
Na lista Frequência de repetição, selecione uma opção para especificar com que frequência essa transferência é executada. Para especificar uma frequência de repetição personalizada, selecione Personalizada. Se você selecionar Sob demanda, essa transferência vai ser executada quando você acionar manualmente a transferência.
Se aplicável, selecione Começar agora ou Começar no horário definido e forneça uma data de início e um horário de execução.
Na seção Configurações de destino, em Conjunto de dados, escolha o conjunto criado para armazenar seus dados.
Na seção Detalhes da fonte de dados, faça o seguinte:
- Em ID do cliente, digite o ID do app.
- Em Chave secreta do cliente, digite a chave secreta do app.
- Em Token de atualização, insira o ID do token de acesso do usuário de longa duração clicando em Autorizar.
Para informações sobre como recuperar esses valores, consulte Pré-requisitos dos Anúncios do Facebook.
No menu Conta de serviço, selecione uma conta de serviço nas contas de serviço associadas ao seu projeto do Google Cloud. A conta de serviço selecionada precisa ter os papéis necessários para executar a transferência.
Se você fez login com uma identidade federada, é necessário uma conta de serviço para criar uma transferência. Se você fez login com uma Conta do Google, uma conta de serviço para a transferência é opcional.
Para mais informações sobre o uso de contas de serviço com transferências de dados, consulte Usar contas de serviço.
Opcional: na seção Opções de notificação, faça o seguinte:
- Para ativar as notificações por e-mail, clique no botão de alternância Notificação por e-mail. Quando essa opção está ativada, o administrador de transferência recebe uma notificação por e-mail quando uma execução de transferência falha.
- Para ativar as notificações de execução de transferência do Pub/Sub para essa transferência, clique no botão de alternância Notificações do Pub/Sub. Selecione o nome do tópico ou clique em Criar um tópico.
Clique em Salvar.
Quando essa transferência é executada, o serviço de transferência de dados do BigQuery preenche automaticamente as tabelas a seguir.
Nome da tabela | Descrição |
---|---|
AdAccounts |
As contas de anúncios disponíveis para um usuário. |
AdInsights |
Relatório de insights de anúncios para todas as contas de anúncios. |
AdInsightsActions |
Relatório de ações dos insights de anúncios para todas as contas de anúncios. |
bq
Insira o comando bq mk
e forneça a sinalização de execução da transferência
--transfer_config
:
bq mk \ --transfer_config \ --project_id=PROJECT_ID \ --data_source=DATA_SOURCE \ --display_name=DISPLAY_NAME \ --target_dataset=DATASET \ --params='PARAMETERS'
Em que:
- PROJECT_ID (opcional): o ID do projeto do Google Cloud.
Se
--project_id
não for fornecido para especificar um projeto determinado, o projeto padrão será usado; - DATA_SOURCE: a fonte de dados (por exemplo,
facebook-ads
). - DISPLAY_NAME: o nome de exibição da configuração da transferência. O nome da transferência pode ser qualquer valor que permita identificá-la, caso você precise modificá-la mais tarde.
- DATASET: o conjunto de dados de destino na configuração da transferência.
- PARAMETERS é o parâmetro da configuração de transferência criada no formato JSON. Por exemplo,
--params='{"param":"param_value"}'
. Confira a seguir os parâmetros para uma transferência dos Anúncios do Facebook:connector.authentication.oauth.clientId
: o nome do ID do app para o cliente OAuth 2.0.connector.authentication.oauth.clientSecret
: a chave secreta do app para o cliente OAuth 2.0.connector.authentication.oauth.refreshToken
: o ID do token de longa duração.
Por exemplo, o comando a seguir cria uma transferência dos Anúncios do Facebook no projeto padrão com todos os parâmetros necessários:
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
Use o método projects.locations.transferConfigs.create
e forneça uma instância do recurso
TransferConfig
.
Resolver problemas na configuração de transferência
Se você tiver problemas para configurar uma transferência dos Anúncios do Facebook, verifique a guia Ações necessárias no painel do app Facebook para verificar se há itens que exigem atenção.
Preços
Não há custo para transferir dados dos Anúncios do Facebook para o BigQuery enquanto esse recurso está em Pré-lançamento.
A seguir
- Saiba mais sobre o serviço de transferência de dados do BigQuery.
- Saiba mais sobre como trabalhar com transferências, como visualizar configurações e acessar o histórico de execução.
- Saiba como carregar dados com operações entre nuvens.