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
- 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
- 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.
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:
- 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:
- Plataforma de juego:
- 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.
- 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.
- 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.
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.
- 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).
- 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:
- 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.
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.
- Añadir nuevas personas influyentes al programa (opcional).
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.
- 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:
- Llame a los métodos Creating Creator tag for influencer y Adding influencer to program secuencialmente.
- 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ámetro | Tipo | Descripción |
---|
limit | integer | Número de personas influyentes en la lista (por defecto: 20 , máximo: 100 ). |
offset | integer | Valor del desplazamiento que se produce al cargar personas influyentes en la lista (por defecto: 0 ). |
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ámetro | Tipo | Descripción |
---|
creator_tag | string | Código único de la persona influyente en el programa. Obligatorio. |
transaction_id | string | ID de transacción. Obligatorio. |
transaction_currency | string | Có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 | number | Importe de la transacción. Obligatorio. |
transaction_date | string | Fecha de la transacción en el formato YYYY-MM-DD’T’HH:MM:SS . Obligatorio. |
| string | Plataforma en la que se realizó la transacción. Obligatorio. |
user_id | string | ID del jugador. Obligatorio. |
item_id | string | ID del artículo comprado. Obligatorio. |
item_name | string | Nombre del artículo comprado. Obligatorio. |
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ámetro | Tipo | Descripción |
---|
transaction_id | string | ID de la transacción que va a cancelarse. Obligatorio. |
refund_id | string | ID externo del reembolso del pago. |
reason | string | Motivo del reembolso. |
refund_date | string | Fecha del reembolso en el formato YYYY-MM-DD’T’HH:MM:SS . Obligatorio. |
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ámetro | Tipo | Descripción |
---|
date | string | Fecha de transmisión de las estadísticas del creador en el formato YYYY-MM-DD . Obligatorio. |
creator_tag | string | Código único de la persona influyente en el programa. Obligatorio. |
new_supporters | integer | Número de nuevos jugadores que han utilizado la etiqueta de creador de la persona influyente. Obligatorio. |
total_supporters | integer | Número de todos los jugadores que han utilizado la etiqueta de creador de la la persona influyente. Obligatorio. |
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ámetro | Tipo | Descripción |
---|
creator_tag | string | Código único de la persona influyente en el programa. Obligatorio. |
creator_email | string | Correo electrónico de la persona influyente. Obligatorio. |
creator_channels | array of strings | Enlace al canal de la persona influyente en la red social. Puede haber varios canales. Obligatorio. |
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ámetro | Tipo | Descripción |
---|
creator_tag | string | Código único de la persona influyente en el programa. Obligatorio. |
revenue_share | integer | Porcentaje de los beneficios que obtiene la persona influyente por cada compra a la que se ha aplicado su etiqueta de creador. Obligatorio. |
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"
]
}
Última actualización:
22 de Enero de 2024¿Has encontrado una errata u otro error de texto? Selecciona el texto y pulsa Ctrl+Intro.