Comment configurer un programme avec la balise Creator

Comment ça marche

La balise Creator est un code unique qu’un joueur peut recevoir lorsqu’il regarde des streams sur YouTube ou Twitch ou dans d’autres formats/services. Un joueur (supporteur) peut utiliser cette balise lors d’achats dans le jeu pour soutenir son influenceur préféré. Cette solution vous permet d’établir des relations de confiance avec les influenceurs et d’augmenter vos revenus grâce à l’attribution (suivi) de tous les achats en jeu.

Flux du joueur

  1. Le joueur copie la balise Creator ou suit le lien pour la connecter à partir du service où l'influenceur a partagé son code. L'influenceur peut utiliser les services suivants :
    • Twitch ;
    • YouTube ;
    • Facebook Gaming ;
    • autres réseaux sociaux.
  2. Le joueur saisit la balise Creator dans le champ de la page où vous avez implémenté sa connexion. Si le joueur clique sur le lien, la balise Creator est automatiquement appliquée.

Monétisation

Vous percevez des revenus de tous les achats en jeu. Une part des bénéfices de l’influenceur est déduite de chaque achat, dont la balise Creator a été appliquée lors de l’achat.

Note
La plateforme de jeu et le système de paiement peuvent prélever une commission supplémentaire sur les paiements.

Qui peut l'utiliser

Les partenaires qui ont un jeu avec :

  • un revenu mensuel attendu d’au moins 20 000 $ ;
  • des biens disponibles à l’achat uniquement dans le jeu.

Comment configurer

Configurer un programme avec une balise Creator

Pour configurer un programme avec une balise Creator :

  1. Envoyez une demande à csm@xsolla.com (ou à bizdev@xsolla.com, si vous intégrez un produit Xsolla pour la première fois) et attendez sa soumission. Indiquez les informations suivantes dans la demande :
    • Nom du jeu ;
    • Genre ;
    • Développeur (facultatif) ;
    • Éditeur (facultatif) ;
    • Site officiel du jeu ;
    • Description du jeu ;
    • Steam AppID (facultatif) ;
    • Date de sortie, si le jeu n'est pas encore publié (facultatif) ;
    • Lien vers le matériel promotionnel (facultatif) ;
    • Modèle commercial :
      • premium,
      • free-to-play ;
    • Plateforme de jeu :
      • PC,
      • Steam,
      • mobile,
      • Web ;
    • Période de participation au programme ;
    • Pourcentage de la part des revenus ;
    • Fin du Revenue sharing. Le jour où les influenceurs participants cessent de recevoir des parts de revenus ;
    • Liste des influenceurs. Pour chaque influenceur, indiquez son adresse e-mail, sa chaîne de réseau social et sa balise Creator. Tenez compte des limitations suivantes lors du choix des influenceurs :
      • Le retrait de fonds du solde n'est disponible que pour les influenceurs âgés de plus de 18 ans,
      • Xsolla ne travaille pas avec les influenceurs dont les comptes bancaires sont enregistrés dans des pays faisant l'objet de sanctions de la part des États-Unis.

  1. Implémentez le mécanisme de connexion de la balise Creator par le lecteur de l'une des manières suivantes :
    • En cliquant sur le lien. Dans ce cas, la valeur de la balise Creator sera automatiquement chargée dans le champ de saisie spécifique ;
    • En utilisant la saisie manuelle.

  1. Déterminez l'emplacement de la page avec la balise Creator :
    • Dans l'interface du jeu ;
    • Sur le site publicitaire du jeu ;
    • Dans l'interface de paiement chaque fois que le joueur paie un achat.
