Configure o Openflow Connector for Meta Ads¶

Nota

O conector está sujeito aos termos do conector.

Este tópico descreve as etapas para configurar o Openflow Connector for Meta Ads.

Pré-requisitos¶

Certifique-se de ter revisado Sobre a Openflow Connector for Meta Ads.
Certifique-se de ter configurado o Openflow.

Obtenha as credenciais¶

Como administrador do Meta Ads, execute as seguintes ações em sua conta Meta Ads:

Crie um aplicativo Meta ou certifique-se de ter acesso a um.
Habilite a Marketing API no painel do aplicativo.
Gere um token de longa duração.
Opcional: aumente o limite de taxa alterando o tipo de acesso ao aplicativo de Standard access para Advanced access do acesso padrão de gerenciamento de anúncios. Habilite as permissões ads_read e ads_management.

Configure a conta Snowflake¶

Como administrador de conta Snowflake, execute as seguintes tarefas:

Crie uma nova função ou use uma função existente e conceda a Privilégios de banco de dados.
Crie um novo usuário de serviço Snowflake com o tipo SERVICE.
Conceda ao usuário do serviço Snowflake a função que você criou nas etapas anteriores.
Configure com a autenticação de pares de chaves para o usuário do Snowflake SERVICE da etapa 2.
A Snowflake recomenda enfaticamente essa etapa. Configure um gerenciador de segredos compatível com o Openflow, por exemplo, AWS, Azure e Hashicorp, e armazene as chaves públicas e privadas no armazenamento de segredos.

Nota

Se, por algum motivo, você não quiser usar um gerenciador de segredos, será responsável por proteger os arquivos de chave pública e chave privada usados para autenticação de pares de chaves de acordo com as políticas de segurança de sua organização.
1. Depois que o gerenciador de segredos estiver configurado, determine como você se autenticará nele. No AWS, é recomendável que você use a função de instância EC2 associada ao Openflow, pois dessa forma nenhum outro segredo precisa ser mantido.
2. No Openflow, configure um provedor de parâmetros associado a esse gerenciador de segredos, no menu de três traços no canto superior direito. Navegue até Controller Settings » Parameter Provider e, em seguida, busque os valores dos parâmetros.
3. Nesse momento, todas as credenciais podem ser referenciadas com os caminhos de parâmetros associados e nenhum valor sensível precisa ser mantido no Openflow.
Se qualquer outro usuário Snowflake precisar de acesso aos documentos e tabelas brutos ingeridos pelo conector (por exemplo, para processamento personalizado no Snowflake), conceda a esses usuários a função criada na etapa 1.
Designar um warehouse para o conector usar. Comece com o menor tamanho de warehouse e, em seguida, experimente o tamanho, dependendo do número de tabelas sendo replicadas e da quantidade de dados transferidos. Os números de tabelas grandes normalmente são mais bem dimensionados com warehouses multicluster, em vez de warehouses maiores.

Configuração do conector¶

Como engenheiro de dados, execute as seguintes tarefas para instalar e configurar o conector:

Instalação do conector¶

Crie um banco de dados e um esquema no Snowflake para que o conector armazene os dados ingeridos. Conceda os Privilégios de banco de dados necessários à função criada na primeira etapa. Substitua o espaço reservado para a função pelo valor real e use os seguintes comandos SQL:

CREATE DATABASE META_ADS_DESTINATION_DB;
CREATE SCHEMA META_ADS_DESTINATION_DB.META_ADS_DESTINATION_SCHEMA;
GRANT USAGE ON DATABASE META_ADS_DESTINATION_DB TO ROLE <META_ADS_CONNECTOR_ROLE>;
GRANT USAGE ON SCHEMA META_ADS_DESTINATION_DB.META_ADS_DESTINATION_SCHEMA TO ROLE <META_ADS_CONNECTOR_ROLE>;
GRANT CREATE TABLE ON SCHEMA META_ADS_DESTINATION_DB.META_ADS_DESTINATION_SCHEMA TO ROLE <META_ADS_CONNECTOR_ROLE>;

Copy

Navegue até a página Visão geral do Openflow. Na seção Featured connectors, selecione View more connectors.
Na página de conectores do Openflow, localize o conector e selecione Add to runtime.
Na caixa de diálogo Select runtime, selecione seu tempo de execução na lista suspensa Available runtimes.
Selecione Add.

Nota

Antes de instalar o conector, verifique se você criou um banco de dados e um esquema no Snowflake para que o conector armazene os dados ingeridos.
Autentique-se na implementação com as credenciais de sua conta Snowflake e selecione Allow quando solicitado para permitir que o aplicativo de tempo de execução acesse sua conta Snowflake. O processo de instalação do conector leva alguns minutos para ser concluído.
Autentique-se no tempo de execução com as credenciais de sua conta Snowflake.

A tela do Openflow é exibida com o grupo de processos do conector adicionado a ela.

Configuração do conector¶

Clique com o botão direito do mouse no grupo de processos importado e selecione Parameters.
Preencha os valores dos parâmetros necessários conforme descrito em Parâmetros de fluxo.

