Você pode configurar a integração Web SDK com o Adjust para obter análises de eventos avançadas se você:

• usa o Adjust
• criou seu site usando o construtor de sites da Xsolla

Os seguintes eventos estão disponíveis pela integração Web SDK:

Como funciona

Abaixo, temos um cenário de interação do sistema ao implementar campanhas de aquisição de usuário e redirecionamento. O usuário passa pelos banners de anúncios à Web Shop e faz uma compra. O conjunto de eventos que são enviados ao Adjust nesse processo permite que você rastreie:

• quantos usuários clicaram em cada banner e de onde eles vieram
• quanto os usuários pagaram
• se a campanha de redirecionamento foi eficiente

  sequenceDiagram
    participant User
    participant Promo as Web Shop<br>promotional campaign<br>(ad banner)
    participant Shop as Web Shop
    participant Adjust as Adjust
    User->>Promo: 1. Clicks banner
    Promo->>Shop: 2. Redirect with URL parameters
    Shop->>Adjust: 3. xsolla-web-event event
    User->>Shop: 4. Logs in with CUID
    Shop->>Adjust: 5. xsolla-web-identify event
    User->>Shop: 6. Makes purchase
    Shop->>Adjust: 7. xsolla-web-purchase event

Fluxo do usuário:

1. O usuário clica no banner de campanha de anúncio.
2. O usuário é redirecionado para a Web Shop, e o URL dessa transição inclui os parâmetros, especificando de qual banner e site o usuário foi direcionado.
3. Um evento sobre a visita é enviado para o lado do cliente da Web Shop ao Adjust.
4. O usuário faz login na Web Shop usando o CUID.
5. O evento de autorização é enviado ao Adjust.
6. O usuário faz uma compra na Web Shop.
7. O evento de compra é enviado ao Adjust.

Como configurar no Adjust

No Adjust, você precisa:

1. Criar eventos que você deseja incluir no relatório de análises do Adjust.
2. Ative a integração com a Xsolla.

Criação de eventos

1. Faça login na conta Adjust.
2. Acesse a seção AppView > All apps.
3. Clique no nome do aplicativo necessário.

4. Na aba Events, clique em Add event.

5. Adicione os seguintes eventos um por um:
   • Um evento para receber informações gerais sobre a visita do site, ex.: xsolla-web-event.
   • Um evento para receber informações sobre a autenticação do usuário, ex.: xsolla-web-identify.
   • Um evento para receber informações sobre a compra, ex.: xsolla-web-purchase.

Você pode nomear os eventos e especificar suas regras para corresponder às suas necessidades. Quando os eventos forem adicionados, eles serão exibidos na lista da aba Events.

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.
   2. Evento do mapa de acordo com a tabela:

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

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 Web SDK (Site Builder), selecione Configure. Você será redirecionado à lista dos seus sites.

4. No painel do site necessário, selecione Configure.

5. Na aba Site settings, acesse a seção Apps.
6. No painel Adjust Web SDK, selecione Connect.

7. Na janela modal que abrir, insira o token do app.
8. Selecione Connect.

Para encontrar informações sobre os eventos na sua conta Adjust, acesse a seção Datascape > Reports > All reports. Consulte a documentação Adjust para obter informações detalhadas sobre o trabalho com relatórios.

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: