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

• usar a AppsFlyer Measurement Platform e tiver People-Based Attribution para a conta
• usar o Xsolla Site Builder

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

Como funciona

Abaixo, temos um cenário de interação do sistema ao implementar uma campanha 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 AppsFlyer nesse processo nos permite ver:

• quais usuários, a quantidade deles e de quais banners eles vieram
• quanto eles pagaram
• se a campanha de redirecionamento foi eficiente

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 o grupo de parâmetros AppsFlyer, 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 AppsFlyer.
4. O usuário faz login na Web Shop usando CUID.
5. O evento de autorização é enviado ao AppsFlyer.
6. O usuário faz uma compra na Web Shop.
7. O evento de compra é enviado ao AppsFlyer.

Como configurar no AppsFlyer

Antes de começar, configure as seguintes configurações na plataforma AppsFlyer:

1. Adicione um aplicativo:
   1. Clique em Add app.
   2. Na lista, selecione a plataforma Web (PBA).
   3. Como URL de aplicativo, especifique o domínio da sua Web Shop, ex.: https://www.webshop.example.com/.
   4. Especifique um nome de aplicativo, ex.:Xsolla.
   5. Clique em Add my app.

2. Adicione um conjunto :
   1. Clique em Add bundle.
   2. Especifique Xsolla-bundle como nome.
   3. Na lista de aplicativos da web, selecione Xsolla, adicionado anteriormente.
   4. Clique em Create bundle.

Como configurar na Conta de Distribuidor

1. Abra seu projeto na Conta de Distribuidor.
2. Vá para o construtor do site usando uma das seguintes maneiras:
   • No menu lateral, clique em Site Builder.
   • No menu lateral, clique em Integrations. Na seção que abrir:
     1. Clique no painel AppsFlyer.
     2. No painel Web SDK (Site Builder), clique em Configure.

3. Selecione seu site e clique em Configure.
4. Na aba Site settings, vá para a seção Apps.
5. No painel AppsFlyer, clique em Connect.

6. No campo AppsFlyer Dev Key, insira a chave de desenvolvedor. Você pode encontrar essa informação na sua conta na AppsFlyer:
   1. Vá para a seção My Apps.
   2. Clique em View brand bundles.
   3. Na linha do conjunto de marca Xsolla-bundle, clique no ícone de cópia na coluna Web dev key.
7. Clique em Connect.

Para descobrir mais informações sobre os eventos na sua conta no AppsFlyer:

1. Vá para a seção My Apps.
2. Na seçãoAvailable Apps, escolha o aplicativo Xsolla que deseja e clique em View in PBA.

Você também pode ver os eventos analíticos na seção Dashboards > People-Based Attribution.

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"
}