Integração com o Singular

Glossário

Singular

Atribuição móvel e plataforma de análises de marketing. O Singular possibilita que desenvolvedores de aplicativos, profissionais de marketing e marcas rastreiem, meçam e otimizem a eficiência de suas campanhas de marketing ao longo de vários canais e dispositivos.

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

ID de Aplicativo

ID de Aplicativo móvel exclusivo para cada plataforma (Android, iOS). Ele corresponde ao valor Bundle ID que você pode encontrar no Singular na seção Settings > Apps, no painel de um aplicativo necessário.

Evento no aplicativo

Ação do usuário dentro do aplicativo. Consulte a documentação Singular para obter informações detalhadas sobre os eventos no aplicativo. As ações do usuário na Web Shop também são consideradas como eventos no app no caso da integração S2S e enviadas ao Singular pelo backend 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.

Redirecionamento

Contatar os usuários atuais ou passados através de campanhas de anúncios. Consulte a estratégia de usuários engajantes que já interagiram anteriormente com o seu aplicativo ou site. Consulte a documentação Singular para obter informações detalhadas.

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 Singular. Esse parâmetro é usado para o pareamento e atribuição de usuários.

Aviso

Você deve passar este parâmetro no postback. 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.

Postback

Processo de recebimento de dados em eventos no app. Consulte a documentação Singular para obter informações detalhadas.

Chave SDK

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

Fluxo de integração

Singular e a Xsolla suportam a integração S2S de aplicativos móveis, que permite que você meça e avalie a eficiência de campanhas de aquisição de usuários e redirecionamento para atrair tráfego à Web Shop. A Xsolla envia informações sobre as compras da Web Shop ao Singular como eventos no app móvel, que o Singular atribui então à fonte correspondente.

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

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

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

Como funciona

A integração inclui um fluxo de dados bidirecional entre a Xsolla e o Singular. Abaixo está o cenário de sistema de interação quando um usuário faz uma compra.

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'noteTextColor': '#495C6B' }}}%%
sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Singular
    User->>Mobile App: 1. Logs in
    Mobile App->>Singular: 2. Sends CUID
    Singular->>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->>Singular: 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 Singular, como login, ou qualquer outro evento que inclua o CUID.
3. O Singular envia um postback à Xsolla, que inclui o CUID e outros dados sobre o dispositivo do usuário.
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 Singular.
7. O servidor da Xsolla envia um evento no app ao Singular, que contém parâmetros necessários para o mapeamento.

O Singular 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 Singular.

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. Forneça os seguintes dados:
   1. Chave SDK do Singular.
   2. ID do Aplicativo, exclusivo para cada plataforma (Android/iOS). Para adicionar uma plataforma, selecione Add application ID.
6. Selecione Save.
7. Ative a integração no Singular.

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

Como configurar no Singular

No Singular, você precisa:

1. Obter uma chave SDK.
2. Ativar a integração com a Xsolla.

Obtenção da chave SDK

1. Acesse sua conta Singular.
2. Abra a seção Developer Tools > SDK Integration.
3. Acesse a aba SDK Keys.
4. Selecione Show Keys.
5. Copie o valor no campo SDK Key.

Ative a integração com a Xsolla

1. Acesse sua conta Singular.
2. Acesse a seção Attribution Setup > Partner Configuration.
3. Selecione Add Partner.
4. Na barra de pesquisas, insira e selecione Xsolla.

5. Na janela que surgir, selecione um aplicativo para configurar a integração.
6. Selecione Next.
7. Certifique-se de que o evento Login esteja selecionado no bloco Events Postbacks.
8. Clique em Save.

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 Singular. As seguintes informações de compra são passadas nos parâmetros do evento:

Dados adicionais

Além dos parâmetros passados no evento xsolla-billing-payment, a Xsolla envia os seguintes dados: