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

Antes de começar

Requisitos

• Permissões de Administrador, Editor ou Editor personalizado na Adjust.
• SDK da Adjust versão 4.0.0 ou posterior para mapear os parâmetros do SDK aos parâmetros do 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

Selecione o Pinterest e o seu aplicativo no Campaign Lab

1. No Campaign Lab, selecione Parceiros.
2. Selecione Novo parceiro > Pinterest. Selecione Próximo para ir para a próxima tela.
3. 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.
4. Selecione Próximo.

Habilitar o compartilhamento de dados

Habilite o compartilhamento de dados para ativar a integração com o Pinterest. Para habilitá-lo:

1. Insira seu Tag ID (obrigatório para eventos).
   • Para obter ajuda para encontrá-lo, entre em contato com seu representante do Pinterest.

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:

1. Separar opções de compartilhamento de dados no nível de plataforma selecionando Usar as configurações específicas da plataforma.
2. 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

Envio de dados adicionais

Escolha a quantidade e o tipo de dados que deseja compartilhar com o Pinterest por meio de callbacks. O Pinterest pode usar essas informações para otimizar o desempenho.

1. 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
• Apenas dados atribuídos ao Pinterest

Receita in-app (de compras in-app)

O compartilhamento de receita in-app permite que 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 ao Pinterest.

1. Selecione Mapear evento.

2. Na lista Evento da Adjust, escolha o evento da Adjust que você deseja compartilhar com o Pinterest.

3. Em Evento do parceiro, selecione o evento do Pinterest que corresponde ao evento da Adjust.

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

   2. Na lista Evento do parceiro, escolha ou insira um nome de evento personalizado que você deseja mapear ao evento da Adjust.

4. Selecione Aplicar.

Agora o 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.

Normalmente, é necessário mapear os parâmetros para compartilhar dados personalizados com o Pinterest.

Os parâmetros do parceiro (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 do parceiro ao SDK da Adjust, confira se não há parâmetros pré-existentes que já atendem seus requisitos.

Para compartilhar parâmetros do parceiro com o Pinterest, siga estes passos.

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

2. Em Configure suas opções de compartilhamento de dados, selecione Parâmetros.

3. Em Mapear parâmetros, você pode especificar como deseja enviar à rede os parâmetros do parceiro definidos no SDK:

   1. Selecione Mapear parâmetro.
   2. No campo Parâmetro do SDK, insira o nome do parâmetro de SDK que você deseja compartilhar com a rede.
   3. No campo Parâmetro do parceiro, insira o parâmetro de rede que corresponde ao parâmetro do SDK.

Configure seu link e suas definições

Você tem a opção de definir:

• Estrutura dos links
• Destinos do usuário
• Configurações de atribuição

Crie seu link e compartilhe-o com o Pinterest

Você pode revisar suas escolhas na tela Revisão da configuração. É possível também retornar e fazer alterações em:

• Seu app selecionado
• Opções de compartilhamento de dados
• Parâmetros de estrutura do 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.

Formato da string de callback

Para manter a privacidade do usuário final e permanecer em conformidade com as diretrizes, a Adjust registra dados brutos do Pinterest de uma forma específica.

Abaixo, segue um exemplo de uma string de callback que a Adjust envia normalmente. Nessa string, os textos entre chaves { } são placeholders da Adjust — macros que permitem que a Adjust adicione dados do usuário ou de engajamento à string de callback do cliente.

• String padrão: https://mydatawarehouse.com/adjust/info?tracker={tracker}&tracker_name={link_name}

Do Pinterest, a Adjust envia aos clientes um tipo diferente de string de callback para todas as atividades.

• String seguindo as diretrizes: https://mydatawarehouse.com/adjust/info?tracker=unattr&tracker_name=Unattributed

Observe as seguintes alterações nesta string em comparação com o exemplo padrão:

• tracker = unattr
• tracker_name = Unattributed

Instruções de configuração de parceiros específicos

Para enviar os eventos in-app, insira o Tag ID ao ativar a integração. Esse campo é obrigatório apenas para eventos in-app.

Além disso, lembre-se de que o Pinterest pode executar campanhas no iOS e no Android. Antes de habilitar a integração, contate o Pinterest para que eles possam fazer a sua configuração com campanhas relevantes.

Parâmetros predefinidos

O Pinterest permite enviar uma série de parâmetros predefinidos. Se você anexar qualquer um desses parâmetros a um evento no seu SDK da Adjust, eles serão encaminhados ao Pinterest. Encontre mais informações sobre como anexar parâmetros dos parceiros no readme específico do SDK ou dos SDKs que você está usando. Abaixo, temos uma lista dos parâmetros predefinidos que o Pinterest aceita:

Chave de parâmetro > Valor

• value > Valor dos eventos adicionar ao carrinho ou eventos de compras.
• currency > Moeda usada para representar o valor acima.
• quantity > Número de itens adicionados ao carrinho ou comprados.
• order_id > ID do pedido da compra.
• search_string > String de pesquisa ou consulta para eventos de pesquisa.

os parâmetros value , currency e quantity são válidos tanto para eventos adicionados ao carrinho quanto eventos de compras. _order_id_is só é válido para eventos de compras. search_string é o único parâmetro do parceiro disponível para eventos de pesquisa.

Lista de todos os parâmetros encaminhados ao Pinterest

O Pinterest solicita que a Adjust envie os seguintes parâmetros (pontos de dados) com seus callbacks: