Cómo establecer el programa con la etiqueta de creador

Cómo funciona

La etiqueta de creador es un código único que un jugador puede recibir al ver transmisiones en YouTube o Twitch o en otros formatos/servicios. Un jugador (seguidor) puede utilizar esta etiqueta durante las compras en el juego para apoyar a su persona influyente favorito. La solución le permite generar confianza y relaciones con las personas influyentes y aumentar sus ingresos mediante la atribución (seguimiento) de todas las compras dentro del juego.

Flujo del jugador

  1. El jugador copia la etiqueta de creador o sigue el enlace para conectarlo desde el servicio donde la persona influyente compartió su código. Una persona influyente puede utilizar los siguientes servicios:
    • Twitch
    • YouTube
    • Facebook Gaming
    • otras redes sociales
  2. El jugador introduce la etiqueta de creador en el campo de la página donde implementó su conexión. Si el jugador pulsa en el enlace, la etiqueta de creador se aplica automáticamente.

Monetización

Obtiene ingresos de todas las compras dentro del juego. De cada compra se deduce una parte del beneficio de la persona influyente, cuya etiqueta de creador se aplicó al realizar la compra.

Nota
La plataforma de juego y el sistema de pago pueden cobrar una comisión adicional por los pagos.

¿Quién puede utilizarlo?

Socios que tienen un juego con:

  • unos ingresos mensuales previstos de al menos 20 000 $
  • productos disponibles para la compra solamente dentro del juego

Cómo conseguirlo

Establecer el programa con la etiqueta de creador

Para establecer un programa con una etiqueta de creador:

  1. Envíe una solicitud a csm@xsolla.com (o a bizdev@xsolla.com, si es la primera vez que integra un producto de Xsolla) y espere a su presentación. Especifique la siguiente información en la solicitud:
    • Nombre del juego.
    • Género.
    • Desarrollador (opcional).
    • Editor (opcional).
    • Sitio oficial del juego.
    • Descripción del juego.
    • ID de la app de Steam (opcional).
    • Fecha de lanzamiento, si el juego aún no se ha publicado (opcional).
    • Enlace al material promocional (opcional).
    • Modelo de negocio:
      • prémium
      • free-to-play
    • Plataforma de juego:
      • PC
      • Steam
      • móvil
      • web
    • Periodo de participación en el programa.
    • Porcentaje de reparto de ganancias.
    • Fin del reparto de ganancias. El día en que las personas influyentes participantes dejan de recibir porcentaje de ganacias.
    • Lista de personas influyentes. Para cada persona influyente, especifique su correo electrónico, canal de red social y etiqueta de creador. Tenga en cuenta las siguientes limitaciones a la hora de elegir personas influyentes:
      • La retirada de fondos del saldo solo está disponible para personas influyentes mayores de 18 años.
      • Xsolla no trabaja con personas influyentes cuyas cuentas bancarias estén registradas en países sujetos a sanciones por parte de EE. UU.

  1. Implemente el mecanismo de conexión de la etiqueta de creador por parte del jugador de una de las siguientes formas:
    • Pulsando en el enlace. En este caso, el valor de la etiqueta de creador se cargará automáticamente en el campo de entrada específico.
    • Mediante entrada manual.

  1. Determine dónde estará la página con la etiqueta de creador:
    • en la interfaz del juego
    • en el sitio web de publicidad del juego
    • en la interfaz de pago cada vez que el jugador abone una compra.
Nota
Se recomienda implementar la conexión de la etiqueta de creador en la interfaz del juego para que el código se aplique automáticamente a la compra de cada jugador.
  1. Envíe a csm@xsolla.com un enlace a la página en la que está conectada la etiqueta de creador (si el mecanismo está implementado en la interfaz o en el sitio web del juego).
  2. En el juego, implemente mecanismos para vincular la etiqueta de creador a las compras de los seguidores y para hacer un seguimiento de estas compras.

Gestionar programa con etiqueta de creador

Para gestionar eficazmente un programa con etiqueta de creador:
  1. Envíe regularmente sus compras a Xsolla utilizando el método Creating transaction. La frecuencia recomendada para transmitir estos datos es de una vez al día.
Nota
En el caso de un reembolso por una compra que tenga la etiqueta de creador aplicada, transmita esta información a Xsolla usando el método Canceling transactions.
  1. Añadir nuevas personas influyentes al programa (opcional).
Nota
Si añade personas influyentes a través de Xsolla, suba regularmente su lista utilizando el método Getting influencers with Creator tag. La frecuencia recomendada de obtención de datos es de una vez al día.
  1. Utilizando el método Sending statistics by Creator tag, transfiera a Xsolla la información sobre las estadísticas de los seguidores (opcional).

Añadir personas influyentes al programa

Puede añadir personas influyentes a su programa de una de las siguientes maneras:

Autoañadir

Para añadir personas influyentes a su programa por sus medios:
  1. Llame a los métodos Creating Creator tag for influencer y Adding influencer to program secuencialmente.
  2. Para invitar a una persona influyente al programa, envíe un mensaje a influencer@xsolla.com con el correo electrónico, el canal de red social y la etiqueta de creador de la persona influyente utilizada en el método Creating Creator tag for influencer.

Añadir mediante Xsolla

Para añadir una persona influyente al programa a través de Xsolla, envíe un mensaje a influencer@xsolla.com y especifique el correo electrónico, el canal de la red social y la etiqueta de creador que desea asignar a la persona influyente.

Métodos API para trabajar con la etiqueta de creador

Conseguir personas influyentes con la etiqueta de creador