Note
Il est recommandé d’implémenter la connexion de la balise Creator dans l’interface du jeu afin que le code soit automatiquement appliqué à l’achat de chaque joueur.
  1. Envoyez à csm@xsolla.com un lien vers la page sur laquelle la balise Creator est connectée (si le mécanisme est implémenté dans l'interface ou sur le site du jeu).
  2. Dans le jeu, implémentez des mécanismes permettant de lier la balise Creator aux achats des joueurs, et de suivre ces achats.

Gérer le programme avec la balise Creator

Pour gérer efficacement un programme avec la balise Creator :
  1. Envoyez régulièrement vos achats à Xsolla en utilisant la méthode Creating transactions. La fréquence recommandée pour le passage de ces données est d’une fois par jour.
Note
Dans le cas d’un remboursement pour un achat auquel la balise Creator a été appliquée, passez cette information à Xsolla en utilisant la méthode Canceling transactions.
  1. Ajouter de nouveaux influenceurs au programme (facultatif).
Note
Si vous ajoutez des influenceurs via Xsolla, téléchargez régulièrement leur liste en utilisant la méthode Getting influencers with Creator tag. La fréquence recommandée d’acquisition des données est d’une fois par jour.
  1. En utilisant la méthode Sending statistics by Creator tag, passez à Xsolla les informations relatives aux statistiques des joueurs (facultatif).

Ajouter des influenceurs au programme

Vous pouvez ajouter des influenceurs à votre programme de l’une des manières suivantes :

Ajouter soi-même

Pour ajouter vous-même des influenceurs à votre programme :
  1. Appelez successivement les méthodes Creating Creator tag for influencer et Adding influencer to program.
  2. Pour inviter un influenceur à participer au programme, envoyez un e-mail à influencer@xsolla.com en indiquant l’adresse e-mail, la chaîne de réseau social et la balise Creator de l’influenceur utilisée dans la méthode Creating Creator tag for influencer.

Ajouter via Xsolla

Pour ajouter un influenceur au programme via Xsolla, envoyez un e-mail à influencer@xsolla.com en indiquant l’adresse e-mail, la chaîne de réseau social et la balise Creator que vous souhaitez attribuer à l’influenceur.

Méthodes API pour travailler avec la balise Creator

Getting influencers with Creator tag

Récupère la liste des influenceurs du programme qui ont des balises Creator.
ParamètreTypeDescription
limit
integerNombre d’influenceurs dans la liste (par défaut : 20, maximum : 100).
offset
integerValeur du décalage qui se produit lors du chargement des influenceurs dans la liste (par défaut : 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

Creating transactions

Permet de créer ou de mettre à jour les transactions auxquelles la balise Creator a été appliquée. Un tableau des objets suivants est passé dans le corps de la requête :
ParamètreTypeDescription
creator_tag
stringCode unique de l’influenceur dans le programme. Obligatoire.
transaction_id
stringID de transaction. Obligatoire.
transaction_currency
stringCode de la devise dans laquelle la transaction a été effectuée. Code de devise à trois lettres selon la norme ISO 4217. Obligatoire.
transaction_value
numberMontant de la transaction. Obligatoire.
transaction_date
stringDate de la transaction au format YYYY-MM-DD’T’HH:MM:SS. Obligatoire.
platform_id
stringPlateforme sur laquelle la transaction a été effectuée. Obligatoire.
user_id
stringID du joueur. Obligatoire.
item_id
stringID de l’objet acheté. Obligatoire.
item_name
stringNom de l’objet acheté. Obligatoire.
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
  }
]

Canceling transactions

Annule les transactions auxquelles la balise Creator a été appliquée. Un tableau des objets suivants est passé dans le corps de la requête :
ParamètreTypeDescription
transaction_id
stringID de la transaction à annuler. Obligatoire.
refund_id
stringExternal ID du remboursement de paiement.
reason
stringMotif du remboursement.
refund_date
stringDate de remboursement au format YYYY-MM-DD’T’HH:MM:SS. Obligatoire.
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
  }
]

Sending statistics by Creator tag

Permet d’envoyer des statistiques sur la connexion à la balise Creator de l’influenceur (par jours). Ces informations seront affichées dans la section Statistics dans le Compte influenceur. Un tableau des objets suivants est passé dans le corps de la requête :
ParamètreTypeDescription
date
stringDate de passage des statistiques sur les créateurs au format YYYY-MM-DD. Obligatoire.
creator_tag
stringCode unique de l’influenceur dans le programme. Obligatoire.
new_supporters
integerNombre de nouveaux joueurs ayant utilisé la balise Creator de l’influenceur. Obligatoire.
total_supporters
integerNombre de joueurs ayant utilisé la balise Creator de l’influenceur. Obligatoire.
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
  }
]

Creating Creator tag for influencer

Permet de créer des balises Creator pour les nouveaux influenceurs du programme. Un tableau des objets suivants est transmis dans le corps de la requête :
ParamètreTypeDescription
creator_tag
stringCode unique de l’influenceur dans le programme. Obligatoire.
creator_email
stringAdresse e-mail de l’influenceur. Obligatoire.
creator_channels
array of stringsLien vers la chaîne de l’influenceur dans le réseau social. Plusieurs chaînes peuvent être indiquées. Obligatoire.
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"
  ]
}

Adding influencer to program

Permet d’ajouter un nouvel influenceur au programme. Un tableau des objets suivants est passé dans le corps de la requête :
ParamètreTypeDescription
creator_tag
stringCode unique de l’influenceur dans le programme. Obligatoire.
revenue_share
integerPourcentage de profit que l’influenceur gagne pour chaque achat auquel sa balise Creator a été appliquée. Obligatoire.
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"
  ]
}
Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Évaluer cette page
Évaluer cette page
Que pouvons-nous améliorer ?

Préfère ne pas répondre

Merci pour votre commentaire !
Dernière mise à jour: 22 Janvier 2024

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

Signaler un problème
Nous améliorons continuellement notre contenu grâce à vos commentaires.
Indiquez votre adresse e-mail pour un suivi
Merci pour votre commentaire !