Conversions API Gateway para várias contas
O Conversions API Gateway para várias contas é um modo do Conversions API Gateway que permite conectar fontes de dados gerenciadas por diferentes contas empresariais da Meta à mesma instância do Gateway. A solução exige a implementação da plataforma de computação em nuvem Amazon Web Services (AWS) ou Google Cloud Platform (GCP) e tem uma arquitetura que fornece alta disponibilidade e escalabilidade. Os dados de cada conta empresarial são isolados e separados de forma lógica. Além disso, eles não podem ser acessados por outras contas empresariais conectadas à instância ou à respectiva entidade proprietária, a menos que o acesso seja concedido. Isso garante o uso seguro e eficiente dos recursos da plataforma de nuvem.
Com o Conversions API Gateway para várias contas, agências, parceiros, revendedores ou anunciantes descentralizados podem criar uma instância do Gateway para conectar as fontes de dados com as quais estão trabalhando à API de Conversões.
O Conversions API Gateway é um método de implementação de autoatendimento da API de Conversões. Ele permite que as empresas espelhem dados de marketing do Pixel da Meta para a API de Conversões que, em uma configuração redundante com o Pixel da Meta, ajuda o sistema de entrega a reduzir o custo por ação.
A versão atual do Conversions API Gateway para várias contas funciona com a Amazon Web Services (AWS) e o Google Cloud Platform (GCP).
Como fazer a integração
Se estiver tudo pronto para iniciar a implementação, clique no botão para ver um passo a passo da integração do host.
Iniciar a integração do host para o AWS App RunnerIniciar a integração do host para o AWS Elastic Kubernetes Service
Iniciar a integração do host para o GCP
Visão geral da arquitetura
O diagrama abaixo mostra o contexto de várias contas em que uma única instância do Gateway pode exibir mais Pixels da Meta, gerenciados por diferentes contas empresariais e disparados de domínios distintos.
O diagrama abaixo explica a conexão entre Pixel e Gateway, que é válida para cada uma das muitas conexões no contexto do Conversions API Gateway para várias contas.
- O Pixel da Meta, que é disparado nas páginas da web do anunciante, possibilita enviar ações e informações dos visitantes ao ponto de extremidade do Pixel da Meta e do Conversions API Gateway.
- O Conversions API Gateway recebe as ações e informações dos visitantes enviadas pelo Pixel da Meta, aplica a formatação com base nas especificações da API de Conversões e as envia ao ponto de extremidade da API de Conversões.
- O parâmetro de desduplicação (
event_id) é gerado automaticamente e enviado com os dados transferidos aos pontos de extremidade do Pixel da Meta e da API de Conversões.
A quem se destina?
A solução Conversions API Gateway para várias contas pode ser útil para:
- agências, parceiros e revendedores que querem oferecer um serviço que conecte as fontes de dados dos anunciantes ao Conversions API Gateway;
- anunciantes com múltiplos pixels (disparados em domínios diferentes e gerenciados por contas empresariais distintas) que buscam uma solução centralizada baseada no Conversions API Gateway para conectar o tráfego do próprio pixel à API de Conversões da Meta.
Perguntas frequentes sobre agências
Veja uma lista de perguntas frequentes de agências que querem integrar o Conversions API Gateway para várias contas.
Hosts e contas
Host: a agência, o parceiro, o revendedor ou o anunciante que cria e gerencia a instância do Gateway. O host é responsável por configurar, monitorar e solucionar problemas da instância, bem como por gerenciar e fazer a cobrança da conta da AWS ou do GCP. Ele define os termos do serviço oferecido às empresas que se conectam à instância.
Conta: uma empresa (anunciante) que conecta o próprio pixel a uma instância do Gateway do host. Recomendamos criar uma conta para um ou mais pixels que sejam:
- gerenciados pelo mesmo grupo de pessoas (ou seja, todos os usuários da conta têm acesso ao pixel pela conta empresarial); ou
- disparados no mesmo domínio do anunciante.
Conta gerenciada: uma conta em que as implementações do Pixel da Meta e da API de Conversões são (também) gerenciadas por uma agência, um parceiro ou um revendedor (o host). Especificamente, é delegado ao host acesso de administrador a determinados Pixels da Meta na plataforma do Gerenciador de Eventos. Em um processo padrão, o host cria a conta no Gateway e conecta os pixels à instância relacionada, sob os termos definidos por ele. O host também pode criar usuários da conta com permissões específicas para os funcionários do anunciante. Dependendo da permissão, eles serão capazes de administrar, gerenciar ou apenas visualizar a configuração da conta. O host e o anunciante controlam as configurações específicas do pixel e a conexão dele à instância do Gateway. A qualquer momento, a empresa pode migrar para uma conta não gerenciada.
Conta não gerenciada: uma conta em que as implementações do Pixel da Meta e da API de Conversõesnão são gerenciadas por uma agência, um parceiro nem um revendedor. Em um processo padrão, o host cria a conta e convida a empresa (um administrador da conta) para fazer a integração e conectar-se à instância, sob os termos definidos por ele. A empresa controla as configurações específicas do pixel e a conexão dele à instância. A qualquer momento, a empresa pode migrar para uma conta gerenciada.
Usuários e permissões
Hosts e contas podem criar usuários com uma das seguintes permissões:
Administrar usuários | Host Conta Os usuários administradores podem gerenciar os usuários e as permissões das próprias contas, além de adicionar, remover e atualizar pixels e visualizar todos os apps associados a elas. |
Gerenciar usuários | Host Conta Os gerentes podem fazer alterações em pixels atribuídos, incluindo configurações. |
Visualizar usuários | Host Conta |
Primeiros passos
Se estiver tudo pronto para iniciar a implementação, clique no botão para ver um passo a passo da integração do host.
Iniciar a integração do host para o AWS App RunnerIniciar a integração do host para o AWS Elastic Kubernetes Service
Iniciar a integração do host para o GCP
Componentes técnicos
Amazon Web Services e Google Cloud Platform
O Conversions API Gateway para várias contas exige a implementação da plataforma de computação em nuvem sob demanda Amazon Web Services (AWS) ou Google Cloud Platform (GCP). A conta da AWS ou do GCP pertence e é gerenciada por agências, parceiros, revendedores ou anunciantes que implementam o Conversions API Gateway para várias contas, ou seja, pelo host, e não pela Meta. O host pode implantar automaticamente a instância sem precisar da ajuda de um desenvolvedor. A arquitetura do Gateway para várias contas é baseada no Amazon Elastic Kubernetes Service (Amazon EKS).
Componentes de software
Pixel da Meta
É a biblioteca JavaScript padrão carregada nas páginas da web do anunciante que envia ações e informações do cliente à Meta, descritas como Dados das Ferramentas para Empresas nos Termos das Ferramentas da Meta para Empresas. Para anunciantes que integraram o Conversions API Gateway para várias contas, o Pixel da Meta executará as ações a seguir quando for acionado:
- Baixar e iniciar o código do cliente WebSocket da API de Conversões usado para estabelecer a comunicação com o Conversions API Gateway para várias contas
- Enviar os dados do evento aos pontos de extremidade do Pixel da Meta e do Conversions API Gateway para várias contas por meio de uma conexão HTTP segura
Conversions API Gateway para várias contas
O Conversions API Gateway para várias contas é hospedado por agências, parceiros, revendedores ou anunciantes nas respectivas contas da Amazon Web Services (AWS) ou do Google Cloud Platform (GCP). Ele é provisionado na conta da AWS ou do GCP e inclui o seguinte:
- Um módulo que registra eventos recebidos (ações do visitante do site) do Pixel da Meta, aplica a formatação com base nas especificações da API de Conversões e os envia ao ponto de extremidade da API de Conversões da Meta.
- Uma interface do usuário onde os hosts podem administrar a instância do host (usuários, contas, atualizações, entre outros).
- Uma interface do usuário onde as contas administram a própria conta (usuários, fontes de dados, roteamento de dados, entre outros).
Extensão da Meta para Empresas
No Conversions API Gateway para várias contas, a Extensão da Meta para Empresas (MBE, pelas iniciais em inglês) é usada para facilitar a integração de hosts e contas, bem como para conectar com segurança fontes de dados à instância.
Configuração do DNS
Os hosts precisam configurar um registro CNAME no próprio provedor de DNS para associar um subdomínio à instância do Conversions API Gateway para várias contas (especificamente, ao balanceador de carga da instância) e permitir o acesso pela web.
Recomendamos que as contas configurem um registro CNAME no provedor DNS associando um subdomínio do próprio domínio ao subdomínio do host. Isso permitirá uma conexão primária entre o Pixel da Meta nos respectivos sites e a instância do Conversions API Gateway para várias contas.
Cloudflare como um serviço de DNS integrado padrão
Um balanceador de carga é um componente na infraestrutura do Conversions API Gateway que ajuda a distribuir tráfego de rede recebido em vários servidores. Ao utilizar um balanceador de carga, podemos garantir que nosso app permaneça com alta disponibilidade e responda mesmo durante períodos de tráfego alto.
Além do balanceamento de carga, também usamos certificados SSL/TLS para criptografar dados em trânsito entre clientes e o Conversions API Gateway. Estes certificados são emitidos sempre que um anunciante configura um domínio interno. Um anunciante usaria o domínio da agência por padrão se não tivesse configurado o domínio interno. A vantagem de configurar um domínio interno é que os eventos de pixel serão encaminhados para esse domínio que é propriedade e controlado pelo anunciante; caso contrário, os eventos de pixel serão direcionados do anunciante para a Meta, mas por meio do domínio da agência. Atualmente, o Conversions API Gateway aceita anexar apenas um certificado ao balanceador de carga.
Usando o Cloudflare, podemos superar essa limitação. Um dos principais benefícios de usar o Cloudflare é sua capacidade de emitir até 5.000 certificados SSL/TLS para domínios de anunciantes que apontam para um domínio de agência de gerenciamento ou de propriedade da Cloudflare, isto é, permite que até 5.000 anunciantes por instância do Conversions API Gateway usem um domínio interno. Caso tenha uma instância do Conversions API Gateway baseada em AWS EKS, uma vantagem a mais com o uso do Cloudflare é que também custa menos do que usar o domínio padrão e gerado aleatoriamente do AWS Cloudfront fornecido pelo Conversions API Gateway devido ao custo mais barato de terminação SSL.
Compartilhamento de dados
Com o Conversions API Gateway para várias contas, as empresas podem enviar os mesmos dados compartilhados ao usar o Pixel da Meta, com exceção da lista abaixo. Consulte o Meta Business Solutions Center para saber mais.
Os dados a seguir não são compatíveis com o Conversions API Gateway:
- Ações de clientes configuradas usando a Ferramenta de configuração de evento
- Cookies de terceiros da Meta
Iniciar a implementação
Se estiver tudo pronto para iniciar a implementação, clique no botão para ver um passo a passo da integração e do gerenciamento do host.
Se estiver tudo pronto para iniciar a implementação, clique no botão para ver um passo a passo da integração do host.
Iniciar a integração do host para o AWS App RunnerIniciar a integração do host para o AWS Elastic Kubernetes Service
Iniciar a integração do host para o GCP