Configuração do parceiro Pinterest
O Pinterest é uma rede de anúncios integrada à Adjust. Nossa integração permite que o Pinterest receba dados de atribuição e eventos in-app por meio de callbacks automáticos.
Neste artigo, saiba como configurar a mensuração com o Pinterest para seu aplicativo. Isso inclui a ativação da integração, a criação de um link de campanha e a escolha dos dados que a Adjust pode compartilhar com Pinterest.
Antes de começar
Requisitos
- Permissões de Administrador, Editor ou Editor personalizado na Adjust.
- SDK versão 4.0.0 da Adjust e posteriormente para mapear os parâmetros do SDK aos parâmetros de Pinterest. Siga os guias abaixo para usar essa funcionalidade.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona
Credenciais
TAG ID (required for events), Pinterest Account ID e Pinterest Authentication Token
- Para obter ajuda para encontrar suas credenciais, entre em contato com seu representante do Pinterest.
No painel do parceiro Pinterest:
Os links de cliques de S2S devem ser configurados como parallel click trackers no Pinterest. Mais informações disponíveis aqui.
Selecione Pinterest e o seu aplicativo no Campaign Lab
- Em Campaign Lab, selecione Parceiros.
- Selecione Novo parceiro > Pinterest. Selecione Próximo para ir para a próxima tela.
- Na tela Seleção de aplicativos, escolha o aplicativo para o qual deseja criar o link e habilite a integração para compartilhar dados com o Pinterest.
- Selecione Próximo.
Habilitar o compartilhamento de dados
Habilite o compartilhamento de dados para ativar a integração com o Pinterest. Para habilitá-lo:
- Insira seus TAG ID (required for events), Pinterest Account ID e Pinterest Authentication Token.
Depois que você habilitar o compartilhamento de dados com o Pinterest, a Adjust enviará automaticamente os seguintes dados ao Pinterest, por padrão:
- evento
Configurar suas opções de compartilhamento de dados
Se estiver trabalhando com um aplicativo multiplataforma com compartilhamento de dados habilitado para várias plataformas, você pode:
- Separar opções de compartilhamento de dados no nível de plataforma selecionando Usar as configurações específicas da plataforma.
- Definir as mesmas configurações de compartilhamento de dados para múltiplas plataformas selecionando Usar as configurações globais.
Agora, em O que será compartilhado por padrão?, revise as atividades que a Adjust compartilha com o Pinterest por padrão.
- evento
Enviar dados adicionais
Escolha a quantidade e o tipo de dados que você deseja compartilhar com o Pinterest por meio de callbacks. O Pinterest pode usar essas informações para otimizar o desempenho.
- Em Quais fontes de dados você deseja compartilhar?, escolha a fonte de atribuição dos dados que você está compartilhando com o Pinterest:
- Dados de todas as fontes de atribuição
- Somente dados atribuídos ao Pinterest
Receita in-app (de compras in-app)
O compartilhamento de receita in-app permite que o Pinterest receba valores de receita junto com seus dados de eventos com receita. Você precisa mapear eventos que geram receita para compartilhar esses dados.
Mapear eventos
Mapeie os eventos que você deseja compartilhar com os valores que o Pinterest pode receber. Os dados de eventos não mapeados não são compartilhados com o Pinterest.
Mapear eventos individuais
Se você tiver um aplicativo multiplataforma, poderá optar por compartilhar eventos diferentes por plataforma com o Pinterest. Isso possibilita:
- Definir eventos individuais para gerenciar estratégias de campanha para cada plataforma.
- Personalizar o compartilhamento de dados por plataforma.
Em Mapear eventos, siga estes passos para escolher os eventos in-app que você quer enviar diretamente à Pinterest.
Selecione Mapear evento.
Na lista Evento da Adjust, escolha o evento da Adjust que quer compartilhar com Pinterest.
Em Evento de parceiro, selecione o evento do Pinterest que corresponde ao evento da Adjust.
Para aplicativos de plataforma única e aplicativos multiplataforma com compartilhamento de dados habilitado apenas para uma única plataforma, mapeie eventos apenas para essa plataforma. Para aplicativos multiplataforma com compartilhamento de dados habilitado para várias plataformas, você pode:
- Selecionar Usar mapeamento específico da plataforma para mapear eventos separados no nível da plataforma ou para não mapear eventos para determinadas plataformas.
- Selecionar Usar mapeamento global para mapear os mesmos eventos para todas as plataformas.
Na lista de Eventos de parceiro , escolha ou insira um nome de evento personalizado que você gostaria de mapear ao evento da Adjust.
Selecione Aplicar.
Agora Pinterest receberá dados de eventos in-app para todos os seus eventos vinculados.
Mapear todos os eventos
Se o Pinterest oferecer suporte para o mapeamento automático de todos os eventos, em Mapear eventos , selecione Mapear todos os eventos . Isso economiza tempo no mapeamento de eventos individuais.
Agora o Pinterest receberá dados de eventos in-app de todos os seus eventos vinculados.
Mapear parâmetros
Normalmente é necessário mapear os parâmetros para compartilhar dados personalizados com o Pinterest.
Os parâmetros de parceiros (disponíveis no SDK da Adjust, versão 4.0+) permitem à Adjust coletar pontos de dados personalizados do seu aplicativo e enviá-los ao Pinterest. Isso permite que o Pinterest receba detalhes de eventos personalizados para cada um de seus eventos vinculados.
Antes de adicionar novos parâmetros de parceiros ao SDK da Adjust, confira se não há parâmetros de parceiros que já atendem seus requisitos.
Para encaminhar parâmetros de parceiros ao Pinterest, siga estes passos.
Configure os parâmetros do parceiro no SDK da Adjust.
- Confira Antes de começar para ver todos os links de plataformas de desenvolvimento de SDK.
Em Configure suas opções de compartilhamento de dados, selecione Parâmetros.
Em Mapear parâmetros, você pode especificar como deseja enviar à rede os parâmetros do parceiro definidos no SDK:
- Selecione Mapear parâmetro.
- No campo Parâmetro do SDK, insira o nome do parâmetro de SDK que você deseja compartilhar com a rede.
- No campo Parâmetro do parceiro, insira o parâmetro de rede que corresponde ao parâmetro do SDK.
Se você configurar os parâmetros do parceiro no SDK da Adjust sem configurar o compartilhamento de parâmetros no painel, a Adjust encaminhará os parâmetros conforme nomeados no SDK da Adjust.
Configure seu link e suas definições
Você tem a opção de definir:
Crie seu link e compartilhe-o com Pinterest
Na tela de Revisão de configuração, revise suas escolhas. Você também pode retornar e fazer alterações em:
- Seu app selecionado
- Opções de compartilhamento de dados
- Parâmetros de estrutura de link
- Destinos do usuário
- Configurações de atribuição
Selecione Criar link para criar sua URL de clique e URL de impressão, bem como seu QR Code e seu token de link. A criação de um link também permite o compartilhamento de dados e a integração com Pinterest.
Depois de criar o link, compartilhe-o com o Pinterest para colocá-lo nas campanhas.
Instruções de configuração de parceiros específicos
Visão geral
Para enviar eventos in-app ao Pinterest, as credenciais necessárias dependem da versão da API usada:
API v5 (recomendada):
- ID da Conta de Anúncios
- Token de acesso
API antiga:
- ID da tag
Você pode recuperar seu Token de acesso no Gerenciador de Anúncios do Pinterest : Ad Account Overview> Conversions> Set Up API
Mais informações disponíveis aqui
Como fazer a transição da API antiga para a v5
O Pinterest vai desativar sua API antiga em favor da API v5 . Esta documentação acompanha você pelo processo de configuração, como autenticação, mapeamento de eventos e remoção de configurações antigas.
1. Inserir credenciais
Depois de selecionar o Pinterest e o seu app no Campaign Lab, insira as seguintes informações:
- Account ID
- Token de acesso
Os dois campos são necessários para a API v5. As instruções sobre onde encontrar os tokens de acesso para o ID da conta certo estão aqui
2. Mapeamento de eventos
Entenda os campos de mapeamento de eventos
- Nome (antigo) – usado apenas na API antiga.
- Novo nome (API v5) – valores de eventos necessários para a API v5.
Selecione o evento in-app da Adjust que você quer mapear do campo de evento da Adjust e mapeie-o ao valor no menu suspenso Novo nome
As recomendações do mapeamento do nome do evento da API antiga (Nome) para a API v5 (Novo nome) estão abaixo. Você também pode mapear os eventos da API antiga (Nome) a outros eventos disponíveis da API v5 para o Pinterest.
| Nome (antigo) | Novo nome (API v5) |
| Add to cart | Add to cart |
| Purchase | Checkout |
| Registration | Signup |
| Search | Search |
| Lead | Lead |
| Page visit | Page visit |
3. Remova o antigo ID da tag (opcional)
O ID da tag não é mais necessário para a API v5. Você pode remover esse ID sem problemas da sua configuração. Se você ainda oferecer o ID da tag junto com o ID da conta e o token de acesso , bem como um valor para o campo Novo nome , o sistema vai priorizar a API v5 e ignorar o ID da tag para a API antiga.
Práticas recomendadas
O Pinterest é compatível com as versões iOS e Android das conversões de campanhas com deep linking. Antes de habilitar a integração, entre em contato com o Pinterest para que eles possam ajudar na configuração de campanhas.
Parâmetros predefinidos
Você pode enviar parâmetros predefinidos com seus eventos usando o SDK da Adjust. Quando anexados de forma correta, esses parâmetros são encaminhados ao Pinterest.
Confira a documentação do SDK para a maneira correta de anexar os parâmetros do parceiro aos seus eventos.
| Parâmetro | Descrição | Compatível com a API v5 | Formato/observações |
| external_id | ID de usuário externo | ✅ | Lista de string separada por vírgula ou ponto e vírgula |
| event_source_url | URL da página web em que o evento ocorreu | ✅ | String (formato URL) |
| em | Hashes do endereço de e-mail | ✅ | Hash SHA256 do endereço de e-mail em minúscula |
| ph | Hashes do número de telefone | ✅ | Hash SHA256 do número de telefone apenas com dígitos, com o código do país e o da área. |
| event_id | Identificador de evento único | ✅ | String |
| content_ids | Identificadores de produto ou conteúdo | ✅ | Lista de string separada por vírgula ou ponto e vírgula |
| order_id | Identificador de ordem | ✅ | String |
| valor | Valor da compra ou adicionar ao carrinho | ✅ | Numérico (também disponível na API antiga) |
| Moeda | Moeda para o campo do valor | ✅ | Código ISO 4217 (por exemplo, USD e EUR) — compatíveis com a antiga API |
Para mais detalhes sobre o formato external_id, em e ph, consulte a documentação da API do Pinterest.
Os valores dos parâmetros de valor e moeda são usadas como valores de fallback e são encaminhados ao Pinterest apenas se a Adjust não receber nenhum dados de receita para o evento in-app diretamente do SDK.
Para mais informações, confira a documentação da Adjust sobre o registro da receita de evento.
Os parâmetros agrupados no nível do item
Os parâmetros a seguir descrevem metadados no nível do item e devem ser alinhados em ordem no payload do evento.
| Parâmetro | Descrição | Formato/observações |
| id | Identificadores únicos dos itens | Lista de strings ordenadas (separada vírgula ou ponto e vírgula) |
| quantity | Quantidade de cada item | Lista de string ordenada |
| item_name | Nome de cada item | Lista de string ordenada |
| item_price | Preço de cada item | Lista de string ordenada |
| item_category | Categoria de cada item | Lista de string ordenada |
| item_brand | Marca de cada item | Lista de string ordenada |
A ordem dos valores precisa corresponder em todos estes campos.
(por exemplo, o primeiro valor em item_price deve corresponder ao primeiro em item_name, id, etc.)
Lista de todos os parâmetros encaminhados a Pinterest
Pinterest solicita que a Adjust envie os seguintes parâmetros (pontos de dados) com seus callbacks:
| Espaço reservado | Informação |
{city} | Cidade do dispositivo |
{country} | Código do país de dois caracteres do dispositivo |
{currency} | O código da moeda ISO 4217 original enviado pelo SDK da Adjust |
{device_name} | Número do modelo do dispositivo |
{gps_adid} | Advertising ID da Google Play Store |
{idfa} | ID para anunciantes (apenas iOS) |
{ip_address} | Endereço IP do dispositivo |
{isp} | Provedor de serviços de internet para dispositivos |
{language} | Código do idioma de dois caracteres do dispositivo |
{os_name} | Sistema operacional do dispositivo |
{os_version} | Número da versão do sistema operacional |
{partner_parameters} | Parâmetros dos parceiros personalizados coletados pelo SDK da Adjust ou solicitação S2S e transmitidos a fornecedores de terceira parte via postbacks |
{revenue_usd} | Receita, em dólares americanos |
{revenue} | Receita, conforme enviada pelo SDK da Adjust (em centavos) |
{sdk_version} | Versão do SDK da Adjust (por aplicativo) |
{tracking_limited} | 1 se o monitoramento é limitado, 0 se não |
{user_agent} | Agente do usuário bruto de entrada |
{app_id} | Store App ID ou Google Play Store |
{app_name} | Nome do aplicativo |
{app_version_short} | Número da versão do aplicativo (Android), número da versão do lançamento para bundle (iOS) |
{created_at} | Marca temporal da atividade |
{impression_based} | 1 se engajamento baseado em impressão, 0 se não |