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 créateur préféré. Cette solution vous permet d’établir des relations de confiance avec les créateurs 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ù le créateur a partagé son code. Le créateur 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 du créateur est déduite de chaque achat, dont la balise Creator a été appliquée lors de l’achat.

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 créateurs participants cessent de recevoir des parts de revenus ;
   • Liste des créateurs. Pour chaque créateur, 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 créateurs :
     • Le retrait de fonds du solde n'est disponible que pour les créateurs âgés de plus de 18 ans,
     • Xsolla ne travaille pas avec les créateurs dont les comptes bancaires sont enregistrés dans des pays faisant l'objet de sanctions de la part des États-Unis.

2. 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.

3. 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.

4. 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).
5. 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.

2. Ajouter de nouveaux créateurs au programme (facultatif).

3. En utilisant la méthode Sending statistics by Creator tag, passez à Xsolla les informations relatives aux statistiques des joueurs (facultatif).

Ajouter des créateurs au programme

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

• vous-même ;
• via Xsolla.

Ajouter soi-même

1. Appelez successivement les méthodes Creating Creator tag for creator et Adding influencer to program.
2. Pour inviter un créateur à 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 du créateur utilisée dans la méthode Creating Creator tag for creator.

Ajouter via Xsolla

Méthodes API pour travailler avec la balise Creator

Getting creators with Creator tag

Récupère la liste des créateurs du programme qui ont des balises Creator.

Exemple de requête :

1GET https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals?limit=3&offset=0 HTTP/1.1

Exemple de réponse :

 1{
 2  "items": [
 3    {
 4      "creator_tag": "creatorOne",
 5      "revenue_share_percent": 5
 6    },
 7    {
 8      "creator_tag": "creatorTwo",
 9      "revenue_share_percent": 10
10    },
11    {
12      "creator_tag": "creatorThree",
13      "revenue_share_percent": 50
14    }
15  ],
16  "total_count": 32
17}

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 :

Exemple de requête :

 1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6[
 7  {
 8    "transaction_id": "123456789",
 9    "creator_tag": "creatorOne",
10    "platform_id": "steam",
11    "user_id": "0123456",
12    "transaction_date": "2020-04-10T06:06:24.830Z",
13    "item_id": "GAME_sku_1",
14    "item_name": "hk416",
15    "transaction_currency_code": "USD",
16    "transaction_value": 5
17  },
18  {
19    "transaction_id": "123456788",
20    "creator_tag": "creatorOne",
21    "platform_id": "steam",
22    "transaction_date": "2020-04-10T06:06:24.830Z",
23    "item_id": "GAME_sku_2",
24    "item_name": "hk416",
25    "transaction_currency_code": "EUR",
26    "transaction_value": 10
27  },
28  {
29    "transaction_id": "123456781",
30    "creator_tag": "creatorOne",
31    "platform_id": "xbox",
32    "transaction_date": "2020-04-10T06:06:24.830Z",
33    "item_id": "GAME_sku_1",
34    "item_name": "hk416",
35    "transaction_currency_code": "USD",
36    "transaction_value": 3
37  }
38]

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 :

Exemple de requête :

 1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/transactions HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6[
 7  {
 8    "transaction_id": "123456789",
 9    "creator_tag": "creatorOne",
10    "platform_id": "steam",
11    "user_id": "0123456",
12    "transaction_date": "2020-04-10T06:06:24.830Z",
13    "item_id": "GAME_sku_1",
14    "item_name": "hk416",
15    "transaction_currency_code": "USD",
16    "transaction_value": 5
17  },
18  {
19    "transaction_id": "123456788",
20    "creator_tag": "creatorOne",
21    "platform_id": "steam",
22    "transaction_date": "2020-04-10T06:06:24.830Z",
23    "item_id": "GAME_sku_2",
24    "item_name": "hk416",
25    "transaction_currency_code": "EUR",
26    "transaction_value": 10
27  },
28  {
29    "transaction_id": "123456781",
30    "creator_tag": "creatorOne",
31    "platform_id": "xbox",
32    "transaction_date": "2020-04-10T06:06:24.830Z",
33    "item_id": "GAME_sku_1",
34    "item_name": "hk416",
35    "transaction_currency_code": "USD",
36    "transaction_value": 3
37  }
38]

Sending statistics by Creator tag

Permet d’envoyer des statistiques sur la connexion à la balise Creator du créateur (par jours). Ces informations seront affichées dans la section Statistics dans le Compte créateur. Un tableau des objets suivants est passé dans le corps de la requête :

Exemple de requête :

 1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/supporters HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6[
 7  {
 8    "date": "2020-04-10",
 9    "creator_tag": "creatorOne",
10    "new_supporters": 125,
11    "total_supporters": 35900
12  },
13  {
14    "date": "2020-04-10",
15    "creator_tag": "creatorTwo",
16    "new_supporters": 123,
17    "total_supporters": 34567
18  }
19]

Creating Creator tag for creator

Permet de créer des balises Creator pour les nouveaux créateurs du programme. Un tableau des objets suivants est transmis dans le corps de la requête :

Exemple de requête :

 1PUT https://influencer.xsolla.com/api/partner/v2/tags HTTP/1.1
 2
 3X-API-key: {YOUR_API_KEY}
 4Content-Type: application/json
 5
 6{
 7  "creator_tag": "creatorOne",
 8  "creator_email": "influencer@example.com",
 9  "creator_channels": [
10    "https://www.twitch.tv/creatorOne"
11  ]
12}

Adding creator to program

Permet d’ajouter un nouveau créateur au programme. Un tableau des objets suivants est passé dans le corps de la requête :

Exemple de requête :

1PUT https://influencer.xsolla.com/api/partner/v2/programs/{PROGRAM_ID}/deals HTTP/1.1
2X-API-key: {YOUR_API_KEY}
3
4Content-Type: application/json
5
6{
7  "creator_tag": "creatorOne",
8  "revenue_share": 30
9}