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.
- 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 ) 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 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 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.
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 objetAdPlacementDetails.
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 lePlacementId 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.