优惠券服务

优惠券服务，是当用户输入在 IGAW 优惠券服务中领取的优惠券时给予用户奖励。

优惠券服务详细说明，请通过以下链接确认。

[优惠券服务指南]

注意事项

1. 集成优惠券 add-on 之前，必须先进行 IGAW 共同集成。 [IGAW 共同集成 : Unity Android]
2. 为了集成优惠券，需将 IgawCoupon~*.jar 文件包含在Unity Project 里。[SDK 安装 : Unity]

优惠券 API

为了使用优惠券服务，需要利用下面的API进行集成。

输入用户识别码

用户识别码，是为了辨别完成活动的用户和发放奖励时所使用的信息。

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

    注意事项

1. 1名用户需有1个固定的用户识别码，不可使用可变的值。
2. 个人信息不可包含(电子邮件，姓名，电话号码，可辨认的用户ID)等信息。
3. 包含中文、韩文、特殊字符、空白等情况时，需进行URL Encoding处理后才能使用。
4. 需在用户输入优惠券号码之前进行设定。

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

IgaworksUnityPluginAOS.Common.setUserId("user10001");

显示优惠券

使用优惠券服务时需要具备用户可以输入优惠券号码的界面。优惠券号码输入窗口的构成方法如下。

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

输入界面的构建方式有两种，使用优惠券 SDK 中提供的输入界面，或直接构建输入界面的方法。请根据以下内容进行集成。

使用优惠券 SDK 构建输入界面

调用 showCouponDialog API 显示输入窗口，各参数的说明和使用范例如下。

• showResultToast : 优惠券使用结果信息是否以Toast显示，true or false

IgaworksUnityPluginAOS.Coupon.showCouponDialog(true);

直接构建输入界面

使用 checkCoupon API 以参数形式传达用户输入的优惠券号码，并返回(return)结果。

以下示例的 "优惠券号码" 部分中，用户输入的优惠券号码以 string 形式传达。

IgaworksUnityPluginAOS.Coupon.checkCoupon ("优惠券号码");

Delegate

对于输入的优惠券，提供可以接收优惠券处理结果的 delegate 函数。

• OnSendCouponSucceed : 优惠券使用成功 delegate
• OnSendCouponFailed : 优惠券使用失败 delegate

如下登录和实现 delegate

public class MySampleScene : MonoBehavior {								
 									
    void Start () {								
        // 登录成功使用优惠券delegate							
	IgaworksUnityPluginAOS.OnSendCouponSucceed = mOnSendCouponSucceed;													
        //登录优惠券使用失败 delegate							
	IgaworksUnityPluginAOS.OnSendCouponFailed = mOnSendCouponFailed;						
    }								
									
    void mOnSendCouponSucceed (string msg, int itemKey, string itemName, long quantity) {				
    	//msg : 优惠券使用结果
        //itemKey : 使用的优惠券中支付的虚拟货币key, Deprecated							
	//itemName : 使用的优惠券中需支付的虚拟货币
        //quantity : 使用的优惠券价值
    }								
									
    void mOnSendCouponFailed (string msg) {								
        //msg : 优惠券使用结果							
    }								
}

IGAW 奖励服务器集成

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

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

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

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