Extensão de encaminhamento de eventos da Pinterest

Pinterest O é um mecanismo de descoberta visual para encontrar ideias como receitas, decoração de casas, inspiração de estilo e muito mais. Há bilhões de pinos em Pinterest, que também podem ser compartilhadas com outras pessoas no Pinterest. É possível agrupar os eventos de interação do usuário e aproveitar Pinterest Analytics para entender o comportamento do usuário e executar anúncios direcionados.

A variável Pinterest Conversões API encaminhamento de eventos permite que você aproveite os dados capturados na Rede de borda da 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 pelo Pinterest ao interagir com o Pinterest API.

Casos de uso

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

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

As equipes de marketing e análise podem aproveitar Pinterest Recursos do Analytics para entender as principais interações e comportamento do usuário, 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 o Pinterest casos de uso documentação.

Pinterest pré-requisitos

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

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

Coletar detalhes de configuração necessários

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

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

Instale e configure o Pinterest extensão

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

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

Catálogo que exibe o Pinterest extensão com Instalar destacado.

Configurar a extensão Pinterest

IMPORTANTE

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. Selecionar Configurar no cartão para o Pinterest extensão no Instalado**.

Pinterest extensão mostrada no Instalar guia com Configurar destacado.

Na próxima tela, insira o ID da conta de anúncios e Token de acesso de conversão que você reuniu anteriormente na detalhes da configuração seção. Quando terminar, selecione Salvar.

A variável Pinterest Configurar tela destacando o ID da conta de anúncios e Token de acesso de conversão campos de entrada.

Configurar uma regra de encaminhamento de eventos

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

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

A variável Pinterest Enviar evento criação da regra.

Após a seleção, controles adicionais são exibidos para configurar ainda mais o evento. Você precisa mapear o 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. No entanto, isso pode ser qualquer tipo de evento 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]
Origem da 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 Pinterest API. 1433188255.500 indica 1433188255 segundos e 500 milissegundos após a época ou segunda-feira, 1 de junho de 2015, às 7:50:17H GMT.
ID de 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.

A variável Pinterest Dados do evento destacado na ação regra.

As seguintes propriedades de evento podem ser configuradas:

Nome do campo Descrição
URL de origem 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 de publicidade da Google" (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.

A variável Pinterest Dados do usuário destacado na ação 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.
Primeiro 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.
IMPORTANTE

Antes de enviar os dados para o Pinterest No endpoint da API, 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
Moeda 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. Enviando order_id ajudará Pinterest elimine a duplicação de 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.

A variável Pinterest Dados personalizados destacado na ação regra.

Validar dados no Pinterest

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

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

A variável Pinterest gerenciador de eventos

É possível fazer drill-through e exibir a Pinterest distribuição de dados do evento.

A variável Pinterest distribuição de dados

Próximas etapas

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

Nesta página