DocumentaçãoExperience PlatformTags

Extensão de encaminhamento de eventos da Pinterest

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined

O Pinterest é um mecanismo de descoberta visual para encontrar ideias como receitas, decoração da casa, inspiração de estilo e muito mais. Há bilhões de pins no Pinterest, que também podem ser compartilhados com outras pessoas no Pinterest. Você pode agrupar os eventos de interação do usuário e aproveitar o Pinterest Analytics para entender o comportamento do usuário e executar anúncios direcionados.

A extensão Pinterest Conversões da API encaminhamento de eventos permite que você aproveite os dados capturados no Edge Network do Adobe Experience Platform e os envie para Pinterest. Este documento aborda os casos de uso da extensão, como instalá-la e como integrar seus recursos ao encaminhamento de eventos regras.

Os tokens de acesso de conversões são o método de autenticação usado por Pinterest ao interagir com a API Pinterest.

Casos de uso

Essa extensão deve ser usada se você quiser usar dados do Edge Network em Pinterest para aproveitar seus recursos de análise 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 e os carrega no Pinterest usando esta extensão de encaminhamento de eventos.

As equipes de marketing e análise podem aproveitar os recursos do Analytics Pinterest para entender as principais interações e comportamento dos usuários, permitindo que você entenda melhor os usuários e os direcione para campanhas de anúncios direcionadas.

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

Pinterest pré-requisitos prerequisites

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

Você também precisará de uma conta de desenvolvedor Pinterest, que precisará ser associada à sua conta comercial Pinterest. Para associar a conta de desenvolvedor à conta comercial, consulte a Pinterest ​ conta de desenvolvedor.

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

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

Credencial
Descrição
Exemplo
ID da conta de anúncios
A Id Da Conta Do Pinterest Ads. Consulte a Pinterest documentação para obter orientação.
123456789012
Token de acesso de conversão
Seu Token De Acesso De Conversão Do Pinterest. Consulte o documento Pinterest API de conversões para obter orientação.
Você só precisará fazer isso uma vez, pois esse token não expira.

Instalar e configurar a extensão Pinterest install

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

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

Catálogo exibindo a extensão Pinterest com o realce Instalar.

Configurar a extensão Pinterest

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 navegação à esquerda, selecione Extensões. Selecione Configurar no cartão para a extensão Pinterest na guia Instalado**.

A extensão Pinterest mostrada na guia Instalar com o realce Configurar.

Na próxima tela, insira o ID da Conta do Ads e o Token de Acesso de Conversão coletados anteriormente na seção detalhes de configuração. Quando terminar, selecione Salvar.

A tela Pinterest Configurar destacando os campos de entrada Id da Conta do Ads e Token de Acesso de Conversão.

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 Pinterest.

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

A criação da regra Pinterest Enviar Evento.

Após a seleção, controles adicionais são exibidos para configurar ainda mais o evento. Você precisa mapear as propriedades de evento Pinterest para os elementos de dados criados anteriormente.

Dados do evento

Os seguintes dados de evento serão necessários para criar a nova regra:

Nome do campo
Descrição
Exemplo
Nome do Evento
O tipo de evento do usuário. Isso pode ser qualquer tipo de evento. No entanto, para aproveitar Pinterest Analytics, é recomendável usar Pinterest códigos de evento
* check-out
* add_to_cart
* page_visit
* inscrição
* [Evento definido pelo usuário]
Source de Ação
A origem que indica onde o evento de conversão ocorreu.
* app_android
* app_ios
* web
* offline
Hora do Evento
Refere-se à hora do evento. O formato de hora padrão usado é UNIX, no formato <seconds>.<miliseconds>, dependendo do fuso horário local. Para obter mais informações, consulte a Pinterest API.
1433188255.500 indica 1433188255 segundos e 500 milissegundos após a época, ou segunda-feira, 1 de junho de 2015, às 19h55 GMT.:50:
ID do Evento
Uma sequência de ID exclusiva que identifica esse evento e pode ser usada para desduplicação entre eventos assimilados por meio da API de conversão e do rastreamento do Pinterest. Sem isso, os dados do evento provavelmente serão contados duas vezes e relatarão a inflação de métrica.
ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad
Propriedades do Evento
Um objeto JSON que contém propriedades personalizadas do evento. Escolha entre fornecer JSON bruto ou usar um conjunto simplificado de entradas de valores-chave.
{ "event_source_url": "http://site.com" }

Os Pinterest Dados do Evento destacados na ação de regra.

As seguintes propriedades de evento podem ser configuradas:

Nome do campo
Descrição
URL do Source do evento
URL do evento de conversão da Web.
ID da loja de aplicativos
A ID do aplicativo da app store.
Nome do aplicativo
O nome do aplicativo.
Application Version
A versão do aplicativo.
Marca do dispositivo
Marca do dispositivo sendo usado pelo usuário.
Operadora do dispositivo
Operadora de celular do usuário para o dispositivo.
Modelo do dispositivo
Modelo do dispositivo do usuário.
Device Type
Tipo de dispositivo sendo usado pelo usuário.
Versão do SO
Versão do sistema operacional do dispositivo.
Idioma do usuário
Código de idioma ISO-639-1 de dois caracteres indicando o idioma do usuário.

Dados do usuário

Os seguintes dados do usuário podem ser inseridos por não são campos obrigatórios:

Nome do campo
Descrição
Exemplo
Email
Endereço de email do usuário ou um hash SHA256 do email do endereço do usuário.
ebd543592.f2b7e1
IDs de Anúncios Móveis
Hashes Sha256 das "IDs do Google Advertising" (GAIDs) ou do "Identificador da Apple para anunciantes" (IDFAs) do usuário
ebd543592.f2b7e1
Endereço IP do Cliente
O endereço IP do usuário, que pode estar no formato IPv4 ou IPv6. Usado para correspondência.
192.168.0.1
Agente de Usuário Cliente
A sequência de agente do usuário do navegador da Web do usuário.
Mozilla/5.0 (platform; rv:geckoversion) Gecko/geckotrail Firefox/firefoxversion
Dados de informações do cliente
Um objeto JSON que contém outras informações do cliente. Escolha entre fornecer JSON bruto ou usar um conjunto simplificado de entradas de valores-chave.
{ "ph": "122333445" }

Os Pinterest Dados do Usuário destacados na ação da regra.

As propriedades de informações do cliente que podem ser configuradas são:

Nome do campo
Descrição
Telefone
Número de contato do usuário. Somente dígitos são aceitos e devem ser inseridos com código do país, código de área e número.
Gênero
O gênero pode ser inserido como "f" para feminino, "m" para masculino ou "n" para não binário.
Data de nascimento
Data de nascimento, inserida como ano, mês e dia.
Sobrenome
Sobrenome do usuário.
Nome
Nome do usuário.
Cidade
Cidade de residência do usuário. Isso é usado principalmente para fins de faturamento.
Estado
Estado do usuário, que é fornecido como um código de duas letras em minúsculas.
Código postal
Código postal do usuário, usado principalmente para fins de faturamento.
País
Código de país ISO-3166 de dois caracteres indicando o país do usuário.
ID externa
Identificador exclusivo do anunciante que identifica um usuário em seu espaço. Por exemplo, id de usuário, id de fidelidade e assim por diante.
ID do clique
O identificador exclusivo armazenado no cookie _epik no seu domínio ou no parâmetro de consulta &epik= no URL.
IMPORTANT
Antes de enviar os dados para o ponto de extremidade da API Pinterest, a extensão aplicará hash e normalizará os valores dos seguintes campos: Email, Número de Telefone, Nome, Sobrenome, Gênero, Data de Nascimento, Cidade, Estado, CEP, País e ID Externa. A extensão não aplicará hash ao valor desses campos se uma string SHA256 já estiver presente.

Dados personalizados

Os seguintes dados personalizados podem ser inseridos para a regra:

Nome do campo
Descrição
Currency
O código de moeda ISO-4217. Se isso não for fornecido, Pinterest assumirá como padrão a moeda do anunciante que foi definida durante a criação da conta.
Valor
Valor total do evento. Aceito como uma cadeia de caracteres na solicitação. Isso será analisado em um dígito duplo.
Pesquisar string
A sequência de pesquisa relacionada ao evento de conversão do usuário.
ID do pedido
A ID do pedido. O envio de order_id ajudará Pinterest a desduplicar eventos quando necessário.
Número de produtos
Número total de produtos do evento. Por exemplo, o número total de itens comprados em um evento de check-out.
IDs de conteúdo
Lista (matriz) de IDs de produtos.
Conteúdo
Uma lista (matriz) de objetos que contém informações sobre produtos, como preço e quantidade.

Os Pinterest Dados Personalizados destacados na ação de regra.

Validar dados em Pinterest

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

Se a coleção de eventos e a integração do Experience Platform tiverem sido bem-sucedidas, você verá eventos na interface do usuário do Pinterest.

O Pinterest gerenciador de eventos

Você pode detalhar e visualizar a distribuição de dados do evento Pinterest.

A Pinterest distribuição de dados

Próximas etapas

Este guia abordou como instalar e configurar a extensão de encaminhamento de eventos do Pinterest na interface do usuário. Para obter mais informações, consulte a documentação oficial:

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