Conecte o Reddit Ads

Conecte uma Property do SupremeTracking a um Reddit Pixel e à Reddit Conversions API (CAPI) v3. Com a entrega Browser + Server, o Pixel do navegador e a requisição de servidor do Node carregam o mesmo conversion ID para que o Reddit consiga deduplicar as duas cópias.

O Reddit Ads é hoje uma integração de rollout limitado. Este guia se aplica quando Reddit Ads aparece no catálogo do Console com um release instalável. Um badge de PRIVATE BETA, COMING SOON ou UPDATE NODE significa que ainda falta acesso, um release publicado, ou um Node compatível. A implementação atual do módulo é a versão 1.0.0; a publicação do pacote e a entrega real ao Reddit são portões de release separados.

Pré-requisitos

Antes de começar, tenha em mãos:

• Uma Property no Console para o site que você quer rastrear.
• O Loader do SupremeTracking instalado nesse site e um evento canônico mapeado chegando ao Node.
• Uma versão de Node aceita pelo release do módulo Reddit. Use o Node 3.4.4 ou mais recente ao verificar a deduplicação browser/server; comportamentos de Loader anteriores não conseguem provar o caminho de conversion ID compartilhado para todo produtor de eventos de navegador.
• Acesso à conta de anúncios do Reddit e ao Events Manager dela.
• O Pixel ID do Reddit para a fonte de dados.
• Um Conversion Access Token do Reddit. O Reddit não permite recuperar esse token depois de criado, então guarde-o com segurança antes de sair do Reddit.
• Um Test ID opcional do Reddit Events Manager para Event Testing.

O Pixel ID é um identificador seguro para exposição no navegador, usado pelo Pixel e pelo endpoint da CAPI. O Conversion Access Token é um segredo usado somente pelo Node para requisições CAPI. Não coloque o token no GTM, em código do site, capturas de tela ou tickets públicos de suporte.

Instale o módulo Reddit

A instalação adiciona código de módulo a este Node. Ela não cria uma conexão de Property.

1. Abra Integrations no Console.
2. Selecione Manage Modules, depois Install module.
3. Encontre Reddit Ads em destinos.
4. Selecione Install Module e confirme a instalação.
5. Volte para Manage Modules e confirme que Reddit Ads mostra Installed com uma versão.

Se o card disser PRIVATE BETA, sua conta não tem atualmente o acesso de beta exigido. Se disser UPDATE NODE, atualize o Node para a versão mínima mostrada pelo catálogo antes de instalar. Uma entrada no catálogo, sozinha, não prova que o código do módulo está instalado neste Node.

Crie a conexão da Property

1. Abra a aba Connections em Integrations.
2. Selecione New connection.
3. Escolha a Property de destino.
4. Escolha Reddit Ads como Module.
5. Selecione Browser e Server para produzir a entrega Browser + Server.
6. Informe um Connection name descritivo, como Main Store Reddit Pixel.
7. Informe o Pixel ID.
8. Cole o Conversion Access Token.
9. Para o primeiro teste, informe o Test ID opcional do Reddit Events Manager.
10. Selecione Connect.

O Pixel ID e o Conversion Access Token são obrigatórios para uma conexão configurada. O Test ID é opcional. Quando presente, o Node o coloca na requisição CAPI v3, de modo que esses eventos de servidor sejam roteados para a view de Event Testing do Reddit.

O SupremeTracking suporta uma conexão Reddit por Property. Se já existir uma conexão para a mesma Property e módulo, o Console te direciona para a conexão existente, para que você use Edit credentials em vez de criar uma duplicata.

Eventos suportados

O módulo encaminha somente estes nomes canônicos de evento:

Eventos como refund, initiate_checkout, add_payment_info, subscribe e start_trial não são mapeados na versão 1.0.0 e são ignorados em vez de enviados como eventos customizados do Reddit.

Como funciona a entrega por navegador e servidor

Com Browser + Server selecionado, um evento canônico impulsiona dois caminhos de entrega:

1. Antes da ingestão, o handler de navegador do Reddit no Loader inicializa https://www.redditstatic.com/ads/pixel.js com o Pixel ID e chama o evento de Pixel mapeado.
2. O evento entra no pipeline canônico do Node e é persistido localmente.
3. Durante o Forwarding, o handler do Reddit envia um evento para a Reddit CAPI v3, no endpoint de conversion-events específico do Pixel.

Os metadados do navegador usam conversionId; o payload da CAPI usa metadata.conversion_id. Ambos recebem o event_id canônico. O Reddit usa esse valor compartilhado e o tipo de evento para identificar cópias duplicadas de navegador e servidor.

O handler de navegador espera pelo cookie _rdt_uuid por até cerca de dois segundos em uma primeira visita, e depois segue em frente mesmo que o cookie ainda esteja indisponível. A requisição de servidor também pode usar:

• rdt_cid da URL de destino como o click ID do Reddit.
• O valor completo do cookie _rdt_uuid como o UUID do Reddit.
• A URL da página, as dimensões de tela, o STUID canônico, o endereço IP, o user agent, o e-mail e o telefone, quando esses valores estão presentes no evento canônico.
• Currency, value, contagem de itens e detalhes de produto a partir dos parâmetros do evento.

O Node envia os campos de match suportados pelo Reddit diretamente da sua infraestrutura para o Reddit. Eles não passam pelo Supreme System. O módulo não adiciona uma camada de hashing; ele apara os valores e formata números de telefone com um + na frente, enquanto valores já pré-hasheados podem passar direto.

Teste a conexão

