(Conversão de API) Meta-conversões de API

Seguir
Avatar
Jonathan Chen
Updated
Documento
OsPostbacks de conversão para eventosna Web, PC e consola só estão disponíveis para clientes Singular com acesso à atribuição de jogos na Web, PC e consola da Singular.

A integração da Singular com a API de Conversões do Meta permite que os anunciantes enviem conversões de cliques do Meta atribuídas pela Singular para o Meta. Esta integração é suportada para a medição da Singular para web, PC e consola. Para a integração da medição móvel da Singular com o Meta, consulte nosso artigo da Central de Ajuda sobre o tópico.

Como configurar a integração da API de conversões do Meta

  1. Certifique-se de que você tem um aplicativo integrado para web, PC ou console com o Singular
  2. Vá para Singular > Atribuição > Configuração de parceiro
  3. Clique em "Adicionar um parceiro", digite e escolha "Meta Conversions API"
  4. Na caixa de diálogo, escolha seu aplicativo e site de aplicativo (plataforma) para configurar. Tenha em atenção que apenas as aplicações Web, PC e consola são suportadas com esta integração
  5. Cole o"Access Token" e a"Dataset ID" da sua aplicação a partir do painel de controlo do Meta Event Manager.


  6. Opcionalmente, configure quaisquer eventos adicionais para enviar ao Meta e mapeie-os para um "Nome do evento Meta"


  7. Clique em "Salvar" para concluir.

PERGUNTAS FREQUENTES

Onde é que se pode encontrar o ID do conjunto de dados Meta?
  1. Navegue até ao Gestor de Eventos Meta.
  2. Em"Data Sources", selecione a sua fonte de dados web/PC/Console

    Se esta for uma nova fonte de dados, crie uma nova fonte de dados através de"Ligar fontes de dados" e siga o guia passo-a-passo do Meta para criar uma fonte de dados"Web". Leia mais sobre as fontes de dados do Meta aqui.
  3. Em"Settings"(Configurações), copie seu"Dataset ID" (ID do conjunto de dados)
Onde pode encontrar o Token de acesso?
  1. Navegue até o Gerenciador de eventos do Meta.
  2. Em"Fontes de dados", selecione a sua fonte de dados web/PC/Console.


    Se esta for uma nova fonte de dados, crie uma nova fonte de dados através de"Conectar fontes de dados" e siga o guia passo a passo do Meta para criar uma fonte de dados"Web". Leia mais sobre as fontes de dados do Meta aqui.
  3. Em"Definições", desloque-se para baixo até"API de conversões" e, em"Configurar integração direta", gere e copie o token de acesso.

Que dados é que o Singular envia através da API?
Parâmetro Detalhes
event_name
  • Um evento padrão ou nome de evento personalizado. Este campo é mapeado automaticamente para o Nome do evento Singular. Este valor é utilizado para ajudar o META na deduplicação de eventos. O parâmetro event_id também é usado na deduplicação.
fbc
  • ID de clique do Facebook
  • passado automaticamente
hashed email
  • Opcional
  • O e-mail com hash pode ser passado como um atributo de evento instrumentado Singular "ehash"
  • O valor do e-mail com hash deve ser normalizado e com hash SHA 256
hashed phone number
  • Opcional
  • O número de telefone com hash pode ser passado como um atributo de evento instrumentado Singular "phash"
  • O número de telefone com hash tem de ser normalizado com E164 e com hash SHA 256
hashed first name
  • Opcional
  • O nome próprio com hash pode ser transmitido como um atributo de evento instrumentado Singular "fnamehash"
  • Recomenda-se a utilização de caracteres a-z do alfabeto romano. Apenas em minúsculas e sem pontuação. Se forem utilizados caracteres especiais, o texto deve ser codificado no formato UTF-8.
  • O primeiro nome com hash deve ter um hash SHA 256
hashed last name
  • Opcional
  • O apelido com hash pode ser transmitido como um atributo de evento instrumentado Singular "fnamehash"
  • Recomenda-se a utilização de caracteres a-z do alfabeto romano. Apenas letras minúsculas e sem pontuação. Se forem utilizados caracteres especiais, o texto deve ser codificado no formato UTF-8.
  • O último nome com hash deve ter um hash SHA 256
IP address
  • O endereço IP do cliente
user agent
  • (Apenas para a Web) O agente do utilizador do browser correspondente ao evento
Para a deduplicação de eventos (opcional)
event_id
  • Parâmetro necessário para a deduplicação
  • Passe o valor event_id para o Singular nos Argumentos do evento usando um nome de atributo:"eventId".

Meta-requisitos:

  • O parâmetro event_id deve ser adicionado aos seus eventos tanto da API de conversões quanto do Pixel do navegador.
  • O parâmetro event_id é um identificador que pode distinguir exclusivamente entre eventos semelhantes. Leia mais sobre o parâmetro event_id.
Quais são as limitações da API de Meta Conversões?
  • A Meta recomenda que a API de conversões Meta seja utilizada para aumentar uma implementação existente de píxeis Meta.
  • Para integrações móveis, a Meta e a Singular recomendam passar dados de conversão móvel através da integração de atribuição móvel dedicada da Singular com a Meta. Se estiver interessado em transmitir dados de conversão móvel através da API de conversão Meta, contacte o seu gestor de sucesso do cliente Singular.