loyalty-station-android-sdk
简介
Gamiphy Loyalty & Rewards是一款专为电子商务设计的游戏化忠诚度计划插件/小部件。您将能够通过在您的商店完成预定义的“挑战”来奖励用户积分。除此之外,用户还可以在排行榜上与其他用户竞争、获得徽章和邀请他们的朋友,以及其他游戏化特性。
要求
- iOS 9.0+ / macOS 10.10+
- Xcode 9.0+
- Swift 4+
安装
Gamiphy Loyalty Station可以通过CocoaPods获得。要安装,只需将以下行添加到您的Podfile中:
pod 'LoyaltyStation'
入门
Gamiphy SDK需要在应用程序类中初始化,您可以通过如下方式调用init方法,并传递在Gamiphy注册账号后获取的一些必需数据和参数。请注意下面的initialize方法。
LoyaltyStation
//Set app id (required)
.setApp(app: String?)
//Set user data (optional)
.setUser(
user: User(
//User id (required)
id: String,
//User first name (required)
firstName: String,
//User last name (required)
lastName: String,
//User country (required)
country: String?,
//User referral (optional) - Check referral section
referral: UserReferral(
//User referrer id (required)
referrer: String
),
//User hmac hash result (required)
hash: String
)
)
//Gamiphy custom agent key (optional)
.setAgent(agent: String)
//Preferred language to show (optional)
.setLanguage(language: String)
//Open within sandbox (optional)
.setSandbox(sandbox: Bool)
//Start initialization
.initialize()
要打开机器人,使用以下行。
LoyaltyStation.open(on: self)
小部件访客流程
Gamiphy忠诚度站支持最终用户导航不同功能,即使未登录也可以。但每当用户尝试执行操作时,系统会自动将其重定向到登录或注册应用程序界面。您需要指定用户可以在其中登录/注册的应用活动。在widget中点击sign Up/login时调用OnAuthTrigger方法。isSignUp为true时,将进行注册重定向;isSignUp为false时,将进行登录重定向。
在登录活动中,用户登录后,设置用户名和电子邮件并启动gamiphy视图。
LoyaltyStation.login(
user: User(
//User id (required)
id: String,
//User first name (required)
firstName: String,
//User last name (required)
lastName: String,
//User country (required)
country: String?,
//User referral (optional) - Check referral section
referral: UserReferral(
//User referrer id (required)
referrer: String
),
//User hmac hash result (required)
hash: String
)
)
推荐计划集成
忠诚度站通过Firebase动态链接支持用户推荐。 Gamiphy系统为每个用户生成一个动态链接。此链接包含原始用户的推荐ID。要获得推荐系统的好处,您需要将动态链接参数传递给忠诚度站SDK。从那里SDK将处理。
解析动态链接
按照Firebase官方文档解析动态链接并读取所需的参数。您可以在此处查看这里。
传递引用参数
您需要从动态链接中读取 ls-referrer
参数并将其传递给用户.referral.referrer 下的忠诚度站。