Parâmetros de fluxo¶

Esta seção descreve os parâmetros de fluxo que podem ser configurados com base nos contextos de parâmetros a seguir:

Parâmetros de origem do Meta Ads: usados para estabelecer conexão com a MetaAds API.
Parâmetros de destino do Meta Ads: usados para estabelecer conexão com o Snowflake.
Parâmetros de ingestão do Meta Ads: usados para definir a configuração dos dados baixados do Meta Ads.

Parâmetros de origem do Meta Ads¶

Parâmetro	Descrição
Token de acesso	Token necessário para solicitar a Insights API do Meta Ads

Parâmetros de destino do Meta Ads¶

Parâmetro	Descrição
Banco de dados de destino	O banco de dados onde os dados serão mantidos. Ele já deve existir no Snowflake.
Esquema de destino	O esquema em que os dados serão mantidos. Ele já deve existir no Snowflake.
Identificador de conta Snowflake	Nome da conta Snowflake formatado como [organization-name]-[account-name] onde os dados serão mantidos
Estratégia de autenticação Snowflake	Estratégia de autenticação para o Snowflake. Valores possíveis: `SNOWFLAKE_SESSION_TOKEN` quando você estiver executando o fluxo em SPCS, e `KEY_PAIR` quando quiser configurar o acesso usando uma chave privada.
Chave privada Snowflake	A chave privada RSA utilizada para autenticação. A chave RSA deve ser formatada de acordo com os padrões PKCS8 e ter cabeçalhos e rodapés no padrão PEM. Observe que o arquivo de chave privada Snowflake ou a chave privada Snowflake devem ser definidos.
Arquivo de chave privada Snowflake	O arquivo que contém a chave privada RSA usada para autenticação no Snowflake, formatado de acordo com os padrões PKCS8 e com cabeçalhos e rodapés no padrão PEM. A linha do cabeçalho começa com `-----BEGIN PRIVATE`. Marque a caixa de seleção Reference asset para carregar o arquivo de chave privada.
Senha de chave privada Snowflake	A senha associada ao arquivo de chave privada Snowflake
Função Snowflake	Função Snowflake usada durante a execução da consulta
Nome de usuário do Snowflake	Nome de usuário usado para se conectar à instância Snowflake
Warehouse Snowflake	Warehouse Snowflake usado para executar consultas

Parâmetros de ingestão do Meta Ads¶

Parâmetro	Descrição
Nome do relatório	Nome do relatório a ser usado como nome da tabela de destino. O nome deve ser exclusivo no esquema de destino.
Report Object Id	Identificador do objeto baixado do Meta Ads. Referência à API listando diferentes IDs de objeto: Contas de anúncio Conjuntos de anúncio Anúncios Campanhas
Estratégia de ingestão de relatórios	Modo em que os dados são obtidos, instantâneo ou incremental
Meta Ads Version	Versão da Meta Ads API usada para fazer download de relatórios. Valor permitido: `v22.0`.
Nível do relatório	Apresenta o nível de agregação do resultado. Possíveis valores: `account` `campaign` `ad` `adset`.
Campos de relatório	Lista de campos de relatório separados por vírgulas
Detalhamento de relatórios	Lista de detalhamentos de relatórios separados por vírgulas. A lista completa de detalhamentos disponíveis pode ser encontrada aqui.
Incremento de tempo do relatório	Nível de agregação com base na contagem de dias Possíveis valores: `1` – Diariamente `3` – A cada 3 dias `7` – Semanalmente `monthly` – Mensalmente `90` – Trimestral `all_days` – Todos os dias; não corte o resultado
Report Action Time	Estatísticas de tempo de ação Possíveis valores: `conversion` – Relatórios de ação com base na data de conversão `impression` – Relatórios de ação com base na data de impressão `mixed` – Abordagem mista entre conversão e impressão
Report Click Attribution Window	Janela de atribuição para a ação de clique Possíveis valores: `1d_click` `7d_click` `28d_click`
Report View Attribution Window	Janela de atribuição para a ação de exibição Possíveis valores: `1d_view` `7d_view` `28d_view`
Cronograma do relatório	Agende horário para o processador criar relatórios
Data de início do relatório	Data de início a partir da qual a ingestão deve ocorrer. O formato da data é YYYY-MM-DD.

Execute o fluxo¶

Clique com o botão direito do mouse no plano e selecione Enable all Controller Services.
Clique com o botão direito do mouse no grupo de processos importado e selecione Start. O conector inicia a ingestão de dados.

Como redefinir o conector¶

Para redefinir totalmente o conector para o estado inicial, faça o seguinte:

Certifique-se de que não haja mais FlowFiles nas filas.
Parar todos os processadores.
Limpe o estado do processador inicial.
1. Clique com o botão direito do mouse no processador Create Meta Ads Report e selecione View State.
2. Selecione a opção Clear State. Isso redefine o estado do processador.
Solte a tabela de destino no Snowflake.