Estamos sempre publicando atualizações em nossa documentação, mas pode ser que elas ainda não estejam disponíveis em seu idioma. Para ter acesso às informações mais atualizadas, use a ​​versão em inglês.

Configuração do parceiro Epsilon

O Epsilon é uma rede de anúncios integrada à Adjust. Nossa integração permite que o Epsilon 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 Epsilon 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 Epsilon.

Antes de começar

Requisitos

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

Credenciais

Company ID e Company Magic

  • Para obter ajuda para encontrar suas credenciais, entre em contato com seu representante do Epsilon.

Selecione Epsilon e o seu aplicativo no Campaign Lab

  1. Em Campaign Lab, selecione Parceiros.
  2. Selecione Novo parceiro > Epsilon. 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 Epsilon.
  4. Selecione Próximo.

Habilitar o compartilhamento de dados

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

  1. Insira seus Company ID e Company Magic.

Depois que você habilitar o compartilhamento de dados com o Epsilon, a Adjust enviará automaticamente os seguintes dados ao Epsilon, por padrão:

  • instalação
  • sessão
  • Reinstalaçã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 Epsilon por padrão.

  • instalação
  • sessão
  • Reinstalação
  • evento

Enviar dados adicionais

Escolha a quantidade e o tipo de dados que você deseja compartilhar com o Epsilon por meio de callbacks. O Epsilon 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 Epsilon:
  • Dados de todas as fontes de atribuição
  • Somente dados atribuídos ao Epsilon

Sessões

A Adjust não envia automaticamente callbacks de sessão devido ao alto volume de sessões. Ao compartilhar sessões, o Epsilon receberá a atividade da sessão do seu aplicativo.

Desinstalações ou reinstalações

O compartilhamento de desinstalações ou reinstalações permite que o Epsilon receba os dados de desinstalação e/ou reinstalação do seu aplicativo mensurados pela Adjust.

Observação:

No caso de apps iOS, pode haver uma baixa quantia de desinstalações e/ou reinstalações. Para mais informações, confira o artigo Mensuração de desinstalações e reinstalações.

Receita in-app (de compras in-app)

O compartilhamento de receita in-app permite que o Epsilon 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 Epsilon pode receber. Os dados de eventos não mapeados não são compartilhados com o Epsilon.

Mapear eventos individuais

Se você tiver um aplicativo multiplataforma, poderá optar por compartilhar eventos diferentes por plataforma com o Epsilon. 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 à Epsilon.

  1. Selecione Mapear evento.

  2. Na lista Evento da Adjust, escolha o evento da Adjust que quer compartilhar com Epsilon.

  3. Em Evento de parceiro, selecione o evento do Epsilon 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 de Eventos de parceiro , escolha ou insira um nome de evento personalizado que você gostaria de mapear ao evento da Adjust.

  4. Selecione Aplicar.

Agora Epsilon receberá dados de eventos in-app para todos os seus eventos vinculados.

Mapear todos os eventos

Se o Epsilon 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 Epsilon 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 Epsilon.

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 Epsilon. Isso permite que o Epsilon 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 Epsilon, 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.
Observação:

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 Epsilon

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

Depois de criar o link, compartilhe-o com o Epsilon para colocá-lo nas campanhas.

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

Epsilon permite que você envie um conjunto de parâmetros predefinidos. Se você anexar quaisquer um desses parâmetros a um evento ou sessão em seu SDK da Adjust, esses serão encaminhados ao Epsilon. Você pode encontrar mais sobre como anexar parâmetros de parceiros no readme do SDK ou SDKs específico(s) com o(s) qual(is) você está trabalhando. Abaixo segue uma lista de parâmetros definidos que a Epsilon aceita:

Parameter key> Valor

  • dtm_fid*> form identifier

  • dtm_promo_id*> valor que identifica o tipo da página

  • dtm_email_hash> hash SHA-256 do endereço de e-mail do cliente. Remova espaços iniciais/finais e mude o endereço de e-mail para letras minúsculas antes de fazer o hash

  • dtm_mobile_hash> hash SHA-256 do número de telefone do cliente no formato: código do país + código da área sem deixar zeros + número do assinante. Remova quaisquer caracteres especiais.

  • dtm_user_id> identificador único. Não pode ser PII ou o endereço de e-mail em hash

  • dtmc_tcf_string**> string de consentimento GDPR

  • dtmc_department***> nome do departamento para visualização atual

  • dtmc_category***> nome da categoria para visualização atual

  • dtmc_sub_category***> nome da subcategoria para visualização atual

  • dtmc_product_id****> ID do produto para visualização atual

  • dtmc_brand****> marca do fabricante

  • dtmc_upc****> código UPC do fabricante

  • dtmc_mpn***> número de peça do modelo do fabricante

  • dtmc_transaction_id*****> identificador único do cliente para cada conversão

  • dtm_items> uma disposição de todos os itens na conversão. Cada item deve incluir o seguinte

    • product_id: SKU do item
    • item_amount: custo de 1 unidade do item
    • item_quantity: número de itens SKU na transação
    • item_discount: valor de desconto a partir do valor original
  • dtmc_conv_type> diferencia os tipos de compras on-line: entrega, retirada,...

  • dtmc_conv_store_location> para tipos de conversões de retirada, indica o local da loja da retirada

** obrigatório*

*** obrigatório em áreas onde as restrições de GDPR se aplicam*

**** conditional - requisitado onde conhecido, incluindo eventos de produto*

**** Condicional - apenas requisitado em eventos de visualização de produto

****** Obrigatório em transações*

Lista de todos os parâmetros encaminhados a Epsilon

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

PlaceholderInformação
{currency}O código da moeda ISO 4217 original enviado pelo SDK da Adjust
{deeplink}URL do deeplink adicionada à URL do clique
{gps_adid}Advertising ID da Google Play Store
{idfa}ID para anunciantes (apenas iOS)
{ip_address}Endereço IP do dispositivo
{partner_parameters}Parâmetros dos parceiros personalizados coletados pelo SDK da Adjust ou solicitação S2S e transmitidos a fornecedores terceiros via postbacks
{random}Número aletório (único por callback)
{revenue_float}Receita conforme enviada do SDK da Adjust, em unidades de moedas inteiras
{user_agent}Agente do usuário bruto de entrada