인센티브 구성 인터페이스

인센티브 복권 인터페이스의 데모는 LotteryActivity.java에 있습니다.

사업 설명

복권 방법:

다음 복권 방법을 지원합니다

1. : 즉, 사용자는 무료로 복권에 참여할 수 있습니다

2. 소비 복권: 즉, 복권을 위해서는 쇼핑몰 포인트를 소비해야 합니다

3. 혼합 복권: 먼저 무료 복권을 사용하고 자유 시간이 사용된 후 소비 복권을 사용합니다. up

4. 소비 복권 : 사용자가 상품을 구매하는 경우 설정된 확률에 따라 경품을 돌려받을 수 있음(APP 도킹 없이 구현 가능)

복권 전략 :

확률 복권 : 복권 구성 일정 확률로

경품 설명:

1) 가상 상품

모은 보너스, 빨간 봉투(모든 네트워크 또는 지정 상품), 상품권, 금화, Tmall 포인트, 쇼핑몰 포인트, 영화 티켓, 복권, APP 선물 팩

2) 실제 경품

무료 제품: 실제 경품은 Tmall/Taobao 매장 유무에 관계없이 제공될 수 있습니다.

할인 제품: 사용자는 QR 코드를 스캔하여 할인 제품을 구매할 수 있습니다. 할인율은 백그라운드에서 구성할 수 있습니다.

기타 지침:

1) eventKey

는 복권을 만족시키는 이벤트를 정의하는 데 사용됩니다. 각 eventKey는 인센티브 배경에 따라 구성됩니다. 앱은 일반적으로 설치 패키지를 업데이트해야 합니다.

2) 인센티브 백엔드

• 인센티브 백엔드는 앱의 필요에 따라 해당 복권 활동을 구성할 수 있으며 각 활동은 eventKey에 해당합니다.
• 복권 만료 후, APP에서 복권을 위해 eventKey를 다시 호출하더라도 당첨되지 않습니다.
• 한 APP에 여러 개의 복권 활동이 있는 경우 여러 개의 eventKey를 생성해야 하며, 동일한 eventKey의 복권 이벤트 시간이 겹칠 수 없습니다.
• 소비 복권의 경우 APP 구성만 제출하면 됩니다.

인센티브 정보 목록 가져오기

인터페이스 설명:

복권 활동 정보 목록 가져오기, 활동 정보 표시 또는 다음을 수행하세요. 리스너의 결과에 따라 해당 처리가 수행됩니다.

반환되는 데이터에는 복권 유형, 복권에서 소비된 포인트, 무료 추첨 횟수 등이 포함됩니다.

전제조건:

없음

함수 프로토타입:

public static void getActivitesInfo(String eventKey, IReceiveActivitesListener Listener)

매개변수 설명:

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

반품 설명

consumeAmountaccess AmountluckyType

Name	Type	Description
activityId	String	이벤트 ID
fventKey	String	이벤트 키
name	String	활동 이름
startTime	String	이벤트 시작 시간
endTime	String	이벤트 종료 시간
awardInfo ItemList	ActivityInfoAwardItem	활동상 개체 는 보상 목록을 볼 수 있습니다
Int	이벤트는 매번 엔터테인먼트 포인트를 소모합니다	0이면 소모되지 않습니다
Int	이 이벤트의 무료 추첨 횟수
Int	복권 유형 무료 복권: 1 소비 복권: 2 혼합 복권: 3
activityUrl	String	CP로 이용 가능한 이벤트 URL로 돌아가기 생산 QR 코드, 사용자가 코드를 스캔하면 H5 페이지가 휴대폰에 표시됩니다

AwardInfoItemListDefinition

#🎜 🎜#

인터페이스 인센티브

인터페이스 설명:

복권 결과를 받으세요. APP의 UI는 CP로 표시됩니다.

전제 조건:

승인이 필요합니다. 승인되지 않은 경우 승인되지 않은 오류 코드가 반환됩니다.

Function 프로토타입:

public static void getLitteryResultWithPermission(String eventKey, String verifyKey, String BehaviorKey, IReceiveAwardResultListener 리스너)

매개변수 설명:

eventKey: 해당 활동 키워드

listener: 복권 결과 ID가 리스너에게 반환되고 데이터 비트가 반환됩니다. ActivityAwardModel

behaviorKey (선택 사항): 행동 복권의 키 이름

verifyKey (선택 사항) ): 비밀 키를 확인합니다. 이 비밀 키는 Alibaba에서 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) {
      }
});

반품 설명:

Field	Type	Description
activityId	Number	activityid
name	String	Award Name
Id	Number	Award ID
typeName	String	수상 이름 M코인, 디지털 엔터테인먼트 포인트 등 반환된 경품 이름
Type	Number	Award code 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 등
amount	Number	상품 금액
Unit	String	시상 유형: 참고, 개인, Zhang
price	Number	시상 가치 단위 포인트
hyperlinkUrl	String	맞춤형 하이퍼링크 URL(할인 QR 코드, 비즈니스 등) 점프 등)
hyperlinkDesc	String	하이퍼링크 설명

Name	Type	설명
isLucky	부울	상금 획득 여부에 따라 true는 우승, false는 우승하지 않음을 의미합니다
activityAwardItem	ActivityAwardItem	당첨: 아래를 참조하세요 당첨되지 않음: 비어 있음
totalAmount	Long	사용자 잔여 포인트 음수이면 유효하지 않은 값입니다
accessAmount	Int	사용자 남은 무료 그리기 시간

ActivityAward항목 정의:

1, 2, 3, 4, 5, 6, 7, 8, 9, 10 등과 같은 코드 수상 단위 비고, 개인, 장 시상 가치 단위 포인트Award 간단한 설명 # 🎜🎜#hyperlinkDescString 전제 조건: 접속 방법:

Field	Type	Description
activityId	번호	활동 ID
이름	String	Award Name
Id	Number	Award ID
typeName	String	반환된 수상명 UTypemnumber
를 받았습니다. 수상의 종류	단위	String
	가격	번호
	simpleDesc	String
	fullDesc	String	수상에 대한 전체 설명
hyperlinkUrl	String	맞춤형 하이퍼링크 URL(예: 할인 QR 코드, 비즈니스 점프 등) # 🎜🎜#
	#🎜 🎜#超체인 설명 🎜🎜#	데이터 엔터테인먼트 운영 인터페이스 담당자에게 구성 요구 사항을 제출하면 데이터 엔터테인먼트 배경 구성이 적용됩니다. 앱 연결 필요 없음

일반 결제

특정 상품에 대해 반품하도록 구성 가능 접속자에게 어떠한 구성이나 UI도 요구하지 않습니다. 모든 구성과 디스플레이는 Digital Entertainment에서 구현합니다. 결제 후 지급할 수 있는 보상은 다음과 같습니다. (결제를 위해서는 로그인이 필요합니다.)

1 가상 상품 : # 🎜🎜# 플랫폼 내 경품: 쇼핑몰 포인트, 앱 선물 팩

플랫폼 외부 경품: Jifenbao, 빨간 봉투, 상품권, 금화, Tmall 포인트, 영화 티켓, 복권 사용자 2 실제 상품:

Tmall 또는 Taobao 매장의 실제 항목 지원

실제 항목 지원 Tmall 또는 Taobao 매장에서# 🎜🎜#