Configure o Openflow Connector for Amazon Ads

Nota

O conector está sujeito aos termos do conector.

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

Pré-requisitos

  1. Certifique-se de ter revisado Sobre a Openflow Connector for Amazon Ads.

  2. Certifique-se de ter configurado o Openflow.

Obtenha as credenciais

Como administrador do Amazon Ads, execute as seguintes ações:

  1. Certifique-se de que você tenha acesso a uma conta Amazon Ads.

  2. Adquira o acesso à Amazon Ads API e conclua o processo de integração.

  3. Obtenha o ID e segredo de cliente.

  4. Crie uma concessão de autorização e recupere um token de atualização.

  5. Analise as regiões disponíveis e obtenha um URL base usado para solicitações com base na região em que você está anunciando.

  6. Busque os IDs de perfil para configuração do relatório.

Configure a conta Snowflake

Como administrador de conta Snowflake, execute as seguintes tarefas:

  1. Crie uma nova função ou use uma função existente e conceda a Privilégios de banco de dados.

  2. Crie um novo usuário de serviço Snowflake com o tipo SERVICE.

  3. Conceda ao usuário do serviço Snowflake a função que você criou nas etapas anteriores.

  4. Configure com a autenticação de pares de chaves para o usuário do Snowflake SERVICE da etapa 2.

  5. 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.

  6. 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.

  7. 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

  1. Navegue até a página Visão geral do Openflow. Na seção Featured connectors, selecione View more connectors.

  2. Na página de conectores do Openflow, localize o conector e selecione Add to runtime.

  3. Na caixa de diálogo Select runtime, selecione seu tempo de execução na lista suspensa Available runtimes.

  4. 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.

  5. 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.

  6. 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

  1. Clique com o botão direito do mouse no grupo de processos importado e selecione Parameters.

  2. 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 Amazon Ads

Parâmetro

Descrição

ID do cliente

ID de cliente da conta Amazon Advertising

Segredo do cliente

Segredo de cliente da conta Amazon Advertising

URL base de OAuth

O URL do servidor de autorização que emite o token de acesso

Possíveis valores:

Token de atualização

Token de atualização para a Amazon Ads API

Região

Ambiente do qual os dados de publicidade são baixados

Possíveis valores:
  • NA

  • EU

  • FE

Parâmetros de destino do Amazon 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 estivermos executando o fluxo em SPCS, e KEY_PAIR quando quisermos definir o acesso usando a 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 do Snowflake ou a chave privada do 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 Amazon 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.

Relatório de produto de anúncio

Tipo de produto publicitário que está sendo relatado

Possíveis valores:
  • SPONSORED_PRODUCTS

  • SPONSORED_BRANDS

  • SPONSORED_DISPLAY

  • SPONSORED_TELEVISION

  • DEMAND_SIDE_PLATFORM

Colunas do relatório

Conjunto de colunas que estarão presentes no relatório final

Filtros de relatório

Conjunto de filtros usados para cortar os dados retornados

Agrupar relatórios por

Nível de granularidade do relatório

Estratégia de ingestão de relatórios

Modo em que os dados são obtidos, instantâneo ou incremental

Possíveis valores:
  • SNAPSHOT

  • INCREMENTAL

Janela de ingestão de relatórios

Especifica o número de dias, cujos dados devem ser baixados durante a ingestão incremental

ID do perfil do relatório

O ID de perfil associado a uma conta de publicidade em um mercado específico

Unidade de tempo do relatório

Agregação de datas

Possíveis valores:
  • DAILY: cada dia é representado por uma linha

  • SUMMARY: todo o período de data ingerido é representado como uma linha

Tipo de relatório

Tipo de dados contidos no relatório

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.

Cronograma do relatório

Agende horário para o processador criar relatórios

Execute o fluxo

  1. Clique com o botão direito do mouse no plano e selecione Enable all Controller Services.

  2. Clique com o botão direito do mouse no grupo de processos importado e selecione Start. O conector inicia a ingestão de dados.