Obtener una lista de las personas influyentes del programa que tienen etiquetas de creador.
ParámetroTipoDescripción
limit
integerNúmero de personas influyentes en la lista (por defecto: 20, máximo: 100).
offset
integerValor del desplazamiento que se produce al cargar personas influyentes en la lista (por defecto: 0).
Copy
Full screen
Small screen
GET https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals?limit=3&offset=0 HTTP/1.1

Crear transacciones

Crear/actualizar transacciones a las que se ha aplicado la etiqueta de creador. En el cuerpo de la solicitud se transmite una matriz de los siguientes objetos:
ParámetroTipoDescripción
creator_tag
stringCódigo único de la persona influyente en el programa. Obligatorio.
transaction_id
stringID de transacción. Obligatorio.
transaction_currency
stringCódigo de la moneda en la que se realizó la transacción. Código de moneda de tres letras según la norma ISO 4217. Obligatorio.
transaction_value
numberImporte de la transacción. Obligatorio.
transaction_date
stringFecha de la transacción en el formato YYYY-MM-DD’T’HH:MM:SS. Obligatorio.
platform_id
stringPlataforma en la que se realizó la transacción. Obligatorio.
user_id
stringID del jugador. Obligatorio.
item_id
stringID del artículo comprado. Obligatorio.
item_name
stringNombre del artículo comprado. Obligatorio.
Copy
Full screen
Small screen
PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

[
  {
    "transaction_id": "123456789",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "user_id": "0123456",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 5
  },
  {
    "transaction_id": "123456788",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_2",
    "item_name": "hk416",
    "transaction_currency_code": "EUR",
    "transaction_value": 10
  },
  {
    "transaction_id": "123456781",
    "creator_tag": "creatorOne",
    "platform_id": "xbox",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 3
  }
]

Anular transacciones

Cancela las transacciones a las que se aplicó la etiqueta de creador. Se transmite una matriz de los siguientes objetos en el cuerpo de la solicitud:
ParámetroTipoDescripción
transaction_id
stringID de la transacción que va a cancelarse. Obligatorio.
refund_id
stringID externo del reembolso del pago.
reason
stringMotivo del reembolso.
refund_date
stringFecha del reembolso en el formato YYYY-MM-DD’T’HH:MM:SS. Obligatorio.
Copy
Full screen
Small screen
PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

[
  {
    "transaction_id": "123456789",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "user_id": "0123456",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 5
  },
  {
    "transaction_id": "123456788",
    "creator_tag": "creatorOne",
    "platform_id": "steam",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_2",
    "item_name": "hk416",
    "transaction_currency_code": "EUR",
    "transaction_value": 10
  },
  {
    "transaction_id": "123456781",
    "creator_tag": "creatorOne",
    "platform_id": "xbox",
    "transaction_date": "2020-04-10T06:06:24.830Z",
    "item_id": "GAME_sku_1",
    "item_name": "hk416",
    "transaction_currency_code": "USD",
    "transaction_value": 3
  }
]

Enviar estadísticas por etiqueta de creador

Permitir el envío de estadísticas sobre la conexión de la etiqueta de creador de la persona influyente (por días). Esta información se publicará en la sección Statistics de Cuenta de la persona influyente. En el cuerpo de la solicitud se transmite una matriz de los siguientes objetos:
ParámetroTipoDescripción
date
stringFecha de transmisión de las estadísticas del creador en el formato YYYY-MM-DD. Obligatorio.
creator_tag
stringCódigo único de la persona influyente en el programa. Obligatorio.
new_supporters
integerNúmero de nuevos jugadores que han utilizado la etiqueta de creador de la persona influyente. Obligatorio.
total_supporters
integerNúmero de todos los jugadores que han utilizado la etiqueta de creador de la la persona influyente. Obligatorio.
Copy
Full screen
Small screen
PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/supporters HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

[
  {
    "date": "2020-04-10",
    "creator_tag": "creatorOne",
    "new_supporters": 125,
    "total_supporters": 35900
  },
  {
    "date": "2020-04-10",
    "creator_tag": "creatorTwo",
    "new_supporters": 123,
    "total_supporters": 34567
  }
]

Crear etiqueta de creador para una persona influyente

Permitir la creación de etiquetas de creador para nuevas personas influyentes en el programa. En el cuerpo de la solicitud se transmite una matriz de los siguientes objetos:
ParámetroTipoDescripción
creator_tag
stringCódigo único de la persona influyente en el programa. Obligatorio.
creator_email
stringCorreo electrónico de la persona influyente. Obligatorio.
creator_channels
array of stringsEnlace al canal de la persona influyente en la red social. Puede haber varios canales. Obligatorio.
Copy
Full screen
Small screen
PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

{
  "creator_tag": "creatorOne",
  "creator_email": "influencer@example.com",
  "creator_channels": [
    "https://www.twitch.tv/creatorOne"
  ]
}

Añadir una persona influyente al programa

Permite añadir una nueva persona influyente al programa. Se transmite una matriz de los siguientes objetos en el cuerpo de la solicitud:
ParámetroTipoDescripción
creator_tag
stringCódigo único de la persona influyente en el programa. Obligatorio.
revenue_share
integerPorcentaje de los beneficios que obtiene la persona influyente por cada compra a la que se ha aplicado su etiqueta de creador. Obligatorio.
Copy
Full screen
Small screen
PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1

X-API-key: 7890ZYXWVUTSRQPONMLKJIHG
Content-Type: application/json

{
  "creator_tag": "creatorOne",
  "creator_email": "influencer@example.com",
  "creator_channels": [
    "https://www.twitch.tv/creatorOne"
  ]
}
¿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: 22 de Enero 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!