(API de conversões) API de conversões do Reddit

Seguir
Avatar
Travis Simpson
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 Reddit permite que os anunciantes enviem conversões de cliques atribuídas pela Singular para o Reddit. Esta integração é suportada para a medição Singular para web, PC e consola. Para a integração da medição móvel do Singular com o Reddit, consulte nosso artigo da Central de Ajuda sobre o tópico.

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

  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"Reddit 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. Encontre sua ID de pixel do Reddit. Especifique qual conta comercial deve receber suas conversões. Você pode encontrar sua ID de pixel no Gerenciador de eventos, e ela deve corresponder à ID de pixel da conta comercial encontrada em Contas.
  6. Gerar um token de acesso à API de conversão. O Reddit recomenda a geração de um token de conversão para que não tenhas de te preocupar com a sua expiração.
  7. Cole no seu aplicativo o"ID da conta do Reddit" e o"Token da API de conversão do Reddit" das etapas 5 e 6 acima.


  8. Opcionalmente, configure quaisquer eventos adicionais para enviar para o Reddit e mapeie-os para um "Reddit Event Name" (Nome do evento do Reddit)


  9. Clique em"Guardar" para terminar.

PERGUNTAS FREQUENTES

Como posso validar que o Reddit está a receber eventos do Singular
  1. Navegue até o Gerenciador de eventos do Reddit.
  2. Você deve ver os eventos do Reddit mapeados a partir da configuração do seu parceiro Singular gravados aqui

Quais dados o Singular envia via API?
Parâmetro Detalhes
click_id
  • ID de clique do Reddit
  • passado automaticamente
email
  • Opcional
  • O e-mail com hash pode ser passado como um atributo de evento instrumentado do Singular"ehash" (consulte a documentação do SDK do Singular para obter detalhes sobre o envio de atributos de evento)
  • O valor do e-mail com hash deve ser normalizado e com hash SHA 256
IP address
user agent
  • (Apenas para a Web) O agente do utilizador do browser correspondente ao evento
external_id
  • ID de utilizador definido pelo anunciante (custom_user_id)
Reddit uuid
  • Opcional
  • Gerado pelo pixel do Reddit
  • Pode ser recuperado a partir do cookie de 1ª parte do Reddit e enviado em argumentos de eventos Web com a chave rdt_uuid
  • e.g. {"rdt_uuid":"532ae67f-e9e0-47b8-9d81-b47fdb62f014"}
IDFA / GAID
  • passado automaticamente
  • IDs de dispositivos móveis apenas para iOS e Android
conversion_id
  • Opcional
  • Se você estiver usando a integração da API de conversão do Reddit Pixel e do Singular Reddit para enviar o mesmo evento, será necessário aproveitar a ID de conversão
  • Envie a ID de conversão em seus Argumentos de evento da Web para Singular na chave eventId
  • e.g. {"eventId":"12343abcdkjdf"}
Quais são as limitações da API de conversões do Reddit?
  • O Reddit recomenda que a API de Conversões do Reddit seja utilizada para aumentar uma implementação de píxeis do Reddit existente (ver Melhores práticas na documentação do Reddit).
  • Usando a integração da API de conversões do Reddit no Singular, os eventos do aplicativo podem ser enviados e registrados como eventos do site no Reddit para fluxos de atribuição da Web para o aplicativo. No entanto, para integrações mobile, o Reddit e o Singular recomendam passar dados de conversão mobile através da integração de atribuição mobile dedicada do Singular com o Reddit.