Présentation

Avoir votre propre site vous permet de distribuer vos jeux sans payer de frais à une plateforme tierce. Vous gardez un contrôle total sur le marketing, les données des utilisateurs et l’entonnoir de vente, et vous interagissez directement avec votre audience à travers des mises à jour et des offres spéciales.

Avec un modèle prêt à l’emploi dans Xsolla Site Builder, vous avez la possibilité de créer votre propre magasin multi-jeux et de le personnaliser en fonction de vos besoins.

Voir la démo

1. Créez un projet dans le Compte éditeur.
2. Signez le contrat de licence avec Xsolla et passez l’entretien fiscal.

3. Pour chaque jeu, créez des packages de clés de jeu au sein d’un même projet.
4. Créez des lots avec des clés de jeu (facultatif).
5. Créer un site :
   • Ajoutez et personnalisez des pages de jeu ;
   • Créez la page principale du magasin.
6. Ajoutez des nouvelles au site (facultatif).
7. Testez le fonctionnement du site.
8. Publiez le site.

Guide d'intégration

Créer un projet dans le Compte éditeur

S'inscrire au Compte éditeur

Le Compte éditeur est l’outil principal pour configurer les fonctionnalités Xsolla, ainsi que pour gérer les analyses et les transactions.

Les informations relatives à votre entreprise et à votre application fournies lors de l’inscription seront utilisées pour créer un projet de contrat de licence avec Xsolla et pour générer des recommandations sur les solutions adaptées à vos besoins. Bien que vous puissiez modifier ces informations ultérieurement, les fournir correctement lors de l’inscription accélérera le processus de signature du contrat de licence.

Pour vous inscrire, accédez au Compte éditeur et créez un compte.

Créer un projet dans le Compte éditeur

Si vous gérez plusieurs applications, nous vous recommandons de créer un projet distinct pour chacune d’entre elles. En fonction des informations fournies lors de la création du projet, Xsolla génère des recommandations adaptées à vos besoins.

Pour créer un nouveau projet :

1. Ouvrez votre Compte éditeur.
2. Dans le menu latéral, cliquez sur Create project.

3. Entrez le nom de votre projet en anglais (obligatoire).

4. Sélectionnez un ou plusieurs plateformes de sortie pour votre jeu (obligatoire).
5. Ajoutez un lien vers votre jeu. Si votre jeu n'a pas encore de site, ajoutez un lien vers votre site principal ou vers la section où vos jeux sont répertoriés (obligatoire).
6. Choisissez le moteur de jeu.
7. Sélectionnez les options de monétisation que vous utilisez ou prévoyez d'utiliser.
8. Spécifiez si le jeu est déjà publié. Si le jeu n'a pas encore été publié, indiquez la date de sortie prévue.
9. Cliquez sur Create project. Une page avec les produits Xsolla recommandés pour vous s'affiche.

Aspects légaux

Signer un contrat de licence

La signature du contrat de licence vous permettra de monétiser votre projet via tous les modes de paiement offerts par Xsolla. Pour signer le contrat de licence :

1. Ouvrez votre Compte éditeur.
2. Dans le menu latéral, accédez à la section Agreements & taxes > Agreements.
3. Dans l’onglet Licensing Agreement, cliquez sur Complete application form.
4. Entrez vos informations dans les champs correspondants.

Votre demande sera examinée sous 3 jours ouvrables. En plus de vérifier les aspects légaux, nous recherchons la présence de problèmes de propriété intellectuelle, de contenu pour adultes et de tout autre contenu interdit ou restreint. Si des questions surviennent pendant la vérification, nous contacterons la personne désignée dans la demande. Une fois que Xsolla a terminé la procédure de vérification, le statut de votre contrat passera à Signed.

Passer l'entretien fiscal

Pour se conformer à la réglementation américaine en matière de déclaration fiscale et de retenue à la source, Xsolla exige que tous ses partenaires fournissent des informations fiscales valides et soumettent le formulaire fiscal approprié (W-8 pour les entités et personnes non américaines, W-9 pour les entités et personnes américaines) durant l’entretien fiscal. Cette étape est accessible après la signature du contrat de licence avec Xsolla.

Pour passer l’entretien fiscal :

1. Ouvrez votre Compte éditeur.
2. Dans le menu latéral, accédez à la section Agreements & taxes > Tax interview. Si vous avez des questions, consultez la FAQ disponible dans cette section.
3. Remplissez le formulaire fiscal avec des informations exactes sur vous ou votre entreprise.

Si nous avons des questions pendant la procédure de vérification, vous recevrez un e-mail à l’adresse spécifiée. Une fois la vérification terminée, la section Agreements & taxes > Tax interview indiquera que votre entretien fiscal a été examiné et validé.

Pour plus de détails sur la gestion de la fiscalité internationale, consultez le site Web Xsolla.

Créer des packages de clés de jeu

Créez des packages de clés de jeu pour chaque jeu :

1. Dans votre projet, dans le Compte éditeur, accédez à la section Store > Game Keys.
2. Dans l’onglet Game Keys, cliquez sur New game key package.

3. Définissez les paramètres de base du package :
   1. Ajoutez des informations générales pour chaque jeu, notamment :
      • Image ;
      • UGS ;
      • Titre du jeu ;
      • Description du jeu (facultatif).
   2. Ajoutez un lien vers la page du jeu :
      1. Réglez la bascule Add game page link sur On ;
      2. Si vous n’avez pas encore créé de page de jeu, sélectionnez Create new game page et indiquez le Game page name ;
      3. Si vous avez déjà créé une page de jeu à l’aide de Site Builder, sélectionnez-la dans la liste déroulante.

4. Cliquez sur Save and continue.
5. Sélectionnez les plateformes de distribution de jeux, puis téléchargez un fichier CSV ou TXT contenant les clés. Chaque clé doit avoir une combinaison alphanumérique unique. Les clés ayant la même combinaison ne seront pas téléchargées.
6. Si vous souhaitez vendre le jeu avant sa sortie officielle, réglez la bascule Pre-orders sur On. La date de livraison des clés peut être définie lors de la création des clés ou ultérieurement.
7. Cliquez sur Save and continue.
8. Configurez les prix pour les plateformes sélectionnées :
   1. Définissez des prix ou créez des clés gratuites :
      • Pour créer un package de clés gratuites, dans le champ Paid or free, sélectionnez Paid game key ;
      • Pour définir un prix, dans le champ Paid or free, sélectionnez Paid game key et indiquez le prix dans une ou plusieurs devises.
   2. Définissez des prix régionaux (facultatif). Pour configurer des prix régionaux pour des pays spécifiques, procédez comme suit :
      1. Dans le champ Country-based pricing in real currency, cliquez sur Add price ;
      2. Spécifiez le pays, la devise et le montant.
9. Cliquez sur Save and continue.
10. Une fois le package de clés de jeu créé avec succès, une fenêtre modale s’affiche avec des options de vente de clés de jeu. Cliquez sur Fermer, car la page de jeu a déjà été créée (voir étape 3b).

L’ordre des jeux dans le magasin correspond à celui des packages de clés de jeu dans la liste. Pour modifier la position d’un package, survolez le numéro de la ligne et faites-la glisser à l’aide de l’icône ☰ jusqu’à la position souhaitée.

Liens utiles

Créer un lot avec des clés de jeu

Les lots permettent de regrouper du contenu numérique distribué via des clés en un seul package. Par exemple, un lot peut inclure des clés pour plusieurs jeux, des DLC, des bandes sonores ou des mises à niveau vers des éditions étendues. Ce format de vente profite autant aux utilisateurs qu’aux développeurs : les utilisateurs bénéficient de jeux à prix réduit, tandis que les développeurs augmentent l’engagement du public et stimulent leurs ventes.

Les paramètres flexibles permettent aussi d’appliquer des remises et de définir des restrictions de durée ou de quantité sur l’offre.

Limites :

• Un lot ne peut pas contenir le même lot.
• Un lot ne peut pas être vide.
• Les ventes de lots s’arrêtent lorsque les clés qu’ils comprennent s’épuisent.
• Vous pouvez configurer des restrictions régionales pour un lot uniquement via API.

Pour configurer un lot :

1. Dans votre projet, dans le Compte éditeur, accédez à la section Store > Bundles.
2. Cliquez sur Create bundle.

3. Définissez les paramètres de base du lot :
   • Image ;
   • UGS ;
   • Nom du lot ;
   • Description du lot (facultatif).
4. Cliquez sur Next.
5. Configurez le contenu du lot :
   1. Dans le champ Product typ, sélectionnez Game keys ;
   2. Cochez les cases des clés de jeu à inclure dans le lot.
6. Cliquez sur Next.
7. Configurez les prix du lot :
   1. Définissez les prix ou créez un lot gratuit :
      • Pour créer un lot gratuit, dans le champ Paid or free, sélectionnez Free bundle ;
      • Pour définir un prix, dans le champ Paid or free, sélectionnez Paid bundle et indiquez le prix dans une ou plusieurs devises.
   2. Définissez les prix régionaux (facultatif). Pour configurer des prix régionaux pour des pays spécifiques, procédez comme suit :
      1. Dans le champ Country-based pricing in real currency, cliquez sur Add price ;
      2. Spécifiez le pays, la devise et le montant.
   3. Définissez une limite d’achat pour le lot (facultatif). Pour ce faire, réglez la bascule Limit number of times one user can buy bundle sur On et indiquez le nombre de lot que l’utilisateur peut acheter.
8. Cliquez sur Next.
9. Configurez l’affichage du lot dans le magasin :
   1. Changez le statut en Available ;
   2. Définissez une limite de temps pour l’affichage du lot dans le magasin (facultatif). Pour ce faire, sélectionnez Time period et indiquez le fuseau horaire, le début et la fin de la période. Si vous ne souhaitez pas définir la fin de la période, cochez la case No end date.
10. Cliquez sur Next.
11. Vérifiez les paramètres et cliquez sur Save.

L’ordre des lots dans le magasin correspond à celui de la liste. Pour modifier la position d’un lot, survolez le numéro de la ligne et faites-la glisser à l’aide de l’icône ☰ jusqu’à la position souhaitée.

Liens utiles

Limiter le nombre de lots disponibles à l'achat

Limiter la durée d'affichage des lots dans le magasin

API pour la gestion des lots

Créer une page de jeu

Terminez la configuration de la page de jeu. Pour chaque jeu, suivez ces étapes :

1. Dans votre projet, dans le Compte éditeur, accédez à la section Site Builder.
2. Dans le volet du site créé automatiquement lors de la création du package de clés de jeu, cliquez sur Open Site Builder.
3. Sélectionnez le modèle Single game page.
4. Pour une configuration automatique du design du magasin, ajoutez un lien vers votre jeu sur Steam ou Epic Games Store.
5. Si votre jeu n’est pas disponible sur ces plateformes ou si vous souhaitez personnaliser le design manuellement, désactivez l’option Copy game info via Steam or Epic Games Store URL.
6. Cliquez sur Create game page.

7. Modifiez ou ajustez les principaux blocs de contenu.

8. Dans le bloc Game editions, sélectionnez le package de clés correspondant à chaque édition du jeu. Dans cette section, vous pouvez :
   • Ajouter ou supprimer des éditions ;
   • Modifier la liste des avantages, les titres, les descriptions et les images des éditions du jeu. Pour mettre en avant l’édition la plus avantageuse, activez l’option Featured edition.

Créer la page principale du magasin

Créez une page principale avec un catalogue de tous les jeux ajoutés :

1. Dans votre projet dans le Compte éditeur, accédez à la section Site Builder, puis cliquez sur Create site.
2. Sélectionnez le modèle Multiple games store et cliquez sur Create store.

3. Configurez le bloc des éditions de jeux en vedette :
   1. Accédez au bloc Featured games ;
   2. Définissez les paramètres généraux du bloc :
      • Heading
      • Description
      • Layout style
      • Action on edition area click
      • Presence or absence of horizontal scrolling
      • Custom background
   3. Ajoutez des sections avec le contenu nécessaire.

4. Le bloc Store inclut automatiquement les packages de clés de jeu et les jeux individuels configurés précédemment. Ajustez ses paramètres si nécessaire.

5. Si vous prévoyez d’utiliser des codes promo pour les clés de jeu :
   1. Accédez au bloc Cart settings ;
   2. Activez l’option Show promo code field. Pour configurer les codes promo, reportez-vous aux instructions.

Note

Les codes promo ne sont disponibles qu’aux utilisateurs autorisés. Si les codes promo sont utilisés sur le site Web, assurez-vous d’avoir activé l’authentification utilisateur et configuré la section Login setting.

6. Modifiez ou ajustez les autres blocs de contenu.

Ajouter des nouvelles au site

Sur votre site, vous avez la possibilité de publier des articles portant sur les mises à jour et promotions des jeux, d’annoncer des événements, ainsi que de partager divers contenus intéressants liés à vos jeux. Cela vous permet de renforcer la communication avec les joueurs et d’augmenter leur fidélité.

Pour publier des articles sur votre site :

1. Créez des catégories d’articles (facultatif).
2. Créez un article.
3. Publiez des articles sur votre site.

Créer des catégories d'articles

Utilisez les catégories pour organiser les articles par thèmes et gérer leur affichage sur votre site.

Pour créer une catégorie d’articles :

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Launcher.
3. Dans l’onglet Dashboard, procédez comme suit :
   • Si vous avez déjà créé des lanceurs, cliquez sur Edit launcher dans le volet du lanceur concerné.
   • Si vous n’avez pas encore créé de lanceurs :
     1. Cliquez sur Set up launcher ;
     2. Cliquez sur Create launcher ;
     3. Entrez le nom du lanceur ;
     4. Cliquez sur Next ;
     5. Sélectionnez n’importe quel système d’exploitation (ce paramètre n’affecte pas la publication d’articles) ;
     6. Cliquez sur Next ;
     7. Cliquez sur Create. Pour publier des articles, aucun besoin d’ajouter des jeux ni de configurer Login.

4. Dans la section Content, cliquez sur Content tiles.

5. Cliquez sur Create group.

6. Remplissez les champs requis :
   • Dans le champ Where should this content be displayed?, sélectionnez All games ;
   • Sélectionnez l’emplacement du contenu sur la page ;
   • Dans le champ Which game is the content about?, sélectionnez It’s not game-related.

Ces paramètres sont nécessaires pour créer des catégories d’articles, sans toutefois influencer leur publication.

7. Cliquez sur Next.
8. Spécifiez Title.
9. Si vous avez déjà créé des articles, vous pouvez les ajouter à ce groupe.
10. Cliquez sur Create.

Le groupe créé apparaîtra dans la section Content tiles avec le statut Draft. Pour publier le groupe, changez son statut en Publish.

Créer des articles

Pour créer un article :

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Launcher.
3. Dans le volet du lanceur correspondant, cliquez sur Edit launcher.
4. Dans la section Content, cliquez sur Content tiles.
5. Cliquez sur Create content.

6. Remplissez les champs requis :
   • Dans le champ Where should this content be displayed?, sélectionnez All games ;
   • Sélectionnez l’emplacement du contenu sur la page ;
   • Dans le champ Which game is the content about?, sélectionnez It’s not game-related.

Ces paramètres sont nécessaires pour créer des articles, sans toutefois influencer leur publication.

7. Cliquez sur Next.
8. Sélectionnez le type de contenu : News.
9. Spécifiez le titre de l’article.
10. Téléchargez une image d’article.
11. Dans le champ Content, ajoutez le texte de l’article. Vous pouvez également ajouter des images, des vidéos et des liens.
12. Si votre site est localisé dans d’autres langues, ajoutez les versions traduites de votre article dans les blocs appropriés.
13. Cliquez sur Create.

L’article créé apparaîtra dans la section Content tiles avec le statut Draft. Pour publier l’article, changez son statut en Publish.

Pour ajouter des articles à une catégorie :

1. Dans la section Content tiles, cliquez sur l’icône de modification du groupe de contenu souhaité.
2. Accédez à l’onglet Content.
3. Dans le champ Linked content, spécifiez les articles que vous souhaitez ajouter à cette catégorie.
4. Cliquez sur Save.

Publier des articles sur votre site

1. Dans votre projet, dans le Compte éditeur, accédez à la section Site Builder.
2. Dans le volet de la page principale du magasin, cliquez sur Open Site Builder.
3. Sélectionnez le bloc News.
4. Dans le menu latéral de la section Content, ouvrez la liste déroulante News source et sélectionnez un lanceur dont les articles publiés s’afficheront sur votre site.
5. Dans le menu latéral de la section Content, ouvrez la liste déroulante Displayed categories et sélectionnez les catégories d’articles à publier : published content groups.

6. Si nécessaire, personnalisez le bloc dans la section Layout :
   • cachez ou affichez l’en-tête du bloc ;
   • ajoutez un arrière-plan personnalisé ;
   • affichez les catégories d’articles sous forme d’onglets.
7. Publiez votre site. Si votre site a déjà été publié, les articles s’afficheront automatiquement sur le site.

Tester le site en mode bac à sable

Le mode bac à sable est un environnement autonome qui reproduit toutes les fonctionnalités du mode de production, à l’exception de la connexion utilisateur, des paiements réels et des remboursements.

Pour tester le fonctionnement de votre site en mode bac à sable, procédez comme suit :

1. Dans votre projet, dans le Compte éditeur, accédez à la section Site Builder.
2. Dans le volet de la page principale du magasin, cliquez sur Open Site Builder.
3. Cliquez sur Preview.

4. Sélectionnez un jeu ou un lot et cliquez sur le bouton d’achat.
5. Choisissez le groupe de mode de paiement Credit/Debit cards.
6. Entrez les informations de la carte bancaire de test. Entrez des valeurs aléatoires dans les champs restants. Vous pouvez également indiquer des informations incorrectes (numéro de carte, date d’expiration ou CVV) pour générer une erreur.

Liste des cartes de test

Voir la liste des cartes bancaires de test.

Publier le site et créer un domaine personnalisé

Publier le site

1. Après avoir créé et configuré votre site dans Site Builder, publiez toutes les pages de jeu ainsi que la page principale. Pour ce faire, ouvrez le site dans le Site Builder et cliquez sur Publish.

2. Apportez des modifications au domaine (facultatif) :
   1. Dans votre projet dans le Compte éditeur, accédez à la section Site Builder ;
   2. Dans le volet du site, cliquez sur Configure ;
   3. Dans la section Domain, éditez la valeur Xsolla domain ou configurez votre propre domaine.

Configurer votre propre domaine

Pour configurer un domaine personnalisé (par exemple, example.com) :

1. Obtenez l’adresse IP de votre site publié (vous l’utiliserez à l’étape 5) :
   1. Dans votre projet dans le Compte éditeur, accédez à la section Site Builder ;
   2. Dans le volet du site, cliquez sur Configure ;
   3. Dans la section Domain, développez le bloc Set up your domain et copiez l’adresse IP.
2. Créez votre domaine personnalisé ou utilisez un domaine existant.

3. Accédez au panneau d'administration de votre fournisseur DNS.
4. Sélectionnez votre domaine et ajoutez un enregistrement A.
5. Ajoutez l'enregistrement A avec l'adresse IP de votre site en tant que valeur et enregistrez les modifications.

6. Ouvrez le projet dans le Compte éditeur.
7. Dans la barre latérale, cliquez sur Site Builder.
8. Cliquez sur Configure dans le volet de votre site.
9. Dans la section Domain, réglez la bascule Use my own domain sur On.
10. Dans la fenêtre modale, dans le champ Your domain, spécifiez le nom du domaine personnalisé et cliquez sur Save domain.

Pour configurer un sous-domaine (par exemple, store.example.com) :

1. Accédez au panneau d’administration de votre fournisseur DNS.
2. Sélectionnez votre domaine et ajoutez un enregistrement CNAME.
3. Ajoutez l’enregistrement CNAME avec l’adresse de votre site dans en tant que valeur, puis enregistrez les modifications.

4. Ouvrez le projet dans le Compte éditeur.
5. Dans la barre latérale, cliquez sur Site Builder.
6. Cliquez sur Configure dans le volet de votre site.
7. Dans la section Domain, réglez la bascule Use my own domain sur On.
8. Dans la fenêtre modale, dans le champ Your domain, spécifiez le nom du sous-domaine et cliquez sur Save domain.

Liens utiles