> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Prise en main des publicités récompensées. > Démarrage rapide pour configurer un emplacement publicitaire récompensé PlayFab dans Game Manager, configurer les récompenses et intégrer des publicités vidéo dans votre client de jeu. # Démarrage rapide : configurer un emplacement publicitaire Les publicités récompensées sont un moyen d'inciter vos joueurs à regarder des publicités vidéo en échange d'une récompense. Chaque publicité, avec ses récompenses associées, est considérée comme un emplacement publicitaire. Dans ce démarrage rapide, vous configurerez un emplacement publicitaire et ses récompenses. ## Prérequis * Un [compte de développeur PlayFab](https://developer.playfab.com/en-US/my-games). * Un ID d'application (Application ID) et un type d'unité publicitaire (Advertising Unit type) provenant de votre fournisseur de publicités. ## Configurer un emplacement publicitaire Dans l'onglet **Rewarded Ads**, la première chose que vous verrez est le tableau de bord principal de vos publicités. Vous y trouverez des indicateurs de performance clés (KPI) de base pour vos publicités, ainsi qu'un graphique montrant vos événements publicitaires récents (ils apparaissent également dans [PlayStream ](/fr-CA/services/playfab/data-analytics/ingest-data/playstream-overview)) En haut, sélectionnez **Placements**. Les emplacements publicitaires sont la partie la plus fondamentale du système. Considérez un emplacement comme une « position publicitaire » : le type de publicité qui sera affiché (bannière, vidéo, etc.) et le moment dans le jeu où le joueur la verra (interstitiel de niveau, après avoir cliqué sur « montrez-moi une publicité », etc.). Dans le coin supérieur droit, sélectionnez **New Ad Placement**. Nommez votre emplacement comme vous le souhaitez, puis entrez l'ID d'application et le type d'unité publicitaire de votre fournisseur de publicités. Si vous ne savez pas où trouver l'ID d'application et le type d'unité publicitaire de votre fournisseur, faites-le-nous savoir et nous pourrons vous aider à les repérer. ## Ajouter des récompenses Vous devez maintenant ajouter vos récompenses. Pour chaque récompense possible de cet emplacement, sélectionnez **New Reward**. Donnez un nom à votre récompense et entrez le texte de description et l'URL du package de ressources que vous souhaitez retourner au client lorsque cette récompense est accordée. Ensuite, sous **Actions**, sélectionnez **Add Action**. Comme avec les actions [PlayStream](/fr-CA/services/playfab/data-analytics/ingest-data/playstream-overview) habituelles, vous pouvez effectuer dès maintenant un certain nombre d'actions différentes : exécuter un gestionnaire Cloud Script, octroyer des articles, etc. Habituellement, vous octroierez ici de la monnaie virtuelle ou des articles, mais si vous souhaitez utiliser les autres types d'actions, tout sera traité de la même façon que pour un déclencheur d'action PlayStream normal. Après avoir défini quelques récompenses, attribuez un poids à chacune pour configurer la distribution aléatoire. Si vous avez défini des [segments](/fr-CA/services/playfab/live-service-management/game-configuration/segmentation/segmentation-overview) pour votre titre, vous pouvez également définir des remplacements dans l'outil **Segment Assignment** sous **Rewards**. Par exemple, si vous voulez qu'un certain groupe de joueurs obtienne toujours une récompense précise, associez ce segment à cette récompense dans la liste d'attribution. Les attributions de segments sont classées par ordre de priorité : le premier segment correspondant au joueur actuel est celui qui est utilisé. L'exemple suivant définit un emplacement publicitaire qui fournit des gemmes gratuites 0 % du temps, des points d'expérience bonus 30 % du temps et un article « clé » 70 % du temps. Game Manager - Magasins - Remplacements par segment Dans l'exemple, nous utilisons **Segment Assignment** pour fournir les récompenses selon un ordre de priorité. Si le joueur fait partie du groupe « High XP Players », la sélection aléatoire normale s'applique. Mais si le joueur fait partie du segment « VIP players », nous lui octroyons la récompense « gems ». Envisagez de créer un segment pour les joueurs qui regardent une publicité pour la première fois, et octroyez-leur l'une de vos récompenses les plus convoitées. Cela peut inciter vos joueurs à continuer d'interagir avec les publicités récompensées et entraîner un taux de rétention global plus élevé. Enfin, vous avez la possibilité de limiter le nombre de fois qu'un joueur peut être récompensé pour une publicité. Dans notre exemple, nous avons limité ce nombre à 4 fois par jour, par joueur (la réinitialisation quotidienne de ce compteur a lieu à 00 h 00 UTC). Vous pouvez faire réinitialiser la limite chaque jour, chaque heure ou toutes les deux heures. ## Récupération des emplacements publicitaires Après avoir défini au moins un emplacement publicitaire, vous pouvez interroger la liste des emplacements disponibles à l'aide de Client/GetAdPlacements. Spécifiez un identifiant dans l'appel pour vous assurer d'obtenir uniquement l'information sur l'emplacement donné. Pour filtrer un emplacement précis, vous pouvez utiliser soit le nom que vous lui avez donné (ci-dessus), soit l'identifiant unique de l'emplacement généré par PlayFab (que vous pouvez voir dans l'URL, dans l'exemple ci-dessus). Sinon, tous les emplacements disponibles pour lesquels le joueur a une récompense valide, y compris la récompense du joueur, le nombre de visionnements restants et le délai avant la réinitialisation de la limite de visionnements, sont retournés dans un objet `AdPlacementDetails`. Lorsque vous avez sélectionné un emplacement publicitaire dans le code client, assurez-vous d'enregistrer le `PlacementId` et le `RewardId`. Vous les utiliserez dans les deux étapes suivantes. ## Signalement de l'activité publicitaire Nous définissons quatre états d'activité pour une publicité : « Opened », « Closed », « Start » et « End ». Lorsque vous utilisez les publicités récompensées, assurez-vous d'appeler Client/ReportAdActivityRequest pour mettre à jour l'état d'activité chaque fois que votre SDK publicitaire signale un changement d'état. ## Récompense de l'activité publicitaire Lorsque votre SDK publicitaire signale que le visionnement de la publicité s'est terminé avec succès, appelez Client/RewardAdActivity pour déclencher la récompense. Cet appel nécessite le `PlacementId` et le `RewardId` retournés par Client/GetAdPlacements. Il vérifie d'abord que la récompense est valide, puis la traite pour le joueur. Les articles sont octroyés immédiatement, et l'appel retourne ensuite l'ensemble complet des modifications apportées au joueur par les actions Grant Item, Grant Virtual Currency et Increment Player Statistic. Enfin, il est important de noter que l'ID de récompense n'est pas lié au joueur dans le cadre de l'appel à GetAdPlacements. Selon les pondérations que vous avez fournies, appeler GetAdPlacements plusieurs fois peut entraîner un changement de récompense. L'appel à `RewardAdActivity` exige seulement que la récompense soit valide pour le joueur, et non qu'il s'agisse de la dernière récompense retournée par GetAdPlacements. ## Related topics - [Prise en main des dispositions d'ensembles tactiles](/fr-CA/build/core-features/common/game-streaming/building-touch-layouts/samples/game-streaming-touch-getting-started-with-sample-layouts.md) - [Prise en main de l'empaquetage des titres PC avec les outils MSIXVC](/fr-CA/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md) - [Prise en main d'Android Studio et des notifications push](/fr-CA/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/getting-started-android-studio-push-notifications.md) - [Packages (expérience classique)](/fr-CA/publishing/game-publishing/concepts/packages-overview.md) - [Que sont les publicités récompensées?](/fr-CA/services/playfab/economy-monetization/rewarded-ads/index.md)