Análise de eventos

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

Aviso

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

Para conectar a plataforma de análises:

  1. Abra seu projeto na Conta de Distribuidor.
  2. Vá para Pay Station > Configurações.
  3. Na seção Aplicativos, escolha Google Analytics.
  4. 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çãoDescrição
open-{state_name}Abertura de uma página na interface de pagamento.
click-btn-payClicando no botão Pagar agora no formulário de dados de cobrança.
returnClicando no botão Retornar à Loja/Iniciar novamente.
create-invoiceCriação de transações.
purchaseCriando 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-cardAbrindo a interface de pagamento para inserir os detalhes do cartão.
open-payment-saved-methodsAbrindo a página com os métodos de pagamento salvos.
open-payment-payment-methodsAbrindo 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-statusAbrindo a página de um status de pagamento.
open-status-processingAbrindo 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-errorAbrindo uma página com um status de pagamento error.
open-status-successAbrindo uma página com um status de pagamento success.
choose-methodEscolha um método de pagamento ao abrir a lista mais.
Dimensões personalizadas para o Google Analytics
ID DimensionNomeDescrição
1versionVersão do Pay Station.
2purchase_invoice_idID da fatura de pagamento no sistema Xsolla.
3external_idID da fatura de pagamento no sistema do parceiro.
5total_sumValor total de compra. Todas as taxas estão incluídas.
6total_sum_currencyValor total da compra em moeda.
7pidID do sistema de pagamento.
8projectIdID do projeto.
9countryPaís de pagamento.
10projectNameNome do projeto.

Facebook Analytics

Para conectar a plataforma de análises:

  1. Abra seu projeto na Conta de Distribuidor.
  2. Vá para Pay Station > Configurações.
  3. Na seção Aplicativos, escolha Facebook Pixel.
  4. 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:

EventoDescrição
open-{state_name}Abrindo uma página na interface de pagamento. O nome do estado é passado em parameters.
click-btn-payClicando no botão Pagar agora no formulário de dados de cobrança. O nome do método de pagamento é passado em parameters.
returnClicando 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-invoiceCriação de transações.
open-payment-credit-cardAbrindo a interface de pagamento para inserir os detalhes do cartão.
open-payment-saved-methodsAbrindo a página com os métodos de pagamento salvos.
open-payment-payment-methodsAbrindo 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-statusAbrindo a página de um status de pagamento.
open-status-processingAbrindo 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-errorAbrindo uma página com um status de pagamento error.
open-status-successAbrindo uma página com um status de pagamento success.
choose-methodEscolha um método de pagamento ao abrir a lista mais.

Para integrar a plataforma de análise:

  1. Vá para sua Conta de Distribuidor > Pay Station > Settings.
  2. Selecione Google Analytics/Facebook Pixel na seção Apps.
  3. 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:
  1. Abra seu projeto na Conta de Distribuidor.
  2. Vá para Pay Station > Configurações.
  3. Na seção Aplicativos, escolha GameAnalytics.
  4. Clique em Conectar.

  1. 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.

