Integração com o Tenjin

Glossário

Tenjin

Uma plataforma para atribuições móveis e análises de marketing. Ela permite que os desenvolvedores de aplicativos e profissionais de marketing rastreiem, meçam e otimizem campanhas de marketing ao longo de diversos canais e dispositivos.

Consulte a documentação Tenjin para obter informações detalhadas sobre a plataforma.

ID de Aplicativo

ID de aplicativo móvel que é automaticamente gerado ao adicionar um aplicativo ao Tenjin. Ele corresponde ao Bundle ID. Para encontrar esse valor:

1. Na sua conta no Tenjin, acesse a seção Configure > All apps.
2. Abra a página para o aplicativo necessário.
3. Na seção Add details, copie o Bundle ID.

Chave SDK

ID de aplicativo móvel que é automaticamente gerado ao adicionar um aplicativo ao Tenjin. Ele corresponde ao Bundle ID. Para encontrar esse valor:

1. Na sua conta no Tenjin, acesse a seção Configure > All apps.
2. Abra a página para o aplicativo necessário.
3. Na seção Add details, copie o Bundle ID.

Observação

Se seu aplicativo foi publicado tanto nas plataformas iOS quanto Android, você precisa obter uma chave de nível de conta. Para isso, contate seu gerente Tenjin.

Chave de nível de conta

Token que é usado para autorizar chamadas servidor-a-servidor (S2S) para quando seu aplicativo foi publicado tanto nas plataformas iOS quanto Android. Ele é gerado no lado do Tenjin. Para obtê-lo, contate seu gerente Tenjin.

Tenha em mente que os IDs de conjunto são exclusivos para cada plataforma.

ID Tenjin

ID de Usuário gerado pelo Tenjin (analytics_installation_id).

Valor Vitalício (LTV)

Receita média que um usuário gera durante o tempo que eles usam o aplicativo. Consulte a documentação Tenjin para obter informações mais detalhadas sobre o LTV.

Retorno Nos Gastos de Anúncios (ROAS)

Métrica que mede a eficiência de uma campanha de anúncios calculando a receita obtida por unidade de anúncio gasta. Consulte a documentação Tenjin para obter informações mais detalhadas sobre o ROAS.

Retorno Sobre o Investimento (ROI)

Métrica que garante o retorno sobre o investimento calculando o percentual de lucro adquirido relativo ao custo total. Consulte a documentação Tenjin para obter informações detalhadas sobre o ROI.

Evento no aplicativo

As ações do usuário dentro do aplicativo. As ações do usuário na Web Shop também são consideradas eventos no aplicativo no caso da integração S2S e enviadas ao Tenjin no backend da Xsolla.

Aquisição de usuários

O processo de atrair novos usuários ao site, serviço, plataforma ou aplicativo através da atividade de marketing.

ID de Usuário Cliente (Customer user ID, CUID)

ID de Usuário gerado e definido pelo proprietário do aplicativo no momento do cadastro do usuário. O CUID deve ser o mesmo para a Web Shop e o Tenjin. Esse parâmetro possibilita o pareamento e atribuição de usuários.

Aviso

Se os CUIDs na Web Shop e seu aplicativo móvel não corresponderem, contate seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com para implementar o webhook Validação de usuário na Web Shop ou a autenticação via link profundo.

Retorno de chamada

Processo de recebimento de dados em eventos no app. Consulte a documentação do Tenjin para obter informações detalhadas.

Cenário de integração

O Tenjin e a Xsolla suportam integrações de aplicativos móveis S2S que permitem a conclusão de medições LTV, ROAS e ROI completas para as compras dentro do aplicativo e na Web Shop. A Xsolla envia informações sobre as compras na Web Shop para o Tenjin como eventos no aplicativo móvel, que o Tenjin depois atribui à quantidade de instalações de aplicativos móveis e aquisições de usuários.

Você pode configurar a integração de aplicativos móveis para obter análises de eventos avançadas se você:

• tem um aplicativo móvel para a plataforma Android/iOS
• usa o Tenjin
• use a solução Web Shop para vender itens no jogo

O seguinte evento está disponível via Xsolla e a integração Tenjin S2S:

Como funciona

