Integração com o AppsFlyer

Glossário

AppsFlyer

Atribuição móvel e plataforma de análises de marketing que permite os desenvolvedores de aplicativos, marqueteiros e marcas a rastrearem e medirem a eficiência das campanhas de marketing entre diversos canais e dispositivos.
Consulte a documentação AppsFlyer para mais informações sobre a plataforma.

ID de Aplicativo

ID de aplicativo móvel, que é único para cada plataforma móvel (Android, iOS, etc.). Os valores do ID de aplicativo especificado na Xsolla devem corresponder ao ID de aplicativo na seção AppsFlyer’s My Apps.
Consulte a documentação Android ou documentação Apple para mais informações sobre o ID de aplicativo.

ID appsflyer

ID de usuário gerado pelo AppsFlyer.

AppsFlyer web ID

ID do site na conta AppsFlyer, usado durante a integração Web SDK com o AppsFlyer e passado no campo webAppId nos eventos web.

Transparência do Rastreamento dos Aplicativos (App Tracking Transparency, ATT)

Recurso de privacidade introduzido pela Apple no iOS 14.5 e nas versões futuras que exige que os aplicativos peçam permissão ao usuário antes de rastrearem seus dados.

ID de usuário cliente (Customer user ID, CUID)

O 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 na Web Shop e AppsFlyer. Consulte a documentação AppsFlyer para mais informações sobre o CUID.

Identificador Para Publicitários (Identifier for Advertisers, IDFA)

ID desenvolvido pela Apple atribuído a um dispositivo do usuário. Consulte a documentação Apple para mais informações sobre o IDFA.

Evento no aplicativo

Ação do usuário dentro do aplicativo. Consulte a documentação AppsFlyer para mais informações sobre os eventos no aplicativo.
As ações do usuário na Web Shop também são considerados eventos no aplicativo no caso da integração S2S e enviadas ao AppsFlyer no backend da Xsolla.

Evento web

As ações do usuário na Web Shop, que são enviadas do lado do cliente da Web Shop ao AppsFlyer e são necessários à integração do Web SDK.

Valor Vitalício (LTV)

Receita média que um usuário gera durante o tempo que eles usam o aplicativo. Consulte a documentação AppsFlyer para mais informações sobre o LTV.

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.

Retorno Nos Gastos de Anúncios (ROAS)

Métrica que mede a eficiência de uma campanha de anúncios calculando a receita adquirida por unidade de anúncio gasta.

Postback

Processo de receber dados nos eventos do aplicativo as redes publicitárias. Consulte a documentação AppsFlyer para mais informações sobre o postback.

Token Servidor-para-servidor (Server-to-server, S2S) ou chave S2S

Token usado para autorizar chamadas S2S para enviar dados de eventos ao AppsFlyer. Ele é gerado no lado do AppsFlyer. Consulte a documentação AppsFlyer para mais informações sobre o token S2S.

Chave de Desenvolvedor AppsFlyer

A chave que é usada durante a integração do AppsFlyer Web SDK. Essa chave é exclusiva para cada aplicativo e é usada para autorizar seu aplicativo no sistema AppsFlyer. Ela é gerada no lado da AppsFlyer.
Consulte a documentação AppsFlyer para mais informações sobre a Chave de Desenvolvedor.

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.

Cenários de integração

AppsFlyer e a Xsolla suportam os seguintes tipos de integrações:

Integração S2S do aplicativo móvel — permite a conclusão de medições 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 AppsFlyer como eventos no aplicativo móvel, que o AppsFlyer então atribui à quantidade de parcelas do aplicativo móvel, aquisição de usuários e campanhas de reengajamento.

Integração do Web SDK — permite que você meça e avalie a eficiência da aquisição de usuário e campanhas de redirecionamento por atrair tráfegos à Web Shop.
A integração Web SDK permite a avaliação de quantos usuários vieram ao site através da campanha de redirecionamento e a conversão dos canais que levam ao site. A Xsolla envia informações sobre as compras na Web Shop ao AppsFlyer como eventos web, que o AppsFlyer atribui à fonte de mídia, campanha, conjunto de anúncios e anúncios em si correspondentes que levam o usuário a fazer a compra.

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:

Evento	Descrição
`load`	Evento de visitação do site, incluindo os parâmetros URL que contém a informação fonte de onde o usuário está vindo, e um AppsFlyer web ID, que é armazenado em um cookie primário.
`identify`	Evento de login, incluindo AppsFlyer web ID e CUID.
`event`	Evento de compra de item, incluindo o AppsFlyer web ID e CUID.

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

Para rastrear fontes de tráfego, recomendamos configurar os seguintes parâmetros de rastreamento:

Grupo de parâmetros AppsFlyer tais como pid, c, af_c_id, af_adset, af_adset_id, af_ad, af_ad_id, para obter relatórios no nível dos anúncios (nível criativo) no AppsFlyer.
Configure o parâmetro pid de acordo com como você deseja exibir cada fonte de mídia no AppsFlyer. Por exemplo, você pode usar pid=google ou pid=googleadwords_int, dependendo de como você quiser classificar e rastrear diferentes fontes de tráfego.

