インセンティブ設定インターフェイス


インセンティブ宝くじインターフェイスのデモは、LotteryActivity.java

ビジネスの説明 にあります。

抽選方法:

次の抽選方法をサポートします

1. 無料の抽選: つまり、ユーザーは無料で抽選に参加できます

2. 消費抽選 : モールポイントを消費して抽選する必要があります

3. 混合抽選 : 最初に無料抽選を行い、無料時間がなくなったら消費抽選を行います

4. 消費抽選: ユーザーが商品を購入すると、設定された確率に従って賞品を返すことができます (これを実現するためにアプリをドッキングする必要はありません)

宝くじ戦略:

確率ベースの宝くじ: 一定の確率で宝くじを構成します

賞品の説明:

#1) バーチャルグッズ

九份包、紅包(すべてのネットワークまたは指定商品)、バウチャー、金貨、天猫ポイント、モールポイント、映画チケット、宝くじ、APP ギフト パック

2 ) 物理的賞品

無料製品: 天猫/淘宝網ストアの有無にかかわらず、物理的賞品を発行できます。

割引製品: ユーザーは QR コードをスキャンすることで割引製品を購入できます。割引率はバックグラウンドで設定できます。

その他の指示:

1)eventKey

は、宝くじを満たすイベントを定義するために APP で使用されます。各 EventKey は宝くじアクティビティに対応し、イベントキーがインセンティブのバックグラウンド構成に追加された場合、通常、APP はインストール パッケージを更新する必要があります。

2) インセンティブ背景

    インセンティブ背景は、APP のニーズに応じて対応する宝くじアクティビティを構成でき、各アクティビティはイベントキーに対応します。
  • 抽選の有効期限が切れた後、アプリが抽選のために再度eventKeyを呼び出しても当選しません。
  • APP に複数の宝くじアクティビティがある場合、複数のイベントキーを作成する必要があり、同じイベントキーを持つ宝くじイベント時間が重複することはできません。
  • 消費者向け宝くじの場合、APP 構成は必要ありません。 、エンターテイメント オペレーションの番号に要件を提出し、オペレーションの背景を


#インセンティブ情報リストを取得する#に設定します。 # #インターフェースの説明

:

宝くじアクティビティ情報リストを取得し、アクティビティ情報を表示するか、リスナーで結果に応じて対応する処理を実行します。

返されるデータには、宝くじの種類、宝くじで消費したポイント、無料抽選回数などが含まれます。

前提条件:

なし

関数プロトタイプ

:

public static void getActivitesInfo(String eventKey, IReceiveActivitesListener リスナー)

パラメータの説明

:

eventKey: この ID に対応するアクティビティ情報を取得します。null が渡された場合は、利用可能なすべてのアクティビティの情報を取得します

Listener: アクティビティ情報を返すリスナー。戻り値の型は ActivityInfoModel です。

リクエスト例:

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) {
      }
});

リターンの説明

#fventKeyStringEventKeyname文字列アクティビティ名startTime文字列 アクティビティ開始時刻endTimeStringイベント終了時刻##awardInfoItemListconsumeAmountaccessAmountluckyType

名前

タイプ

説明

アクティビティ ID

文字列

##アクティビティ ID

ActivityInfoAwardItem

イベント賞オブジェクト
賞リストを表示できます

Int

このアクティビティは毎回デジタル エンターテイメント ポイントを消費します
0 の場合は消費しませんConsumption

#Int

無料の数このイベントの抽選

Int

くじ種類

無料くじ: 1

消費くじ: 2

混合くじ: 3

activityUrl

String

使用できるアクティビティ URL を返します。 CP プロダクション QR コードの場合、ユーザーがコードをスキャンした後、携帯電話に H5 ページが表示されます

#AwardInfoItemList定義

#タイプアクティビティID##賞名Number##typeNameタイプ 賞金額 アワードユニット 注、個人、Zhang 賞品価値単位ポイント #hyperlinkUrlStringカスタム ハイパーリンク URL (割引 QR コード、ビジネス ジャンプ、等。)###

インターフェース インセンティブ

インターフェースの説明:

宝くじの結果を取得します。 APP内のUIはCPで表示されます。

前提条件:

承認が必要、承認されていない場合は、未承認のエラー コードが返されます

関数プロトタイプ

public static void getLotteryResultWithPermission(StringeventKey, StringconfirmKey, String BehaviorKey, IReceiveAwardResultListener リスナー)

パラメータの説明:

eventKey : 対応するアクティビティ キーワード

listener: 抽選結果 ID がリスナーに返され、データ ビットが返されます。 ActivityAwardModel

behaviorKey (オプション): 行動抽選のキー名

confirmKey (オプション): 秘密キーを確認します。この秘密鍵はCPがアリババから取得した秘密鍵文字列をアルゴリズムで計算したもので、秘密鍵のアルゴリズムについてはデモを参照してください。アルゴリズムのセキュリティのため、この確認キーは cp サーバーによって生成され、クライアントに送り返される必要があります。

#リクエスト例:

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) {
      }
});

リターンの説明:

#フィールド

##説明

#番号

アクティビティID

名前
文字列

##ID

賞 ID

##String
賞品タイプ名

返される賞品名 (M コイン、デジタル エンターテイメント ポイントなど)。


番号
賞コード

1、2、3、4、5、6、7、8、9、10 年生など

#金額


番号

#ユニット

文字列

価格

番号

#hyperlinkDesc

String

ハイパーリンクのコピーの説明

#isLucky#activityAwardItem不当選: 空です##Longマイナスの場合は無効な値です Int

名前

タイプ

##説明

Boolean

賞品を獲得するかどうか、true は勝ち、false はそうでないことを意味します勝利

ActivityAwardItem

勝利: 以下を参照

#合計金額

#ユーザー残りポイント

アクセス量

ユーザーの残りの無料ドローの数

ActivityAwardItem 定義:

##番号アクティビティid名前文字列賞名Id番号賞IDtypeNameString返された賞名 #タイプ 1、2など、3、4、5、6、7、8、9、10 など##金額文字列 アワードユニットメモ、個人、ZhangNumbersimpleDesc 文字列完全な説明文字列
##フィールド

タイプ

説明

アクティビティID

番号

特典コード


Number

#受賞数

##単位

##価格

##付与バリューユニットポイント

賞の簡単な説明

#賞の詳細な説明

hyperlinkUrl

String

カスタマイズされたハイパーリンク URL (割引 QR コード、ビジネス ジャンプなど)

hyperlinkDesc

文字列

ハイパーリンクのコピーの説明

##消費インセンティブ

前提条件:

データ エンターテイメントの操作インターフェイス担当者に構成要件を送信すると、データ エンターテイメントのバックグラウンド構成が有効になります。 APP ドッキングは不要

アクセス方法:

通常の支払い

アクセス パーティを必要とせず、特定の製品に対して返される報酬を設定できます。設定とUI、すべての設定と表示はデジタルエンターテインメントによって実装されています 支払い後に発行できる賞品は次のとおりです(支払いにはユーザーがログインする必要があります)

1 バーチャル賞品:


プラットフォーム内賞品: モール ポイント、アプリ ギフト パック
  • プラットフォーム外賞品: 九份包、紅包、商品券、金貨、天猫ポイント、映画チケット、宝くじ、ユーザー
  • 2 物理的賞品:

天猫または淘宝網ストアの物理的商品をサポート
  • 天猫または淘宝網ストアのない物理的商品をサポート