Use um evento novo já mapeado e verifique cada fronteira separadamente.

1. Mantenha o Test ID do Reddit na conexão.
2. Abra o Reddit Events Manager e a view de Event Testing dele para o mesmo Pixel ID.
3. Visite o site rastreado pelo caminho normal do Loader. Para teste de atribuição, preserve qualquer parâmetro de query rdt_cid ao longo dos redirecionamentos.
4. Dispare um evento suportado, como page_view, lead, ou um purchase controlado.
5. Confirme que o evento aparece no Console, para a Property selecionada.
6. Confira os logs do Node em busca do resultado do encaminhamento para o Reddit.
7. Confirme o evento de servidor na view de Event Testing do Reddit e inspecione o tipo de evento, o conversion ID, as match keys, o value e a currency dele.
8. Se estiver usando Browser + Server, confirme que o Reddit recebe o evento de Pixel correspondente com o mesmo conversion ID.
9. Depois do teste, abra Edit credentials da conexão, limpe o Test ID e selecione Save antes de enviar tráfego de produção.

Essas checagens provam coisas diferentes:

• Um evento no Console prova a ingestão e a persistência local no Node. Não prova a entrega ao Reddit.
• Um diagnóstico browser_sent prova que o SupremeTracking chamou a fila de navegador do Reddit. Não prova que o script do Pixel completou a requisição de rede dele, nem que o Reddit atribuiu o evento.
• Um log de encaminhamento bem-sucedido no Node prova que a requisição CAPI completou sem um erro de transporte ou HTTP reconhecido pelo handler. Não prova atribuição de campanha nem reporting.
• Um evento no Event Testing do Reddit prova o recebimento pela fonte de dados Reddit selecionada. Deduplicação e reporting são etapas posteriores de processamento do lado do Reddit.

Solução de problemas

O Reddit Ads está indisponível para instalação

Leia primeiro o badge do catálogo. PRIVATE BETA exige acesso de beta, COMING SOON significa que nenhum release instalável está disponível, e UPDATE NODE significa que o release exige um Node mais recente. Não copie manualmente arquivos de módulo por fora do instalador do catálogo.

A conexão fica em Pending configuration

Abra Edit credentials e confirme que tanto o Pixel ID quanto o Conversion Access Token têm valores preenchidos. Confirme que você editou a conexão da Property pretendida.

O evento chega ao Console mas não ao Reddit

Confirme que:

• O nome do evento é um dos oito eventos mapeados acima.
• O módulo Reddit está instalado e a conexão da Property existe.
• O modo de entrega da conexão inclui Server para a CAPI e Browser para o caminho de Pixel que você está testando.
• O Pixel ID e o token pertencem à mesma fonte de dados e ao mesmo contexto de conta do Reddit.
• O Test ID e a view de Event Testing pertencem a essa mesma fonte de dados.
• Os logs do Node não reportam um erro da API do Reddit.

Um HTTP 401 geralmente aponta para um bearer token ausente ou inválido. Um HTTP 403 pode indicar o Pixel ID errado ou autorização insuficiente para aquele Pixel. O módulo envia um User-Agent descritivo; se o Reddit reportar throttling de User-Agent automatizado, confirme que o módulo empacotado atual está instalado, e não um cliente mais antigo ou modificado.

O caminho do Pixel está ausente

Confirme que a conexão inclui Browser, que o Loader está ativo na página, e que o script do Reddit Pixel não está sendo bloqueado por controles de privacidade do navegador, regras de consentimento, um bloqueador de conteúdo ou política de rede. A entrega por servidor ainda pode funcionar quando o Pixel do navegador está bloqueado.

A qualidade de match está mais baixa que o esperado

Confirme que os redirecionamentos da landing page preservam o rdt_cid, que o Loader consegue ler o cookie _rdt_uuid depois que o Pixel inicializa, e que o evento canônico contém os campos de usuário e contexto disponíveis. Match keys ausentes não significam que o Console perdeu o evento; elas afetam o que o handler do Reddit consegue enviar para o match.

As cópias de navegador e servidor não são deduplicadas

Use Browser + Server, teste no Node 3.4.4 ou mais recente, e confirme que as duas cópias são do mesmo tipo de evento mapeado, com o mesmo event_id canônico. Não dispare um evento manual separado de Pixel do Reddit para a mesma ação, a menos que ele use o mesmo conversion ID. O Reddit realiza a deduplicação de forma assíncrona, então dois registros de teste recém-recebidos não provam, por si só, uma duplicata permanente.

Limitações e remoção

A versão 1.0.0 é focada em site: eventos CAPI usam WEBSITE como action source, um evento é enviado por requisição, e o client não faz retry automático depois de uma requisição com falha. Identificadores de publicidade mobile, mapeamento de action-source offline, eventos customizados do Reddit e os eventos canônicos não mapeados listados acima não são suportados por esta versão.

Para parar a entrega ao Reddit de uma Property, abra a conexão dela e selecione Disconnect. O Console avisa que isso interrompe a entrega para aquela Property até que ela seja reconectada. Desconectar a conexão da Property é mais restrito do que desinstalar o módulo.

Para remover o código do módulo do Node, use Uninstall em Manage Modules depois de desconectar as conexões de Property afetadas. A confirmação de desinstalação informa que as configurações salvas do módulo permanecem no Node e são restauradas se o módulo for reinstalado. Desinstalar um módulo do Node não remove eventos, pixels, públicos ou configuração de campanha do lado do Reddit.

Para o modelo geral de catálogo e runtime, leia Visão geral de integrações.