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

• tiver um aplicativo móvel na plataforma Android/iOS
• usa a AppsFlyer Measurement Platform
• usar a solução Web Shop para vender itens do jogo

Os seguintes eventos estão disponíveis pela integração Xsolla e AppsFlyer S2S:

Como funciona

A integração inclui o fluxo de dados bidirecionais entre a Xsolla e AppsFlyer. Abaixo encontra-se o cenário de interação do sistema quando um usuário faz uma compra.

1. O usuário (jogador do jogo) se cadastra ou acessa a conta no aplicativo móvel Android/iOS.
2. Seu aplicativo envia um evento no aplicativo padrão ao AppsFlyer: af_login, af_signup ou qualquer evento que contém o CUID.
3. O AppsFlyer envia um postback à Xsolla, incluindo o ID de aplicativo, ID appsflyer e CUID.
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 backend da Xsolla e é comparado com a informação recebida do AppsFlyer.
7. O backend da Xsolla envia um evento S2S no aplicativo ao AppsFlyer que contém o ID appsflyer.

O AppsFlyer atribui esse novo evento, compra e receita de volta à fonte de mídia que levou à aquisição do usuário ou ao reengajamento do usuário.

Como configurar na Conta de Distribuidor

1. Abra seu projeto na Conta de Distribuidor.
2. No menu lateral, clique em Integrations.
3. Clique no painel AppsFlyer.

4. No painel Mobile app S2S integration, clique em Configure.

5. Na janela que surgir, insira os seguintes dados:
   1. Token S2S AppsFlyer.
   2. IDs do aplicativo nas plataformas de publicação (Android/iOS). Para adicionar uma platforma, clique em Add application ID.
6. Clique em Save.

Depois de salvar, a opção no painel AppsFlyer ficará ativada.
Para fazer alterações Na integração conectada:

1. Clique no painel AppsFlyer.
2. Na janela que surgir, faça as mudanças necessárias.
3. Clique em Save.

Como configurar no AppsFlyer

No AppsFlyer, você precisa:

1. Obter um token S2S.
2. Ative a integração com a Xsolla.

Obtenção do token S2S

Para recuperar o token S2S:

1. Acesse sua conta AppsFlyer HQ.
2. Vá para a seção Account > Security Center > AppsFlyer API and S2S tokens and S2S tokens.
3. Na linha com o token S2S, clique no ícone de copiar na coluna Token.

Se você ainda não tiver o token S2S, crie um.

Ativação da integração com a Xsolla.

1. Na sua conta AppsFlyer HQ, selecione o aplicativo Android/iOS necessário e vá para a seção Collaborate > Partner marketplace.

2. Encontre e selecione a Xsolla na barra de pesquisa.

3. Clique em Set up integration.

4. Na aba de integração:
   1. Ative a opção Activate Partner.
   2. Apenas para aplicativos iOS: defina a opção Advanced Privacy de acordo com a sua política de privacidade:
      1. On — todos os eventos são enviados para a Xsolla
      2. Off — apenas os eventos ATT autorizados são enviados à Xsolla

1. 3. Deixe o valor Default postbacks — off (por padrão).
   4. Ative a opção In-app event postbacks.
   5. Configure ao menos um evento no aplicativo que inclui informações de login (CUID).
   6. Insira qualquer valor no campo mapped to partner event. A Xsolla suporta qualquer nome de evento.
   7. Salve a integração.

Você pode ler mais sobre as configurações de integração no lado do AppsFlyer na documentação.

Estrutura dos valores do evento

Se você quiser configurar um evento específico ou se as capacidades 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 AppsFlyer. As seguintes informações de compra são passadas nos parâmetros do evento:

Exemplo de evento com um único SKU:

{
    "af_content_id": "test-coin",
    "af_quantity": "11",
    "af_revenue": "99.99",
    "af_currency": "USD",
    "af_purchase_currency": "USD",
    "af_receipt_id": "1234567890"
}

Exemplo de evento com múltiplos SKUs:

{
    "af_content_id": ["test-coin-1", "test-coin-2"],
    "af_quantity": ["5", "60"],
    "af_revenue": "99.99",
    "af_currency": "USD",
    "af_purchase_currency": "USD",
    "af_receipt_id": "1234567890"
}

Reembolso

Quando um usuário inicia um reembolso de pagamento, a Xsolla envia o evento xsolla-billing-refund ao AppsFlyer. As informações de reembolso seguintes são passadas nos parâmetros do evento:

Exemplo de evento com múltiplos SKUs:

{
    "af_content_id": ["test-coin-1", "test-coin-2"],
    "af_quantity": ["5", "60"],
    "af_revenue": "-99.99",
    "af_currency": "USD",
    "af_purchase_currency": "USD",
    "af_receipt_id": "1234567890"
}