Extensão de encaminhamento de eventos da Twitter

Twitter é uma rede social online e um serviço de rede social, 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 suas APIs

A extensão Twitter da API de encaminhamento de eventos das Conversões da Web permite que você aproveite os dados capturados no Edge Network do 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 requer OAuth 1.0 para autenticação com a API Twitter Web Conversions.

Casos de uso

Essa extensão deve ser usada se você quiser usar dados do Edge Network em Twitter para aproveitar seus recursos de análise e direcionamento de clientes.

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 usando esta extensão de encaminhamento de eventos.

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

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

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

Você deve ter uma conta Twitter válida para usar esta extensão. Vá para a Twitter página de registro para se registrar e criar uma conta, caso ainda não tenha uma.

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

Medidas de proteção de API guardrails

A API de Conversões da Web do Twitter 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 a API Twitter. Consulte a documentação do Twitter sobre chaves e segredos da api para obter orientação.
Segredo do consumidor
O Segredo de API permite que seu aplicativo acesse a API Twitter. Consulte a documentação do Twitter 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 API Twitter via OAuth. Consulte a documentação do Twitter 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 API Twitter via OAuth. Consulte a documentação do Twitter sobre obtenção de tokens de acesso de uso para obter orientação.
ID do pixel
O Pixel do Twitter é uma tag de site implementada no seu site para rastrear ações ou conversões de site. Consulte a documentação do Twitter em rastreamento de conversão para sites para obter orientação.

Instalar e configurar a extensão Twitter install

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

Selecione Extensões na navegação à esquerda. Na guia Catálogo, selecione Instalar no cartão para a extensão Twitter.

Catálogo mostrando a instalação do destaque de extensão Twitter.

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 próxima tela, insira os valores de configuração a seguir, coletados anteriormente de Twitter:

  • Id Do Pixel
  • Chave do consumidor
  • Segredo do consumidor
  • Token
  • Segredo do token

Quando terminar, selecione Salvar.

Tela de configuração Twitter para a extensão Twitter.

Configurar uma regra de encaminhamento de eventos config-rule

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

Crie uma nova regra na propriedade de encaminhamento de eventos. Em Ações, adicione uma nova ação e defina a extensão como Twitter. Para enviar eventos Edge Network para Twitter, defina o Tipo de Ação como Enviar Conversão da Web.

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

O Twitter está criando uma regra de evento de conversão.

Identificação de usuário

Nome do campo
Descrição
Exemplo
Obrigatório
Twitter Clique em ID
Twitter ID de clique conforme analisado a partir da 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 cadeia de caracteres no formato ISO 8601 ou yyyy-MM-dd'T'HH:mm:ss:SSSZ.
2022-02-18T01:14:00.603Z
Sim
Id Do Evento
A ID de base 36 de um evento específico. Esta ID deve corresponder a um evento pré-configurado contido em sua conta de anúncio Twitter. 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 em Twitter

Depois que a regra de encaminhamento de eventos for criada e executada, valide se o evento enviado para a API Twitter é exibido conforme esperado na interface do usuário Twitter.

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

O Twitter gerenciador de eventos

Próximas etapas

Este guia abordou como enviar eventos de conversão para 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