Extensão de encaminhamento de eventos da Twitter

Twitter O é um serviço de redes sociais online, no qual os usuários postam e interagem com mensagens de 280 caracteres conhecidas como tweets. Os usuários podem interagir com o Twitter usando um navegador, software de front-end móvel ou programaticamente por meio de seu APIs

A variável Twitter API de conversões da Web encaminhamento de eventos permite que você aproveite os dados capturados na Rede de borda da Adobe Experience Platform e os envie para Twitter. Este documento aborda os casos de uso da extensão, como instalá-la e como integrar seus recursos ao encaminhamento de eventos regras.

Twitter exige OAuth 1.0 para autenticação com o Twitter Web Conversions API.

Casos de uso

Essa extensão deve ser usada se você quiser usar dados da Rede de borda no Twitter para aproveitar os recursos de análise e direcionamento do cliente.

Por exemplo, considere uma equipe de marketing em uma organização. A equipe captura dados do evento de interação do usuário de seu site como dados do evento de seu site e os carrega em Twitter usar esta extensão de encaminhamento de eventos.

As equipes de marketing e análise podem aproveitar Twitter’s recursos para realizar análises adicionais e direcionar esses usuários para campanhas de anúncio direcionadas.

Para obter mais informações sobre casos de uso específicos do Twitter, consulte o Twitter casos de uso documentação.

Twitter pré-requisitos e medidas de proteção prerequisites

Você deve ter um válido Twitter para usar essa extensão. Vá para a Twitter página de registro para registrar e criar uma conta se ainda não tiver uma.

Você deve configurar sua conta como um Twitter conta de desenvolvedor. Para saber como se inscrever como desenvolvedor, consulte o Twitter conta do desenvolvedor.

Medidas de proteção de API guardrails

A variável Twitter A API de conversões da Web tem um limite de taxa de 60.000 solicitações por intervalo de 15 minutos, em que cada solicitação permite 500 eventos.

Coletar detalhes de configuração necessários configuration-details

Para conectar o Experience Platform a Twitter, as seguintes entradas são necessárias:

Tipo de chave
Descrição
Chave do consumidor
​ A chave de API do aplicativo para acessar o Twitter API. Consulte a Twitter documentação sobre chaves e segredos da api para obter orientação.
Segredo do consumidor
O segredo da API permite que o aplicativo acesse o Twitter API. Consulte a Twitter documentação sobre chaves e segredos da api para obter orientação.
Segredo do token
O token secreto sem expiração do seu aplicativo, que é usado para autenticação na Twitter API via OAuth. Consulte a Twitter documentação sobre obtenção de tokens de acesso de uso para obter orientação.
Token de acesso
O token de acesso sem expiração do seu aplicativo, que é usado para autenticação na Twitter API via OAuth. Consulte a Twitter documentação sobre obtenção de tokens de acesso de uso para obter orientação.
ID do pixel
A variável Twitter Pixel é uma tag do site implementada no site para rastrear ações ou conversões do site. Consulte a Twitter documentação sobre rastreamento de conversão para sites para obter orientação.

Instale e configure o Twitter extensão install

Para instalar a extensão, criar uma propriedade de encaminhamento de eventos ou escolha uma propriedade existente para editar.

Selecionar Extensões no painel de navegação esquerdo. No Catálogo selecione Instalar no cartão para o Twitter extensão.

Catálogo que mostra o Twitter realce da extensão instalar.

IMPORTANT
Dependendo das suas necessidades de implementação, talvez seja necessário criar um esquema, elementos de dados e um conjunto de dados antes de configurar a extensão. Revise todas as etapas de configuração antes de começar para determinar quais entidades você precisa configurar para seu caso de uso.

Na tela seguinte, insira valores de configuração que você coletou anteriormente Twitter:

  • ID do pixel
  • Chave do consumidor
  • Segredo do consumidor
  • Token
  • Segredo do token

Quando terminar, selecione Salvar.

Twitter tela de configuração para o Twitter extensão.

Configurar uma regra de encaminhamento de eventos config-rule

Depois que todos os elementos de dados forem configurados, você poderá começar a criar regras de encaminhamento de eventos que determinam quando e como seus eventos serão enviados para o Twitter.

Criar um novo regra na propriedade de encaminhamento de eventos. Em Ações, adicione uma nova ação e defina a extensão para Twitter. Para enviar eventos da Rede de borda para o Twitter, defina o Tipo de ação para Enviar conversão da Web.

Após a seleção, controles adicionais são exibidos para configurar ainda mais o evento. Você precisa mapear o Twitter para os elementos de dados criados anteriormente. Para obter mais informações, consulte Twitter API de conversões da Web.

A variável Twitter criação de uma regra de evento de conversão.

Identificação do usuário

Nome do campo
Descrição
Exemplo
Obrigatório
Twitter ID do clique
Twitter ID do clique conforme analisado no URL de click-through.
26l6412g5p4iyj65a2oic2ayg2
Obrigatório se nenhum outro identificador for adicionado.
Email
Um endereço de email com hash SHA256. O texto deve estar em minúsculas e qualquer espaço à direita ou à esquerda deve ser removido antes do hash.
eventforwarding@example.com
Obrigatório se nenhum outro identificador for adicionado.
Telefone
O telefone serve como um identificador para corresponder ao evento de conversão. O número de telefone deve estar no formato E164 [+][código do país][código de área][local phone number] antes do hash.
+911234567875
Obrigatório se nenhum outro identificador for adicionado.

Dados de conversão

Nome do campo
Descrição
Exemplo
Obrigatório
Tempo de conversão
Data e hora como string em ISO 8601 ou em yyyy-MM-dd'T'HH:mm:ss:SSSZ formato.
2022-02-18T01:14:00,603Z
Sim
ID do evento
A ID de base 36 de um evento específico. Essa ID deve corresponder a um evento pré-configurado contido em seu Twitter conta de publicidade. Isso é conhecido como a ID do evento correspondente no Gerenciador de eventos.
o87ne ou tw-o8z6j-o87ne (tw-pixel_id-event-id)
Sim
Número de itens
O número de itens sendo comprados no evento. Deve ser um número positivo maior que 0.
4
Não
Moeda
A moeda dos itens que estão sendo comprados no evento. Isso é expresso em ISO-4217 e, se não for fornecido, o padrão será USD.
USD
Não
Valor
O valor do preço dos itens que estão sendo comprados no evento.
100,00
Não
ID de conversão
Um identificador para um evento de conversão que pode ser usado para desduplicação entre conversões de Pixel da Web e API de conversão na mesma tag de evento.
23294827
Não
Descrição
Uma descrição com todas as informações adicionais sobre as conversões.
Testar conversão
Não

Validar dados no Twitter

Depois que a regra de encaminhamento de eventos tiver sido criada e executada, valide se o evento enviado para o Twitter A API é exibida conforme esperado no Twitter IU.

Se a coleção de eventos e a Experience Platform integração foram bem-sucedidas, você verá eventos no Twitter Gerenciador de eventos.

A variável Twitter gerenciador de eventos

Próximas etapas

Este guia abordou como enviar eventos de conversão para o Twitter usando o encaminhamento de eventos. Para obter mais informações sobre essas tecnologias subjacentes, consulte a documentação oficial:

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743