Análise de eventos

Você pode usar esse recurso se você já integrou a Pay Station e configurou ao menos uma conta:

A Google Analytics e o Facebook coletam dados se um usuário concedeu permissão para usar todos os cookies ou consentiu ao uso de cookies analíticos e de desempenho no banner da RGPD.

Integração com plataformas de análise

Para rastrear eventos ocorrendo na interface de pagamento quando os usuários interagirem com eles, conecte as plataformas de análise na sua Conta de Distribuidor:

Google Analytics
Facebook Pixel
GameAnalytics

Google Analytics

Para conectar a plataforma de análises:

Abra seu projeto na Conta de Distribuidor.
Vá para Pay Station > Configurações.
Na seção Aplicativos, escolha Google Analytics.
Clique em Conectar.

Ao conectar o Google Analytics, os eventos correspondentes serão enviados à sua conta do Google Analytics. Você pode encontrar esses eventos no Google Analytics em Behaviour > Events > Top Events.

Você pode acompanhar os seguintes eventos:

Ação	Descrição
open-{state_name}	Abertura de uma página na interface de pagamento.
click-btn-pay	Clicando no botão Pagar agora no formulário de dados de cobrança.
return	Clicando no botão Retornar à Loja/Iniciar novamente.
create-invoice	Criação de transações.
purchase	Criando uma fatura (atribuindo um ID de transação). Os parâmetros do evento contêm informações detalhadas sobre uma compra, incluindo preços e taxas de itens. Consulte a documentação Google Analytics para obter descrições dos parâmetros. O evento é apenas enviado se você configurou o catálogo na Conta de Distribuidor na seção Store.
open-payment-credit-card	Abrindo a interface de pagamento para inserir os detalhes do cartão.
open-payment-saved-methods	Abrindo a página com os métodos de pagamento salvos.
open-payment-payment-methods	Abrindo a lista de todos os métodos de pagamento disponíveis ao clicar em mais.
open-payment-{id}	Abrindo a página de um método de pagamento específico, onde `id` é um ID de método de pagamento.
open-status	Abrindo a página de um status de pagamento.
open-status-processing	Abrindo uma página com um status de pagamento `processing`. Após a conclusão do processamento, o status pode mudar para `success` ou `error`.
open-status-error	Abrindo uma página com um status de pagamento `error`.
open-status-success	Abrindo uma página com um status de pagamento `success`.
choose-method	Escolha um método de pagamento ao abrir a lista mais.

Dimensões personalizadas para o Google Analytics

ID Dimension	Nome	Descrição
1	version	Versão do Pay Station.
2	purchase_invoice_id	ID da fatura de pagamento no sistema Xsolla.
3	external_id	ID da fatura de pagamento no sistema do parceiro.
5	total_sum	Valor total de compra. Todas as taxas estão incluídas.
6	total_sum_currency	Valor total da compra em moeda.
7	pid	ID do sistema de pagamento.
8	projectId	ID do projeto.
9	country	País de pagamento.
10	projectName	Nome do projeto.

Facebook Analytics

Para conectar a plataforma de análises:

Abra seu projeto na Conta de Distribuidor.
Vá para Pay Station > Configurações.
Na seção Aplicativos, escolha Facebook Pixel.
Clique em Conectar.

Ao conectar o Facebook Pixel, os eventos correspondentes serão enviados à sua conta do Facebook Analytics. Você pode encontrar esses eventos no Facebook Analytics em Business Settings > Measure & Report > Analytics > Pixels > Overview.

Você pode acompanhar os seguintes eventos:

Evento	Descrição
open-{state_name}	Abrindo uma página na interface de pagamento. O nome do estado é passado em `parameters`.
click-btn-pay	Clicando no botão Pagar agora no formulário de dados de cobrança. O nome do método de pagamento é passado em `parameters`.
return	Clicando no botão Retornar à Loja/Iniciar novamente. O nome do status é passado em `parameters`.
change-status-{status_name}	Alterando o status do pagamento. Se o usuário fechar a interface de pagamento ou sair da página e o status for alterado em seguida, a mensagem do evento não será enviada.
create-invoice	Criação de transações.
open-payment-credit-card	Abrindo a interface de pagamento para inserir os detalhes do cartão.
open-payment-saved-methods	Abrindo a página com os métodos de pagamento salvos.
open-payment-payment-methods	Abrindo a lista de todos os métodos de pagamento disponíveis ao clicar em mais.
open-payment-{id}	Abrindo a página de um método de pagamento específico, onde `id` é um ID de método de pagamento.
open-status	Abrindo a página de um status de pagamento.
open-status-processing	Abrindo uma página com um status de pagamento `processing`. Após a conclusão do processamento, o status pode mudar para `success` ou `error`.
open-status-error	Abrindo uma página com um status de pagamento `error`.
open-status-success	Abrindo uma página com um status de pagamento `success`.
choose-method	Escolha um método de pagamento ao abrir a lista mais.

Para integrar a plataforma de análise:

Vá para sua Conta de Distribuidor > Pay Station > Settings.
Selecione Google Analytics/Facebook Pixel na seção Apps.
Insira seu ID de rastreamento e clique em Connect.

Ao integrar o Google Analytics e o Facebook Pixel, os eventos correspondentes serão enviados para suas contas do Google Analytics e do Facebook Analytics.

GameAnalytics

Para conectar a plataforma de análise:

Abra seu projeto na Conta de Distribuidor.
Vá para Pay Station > Configurações.
Na seção Aplicativos, escolha GameAnalytics.
Clique em Conectar.

No campo GameAnalytics game key, insira a chave do jogo. Para encontrar essa informação na sua conta no GameAnalytics:
1. No menu suspenso no painel superior, selecione o jogo.
2. Na seção Keys, clique no ícone de copiar próximo a Game key.

Se seu jogo for lançado em múltiplas plataformas, e houver projetos dedicados para cada um deles no GameAnalytics, você pode inserir uma chave de jogo para qualquer uma dessas plataformas na Conta de Distribuidor.

Clique em Connect.

Atualmente, a integração com a plataforma GameAnalytics permite que você receba informações sobre eventos de pagamento bem-sucedidos. Você pode encontrar esses dados na sua conta GameAnalyitics no painel na seção Monetization.

Eventos da interface de pagamento

Os eventos da interface de pagamento são processados através do mecanismo postMessage ao abrir o Pay Station em um iframe, nova janela ou com a Pay Station Embed.

Exemplo de cenário para processar mensagens enviadas via postMessage:

Cadastre-se para receber mensagens enviadas via postMessage.
Analise os dados do evento em um formato JSON.
Implemente uma verificação da presença do evento que precisa ser processado.
Quando o evento necessário for recebido, implemente a lógica para processá-lo. No exemplo abaixo, o texto é enviado para o console. Você pode adicionar sua própria lógica.

Exemplo:

Copy

Full screen

Small screen

window.addEventListener('message', (event) => {
  const eventData = JSON.parse(event.data);

  if (eventData.command === 'open-payment') {
    console.log('hello!')
  }
});

Evento	Descrição
add_saved_account	Salvamento bem-sucedido de uma conta de pagamento.
add_saved_account_error	Erro ao salvar uma conta de pagamento.
cancel_save_account	Cancelamento do salvamento de uma conta de pagamento pelo usuário.
cart_display	Exibição da interface de pagamento como colunas. O parâmetro `value` pode ser: `1` se a interface de pagamento for aberta como duas colunas `0` se a interface de pagamento for aberta como uma coluna, por exemplo, na página onde você gerencia os métodos de pagamento salvos Exemplo: `{“command”:“cart_display”,“data”:{“value”:“1”,“version”:“Pay Station 4”}}`.
change-status	Alterando o status do pagamento. Se o usuário fechar a interface de pagamento ou sair da página e o status for alterado em seguida, a mensagem do evento não será enviada.
choose-method	Escolha um método de pagamento ao abrir a lista mais.
click-custom-package-continue	Clicando no botão Continuar ao comprar uma quantidade arbitrária de moedas virtuais.
click-comment	Clicando no botão para publicar um comentário.
click-buy-package	Clicando no botão Comprar pacote ao comprar um pacote de moedas virtuais.
click-buy-gift-package	Clicando no botão ao comprar um pacote de moedas virtuais como presente.
click-buy-gift-custom-package	Clicando no botão ao comprar uma quantidade arbitrária de moedas virtuais como presente.
click-btn-pay	Clicando no botão Pagar agora no formulário de dados de cobrança.
click-btn-continue	Clicando no botão para comprar a assinatura.
click-btn-apply	Clicando no botão Aplicar ao resgatar um cupom.
click-btn-activate	Clicando no botão Ativar ao ativar uma chave de jogo.
click-btn-accept	Clicando no botão para comprar conteúdos digitais.
create-invoice	Criação de transações.
dimensions	Quando o Pay Station é aberto no iframe, a largura e a altura do iframe são passadas nos parâmetros `width` e `height`.
error	Um erro que ocorre durante o processo de pagamento. O código do erro é passado no parâmetro `data.code`, e a descrição do erro na interface de pagamento é passada no parâmetro `data.message`.
external-link-open	Redirecionamento para um recurso externo. O endereço para o qual o redirecionamento ocorreu é passado no parâmetro `url`.
external-payment-open	Redirecionamento da interface de pagamento para um sistema de pagamento externo ou verificação 3-D Secure.
focus-change	Alteração do foco em elementos do widget Pay Station. O estado de foco é passado no parâmetro `hasFocus` e pode ser `true` ou `false`.
open-{state_name}	Abertura de uma página na interface de pagamento.
open-payment-credit-card	Abrindo a interface de pagamento para inserir os detalhes do cartão.
open-payment-saved-methods	Abrindo a página com os métodos de pagamento salvos.
open-payment-payment-methods	Abrindo a lista de todos os métodos de pagamento disponíveis ao clicar em mais.
open-payment-{id}	Abrindo a página de um método de pagamento específico, onde `id` é um ID de método de pagamento.
open-status	Abrindo a página de um status de pagamento.
open-status-processing	Abrindo uma página com um status de pagamento `processing`. Após a conclusão do processamento, o status pode mudar para `success` ou `error`.
open-status-error	Abrindo uma página com um status de pagamento `error`.
open-status-success	Abrindo uma página com um status de pagamento `success`.
order-status	Alterando o status do pedido para `done`. O evento é enviado a partir da página de status de pagamento se um pedido foi criado por meio de uma das seguintes chamadas de API: Criar pedido com todos os itens de um carrinho específico Criar pedido com todos os itens do carrinho atual Criar pedido com item especificado Os dados sobre um usuário, transação e pedido são passados no objeto `data`. Exemplo: {“command”:“order-status”,“data”:{“user_id”:“123abc-456”,“invoice_id”:123456,“price”:{“amount”:“12.96”,“currency”:“USD”},“order_id”:123456,“items”:[{“id”:123456,“sku”:“booster_min”,“quantity”:2,“amount”:“3.99”,“price”:{“amount”:“3.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:123456,“sku”:“boots_1”,“quantity”:1,“amount”:“2.99”,“price”:{“amount”:“2.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:1234567,“sku”:“xsolla_gloves”,“quantity”:1,“amount”:“1.99”,“price”:{“amount”:“1.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:12345678,“sku”:“reward_vp_a”,“quantity”:5,“amount”:“0”,“price”:{“amount”:“0”,“currency”:“USD”},“tax_category”:“DG00001”}],“version”:“Pay Station 4”}}.
resize	Alteração do tamanho da interface de pagamento. A largura e a altura da interface de pagamento aberta são passadas no objeto `data`. Exemplo: `{“command”:“resize”,“data”:{“dimensions”:{“width”:924,“height”:754}, “version”:“Pay Station 4”}}`.
show-error-page	Abrindo uma página com um erro. Um código de erro é passado no parâmetro `value`.
status	Indo para a página de status do pagamento. Os seguintes parâmetros podem ser passados: `status` — status do pagamento `email` — e-mail do usuário `invoice` — ID da transação `virtualCurrencyAmount` — a quantidade de moedas virtuais comprada `userId` — ID do usuário `discount` — o desconto aplicado ao pagamento
status-redeem	O resgate do cupom em um formulário de pagamento.
close	Fechando a interface de pagamento.

Os parâmetros de evento são passados em cada mensagem de postMessage. Se as informações do parâmetro ainda não tiverem sido coletadas, será exibida uma cadeia de caracteres vazia.

Parâmetro	Tipo	Descrição
action	string	Nome do evento.
value	string	Parâmetro adicional. Contém parâmetros de evento específicos que variam dependendo da escolha do usuário.
state	string	A página da interface de pagamento, na qual a ação foi executada.
date	string	Data e hora no fuso horário GMT.
milliseconds	number	Data e horário no formato Unix.
timezone	string	Fuso horário do usuário.
session_id	string	ID da sessão. A sessão inclui todas as ações do usuário executadas dentro de 30 minutos ou até que a interface de pagamento seja fechada. A sessão começa a partir do momento em que a interface do usuário de pagamento é aberta e salva depois que a página com a interface de pagamento é atualizada.
payment_country	string	País de pagamento.
purchase_invoice_id	number	ID da fatura de pagamento no sistema Xsolla.
purchase_external_id	string	ID da fatura de pagamento no sistema do parceiro.
purchase_type	string	Tipo de compra. Pode ser: `virtual item`, `virtual currency`, `pay2play`, `subscription`.
purchase_sum	number	Valor nominal de compra.
purchase_currency	string	Moeda de compra.
purchase_sku	string	SKU do item comprado.
purchase_digital_content_sku	string	SKU do pacote de chaves de jogo comprado.
purchase_description	string	Descrição da compra.
virtual_currency_amount	number	Quantia da moeda virtual.
coupon_code	string	Código do cupom.
subscription_package_external_id	number	ID da assinatura.
subscription_package_name	string	Nome da assinatura.
subscription_package_description	string	Descrição da assinatura.
total_sum	number	Valor total de compra. Todas as taxas estão incluídas.
total_sum_currency	string	Valor total da compra em moeda.
user_id	string	ID do usuário (v1).
user_country	string	País do usuário.
payment_instance_name	string	Nome do método de pagamento.

Os eventos são vinculados às páginas onde o usuário executa todas as ações ao comprar um item.

Estado	Descrição
cart	Página com o item selecionado comprado em moeda virtual e uma confirmação de compra.
coupon	Formulário de inserção de cupom.
giftcard	Página com a lista de cartões-presente (widget Cartões-presentes).
giftrecipient	Página de compra de presentes.
history	Página de histórico de compras.
index	Página de serviço, para a qual o usuário é redirecionado após abrir o aplicativo. Ela não é mostrada ao usuário.
legal	Versão móvel da página com links para documentos legais.
list	Lista de métodos de pagamento.
paybycash	Página com a lista de métodos de pagamento para compra através de quiosques de dinheiro (widget Pagar com dinheiro).
payment	Formulário de pagamento.
paymentaccount	Página com as contas de pagamento salvas.
paymentreturn	Página de serviço, para a qual o usuário é redirecionado após o pagamento ser feito, e a partir da qual o usuário é enviado para a página de status. Ela não é exibida ao usuário.
pincart	Página com a lista de plataformas de conteúdo digital.
pricepoint	Loja de moedas virtuais.
savedmethod	Lista de métodos de pagamento salvos.
shippingaddress	Formulário de endereço de entrega.
status	Página de status.
subscription	Loja de planos de assinatura.
subscriptionchange	Alteração do plano de assinatura.
useraccount	Página de informações da conta (nome de usuário, saldo) com a configuração Desativar tela de confirmação para as próximas compras de itens.
userinventory	Inventário do usuário.
usermenu	Versão móvel da página de menu do usuário.
usersubscription	Gerenciamento de assinaturas do usuário.
usersubscriptioninfo	Página de detalhes da assinatura.
virtualitem	Loja de itens virtuais.

Para enviar eventos para suas contas Google Analytics e Facebook Analytics, você precisa integrar essas plataformas de análise.

Obrigado pelo seu feedback!

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

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

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

Your browser is not supported. Please try a different browser

Artigos populares

Ou escolha as mais frequentes:

Resposta com base nas seguintes fontes:

Nos dê seu feedback (opcional)