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.

Se você configurou a autenticação de ID de usuário na sua Web Shop, certifique-se de que o CUID utilizado na Web Shop corresponda ao configurado para ser enviado ao MMP a partir do seu aplicativo móvel. Se não estiver, contate seu Gerente de Sucesso do Cliente ou envie um e-mail a [email protected] para implementar o webhook User validation in Web Shop ou autenticação via link profundo.

Se você configurou outras opções de autenticação, consulte a seção Authentication configuration for integration with MMPs.

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

Uma estratégia para engajar os usuários que interagiram previamente com o seu aplicativo ou site. Seu objetivo é restaurar a atividade de usuários atuais ou inativos através de campanhas de anúncios.

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 apoiam os seguintes tipos de integrações:

Integração de aplicativo móvel S2S — 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 app móveis, que o AppsFlyer atribui então à quantidade de instalações do aplicativo móvel, campanhas de aquisição de usuários e de reengajamento.

Integração Web SDK — Permite que você meça e avalie a eficiência das campanhas de aquisição de usuários e redirecionamento para atrair tráfego à Web Shop.

Integração da Web SDK permite a avaliação de quantos usuários vieram ao site através de uma campanha de redirecionamento e a conversão de canais que levam ao site. A Xsolla envia informações sobre compras na Web Shop ao AppsFlyer como eventos da web, que o AppsFlyer atribui à fonte de mídia correspondente, campanha, conjunto de anúncios e anúncios que levam o usuário à 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

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 definir os seguintes parâmetros:

Grupo AppsFlyer de parâmetros, tais como pid, c, af_c_id, af_adset, af_adset_id, af_ad, af_ad_id, para obter relatórios de anúncios (nível criativo) no AppsFlyer.
Configure o parâmetro pid de acordo com como deseja exibir a fonte de mídia no AppsFlyer. Por exemplo, você pode usar pid=google ou pid=googleadwords_int, dependendo de como deseja classificar e rastrear diferentes fontes de tráfego.
Para rastrear campanhas de anúncios para sua Web Shop, inclua um parâmetro de nome da campanha nos seus URLs de atribuição. O valor do parâmetro será incluso nos dados de atribuição e refletidos nos relatórios via AppsFlyer.

Use o parâmetro c para passar o nome da campanha.

Exemplos: c=summer_sale ou c={{campaign.name}}.

Siga as melhores práticas de atribuição de URL de site PBA do AppsFlyer.

  sequenceDiagram
    participant U as Usuário
    participant WSP as Campanha promocional Web Shop (banner de anúncio)
    participant WS as Web Shop
    participant AF as AppsFlyer
    U->>WSP: Pressiona o banner
    WSP->>WS: Redireciona com parâmetros de URL
    WS->>AF: Envia evento de carga
    U->>WS: Faz login com CUID
    WS->>AF: Envia evento de identificação
    U->>WS: Faz uma compra
    WS->>AF: Envia um evento de compra

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

Como configurar na sua conta

Abra seu projeto na Conta de Distribuidor.
Vá para o construtor do site usando uma das seguintes maneiras:
- No menu lateral, selecione Storefronts > Websites.
- No menu lateral, selecione Integrations. Na seção que abrir:
  1. Selecione o painel AppsFlyer.
  2. No painel Web SDK (Site Builder), selecione Configure.

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

Abra seu projeto na sua conta.
Vá para o construtor do site usando uma das seguintes maneiras:
- No menu lateral, selecione Storefronts > Websites.
- No menu lateral, selecione Other tools > Integrations. Na seção que abrir:
  1. Selecione o painel AppsFlyer.
  2. No painel Web SDK (Site Builder), selecione Configure.

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

Abra seu projeto na sua conta.
Vá para o construtor do site usando uma das seguintes maneiras:
- No menu lateral, selecione Storefronts > Websites.
- No menu lateral, selecione Other tools > Integrations. Na seção que abrir:
  1. Selecione o painel AppsFlyer.
  2. No painel Web SDK (Site Builder), selecione Configure.

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

Abra seu projeto na sua conta.
Vá para o construtor do site usando uma das seguintes maneiras:
- No menu lateral, selecione Storefronts > Websites.
- No menu lateral, selecione Other tools > Integrations. Na seção que abrir:
  1. Selecione o painel AppsFlyer.
  2. No painel Web SDK (Site Builder), selecione Configure.

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

Abra seu projeto na conta para jogos de celular.
Vá para o construtor do site usando um dos seguintes métodos:
- No menu lateral, clique em Web Shop.
- No menu lateral, clique em Operations > MMP. Na seção que abrir:
  1. Clique no painel AppsFlyer.
  2. No painel Web SDK (Site Builder), clique em Configure.

No painel do seu site, selecione o ícone ⋮ e então 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 uma compra.
xsolla-billing-refund	Reembolso de pagamento. Os parâmetros do evento contém informações sobre a quantidade do reembolso de pagamento.
xsolla-billing-created	Criação de fatura. Os parâmetros do evento contêm informações sobre a fatura criada.
xsolla-billing-error	Erro de pagamento. Os parâmetros do evento contêm informações sobre o erro ocorrido durante o processamento de pagamento.

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.

  sequenceDiagram
    participant User
    participant App as Application
    participant Shop as Web Shop
    participant Backend as Xsolla Backend
    participant AF as AppsFlyer
    User->>App: 1. Logs in
    App->>AF: 2. Sends CUID
    AF-->>Backend: 3. Sends postback (Application ID, AppsFlyer ID, CUID)
    User->>Shop: 4. Logs in with CUID
    User->>Shop: 5. Makes purchase
    Shop->>Backend: 6. Sends purchase event
    Backend->>AF: 7. Sends xsolla-billing-payment event

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 e CUID.

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

Como configurar na sua conta

Abra seu projeto na Conta de Distribuidor e acesse Integrations.

Abra o projeto na sua conta e vá para a seção Other tools > Integrations.

Abra o projeto na sua conta e vá para a seção Other tools > Integrations.

Abra o projeto na sua conta e vá para a seção Other tools > Integrations.

Abra o projeto na sua conta e acesse Operations > MMP.

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 S2S.
2. IDs de Aplicativos para as plataformas de distribuição Android/iOS no seguinte formato:
  - iOS: idXXXXXXXXX
  - Android: com.example.yourapp
  Para adicionar uma plataforma, selecione Add application ID.
Selecione 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.
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 [email protected].

Compra de itens

Quando um usuário faz uma compra na Web Shop, a Xsolla envia o evento xsolla-billing-payment ao AppsFlyer.

Parâmetros principais

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, incluindo descontos, antes da dedução de taxas e comissões.
af_currency	Moeda na qual o preço do item é exibido na Web Shop (moeda de compra).
af_net_revenue	Quantia de compra recebida pelo comerciante (jogo) após a dedução de comissões e taxas. Especificada na moeda de compra (`af_currency`).
af_receipt_id	Os 10 primeiros dígitos do ID da Fatura.

Parâmetros adicionais

Esses parâmetros não são exibidos nos relatórios agregados e nos painéis, e ficam disponíveis somente ao exportar dados brutos:

Parâmetro	Descrição
af_purchase_currency	Moeda na qual o usuário realmente pagou pela compra, após a conversão ou seleção do método de pagamento (moeda de pagamento).
af_payment_amount	Quantia que o usuário realmente pagou na moeda de pagamento.
payout_amount	Quantia de compra recebida pelo comerciante (jogo) após a dedução de comissões e taxas. Especificada na moeda de compra (`payout_currency`). Corresponde a `af_net_revenue`, mas sem a conversão para `af_currency`.
payout_currency	Moeda de pagamento. Corresponde a `af_purchase_currency`.
af_store	Fonte de dados. Sempre tem o valor `xsolla` e é usado na identificação de eventos internos no AppsFlyer.
af_dry_run	Indicador de pagamento de teste. Possíveis valores: `1` — pagamentos feitos no modo sandbox. `0` — pagamentos reais.
date_payment	Data de pagamento no formato ISO 8601.

Exemplo de evento com um único SKU:

Copy

Full screen

Small screen

 1{
 2    "af_content_id" : "test-coin",
 3    "af_quantity" : "2",
 4    "af_revenue" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

Exemplo de evento com múltiplos SKUs:

Copy

Full screen

Small screen

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_revenue" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

Reembolso

Quando um usuário inicia um reembolso de pagamento, a Xsolla envia o evento xsolla-billing-refund ao AppsFlyer.

Parâmetros principais

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 na qual o preço do item é exibido na Web Shop (moeda de compra).
af_net_revenue	Quantia de compra recebida pelo comerciante (jogo) após a dedução de comissões e taxas. Especificada na moeda de compra (`af_currency`).
af_receipt_id	Os 10 primeiros dígitos do ID da Fatura.

Parâmetros adicionais

Esses parâmetros não são exibidos nos relatórios agregados e nos painéis, e ficam disponíveis somente ao exportar dados brutos:

Parâmetro	Descrição
af_purchase_currency	Moeda na qual o usuário realmente pagou pela compra, após a conversão ou seleção do método de pagamento (moeda de pagamento).
af_payment_amount	Quantia que o usuário realmente pagou na moeda de pagamento.
payout_amount	Quantia de compra recebida pelo comerciante (jogo) após a dedução de comissões e taxas. Especificada na moeda de compra (`payout_currency`). Corresponde a `af_net_revenue`, mas sem a conversão para `af_currency`.
payout_currency	Moeda de pagamento. Corresponde a `af_purchase_currency`.
af_store	Fonte de dados. Sempre tem o valor `xsolla` e é usado na identificação de eventos internos no AppsFlyer.
af_dry_run	Indicador de pagamento de teste. Sempre definido como `0`. Para evitar ter dados dos pagamentos sandbox nos relatórios, use um conjunto separado no AppsFlyer para testes.
date_payment	Data de pagamento no formato ISO 8601.

Exemplo de evento com múltiplos SKUs:

Copy

Full screen

Small screen

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_revenue" : "-40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "-32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

Criação de fatura

Quando uma fatura da compra de um item é criada no sistema Xsolla para a Web Shop, a Xsolla envia o evento xsolla-billing-created ao AppsFlyer.

Parâmetros principais

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_currency	Moeda na qual o preço do item é exibido na Web Shop (moeda de compra).
af_receipt_id	Os 10 primeiros dígitos do ID da Fatura.

Parâmetros adicionais

Esses parâmetros não são exibidos nos relatórios agregados e nos painéis, e ficam disponíveis somente ao exportar dados brutos:

Parâmetro	Descrição
af_item_value	O custo do item comprado, incluindo descontos. Utilizado nas análises em nível de itens e não incluindo o cálculo de receita (diferentemente de `af_revenue`, que é contabilizado em direção à receita para eventos de compra e reembolso).
af_purchase_currency	Moeda na qual o usuário realmente pagou pela compra, após a conversão ou seleção do método de pagamento (moeda de pagamento).
af_payment_amount	Quantia que o usuário realmente pagou na moeda de pagamento.
payout_amount	Quantia de compra recebida pelo comerciante (jogo) após a dedução de comissões e taxas. Especificada na moeda de pagamento (`payout_currency`).
payout_currency	Moeda de pagamento. Corresponde a `af_purchase_currency`.
af_store	Fonte de dados. Sempre tem o valor `xsolla` e é usado na identificação de eventos internos no AppsFlyer.
af_dry_run	Indicador de pagamento de teste. Sempre definido como `0`. Para evitar ter dados dos pagamentos sandbox nos relatórios, use um conjunto separado no AppsFlyer para testes.
date_payment	Data de pagamento no formato ISO 8601.

Exemplo de evento com múltiplos SKUs:

Copy

Full screen

Small screen

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_item_value" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "payout_amount" : "404577.4",
 9    "payout_currency" : "UZS",
10    "af_receipt_id" : "5555555550",
11    "af_store" : "xsolla",
12    "af_dry_run" : "0",
13    "date_payment" : "2026-08-27T01:50:58Z"
14}

Erro de pagamento

Quando um erro de pagamento ocorre durante uma compra na Web Shop, a Xsolla envia o evento xsolla-billing-error ao AppsFlyer. Os parâmetros do evento contêm as seguintes informações:

Parâmetros principais

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_currency	Moeda na qual o preço do item é exibido na Web Shop (moeda de compra).
af_receipt_id	Os 10 primeiros dígitos do ID da Fatura.

Parâmetros adicionais

Esses parâmetros não são exibidos nos relatórios agregados e nos painéis, e ficam disponíveis somente ao exportar dados brutos:

Parâmetro	Descrição
af_item_value	O custo do item comprado, incluindo descontos. Utilizado nas análises em nível de itens e não incluindo o cálculo de receita (diferentemente de `af_revenue`, que é contabilizado em direção à receita para eventos de compra e reembolso).
af_purchase_currency	Moeda na qual o usuário realmente pagou pela compra, após a conversão ou seleção do método de pagamento (moeda de pagamento).
af_payment_amount	Quantia que o usuário realmente pagou na moeda de pagamento.
payout_amount	Quantia de compra recebida pelo comerciante (jogo) após a dedução de comissões e taxas. Especificada na moeda de pagamento (`payout_currency`).
payout_currency	Moeda de pagamento. Corresponde a `af_purchase_currency`.
af_store	Fonte de dados. Sempre tem o valor `xsolla` e é usado na identificação de eventos internos no AppsFlyer.
af_dry_run	Indicador de pagamento de teste. Sempre definido como `0`. Para evitar ter dados dos pagamentos sandbox nos relatórios, use um conjunto separado no AppsFlyer para testes.
date_payment	Data de pagamento no formato ISO 8601.

Exemplo de evento com múltiplos SKUs:

Copy

Full screen

Small screen

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_item_value" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "payout_amount" : "404577.4",
 9    "payout_currency" : "UZS",
10    "af_receipt_id" : "5555555550",
11    "af_store" : "xsolla",
12    "af_dry_run" : "0",
13    "date_payment" : "2026-08-27T01:50:58Z"
14}

Obrigado pelo seu feedback!

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

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

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 configurar na sua conta
Como configurar na sua conta
Como funciona
Como configurar na Conta de Distribuidor
Como configurar na sua conta
Como configurar na sua conta
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
Criação de fatura
Erro de pagamento