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.

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.

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

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 influenceurs 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 influenceurs au programme

• vous-même ;
• via Xsolla.

Ajouter soi-même

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

Méthodes API pour travailler avec la balise Creator

Getting influencers with Creator tag

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

Creating transactions

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

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

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

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

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"
  ]
}