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 Treasure Data

O Treasure Data é um parceiro de analytics integrado à Adjust. Nossa integração permite que o Treasure Data receba dados mensurados na Adjust por meio de callbacks automáticos. Use esses dados com as ferramentas de parceiros para analytics e insights.

Neste artigo, saiba como configurar a mensuração com o Treasure Data para seu aplicativo. Isso inclui a ativação da integração e a escolha dos dados que a Adjust pode compartilhar com o Treasure Data.

Antes de começar

Requisitos

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

Credenciais

API KEY, DB ID e TABLE ID

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

Selecione Treasure Data e o seu aplicativo no Campaign Lab

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

Habilitar o compartilhamento de dados

Habilite o compartilhamento de dados para ativar a integração com o Treasure Data. Para fazer isso:

  1. Insira seus API KEY, DB ID e TABLE ID.

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

  • clique
  • instalação
  • sessão
  • reatribuiçã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 o Adjust compartilha com o Treasure Data por padrão:

  • clique
  • instalação
  • sessão
  • reatribuição
  • evento

Enviar dados adicionais

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

Para enviar dados adicionais, você pode revisar e personalizar o seguinte:

Sessões

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

Mapear eventos

Mapeie os eventos que você deseja compartilhar com os valores que o Treasure Data pode receber. Os dados de eventos não mapeados não são compartilhados com o Treasure Data.

Mapear eventos individuais

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

  1. Selecione Mapear evento.

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

  3. Em Evento do parceiro, selecione o evento do Treasure Data 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 Treasure Data receberá dados de eventos in-app para todos os seus eventos vinculados.

Mapear todos os eventos

Se o Treasure Data 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 Treasure Data 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 Treasure Data.

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 Treasure Data. Isso permite que o Treasure Data 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 encaminhar parâmetros de parceiros ao Treasure Data, 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.

Habilitar o Treasure Data para seu aplicativo

Na tela Revisão da configuração, revise suas escolhas. Você também pode retornar e fazer alterações em:

  • Seu app selecionado
  • Opções de compartilhamento de dados

Selecione Habilitar parceiro para habilitar o Treasure Data para seu aplicativo. Os parceiros de análise não trabalham com links para campanhas. Uma vez ativada, nossa integração envia dados de atribuição e de eventos no aplicativo por meio de callbacks automatizados.

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

O serviço Treasure Data está disponível em várias regiões. Escolha sua região na lista suspensa Região e dados serão enviados ao endpoint que corresponde à sua região.

Lista de todos os parâmetros encaminhados a Treasure Data

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

Espaço reservadoInformação
{android_id}Android ID (apenas Android)
{country}Código do país de dois caracteres do dispositivo
{device_name}Número do modelo do dispositivo
{gps_adid}Advertising ID da Google Play Store
{idfa}ID para anunciantes (apenas iOS)
`{idfagps_adid}`IDFA ou GPS ADID se o IDFA estiver vazio
{idfv}iOS ID em caixa-alta para fornecedores
{ip_address}Endereço IP do dispositivo
{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
{user_agent}Agente do usuário bruto de entrada
{adgroup_name}Nome do grupo de anúncios, conforme retirado do tracker
{app_version}Número da versão do aplicativo (Android), número da versão para bundle (iOS)
{campaign_name}Nome da campanha, conforme retirado do tracker
{click_time}Marca temporal do clique atribuído
{created_at}Marca temporal da atividade
{creative_name}Nome criativo, conforme retirado do tracker
{network_name}Nome da rede, conforme retirado do tracker