Payments / Datos analíticos del evento

Datos analíticos del evento

Puede utilizar esta función si ya ha integrado Pay Station y ha configurado al menos una cuenta:

Aviso

Google Analytics y Facebook recopilan datos si un usuario dio permiso para usar todas las cookies o dio su consentimiento para usar cookies analíticas y de rendimiento en el banner del RGDP.

Integración con plataformas de análisis web

Para hacer un seguimiento de los eventos que se producen en la interfaz de pago cuando los usuarios interactúan con esta, conecte las plataformas de análisis web en su Cuenta del editor:

Google Analytics

Para conectar la plataforma de análisis:

  1. Abre tu proyecto en la Cuenta del editor.
  2. Accede a Pay Station > Settings.
  3. En la sección Apps, selecciona Google Analytics.
  4. Haz clic en Connect.

Al conectar Google Analytics, los eventos correspondientes se enviarán a tu cuenta de Google Analytics. Encontrarás estos eventos en Google Analytics en Behaviour > Events > Top Events.

Puede hacer un seguimiento de los siguientes eventos:

AcciónDescripción
open-{state_name}Abrir una página en la interfaz de pago.
click-btn-payPulsar el botón Pagar ahora del formulario de introducción de datos de facturación.
returnPulsar el botón Volver a almacenar/Empezar de nuevo.
create-invoiceCreación de transacciones.
purchaseCrear una factura (asignar un ID de transacción). Los parámetros del evento contienen información detallada sobre una compra, incluido el precio de los artículos y los impuestos. Consulte la documentación de Google Analytics para conocer la descripción de los parámetros.

El evento se envía solamente si configuró el catálogo en Cuenta del editor en la sección Store.
open-payment-credit-cardAbrir la interfaz de pago para introducir los datos de la tarjeta.
open-payment-saved-methodsAbrir la página con los métodos de pago guardados.
open-payment-payment-methodsAbrir la lista de todos los métodos de pago disponibles al hacer clic en más.
open-payment-{id}Abrir la página de un método de pago concreto, en el cual id es un ID de método de pago.
open-statusAbrir la página de un estado de pago.
open-status-processingAbrir una página con un estado de pago processing. Tras finalizar el procesamiento, el estado puede cambiar a success o error.
open-status-errorAbrir una página con un estado de pago de error.
open-status-successAbrir una página con un estado de pago de success.
choose-methodElegir un método de pago al abrir la lista más.
Dimensiones personalizadas para Google Analytics
ID de la dimensiónNombreDescripción
1versionVersion de Pay Station.
2purchase_invoice_idID de la factura de pago en el sistema de Xsolla.
3external_idID de la factura de pago en el sistema del socio.
5total_sumImporte total de la compra. Todos los gastos están incluidos.
6total_sum_currencyMoneda del importe total de la compra.
7pidID del sistema de pago.
8projectIdID del proyecto.
9countryPaís de pago.
10projectNameNombre del proyecto.

Facebook Analytics

Para conectar la plataforma de análisis:

  1. Abre tu proyecto en la Cuenta del editor.
  2. Accede a Pay Station > Settings.
  3. En la sección Apps, selecciona Facebook Pixel.
  4. Haz clic en Connect.

Al conectar Facebook Pixel, los eventos correspondientes se enviarán a tu cuenta de Facebook Analytics. Encontrarás estos eventos en Facebook Analytics en Business Settings > Measure & Report > Analytics > Pixels > Overview.

Puede hacer un seguimiento de los siguientes eventos:

EventoDescripción
open-{state_name}Abrir una página en la interfaz de pago. El nombre del estado se transmite en parameters.
click-btn-payPulsar el botón Pagar ahora del formulario de introducción de datos de facturación. El nombre del método de pago se transmite en parameters.
returnPulsar el botón Volver a almacenar/Empezar de nuevo. El nombre del estado se transmite en parameters.
change-status-{status_name}Cambio del estado del pago.
Si el usuario cierra la interfaz de pago o abandona la página y, luego, el estado cambia, no se envía el mensaje de evento.
create-invoiceCreación de transacciones.
open-payment-credit-cardAbrir la interfaz de pago para introducir los datos de la tarjeta.
open-payment-saved-methodsAbrir la página con los métodos de pago guardados.
open-payment-payment-methodsAbrir la lista de todos los métodos de pago disponibles al hacer clic en más.
open-payment-{id}Abrir la página de un método de pago concreto, en el cual id es un ID de método de pago.
open-statusAbrir la página de un estado de pago.
open-status-processingAbrir una página con un estado de pago processing. Tras finalizar el procesamiento, el estado puede cambiar a success o error.
open-status-errorAbrir una página con un estado de pago de error.
open-status-successAbrir una página con un estado de pago de success.
choose-methodElegir un método de pago al abrir la lista más.

Para integrar la plataforma de analítica:

  1. Vaya a su Cuenta del editor > Pay Station > Settings.
  2. Seleccione Google Analytics/Facebook Pixel en la sección Apps.
  3. Introduzca su ID de seguimiento y haga clic en Connect.

Al integrar Google Analytics y Facebook Pixel, los eventos correspondientes se enviarán a sus cuentas de Google Analytics y Facebook Analytics.

GameAnalytics

Para conectar la plataforma de análisis:
  1. Abra su proyecto en Cuenta del editor.
  2. Acceda a Pay Station > Settings.
  3. En la sección Apps, seleccione GameAnalytics.
  4. Haga clic en Connect.

  1. En el campo GameAnalytics game key, introduzca la clave del juego. Para encontrar esta información en su cuenta de GameAnalytics:
    1. En el menú desplegable del panel superior, seleccione el juego.
    2. En la secciónKeys, pulse en el icono de copia situado junto a la Game key.

Nota
Si su juego se publica en varias plataformas y hay proyectos específicos para cada una de ellas en GameAnalytics, puede ingresar una clave del juego para cualquiera de estas plataformas en Cuenta del editor.

  1. Haga clic en Connect.

En estos momentos, la integración con la plataforma GameAnalytics le confiere la capacidad para recibir información sobre los eventos de pago satisfactorios. Puede encontrar estos datos en su cuenta de GameAnalytics en el panel de control, en la sección Monetization.

Eventos de la interfaz de pago

Los eventos de la interfaz de pago se procesan mediante el mecanismo postMessage al abrir Pay Station en un iframe, en una nueva ventana o con Pay Station Embed.

Ejemplo de escenario para procesar mensajes enviados a través de postMessage:

  1. Suscríbase para recibir mensajes enviados a través de postMessage.
  2. Transforme los datos del evento al formato JSON.
  3. Implemente una verificación de la presencia del evento que debe procesarse.
  4. Cuando se reciba el evento requerido, implemente la aplicación lógica para procesarlo. En el siguiente ejemplo, el texto se envía a la consola. Puede añadir su propia aplicación lógica.

