(API de conversões) API de metaconversões - Telemóvel

Seguir
Avatar
Travis Simpson
Updated
Documento

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 diretamente para o Meta. Essa integração suporta a mensuração Web-to-app, permitindo que eventos in-app sejam enviados para a API de Conversão do Meta como eventos Web para otimizar campanhas Web focadas em impulsionar instalações de aplicativos e engajamento do usuário.

Para obter detalhes sobre a integração da medição móvel da Singular com o Meta, consulte nosso[artigo da Central de Ajuda] dedicado ao tópico.

Como configurar a integração da API do Meta Conversions (Mobile)

  1. Certifique-se de ter um Web SDK integrado com Encaminhamento de atribuição de site para aplicativo
  2. Vá para Singular > Atribuição > Configuração de parceiro
  3. Clique em "Adicionar um parceiro", digite e escolha: "Meta Conversions API (Mobile)"
  4. Na caixa de diálogo, escolha seu aplicativo e site de aplicativo (plataforma) para configurar.
    Note que apenas as aplicações iOS e Android são suportadas com esta integração

  5. Cole o"Access Token" e o"Dataset ID" da sua aplicação a partir do seu painel de instrumentos Meta Event Manager.

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

  7. Clique em"Salvar" para concluir.

PERGUNTAS FREQUENTES

Onde se pode encontrar o ID do conjunto de dados do Meta?
  1. Navegue até ao Gestor de Eventos 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"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"Definições", copie a sua"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 essa for uma nova fonte de dados, crie uma nova fonte de dados por meio 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é"Conversions API" 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 obrigatório para 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 usada para aumentar uma implementação existente do Meta Pixel.