Integração com Adjust

Glossário

Adjust

Plataforma de análises de marketing e atribuições móveis. Adjust permite que desenvolvedores de aplicativos, profissionais de marketing e marcas rastreiem, meçam e otimizem a eficiência de suas campanhas de marketing entre diversos canais e dispositivos.

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

Token do app

ID de Aplicativo Móvel exclusivo para cada plataforma (Android, iOS, etc.). Ele é gerado automaticamente ao adicionar um aplicativo ao Adjust. Você pode encontrar este valor no Adjust na seção AppView > All apps, próxima ao nome de um aplicativo correspondente.

ID do Adjust

ID de Usuário gerado pelo Adjust.

Valor Vitalício (LTV)

Receita média que um usuário gera durante o tempo que eles usam o aplicativo. Consulte a documentação Adjust 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 Adjust para obter informações mais detalhadas sobre o ROAS.

Evento no aplicativo

Ação do usuário dentro do aplicativo. Consulte a documentação Adjust para obter informações mais detalhadas sobre os eventos no aplicativo. As ações de usuários na Web Shop também são consideradas como eventos no aplicativo no caso de integração S2S e enviadas ao Adjust pelo back-end 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 do 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 Adjust. Esse parâmetro é usado para o pareamento e atribuição de usuários.

Aviso

Você precisa passar o CUID como o parâmetro xsolla_cuid do parceiro seguindo as instruções.

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 Adjust para obter informações detalhadas.

Token de segurança server-to-server (S2S)

Token que é usado para autorizar as chamadas S2S para enviar dados de eventos para o Adjust. Ele é gerado no lado do Adjust. Consulte as documentações Adjust para obter informações detalhadas sobre o token S2S.

Cenário de integração

Adjust e Xsolla suportam a integração S2S de aplicativos móveis que permite a conclusão de medidas completas de LTV e ROAS para as compras dentro do aplicativo e na Web Shop. A Xsolla envia informações sobre as compras na Web Shop ao Adjust como eventos no app móvel, que o Adjust atribui então ao número de instâncias de aplicativo móvel, aquisições de usuários e campanhas de re-engajamento.

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

• tiver um aplicativo móvel na plataforma Android/iOS
• usar o Adjust
• usar a solução Web Shop para vender itens nos jogos

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

Como funciona

A integração inclui um fluxo de dados bidirecional entre a Xsolla e o Adjust. 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 Adjust
    User->>Mobile App: 1. Logs in
    Mobile App->>Adjust: 2. Sends CUID
    Adjust-->>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->>Adjust: 7. Sends xsolla-billing-payment event

1. O usuário (jogador) se cadastra ou faz login no aplicativo móvel.
2. Seu aplicativo envia um evento no app ao Adjust — por exemplo, login, signup, ou outro evento que inclua o CUID.
3. O Adjust envia um retorno de chamada à Xsolla, que inclui o token do app, ID do Adjust, 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 Adjust.
7. O servidor Xsolla envia um evento S2S no app para o Adjust, que contém o ID do Adjust, token do app e outros parâmetros recebidos do Adjust.

O Adjust atribui um novo evento, compra e receita de volta à fonte de mídia que levou à aquisição do usuário ou o re-engajamento do usuário.

Como configurar na Conta de Distribuidor

1. Abra seu projeto na Conta de Distribuidor e acesse a seção Integrations.
2. Clique no painel Adjust.

3. No painel Mobile app S2S integration, clique em Configure.
4. Na janela que surgir, certifique-se de que a caixa Enable this integration está marcada.
5. Insira os seguintes dados:
   • Token de segurança Adjust S2S.
   • Token do app para as plataformas de distribuição (Android/iOS). Para adicionar uma plataforma, selecione Add app token.
6. Selecione Save.
7. Ative a integração no Adjust.

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

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

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

Como configurar no Adjust

No Adjust, você precisa:

1. Configurar a passagem do CUID como parâmetro do parceiro.
2. Obter um token de segurança S2S.
3. Ativar a integração com a Xsolla.

Passe o CUID como parâmetro do parceiro

Configure a transferência do CUID você mesmo seguindo as instruções. Para fazer isso, chame o método addGlobalPartnerParameter e passe os seguintes dados:

• ID do Usuário do seu lado
• forKey: “xsolla_cuid”

Exemplo:

1Adjust.addGlobalPartnerParameter("abcd123", forKey: "xsolla_cuid")

1[Adjust addGlobalPartnerParameter:@"abcd123" forKey:@"xsolla_cuid"];

Obter token de segurança S2S

Para obter um token de segurança S2S:

1. Faça login na conta Adjust.
2. Abra a seção AppView > All apps e acesse a página do seu aplicativo.
3. Acesse a aba Protection.
4. No bloco S2S security, selecione Open S2S security.
5. Na linha com o token S2S necessário, selecione o ícone de copiar.

Se ainda não tiver o token S2S, crie um seguindo as instruções.

Ative a integração com a Xsolla

1. Faça login na conta Adjust.
2. Acesse a seção Campaign Lab > Partners.
3. Selecione New partner.

4. Na barra de pesquisas, insira e selecione Xsolla.
5. Selecione Next.

6. Selecione um aplicativo para configurar a integração.
7. Selecione Next.
8. Ative o compartilhamento de dados. Para fazer isso, no bloco Enable data sharing, clique em Edit, defina a opção como ativa e selecione Enable.

9. Configure o mapeamento do evento:

1. 1. No bloco Map your events, selecione em Map event.

1. 2. Na seção Adjust event, selecione xsolla-billing-payment.
   3. Na seção Partner event, selecione Xsolla billing payment.
   4. Selecione Apply.

10. Selecione Next.
11. Verifique as configurações e clique em Enable partner. Se necessário, você poderá retornar às etapas anteriores e atualizar as configurações.

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 Adjust. 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: