Integração com o Airbridge

Glossário

Cenário de integração

Airbridge e Xsolla suportam a integração S2S de aplicativos móveis que permite o rastreamento completo 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 Airbridge como eventos no app móvel, que o Airbridge atribui então ao número de parcelas do 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çadas se você:

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

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

Como funciona

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

1. O usuário (jogador) se cadastra ou acessa a conta no aplicativo móvel.
2. Seu aplicativo envia um evento no app ao Airbridge, como login, signup, ou qualquer outro evento que inclua o CUID.
3. O Airbridge envia um postback à Xsolla, que inclui o ID da loja de aplicativos, ID Airbridge, 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 Airbridge.
7. O servidor Xsolla envia um evento S2S no app para o Airbridge, que contém o ID do Airbridge, ID de loja do aplicativo e outros parâmetros recebidos do Airbridge.

O Airbridge 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. Pressione o painel Airbridge.

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

4. Na janela que surgir, marque a caixa Enable this integration.
5. Insira os seguintes dados:
   • Token Airbridge S2S.
   • ID de loja de aplicativo para plataformas de distribuição (Android/iOS). Para adicionar uma plataforma, selecione Add application.

1. Você precisa copiar os valores para esses parâmetros na sua conta Airbridge como descrito abaixo.

6. Selecione Save.
7. Ative a integração no Airbridge.

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 Airbridge.
2. Faça as alterações necessárias na janela que surgir.
3. Selecione Save.

Como configurar no Airbridge

No Airbridge, você precisa:

1. Obter as credenciais.
2. Ativar a integração com a Xsolla.

Obter credenciais

1. Acesse sua conta Airbridge.
2. Acesse a seção Integration > Third-party integration.
3. Pressione o painel Xsolla.

4. Na seção Set up Xsolla dashboard, copie os valores para Application store ID e Airbridge S2S token, e cole-os na Conta de Distribuidor.

Ative a integração com a Xsolla

Depois de ativar a integração na Conta de Distribuidor:

1. Acesse sua conta Airbridge.
2. Acesse a seção Integration > Third-party integration.
3. Pressione o painel Xsolla.
4. Ative a opção Send events.

Observação

Para compartilhar os dados de usuários do iOS que recusarem a App Tracking Transparency (ATT), desative a opção EPC (Extended Privacy Control). Se essa opção estiver desativada, acesse a seção Settings > App settings para atualizá-la.

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 Airbridge. 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 postback: