Cómo configurar la medición para Steam Games
Esta guía describe el proceso para configurar una aplicación de juego de Steam, establecer una conexión segura con la API de servidor a servidor (S2S) y administrar de manera efectiva los links a fin de realizar una medición exitosa de la atribución. Los usuarios pueden descargar tu juego en la tienda de Steam o en tu tienda personalizada, tanto en Windows como en Mac.
Esto es lo que debes hacer a fin de configurar la medición para los juegos de Steam:
- Configurar una nueva aplicación en AppView.
- Configurar la API S2S de Adjust para empezar a registrar las sesiones.
- Configurar links en Campaign Lab.
Cómo configurar tu aplicación de Steam
Para comenzar a agregar y configurar una aplicación de PC, sigue estos pasos:
En la sección AppView , selecciona Todas las aplicaciones.
Selecciona NUEVA APLICACIÓN .
En la sección Escribe los detalles de la aplicación , escribe el nombre de la aplicación, elige la moneda de los informes y revisa si tu juego debe cumplir con lo siguiente:
- Requerimientos de la COPPA. Aplica únicamente para las empresas basadas en EE. UU. Obtén más información acerca del cumplimiento con la COPPA aquí.
- Cumplimiento con la DMA por parte de Google. Para las aplicaciones que tienen una base de usuarios ubicados exclusivamente fuera del Espacio Económico Europeo (EEE). Puedes obtener más información sobre el cumplimiento con la DMA por parte de Google aquí.
Selecciona Agregar aplicación .
Selecciona Agregar plataforma para conectar tu juego con una plataforma.
- Selecciona PC > Steam. Funciona para las tiendas de Steam en Windows y Mac.
- Escribe el ID de la aplicación o selecciona Aún no tengo un ID de la aplicación para introducirlo después.
- (Opcional) Activa la opción Redirigir todos los clics hacia una URL personalizada y escribe una URL personalizada si deseas dirigir a tus usuarios hacia un sitio web personalizado en lugar de hacia la tienda de aplicaciones de Steam. Te recomendamos hacer esto si tu aplicación no tiene un ID de la aplicación.
- Haz clic en Guardar.
En la pestaña Eventos , agrega el nombre de un evento in-app para medir la actividad de los usuarios en tu juego.
En la pestaña Configuración de atribución , elige la configuración de la atribución (para el matching de dispositivos, el modelado probabilístico y la atribución temporal) y la configuración de la reatribución.
- Asegúrate de que el modelado probabilístico esté habilitado para los clics y las impresiones. Lo más recomendable es configurar una ventana de atribución de 24 horas para el modelado probabilístico, pero puedes configurarla con un valor de hasta 90 días. La ventana de atribución de 90 días únicamente está disponible para las plataformas de PC y consolas.
En la pestaña Administración de datos , configura callbacks de servidor o cargas al almacenamiento en la nube para recibir datos sin procesar a nivel de usuario, o utiliza la consola de testeo para ver los datos del dispositivo de testeo.
En la pestaña Protección , configura la seguridad S2S, ya que necesitarás el token en la configuración de la API S2S.
Cómo configurar la API S2S de Adjust
Utiliza la API S2S de Adjust para conectar tu aplicación con Adjust y empezar a medir las sesiones y los eventos de tus usuarios sin tener que cambiar el código de tu aplicación.
Continúa con el proceso de configuración al utilizar el siguiente extremo session
.
Antes de comenzar
Nuestro servidor aplica revisiones de consistencia estrictas para evitar abusos o sobrecargas del sistema. La atribución S2S es una integración exclusiva que no se puede utilizar en conjunto con el SDK de Adjust.
- Asegúrate de leer nuestra lista de verificación para la atribución S2S a fin de entender claramente las limitaciones que implica el uso de una configuración S2S en lugar de una integración de SDK.
- Debes enviar tus solicitudes a nuestros servidores en el mismo orden en que se presenten en el dispositivo.
Autenticación
Configura la seguridad S2S para garantizar la seguridad de tus sesiones S2S y protegerte contra las solicitudes falsificadas. Para hacer esto, todas las solicitudes entrantes deberán incluir un token de autenticación generado en tu Dashboard de Adjust. Nuestro servidor rechazará todas las solicitudes que no incluyan el token o que incluyan un token incorrecto.
Extremo
El endpoint session
te permite registrar las sesiones cuando los usuarios abren tu juego. La sesión se activa cuando un usuario abre el juego (por ejemplo, después de haberlo cerrado anteriormente) o cuando continúa jugando después de haberlo tenido en segundo plano (por ejemplo, si abre otra aplicación mientras el juego se mantiene en ejecución y luego regresa al juego). Nuestro servidor acepta las nuevas sesiones cada 30 minutos para evitar el uso innecesario de recursos.
https://s2s.adjust.com/session
Encabezado de POST
Autorización : cuando realices llamadas a las API de Adjust, envía el valor de tu token de autorización de Adjust con el tipo de autenticación establecido como Bearer.
Ejemplo: Bearer authentication_token
.
Carga útil de POST
Los parámetros marcados con ***** son obligatorios.
Parámetro | Tipo de datos | en | Descripción |
---|---|---|---|
s2s * | cadena | Consulta | Parámetro de servidor a servidor: permite que los servidores de Adjust reconozcan la actividad del lado del servidor. Siempre se debe enviar como "1". |
app_token * | cadena | Consulta | Token de autenticación único de tu aplicación |
os_name * | cadena | Consulta | Utiliza uno de los parámetros disponibles según el sistema operativo de tu aplicación:
|
ip_address * | cadena | Consulta | Dirección IP del dispositivo |
created_at * | Marca de tiempo | Consulta | Marca de tiempo de la creación del paquete en el dispositivo local, incluida la zona horaria. |
external_device_id * | cadena | Consulta | user_id único, por ejemplo: el account_id del usuario o la dirección de correo electrónico cifrada |
Puedes utilizar el parámetro external_device_id
para enviar el steam_id
del usuario hacia nuestro sistema.
Ejemplo de solicitud
Si deseas aprender cómo registrar los eventos con la API S2S, consulta el artículo sobre eventos de servidor a servidor (S2S).
Cómo configurar links
Después de configurar y testear la integración de la API S2S entre el servidor de tu aplicación y Adjust, debes conectar Adjust con la red de publicidad con la que ejecutes tu campaña.
Con el uso de links, puedes registrar la atribución cuando los usuarios interactúan con tu anuncio en otros dispositivos, por ejemplo, si ven un anuncio en su teléfono móvil o en CTV y luego instalan el juego en su PC. Estos son dos ejemplos de redes para las campañas web:
Sigue los pasos descritos a continuación en Campaign Lab.
En la sección Campaign Lab , selecciona Socios.
Selecciona Nuevo socio.
En la pantalla Selección de socios , elige la red de publicidad que desees configurar.
En la pantalla Selección de aplicación , elige la aplicación para la que desees crear el link.
(Opcional) En la pantalla Uso compartido de datos , configura la integración entre tu red y Adjust y elige las opciones de envío de datos.
En la pantalla Estructura del link , revisa los parámetros de estructura de links predeterminados proporcionados por la red y actualiza los valores si es necesario.
(Opcional) En la pantalla Destinos de usuarios , configura un deep link, o agrega un redirect y una alternativa (fallback) a tu link.
- Si deseas redirigir a los usuarios hacia una tienda de juegos en particular, asegúrate de incluir la URL como parámetro de redirect adicional.
(Opcional) En la pantalla Configuración de atribución , configura la atribución personalizada para los usuarios nuevos y existentes. Esta configuración de atribución está disponible para los clics y las impresiones. Si omites este paso, se aplicará la configuración de atribución que hayas elegido al configurar la aplicación.
- Asegúrate de que el modelado probabilístico esté habilitado para los clics y las impresiones. Lo más recomendable es configurar una ventana de atribución de 24 horas para el modelado probabilístico, pero puedes configurarla con un valor de hasta 90 días. La ventana de atribución de 90 días únicamente está disponible para las plataformas de PC y consolas.
En la pantalla Revisión de la configuración , revisa tus opciones y haz cualquier cambio necesario.
Selecciona Crear link para generar la URL del link, la URL de impresión, el código QR y el token del link, y para habilitar el uso compartido de datos, si esta configurado.