Integração do Xsolla com a AppsFlyer

Última atualização:

Resumo: Xsolla, um parceiro integrado da AppsFlyer, é um parceiro de tecnologia de gaming commerce especializado no processamento de pagamentos fora das plataformas tradicionais de aplicativos. A integração entre o Xsolla e a AppsFlyer permite que o Xsolla automatize as compras feitas na Web Shop e que a receita seja enviada para a AppsFlyer, mostrando o ROAS e LTV completos de um jogo, incluindo compras feitas na Web Shop do Xsolla.

Importante!

Algumas fontes de mídiarestringem o compartilhamento de dados com terceiros. Portanto, os postbacks de eventos restritos não serão enviados para esse parceiro, independentemente da configuração de envio de postbacks.

Tipos de integração

Existem dois métodos de integração disponíveis:

  • Integração com parceiros de tecnologia: Essa integração permite que o Xsolla envie compras e receita da Web Shop como eventos mobile, melhorando o ROAS e LTV da campanha mobile, mostrando dados além das compras padrão da loja de aplicativos.
  • Integração de PBA Web SDK: Essa integração permite que o Xsolla envie compras e receita da Web Shop como eventos da web, permitindo que a AppsFlyer mensure a performance das campanhas da web, enviando usuários do jogo diretamente para a Web Shop.

Pré-requisitos: 

  • Antes de criar uma integração, certifique-se de entrar em contato com o parceiro e abrir uma conta com ele.
  • Para que a integração funcione corretamente, certifique-se de compartilhar Customer User ID (CUID) com a AppsFlyer, e que ele faça a correspondência do user ID compartilhado com o Xsolla. Isso permite que os usuários façam login na Web Shop do Xsolla e garante que os dados do usuário sejam enviados com precisão para a AppsFlyer.

Configurando a integração do parceiro de tecnologia

Para ativar ou editar a integração:

  1. Para ativar: na AppsFlyer, no menu lateral, selecione Colaborar > Partner Marketplace.
    Para editar: na AppsFlyer, no menu lateral, selecione Colaborar > Integrações Ativas.
  2. Procure o parceiro e selecione-o.
  3. Clique em Configurar a integração. Você será direcionado para a página de configuração da integração.
  4. Na aba Integração, selecione o aplicativo e clique em Ativar parceiro.
    Atenção: essa opção deve permanecer habilitada (ativada) enquanto você trabalhar com o parceiro./strong>
  5. Complete a configuração utilizando as abas relevantes, conforme descrito abaixo.

A janela de configuração utiliza apenas a aba Integração.

Para obter uma descrição detalhada do header da Janela de Configuração de Parceiros, clique aqui.

Aba de integração

Ativar parceiro

Na sua primeira visita, você precisará habilitar a opção Ativar parceiro para configurar a integração. Essa opção deve permanecer ativada enquanto você trabalhar com o Xsolla. Saiba mais sobre a ativação de parceiros. 

Privacidade avançada

Para aplicativos iOS, o toggle Privacidade Avançada é exibido. Quando ativada, ela limita o compartilhamento de identificadores de usuário com o parceiro. Observe que, quando o botão Privacidade Avançada Agregada está ativado nas configurações do aplicativo, Privacidade Avançada (para iOS 14.5+ e posterior) está ativada e bloqueada por padrão.

Postbacks padrão

A AppsFlyer envia postbacks padrão para o Xsolla após as instalações. Use esta seção para configurar esses postbacks.

  • Desativado: Postbacks de instalação não são enviados para o Xsolla.
    Atenção: A integração do Xsolla com a AppsFlyer não requer o envio de postbacks de instalação. Portanto, recomendamos que você deixe a opção desativada.
  • Todas as fontes de mídia, incluindo orgânicas: Postbacks de instalação são enviados para eventos atribuídos a qualquer parceiro e para eventos orgânicos.

default_postbacks.png

Postbacks de eventos in-app

Nessa seção você pode mapear os eventos da AppsFlyer com o parceiro por meio de postbacks. 