Observação
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.

  1. 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:

  1. Cadastre-se para receber mensagens enviadas via postMessage.
  2. Analise os dados do evento em um formato JSON.
  3. Implemente uma verificação da presença do evento que precisa ser processado.
  4. 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!')
      }
    });
    
    EventoDescrição
    add_saved_accountSalvamento bem-sucedido de uma conta de pagamento.
    add_saved_account_errorErro ao salvar uma conta de pagamento.
    cancel_save_accountCancelamento do salvamento de uma conta de pagamento pelo usuário.
    cart_displayExibiçã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-statusAlterando 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-methodEscolha um método de pagamento ao abrir a lista mais.
    click-custom-package-continueClicando no botão Continuar ao comprar uma quantidade arbitrária de moedas virtuais.
    click-commentClicando no botão para publicar um comentário.
    click-buy-packageClicando no botão Comprar pacote ao comprar um pacote de moedas virtuais.
    click-buy-gift-packageClicando no botão ao comprar um pacote de moedas virtuais como presente.
    click-buy-gift-custom-packageClicando no botão ao comprar uma quantidade arbitrária de moedas virtuais como presente.
    click-btn-payClicando no botão Pagar agora no formulário de dados de cobrança.
    click-btn-continueClicando no botão para comprar a assinatura.
    click-btn-applyClicando no botão Aplicar ao resgatar um cupom.
    click-btn-activateClicando no botão Ativar ao ativar uma chave de jogo.
    click-btn-acceptClicando no botão para comprar conteúdos digitais.
    create-invoiceCriação de transações.
    dimensionsQuando o Pay Station é aberto no iframe, a largura e a altura do iframe são passadas nos parâmetros width e height.
    errorUm 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-openRedirecionamento para um recurso externo. O endereço para o qual o redirecionamento ocorreu é passado no parâmetro url.
    external-payment-openRedirecionamento da interface de pagamento para um sistema de pagamento externo ou verificação 3-D Secure.
    focus-changeAlteraçã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-cardAbrindo a interface de pagamento para inserir os detalhes do cartão.
    open-payment-saved-methodsAbrindo a página com os métodos de pagamento salvos.
    open-payment-payment-methodsAbrindo 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-statusAbrindo a página de um status de pagamento.
    open-status-processingAbrindo 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-errorAbrindo uma página com um status de pagamento error.
    open-status-successAbrindo uma página com um status de pagamento success.
    order-statusAlterando 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:
    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”}}.
    resizeAlteraçã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-pageAbrindo uma página com um erro. Um código de erro é passado no parâmetro value.
    statusIndo 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-redeemO resgate do cupom em um formulário de pagamento.
    closeFechando 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âmetroTipoDescrição
    actionstringNome do evento.
    valuestringParâmetro adicional. Contém parâmetros de evento específicos que variam dependendo da escolha do usuário.
    statestringA página da interface de pagamento, na qual a ação foi executada.
    datestringData e hora no fuso horário GMT.
    millisecondsnumberData e horário no formato Unix.
    timezonestringFuso horário do usuário.
    session_idstringID 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_countrystringPaís de pagamento.
    purchase_invoice_idnumberID da fatura de pagamento no sistema Xsolla.
    purchase_external_idstringID da fatura de pagamento no sistema do parceiro.
    purchase_typestringTipo de compra. Pode ser: virtual item, virtual currency, pay2play, subscription.
    purchase_sumnumberValor nominal de compra.
    purchase_currencystringMoeda de compra.
    purchase_skustringSKU do item comprado.
    purchase_digital_content_skustringSKU do pacote de chaves de jogo comprado.
    purchase_descriptionstringDescrição da compra.
    virtual_currency_amountnumberQuantia da moeda virtual.
    coupon_codestringCódigo do cupom.
    subscription_package_external_idnumberID da assinatura.
    subscription_package_namestringNome da assinatura.
    subscription_package_descriptionstringDescrição da assinatura.
    total_sumnumberValor total de compra. Todas as taxas estão incluídas.
    total_sum_currencystringValor total da compra em moeda.
    user_idstringID do usuário (v1).
    user_countrystringPaís do usuário.
    payment_instance_namestringNome 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.
    EstadoDescrição
    cartPágina com o item selecionado comprado em moeda virtual e uma confirmação de compra.
    couponFormulário de inserção de cupom.
    giftcardPágina com a lista de cartões-presente (widget Cartões-presentes).
    giftrecipientPágina de compra de presentes.
    historyPágina de histórico de compras.
    indexPágina de serviço, para a qual o usuário é redirecionado após abrir o aplicativo. Ela não é mostrada ao usuário.
    legalVersão móvel da página com links para documentos legais.
    listLista de métodos de pagamento.
    paybycashPágina com a lista de métodos de pagamento para compra através de quiosques de dinheiro (widget Pagar com dinheiro).
    paymentFormulário de pagamento.
    paymentaccountPágina com as contas de pagamento salvas.
    paymentreturnPá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.
    pincartPágina com a lista de plataformas de conteúdo digital.
    pricepointLoja de moedas virtuais.
    savedmethodLista de métodos de pagamento salvos.
    shippingaddressFormulário de endereço de entrega.
    statusPágina de status.
    subscriptionLoja de planos de assinatura.
    subscriptionchangeAlteração do plano de assinatura.
    useraccountPá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.
    userinventoryInventário do usuário.
    usermenuVersão móvel da página de menu do usuário.
    usersubscriptionGerenciamento de assinaturas do usuário.
    usersubscriptioninfoPágina de detalhes da assinatura.
    virtualitemLoja de itens virtuais.

    Para enviar eventos para suas contas Google Analytics e Facebook Analytics, você precisa integrar essas plataformas de análise.
    Este artigo foi útil?
    Obrigado!
    Podemos melhorar alguma coisa? Mensagem
    Que pena ouvir isso
    Explique porque este artigo não foi útil para você. Mensagem
    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.

    Relatar um problema
    Nós sempre avaliamos nossos conteúdos. Seu feedback nos ajuda a melhorá-los.
    Forneça um e-mail para que possamos responder
    Obrigado pelo seu feedback!