로딩중입니다
[AOS] 优惠券集成 : Native Android
9/1/2015 5:38:58 PM

优惠券服务

通过 IGAW 优惠券服务,可以发放优惠券号码。当用户使用优惠券号码时,可以兑换相应的奖励。

查看以下链接详细了解优惠券服务。

[优惠券服务指南]


注意事项
  1. 集成优惠券 add-on 前,必须先完成 IGAW 共同集成。 [IGAW 共同集成 : Android]
  2. 为了集成优惠券,须将 IgawCoupon~*.jar 文件包含在 Android Project 内。 [SDK 安装 : Android]



优惠券 API

为了使用优惠券服务,使用以下 API 进行集成。


输入用户识别码

用户识别码的作用是为了判断用户是否完成广告参与,并向用户支付奖励。

用户识别码必须在用户输入优惠券号码前进行设置。


    注意事项

  1. 每一个用户只有一个固定的用户识别码,不可使用变量。
  2. 不可包含个人信息(有邮箱,姓名,电话,可识别的ID等)。
  3. 如需使用中文,韩文,空白等字符时,需对URL进行编码。
  4. 在用户输入优惠券号码之前,必须进行设置。

请留意以上注意事项,输入用户识别码。

IgawCommon.setUserId("user10001");

  


优惠券曝光

需要用户输入优惠券号码的 UI。 输入优惠券号码的输入窗的设定方法如下

  • 使用 优惠券 SDK
  • 直接构建

可以使用优惠券 SDK 提供的 UI,或者直接构建 UI 的方法进行。


使用优惠券 SDK 时

调用 showCouponDialog API,曝光输入窗。以如下关于各参数的示例及内容。

  • showResultToast : 优惠券使用结果信息是否在 Toast 上曝光,true or false 
  • ValidationResultModel  : 将 showResultToast 设置为 false 时,通过 ValidationResultModel Type 的 ValidationResultModel[i] 排列传达,排列中包含的信息如下。   
    • ValidationResultModel.getResult() : 优惠券使用结果
    • ValidationResultModel.getMessage() : 优惠券使用结果信息
    • ValidationResultModel.getItemKey() : 优惠券 item Key
    • ValidationResultModel.getItemName() : 优惠券 item 名称
    • ValidationResultModel.getQuantity() : 支付给用户的虚拟货币数量
 IgawCoupon.showCouponDialog(MainActivity.this, false, new CouponCallbackListener() {
            
	@Override
	public void run(Dialog dialog, ValidationResultModel CouponResult) {

	//将 showResultMsgToast 设置为 false 时,在这里 return 优惠券使用结果。
	//使用优惠券后执行的动作 (ex. 展示 item 确认通知,移动至商店,更新 item 目录)
	Log.d(tag, "showCouponDialog.Result ::: " + CouponResult.getResult());
	Log.d(tag, "showCouponDialog.Message ::: " + CouponResult.getMessage());
	Log.d(tag, "showCouponDialog.ItemKey ::: " + CouponResult.getItemKey());
	Log.d(tag, "showCouponDialog.ItemName ::: " + CouponResult.getItemName());
	Log.d(tag, "showCouponDialog.Quantity ::: " + CouponResult.getQuantity());

	}
});


使用直接构成的 UI 时

使用 checkCoupon API,通过参数传达用户输入的优惠券号,再返回结果。

以下示例中在 {优惠券号码} 部分通过 String 传达用户输入的优惠券号码。

IgawCoupon.checkCoupon(YourActivity.this, "{优惠券号码}", new CouponCallbackListener() {

	@Override
	public void run(Dialog dialog, ValidationResultModel CouponResult) {

	//将 showResultMsgToast 设置为 false 时,在这里 return 优惠券使用的结果
	//使用优惠券后执行的动作 (ex. 展示 item 确认通知,移动至商店,更新 item 目录)
	Log.d(tag, "showCouponDialog.Result ::: " + CouponResult.getResult());
	Log.d(tag, "showCouponDialog.Message ::: " + CouponResult.getMessage());
	Log.d(tag, "showCouponDialog.ItemKey ::: " + CouponResult.getItemKey());
	Log.d(tag, "showCouponDialog.ItemName ::: " + CouponResult.getItemName());
	Log.d(tag, "showCouponDialog.Quantity ::: " + CouponResult.getQuantity());

	}
});



IGAW 奖励服务器集成

为了给输入优惠券号码的用户支付奖励,必须先完成 IGAW 奖励服务器。

优惠券服务仅支持开发商通过自己的服务器来接入奖励服务器的方式。

请通过以下链接,了解 IGAW 奖励服务器集成详情。 

[IGAW 奖励服务器集成指南]