O usuário clica no banner de campanha de anúncio.
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.
Um evento sobre a visita é enviado para o lado do cliente da Web Shop ao AppsFlyer.
O usuário faz login na Web Shop usando CUID.
O evento de autorização é enviado ao AppsFlyer.
O usuário faz uma compra na Web Shop.
O evento de compra é enviado ao AppsFlyer.

Como configurar no AppsFlyer

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

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.

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

Abra seu projeto na Conta de Distribuidor.
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.

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

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.
Clique em Connect.

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

Vá para a seção My Apps.
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:

Evento	Descrição
xsolla-billing-payment	Compra de item. Os parâmetros do evento contêm informações sobre a compra.
xsolla-billing-refund	Compra de item. Os parâmetros do evento contêm informações sobre a compra.

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.

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

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

No painel Mobile app S2S integration, clique em Configure.

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.
Clique em Save.

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

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

Como configurar no AppsFlyer

No AppsFlyer, você precisa:

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

Obtenção do token S2S

Você deve possuir uma função de administrador na conta AppsFlyer para visualizar e gerenciar tokens S2S.
Certifique-se de gerar e compartilhar a chave S2S (token S2S) e não a chave API V2 (token) que é usada para APIs diferentes e não é relevante para essa integração.

Para recuperar o token S2S:

Acesse sua conta AppsFlyer HQ.
Vá para a seção Account > Security Center > AppsFlyer API and S2S tokens and S2S tokens.
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.

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

Encontre e selecione a Xsolla na barra de pesquisa.

Clique em Set up integration.

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

IDFA não é enviado à Xsolla em ambos casos, apenas o ID appsflyer e o CUID são compartilhados.

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

Para a integração bem-sucedida, você precisa de ao menos um dos seguintes eventos: af_login, af_signup ou qualquer outro evento no aplicativo que inclua CUID.
O CUID no AppsFlyer deve ser idêntico ao ICUID na Web Shop. O AppsFlyer e a Xsolla comparam os dados com base no CUID. Portanto, se o CUID não corresponder, a integração não funcionará.
Exemplo da incompatibilidade de valores: o CUID no AppsFlyer é o e-mail criptografado (com hash) do usuário, e o CUID na Xsolla é o e-mail em formato de texto.
Não é necessário configurar outras abas: Attribution Link, Cost, Ad revenue ou Permissions.

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:

Parâmetro	Descrição
af_content_id	Único SKU ou matriz de SKU na compra.
af_quantity	Quantidade do item com o SKU correspondente (um ou uma matriz).
af_revenue	Quantia de compra. Descontos são incluídos. Não contém quaisquer comissões ou taxas.
af_currency	Moeda de compra.

Exemplo de evento com um único SKU:

Copy

Full screen

Small screen

{
    "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:

Copy

Full screen

Small screen

{
    "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:

Parâmetro	Descrição
af_content_id	Único SKU ou matriz de SKUs na compra que foi reembolsada.
af_quantity	Quantidade do item com o SKU correspondente (um ou uma matriz).
af_revenue	Quantia de compra que foi reembolsada.
af_currency	Moeda de compra reembolsada.

Exemplo de evento com múltiplos SKUs:

Copy

Full screen

Small screen

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

Obrigado pelo seu feedback!

Avaliaremos sua mensagem e a usaremos para melhorar sua experiência.

Última atualização: 2 de Outubro de 2024

Encontrou um erro de texto ou digitação? Selecione o texto e pressione Ctrl+Enter.

Conteúdos

Glossário
Cenários de integração
Como funciona
Como configurar no AppsFlyer
Como configurar na Conta de Distribuidor
Como funciona
Como configurar na Conta de Distribuidor
Como configurar no AppsFlyer
Obtenção do token S2S
Ativação da integração com a Xsolla.
Estrutura dos valores do evento
Compra de itens
Reembolso

Your browser is not supported. Please try a different browser

Integração com o AppsFlyer

Glossário

AppsFlyer

ID de Aplicativo

ID appsflyer

AppsFlyer web ID

Transparência do Rastreamento dos Aplicativos (App Tracking Transparency, ATT)

ID de usuário cliente (Customer user ID, CUID)

Identificador Para Publicitários (Identifier for Advertisers, IDFA)

Evento no aplicativo

Evento web

Valor Vitalício (LTV)

Redirecionamento

Retorno Nos Gastos de Anúncios (ROAS)

Postback

Token Servidor-para-servidor (Server-to-server, S2S) ou chave S2S

Chave de Desenvolvedor AppsFlyer

Aquisição de usuários

Cenários de integração

Como funciona

Como configurar no AppsFlyer

Como configurar na Conta de Distribuidor

Como funciona

Como configurar na Conta de Distribuidor

Como configurar no AppsFlyer

Obtenção do token S2S

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

Estrutura dos valores do evento

Compra de itens

Reembolso