Interface de configuration des incitations


La démo de l'interface de loterie incitative est dans LotteryActivity.java

Description de l'entreprise

Méthode de loterie :

Prend en charge les méthodes de loterie suivantes

1 . Loterie gratuite : c'est-à-dire les utilisateurs peuvent participer à la loterie gratuitement

2. Loterie de consommation : c'est-à-dire que vous devez consommer des points du centre commercial pour la loterie

3. Loterie mixte : une loterie gratuite d'abord, puis une loterie de consommation une fois les temps gratuits utilisés. up

4. Loterie de consommation : les utilisateurs achètent des biens. Les prix peuvent être restitués en fonction de la probabilité configurée (peut être réalisé sans connexion à l'APP)

Stratégie de loterie :

Loterie de probabilité : configurer une loterie avec une certaine probabilité

Description des prix :

1) Biens virtuels

Collectez des bonus, des enveloppes rouges (tous les produits du réseau ou désignés), des bons d'achat, des pièces d'or, des points Tmall, des points centre commercial, des billets de cinéma, billets de loterie, coffrets cadeaux APP

2) Prix physiques

Produits gratuits : les prix physiques peuvent être distribués avec ou sans les magasins Tmall/Taobao.

Produits à prix réduit : les utilisateurs peuvent acheter des produits à prix réduit en scannant le code QR ; le taux de réduction peut être configuré en arrière-plan.

Autres instructions :

1) eventKey

est utilisé dans l'APP pour définir des événements qui satisfont à la loterie. Chaque eventKey correspond à une activité de loterie. La stratégie d'activité est configurée par l'arrière-plan de l'incitation. l'APP doit généralement mettre à jour le package d'installation.

2) Backend d'incitation

  • Le backend d'incitation peut configurer les activités de loterie correspondantes en fonction des besoins de l'APP, et chaque activité correspond à une clé d'événement.
  • Après l'expiration de la loterie, même si l'APP appelle à nouveau eventKey pour la loterie, vous ne gagnerez pas.
  • S'il y a plusieurs activités de loterie dans une APP, plusieurs eventKeys doivent être créées et les heures des événements de loterie de la même eventKey ne peuvent pas se chevaucher
  • Pour la loterie de consommation, il n'est pas nécessaire de configurer l'APP. la demande à Digital Entertainment Operations et configurez l'arrière-plan de l'opération.


Obtenez la liste des informations sur les incitations

Description de l'interface :

Obtenez la liste des informations sur les activités de loterie, affichez les informations sur l'activité ou effectuez l'opération. traitement correspondant en fonction des résultats dans l'auditeur.

Les données renvoyées incluent le type de loterie, les points consommés à la loterie et le nombre de tirages gratuits, etc.

Conditions préalables :

Aucun

Prototype de fonction :

public static void getActivitesInfo(String eventKey, IReceiveActivitesListener listening)

Description du paramètre:

eventKey : Obtenez les informations d'activité correspondant à cet identifiant, si null est transmis, obtenez les informations de toutes les activités disponibles

Listener : les informations sur l'activité sont renvoyées à l'auditeur et le type de retour est ActivityInfoModel.

Demande d'échantillon :

AliTvSdk.Lottery.getActivitesInfo (eventKey, new IReceiveActivitesListener() {
      @Override
      public void onResult(ActivityInfoModel activies) {
                           ArrayList<ActivityInfoItem> items = model.obtainActivities();
                           if(items != null){
                                 ActivityInfoItem item = items.get(0);
//抽奖类型,1.免费型2.消耗型3.混合型
                                 int luckyType = item.getLuckyType();
                                 //抽奖一次需要消耗的积分,若免费型抽奖为0
int consumeAmount = item.getConsumeAmount());
                                  //抽奖次数(免费或混合型抽奖初始化设置免费抽奖次数)
             int accessAmount = item.getAccessAmount());
                             AwardsList awardsList = item.getAwards();
for(int j = 0;j < awardItems.size();j++){
      //根据活动信息绘制UI,详见Demo。
}
 
      }
                           
      @Override
      public void onError(int errCode, String errMsg) {
      }
});

Description du retour

ID d'événement Nom de l'activitéstartTimeString Heure de début de l'événementendTimeStringHeure de fin de l'événementawardInfo ItemList ActivityInfoAwardItem Le prix de l'activité L'objet consumeAmountIntS'il est 0, il ne sera pas consomméaccès MontantNombre de tirages gratuits pour cet événement

Nom

Type

Description

activityId

String

peut consulter la liste des récompenses

L'événement consomme des points de divertissement à chaque fois

Int

luckyType

Int

Type de loterie

Loterie gratuite : 1

Loterie de consommation : 2

Loterie mixte : 3

activityUrl

String

Retour à l'URL de l'événement, disponible pour CP Code QR de production, la page H5 s'affichera sur le téléphone mobile après que l'utilisateur aura scanné le code

AwardInfoItemListDéfinition

Nom Nom du prix renvoyé, tel que des pièces M, des points de divertissement numérique, etc. TypeNuméroCode de récompense tel que 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, etc. ingNumérohyperlienUrl

Champ

Type

Description

activityId

Number

activityid

typeName

String

Prix nom

Type de récompense : note, individuel, Zhang

prix


Attribuer des points unitaires de valeur


Chaîne
URL de lien hypertexte personnalisé (tel qu'un code QR de réduction, Business sauter, etc.)

hyperlinkDesc

String

Description de la copie du lien hypertexte

Incitatifs d'interface

Description de l'interface :

Obtenez les résultats de la loterie. L'interface utilisateur de l'application est affichée par CP.

PRÉcondition:

Requires Authorization, si elle n'est pas autorisée, un code d'erreur non autorisé sera retourné prototype de fonctionnement: Public Static void getLotteryResultWithPermission (String EventKey, String ConfirmKey, String BehaviorKey, ireceiveAwardResulTListener Écouteur)

Description du paramètre

 : eventKey : mot-clé d'activité correspondant

listener : l'identifiant du résultat de la loterie est renvoyé à l'auditeur et le bit de données est renvoyé ActivityAwardModel

behaviorKey (facultatif) : nom de clé de la loterie comportementale

confirmKey (facultatif) ) : Confirmez la clé secrète. Cette clé secrète est une chaîne de clé secrète que CP obtient d'Alibaba et la calcule ensuite via un algorithme. Veuillez vous référer à la démo pour l'algorithme de clé secrète. Pour des raisons de sécurité de l'algorithme, cette clé de confirmation doit être générée par le serveur cp et renvoyée au client.

Exemple de demande

 :

AliTvSdk.Lottery.getLotteryResultWithPermission (eventKey, String confirmKey, new IReceiveAwardResultListener() {
      @Override
      public void onResult(ActivityAwardModel activies) {
            if(model != null){
                    if(model.isResult()){
                ActivityAwardItem item = model.getAward();
                           //提示中奖
                  }else{
                     //未中奖                     
            }
//数娱积分/金牌余额
int totalAmount = model.getTotalAmount());
//可用抽奖次数(免费)
int accessAmount = model.getAccessAmount());
          }else{//未中奖
       }
 
      }
      
      @Override
      public void onError(int errCode, String errMsg) {
      }
});

Description du retour :

isLucky Booléen Que le prix soit gagné, vrai signifie gagner, faux signifie ne pas gagneractivityAwardItemActivityAwardItemGagnant : veuillez voir ci-dessous totalAmountLongPoints restants de l'utilisateuraccessAmountIntTemps de tirage gratuits restants pour l'utilisateur

ActivityAwardItem définition :

Nom

Type

Description

Non gagnant : vide

S'il s'agit d'un nombre négatif, c'est une valeur invalide

code attribué Unité de récompense Remarque, individuel, Zhang Attribuez des points unitaires de valeurBrève description du prix

Field

Type

Description

activityId

Numéro

ID d'activité

Nom

String

Nom du prix

Id

Numéro

ID du prix

typeName

String

Le nom de la récompense renvoyé UTypemnumber

tel que 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, etc. de récompense types

Unité


Chaîne

Prix

Numéro

simpleDesc

String

fullDesc

String

Description complète des types de récompenses

hyperlinkUrl

String

URL de lien hypertexte personnalisé (tel qu'un code QR de réduction, un saut commercial, etc.)

hy perlinkDesc

String

Description de la copie du lien hypertexte

Incitatifs à la consommation

Prérequis : Envoyer les exigences de configuration à la personne chargée de l'interface d'exploitation du divertissement numérique, et la configuration de l'arrière-plan du divertissement numérique prendra effet. Aucune station d'accueil pour l'application requise

Méthode d'accès :

Payez normalement

Les récompenses retournées peuvent être configurées pour des produits spécifiques, sans aucune configuration ni interface utilisateur requise par la partie d'accès. Toutes les configurations et tous les affichages sont mis en œuvre par Digital Entertainment après le paiement. Les types de prix qui peuvent être distribués sont les suivants (les utilisateurs doivent se connecter pour payer)

1 Prix virtuel :
  • Prix sur plateforme : points du centre commercial, packs cadeaux App
  • Prix hors plateforme : Jifenbao, enveloppes rouges , bons d'achat, pièces d'or, points Tmall, billets de cinéma, billets de loterie ; utilisateurs
2 prix physiques :
  • Prend en charge les articles physiques des magasins Tmall ou Taobao
  • Prend en charge les articles physiques sans magasins Tmall ou Taobao