xsolla-af-login-3.jpg

  1. Ative Postbacks de eventos in-app.
  2. Clique em Adicionar evento para incluir um evento do SDK ou de servidor para servidor na lista.
  3. Preencha os seguintes parâmetros:
    Nome do parâmetro Descrição
    Evento AppsFlyer

    O nome do evento, conforme recebido pela AppsFlyer do SDK integrado no aplicativo ou de eventos de servidor para servidor.

    Atenção:

    • Para o Xsolla, certifique-se de adicionar o evento af_login ou qualquer outro evento que represente o login do usuário no aplicativo, conforme mostrado na captura de tela acima.
    • O Xsolla recomenda que você evite enviar eventos que ocorrem com muita frequência e não incluir o CUID (como af_app_opened), pois isso pode impedir o funcionamento da integração.
    mapeado para evento do parceiro Digite o nome do evento correspondente que você deseja enviar para o Xsolla. A nomenclatura do Xsolla é flexível e qualquer nome pode ser usado nesse campo.
    para usuários de Selecione Todas as fontes de mídia, incluindo orgânicas para enviar postbacks para eventos atribuídos a qualquer parceiro e para eventos orgânicos.
    incluindo
    • Sem valores e sem receita: Envie apenas o evento em si, sem qualquer parâmetro (valores ou receita).
    • Valores e sem receita: Envie todos os parâmetros, com exceção do valor da receita.
    • Valores e receita: Envie todos os parâmetros de evento, incluindo o valor da receita (se existir no evento).
    Atenção: A integração do Xsolla com a AppsFlyer não requer o envio de valores ou receita. Portanto, qualquer opção selecionada é aplicável. 
  4. Clique em Salvar integração.

Aba do link de atribuição

Links de atribuição não estão disponíveis para o Xsolla.

Custo

Os dados de custo não são compatíveis com a integração com o Xsolla.

Aba receita de anúncios

Os dados de receita de anúncios não são compatíveis com a integração com o Xsolla.

Aba Permissões

As permissões não estão disponíveis para o Xsolla.

Configurando a integração do PBA Web SDK

Essa integração permite o acesso a dados e insights de LTV (Lifetime value) para analisar a performance do aplicativo dentro do dashboard do PBA.

Para configurar a integração:

  1. Na AppsFlyer: Adicione o aplicativo Xsolla. Selecione Web (PBA) como plataforma e insira as seguintes informações:
    • Use seu domínio da Web Shop como URL do aplicativo web. Por exemplo, se seu domínio da Web Shop for www.webshop.com, use ele como sua URL do aplicativo web.
    • Use qualquer valor como o nome do aplicativo.
  2. Na AppsFlyer: Adicione o bundle Xsolla com as seguintes informações:
    1.  
      1. Insira qualquer nome de bundle como o nome do bundle.
      2. Selecione o aplicativo web que você criou na etapa anterior como o aplicativo web do bundle.
  3. No Xsolla: Conecte a AppsFlyer à sua Conta de Publisher do Xsolla:
    1. Abra seu projeto em sua Conta de Publisher.
    2. Selecione seu site e clique em configurar.
    3. Na aba de configurações do site, vá para a seção de aplicativos.
    4. Em AppsFlyer, clique em conectar.
      xsolla-connect.jpg
    5. No campo AppsFlyer Dev Key, insira a dev key da AppsFlyer. Veja abaixo como encontrar a dev key na AppsFlyer.
    6. Clique em conectar.

Como encontrar a web dev key na AppsFlyer

  1. Na página meus aplicativos, clique em ver bundles de marca.
  2. Clique no ícone de copiar na linha do bundle Xsolla.

xsolla-brand-bundle2.jpg

Identificando os eventos do Xsolla no AppsFlyer

Integração de parceiro técnico (S2S):

O Xsolla envia 2 eventos in-app para a AppsFlyer:

  • xsolla-billing-payment - Item comprado
  • xsolla-billing-refund - Reembolso de compra

Ambos os eventos fazem parte dos eventos in-app do aplicativo mobile.

Integração do Web SDK:

O Xsolla envia à AppsFlyer vários eventos da web, personalizados para a atividade específica do anunciante. O mais importante é chamado "PURCHASE" e contém a receita de compras.
Os eventos da web do Xsolla aparecem nos relatórios de atribuição da web do PBA e nos relatórios brutos de "Eventos da web" do DataLocker.

Características e limitações

Suporte para PC / Console - a integração da AppsFlyer com o Xsolla não é compatível com aplicativos de PC / Console nessa fase

Veja também