Ejemplo
Copy
Full screen
Small screen
    window.addEventListener('message', (event) => {
      const eventData = JSON.parse(event.data);
    
      if (eventData.command === 'open-payment') {
        console.log('hello!')
      }
    });
    
    EventoDescripción
    add_saved_accountUna cuenta de pago se guardó correctamente.
    add_saved_account_errorSe produce un error al guardar una cuenta de pago.
    cancel_save_accountCancelación del guardado de una cuenta de pago por parte de un usuario.
    cart_displayVisualización de la interfaz de pago como columnas. El parámetro value puede ser:
    • 1 si la interfaz de pago se abre como dos columnas
    • 0 si la interfaz de pago se abre como una columna; p. ej., en la página donde se administran los métodos de pago guardados
    Ejemplo: {“command”:“cart_display”,“datos”:{“value”:“1”,“version”:“Pay Station 4”}}.
    change-statusCambio del estado del pago. Si el usuario cierra la interfaz de pago o abandona la página y, luego, el estado cambia, no se envía el mensaje de evento.
    choose-methodElegir un método de pago al abrir la lista más.
    click-custom-package-continuePulsar el botón Continuar al comprar una cantidad arbitraria de moneda virtual.
    click-commentPulsar el botón para publicar un comentario.
    click-buy-packagePulsar el botón Comprar paquete al comprar un paquete de moneda virtual.
    click-buy-gift-packagePulsar el botón al comprar un paquete de moneda virtual como regalo.
    click-buy-gift-custom-packagePulsar el botón al comprar una cantidad arbitraria de moneda virtual como regalo.
    click-btn-payPulsar el botón Pagar ahora del formulario de introducción de datos de facturación.
    click-btn-continuePulsar el botón para comprar la suscripción.
    click-btn-applyPulsar el botón Aplicar al canjear un cupón.
    click-btn-activatePulsar el botón Activar cuando se activa una clave del juego.
    click-btn-acceptPulsar el botón para comprar contenidos digitales.
    create-invoiceCreación de transacciones.
    dimensionsCuando Pay Station se abre en el iframe, la anchura y la altura del iframe se transmiten en los parámetros width y height.
    errorUn error que se produce durante el proceso de pago. El código de error se transmite en el parámetro data.code, y la descripción del error en la interfaz de pago se transmite en el parámetro data.message.
    external-link-openRedireccionamiento a un recurso externo. La dirección a la que se ha producido el redireccionamiento se transmite en el parámetro url.
    external-payment-openRedireccionamiento desde la interfaz de pago a un sistema de pago externo o a verificación 3-D Secure.
    focus-changeCambiar el foco de los elementos del widget de Pay Station. El estado del foco se transmite en el parámetro hasFocus y puede ser true o false.
    open-{state_name}Abrir una página en la interfaz de pago.
    open-payment-credit-cardAbrir la interfaz de pago para introducir los datos de la tarjeta.
    open-payment-saved-methodsAbrir la página con los métodos de pago guardados.
    open-payment-payment-methodsAbrir la lista de todos los métodos de pago disponibles al hacer clic en más.
    open-payment-{id}Abrir la página de un método de pago concreto, en el cual id es un ID de método de pago.
    open-statusAbrir la página de un estado de pago.
    open-status-processingAbrir una página con un estado de pago processing. Tras finalizar el procesamiento, el estado puede cambiar a success o error.
    open-status-errorAbrir una página con un estado de pago de error.
    open-status-successAbrir una página con un estado de pago de success.
    order-statusCambiar el estado del pedido a done. El evento se envía desde la página de estado del pago si se creó un pedido a través de una de las siguientes llamadas API:
    Los datos sobre el usuario, la transacción y el pedido se transmiten en el objeto data.

    Ejemplo: {“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”}}.
    resizeCambiar el tamaño de la interfaz de pago. La anchura y la altura de la interfaz de pago abierta se transmiten en el objeto data.
    Ejemplo: {“command”:“resize”,“datos”:{“dimensions”:{“width”:924,“height”:754},“version”:“Pay Station 4”}}.
    show-error-pageAbrir una página con un error. Se transmite un código de error en el parámetro value.
    statusIr a la página de estado del pago. Se pueden transmitir los siguientes parámetros:
    • status - estado del pago
    • email - correo electrónico del usuario
    • invoice - ID de la transacción
    • virtualCurrencyAmount - la cantidad de moneda virtual comprada
    • userId - ID de usuario
    • discount - el descuento aplicado al pago
    status-redeemEl canje del cupón en una forma de pago.
    closeCerrar la interfaz de pago.
    Los parámetros del evento se transmiten en cada mensaje de postMessage. Si aún no se ha compilado la información de los parámetros, se muestra una cadena vacía.
    ParámetroTipoDescripción
    actionstringNombre del evento.
    valuestringParámetro adicional. Contiene parámetros específicos del evento que varían en función de las preferencias del usuario.
    statestringLa página de la interfaz de pago en la que se ha realizado la acción.
    datestringFecha y hora en formato GMT.
    millisecondsnumberFecha y hora en formato Unix.
    timezonestringZona horaria del usuario.
    session_idstringID de sesión. La sesión incluye todas las acciones realizadas por el usuario en un periodo de 30 minutos o hasta que se cierra la interfaz de pago. La sesión comienza en el momento en que se abre la interfaz de pago y se guarda cuando se actualiza la página con la interfaz de pago.
    payment_countrystringPaís de pago.
    purchase_invoice_idnumberID de la factura de pago en el sistema de Xsolla.
    purchase_external_idstringID de la factura de pago en el sistema del socio.
    purchase_typestringTipo de compra. Puede ser: virtual item, virtual currency, pay2play o subscription.
    purchase_sumnumberImporte nominal de la compra.
    purchase_currencystringMoneda de compra.
    purchase_skustringSKU del artículo comprado.
    purchase_digital_content_skustringSKU del paquete de claves del juego adquirido.
    purchase_descriptionstringDescripción de la compra.
    virtual_currency_amountnumberImporte en moneda virtual.
    coupon_codestringCódigo del cupón.
    subscription_package_external_idnumberID de suscripción.
    subscription_package_namestringNombre de la suscripción.
    subscription_package_descriptionstringDescripción de la suscripción.
    total_sumnumberImporte total de la compra. Todos los gastos están incluidos.
    total_sum_currencystringMoneda del importe total de la compra.
    user_idstringID del usuario (v1).
    user_countrystringPaís del usuario.
    payment_instance_namestringNombre del método de pago.
    Los eventos están vinculados a las páginas en las que el usuario realiza todas las acciones al comprar un artículo.
    EstadoDescripción
    cartPágina con el artículo seleccionado comprado en moneda virtual y una confirmación de compra.
    couponFormulario de introducción del cupón.
    giftcardPágina con la lista de tarjetas regalo (widget Tarjetas regalo).
    giftrecipientPágina de compra de regalos.
    historyPágina del historial de compras.
    indexPágina de servicio a la que se redirige al usuario tras abrir la aplicación. No se muestra al usuario.
    legalVersión móvil de la página con enlaces a documentos legales.
    listLista de métodos de pago.
    paybycashPágina con la lista de métodos de pago para comprar mediante quioscos de efectivo (widget Pagar con efectivo).
    paymentForma de pago.
    paymentaccountPágina con las cuentas de pago guardadas.
    paymentreturnPágina de servicio, a la que se redirige al usuario una vez efectuado el pago, y desde la que se envía al usuario a la página de estado. No se muestra al usuario.
    pincartPágina con la lista de plataformas de contenido digital.
    pricepointTienda de moneda virtual.
    savedmethodLista de métodos de pago.
    shippingaddressFormulario de dirección de entrega.
    statusPágina de estado.
    subscriptionTienda de planes de suscripción.
    subscriptionchangeCambio de plan de suscripción.
    useraccountPágina de información de la cuenta (nombre de usuario, saldo) con el ajuste Disable confirmation screen for future item purchases.
    userinventoryInventario de usuarios.
    usermenuVersión móvil de la página del menú de usuario.
    usersubscriptionGestión de suscripciones del usuario.
    usersubscriptioninfoPágina de detalles de la suscripción.
    virtualitemTienda de artículos virtuales.

    Para enviar eventos a sus cuentas de Google Analytics y Facebook Analytics, necesita integrar estas plataformas de análisis web estadístico.
    ¿Te ha resultado útil este artículo?
    ¡Gracias!
    ¿Hay algo en lo que podamos mejorar? Mensaje
    Lo sentimos
    Por favor, cuéntanos por qué no te ha resultado útil este artículo. Mensaje
    ¡Gracias por tu mensaje!
    Nos ayudará a mejorar tu experiencia.
    Última actualización: 3 de Octubre de 2024

    ¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.

    Informar de un problema
    Nos esforzamos por ofrecer contenido de calidad. Tus comentarios nos ayudan a mejorar.
    Déjanos tu correo electrónico para que te podamos responder
    ¡Gracias por tu mensaje!