A integração inclui um fluxo de dados bidirecional entre a Xsolla e o Tenjin. Abaixo está o cenário de sistema de interação quando um usuário faz uma compra.

  sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Tenjin
    User->>Mobile App: 1. Logs in
    Mobile App->>Tenjin: 2. Sends CUID
    Tenjin-->>Xsolla Backend: 3. Sends callback
    User->>Web Shop: 4. Logs in using CUID
    User->>Web Shop: 5. Makes a purchase
    Web Shop->>Xsolla Backend: 6. Sends purchase event
    Xsolla Backend->>Tenjin: 7. Sends xsolla-billing-payment event

1. O usuário se cadastra ou acessa a conta no aplicativo móvel.
2. Seu aplicativo envia um evento no app que inclui o CUID ao Tenjin.
3. O Tenjin envia um retorno de chamada à Xsolla, que inclui o ID do aplicativo, ID Tenjin, CUID e outros parâmetros de dados relacionados.
4. O usuário faz login na Web Shop usando o CUID.
5. O usuário faz uma compra na Web Shop.
6. O evento de compra é enviado ao servidor Xsolla e pareado com os dados recebidos do Tenjin.
7. O servidor Xsolla envia um evento S2S no app para o Tenjin, que contém o ID do Tenjin, ID do aplicativo e outros parâmetros recebidos do Tenjin.

O Tenjin atribui um novo evento, compra e receita de volta à fonte de mídia.

Como configurar na Conta de Distribuidor

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Integrations.
2. Selecione o painel Tenjin.

3. No painel Mobile app S2S integration, selecione Configure.
4. Marque a caixa Ativar esta integração.
5. Insira os seguintes dados:
   • Chave SDK gerada no lado do Tenjin por plataforma. Se seu aplicativo é publicado na plataforma iOS tanto quanto Android, você precisa especificar uma chave de nível de conta recebida do Tenjin.
   • ID de Aplicativo.
6. Selecione Save.
7. Ative a integração no Tenjin.

Depois de salvar as configurações, um indicador verde será exibido no painel de integração S2S.

Para fazer alterações na integração ativada:

1. Selecione o painel Tenjin.
2. Faça as alterações necessárias na janela que surgir.
3. Selecione Save.

Como configurar no Tenjin

No Tenjin, você deve:

1. Configurar a passagem do CUID ao Tenjin.
2. Adicionar a Xsolla como canal de anúncios.
3. Configurar um retorno de chamada.

Passagem do CUID

Configure a transferência do CUID do seu aplicativo móvel ao Tenjin chamando o método setCustomerUserId:

1TenjinSDK instance = TenjinSDK.getInstance(this, "<TENJIN_SDK_KEY>");
2instance.setCustomerUserId(cuid);   // CUID generated by your backend
3instance.connect();

1TenjinSDK.initialize("<TENJIN_SDK_KEY>")
2TenjinSDK.setCustomerUserId(userId: cuid);  // CUID used for Web Shop
3TenjinSDK.connect();

1BaseTenjin instance = Tenjin.getInstance("<TENJIN_SDK_KEY>");
2instance.SetCustomerUserId(cuid);   // CUID used for Web Shop
3instance.Connect();

Adicione a Xsolla como canal de adição

1. Acesse sua conta Tenjin.
2. Acesse a seção Configure > Channels.
3. Selecione Add a channel.

4. Na barra de pesquisa, insira e seleciona a Xsolla.
5. Selecione o painel Xsolla.

6. Selecione Add ad account.

Configure o retorno de chamada

1. Acesse sua conta Tenjin.
2. Acesse a seção Configure > Channels.
3. Acesse a página para o aplicativo necessário.
4. Acesse a aba Callbacks.
5. Na lista suspensa de canais de anúncios, selecione Xsolla.

6. Na seção Channel callbacks, selecione Add events e então Xsolla login.

7. Na janela modal, selecione o evento que contém o CUID e selecione Save.

Estrutura dos valores do evento

Se você quiser configurar um evento específico ou se as opções de integração atuais não cobrirem suas necessidades, contate seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.

Compra de itens

Quando um usuário faz uma compra na Web Shop, a Xsolla envia o evento xsolla-billing-payment ao Tenjin. As seguintes informações de compra são passadas nos parâmetros do evento:

Dados adicionais

Adicionalmente, você pode passar os seguintes parâmetros no retorno de chamada: