方舟智能分析
产品功能SDK指南API
搜索
⌃K
Links

iOS SDK

iOS SDK 适用于 iOS 原生 App，集成前请先下载 SDK

iOS SDK 使用说明

SDK Releases包下载： Github地址(推荐)：https://github.com/analysys/ans-ios-sdk/releases Gitee地址：https://gitee.com/Analysys/ans-ios-sdk/releases Releases中含有更新说明请您阅读，接口使用请参考本文档。
framework
功能描述
是否必选
服务端版本
AnalysysAgent.bundle
配置文件
必选
全部
AnalysysAgent.framework
基础模块
必选
全部
AnalysysVisual.framework
可视化热图模块
可选
热图模块适用方舟V4.3.0及以上
AnalysysPush.framework
推送模块
可选
全部
AnalysysEncrypt.framework
加密模块
可选
全部
请您根据自身业务需求来引用相关的SDK。

快速集成

如果您是第一次使用易观方舟产品，可以通过阅读本文快速了解此产品

1. 选择集成方式

  • Cocoapods
  • 手动引入

2. 配置 Xcode

若使用手动集成方式，需引入部分类库

3. 设置初始化接口

通过初始化接口配置您的AppKey，配置Channel

4. 设置上传地址

通过setUploadURL:接口设置您上传数据的地址。

5. 设置采集页面或事件

通过手动埋点，设置需要采集的页面或事件。

6. 打开Debug模式查看日志

通过设置Debug模式，开/关 log 查看日志。
通过以上6步您即可验证SDK是否已经集成成功。更多接口说明请您查看API文档。

集成配置

Cocoapods集成

  1. 1.
    安装CocoaPods
  2. 2.
    工程目录下创建Podfile文件，并添加pod 'AnalysysAgent'，示例如下：
platform :ios, '8.0'
use_frameworks!
​
target 'YourApp' do
pod 'AnalysysAgent'
end
3. 关闭Xcode，在工程目录下执行pod install或pod install --verbose --no-repo-update，完成后打开xxx.xcworkspace工程

手动导入集成

  1. 1.
    选择 工程 - 右键 - Add Files to "ProjectName"
  2. 2.
    选择 AnalysysAgent.framework文件
  3. 3.
    勾选 Copy items if needed、Create groups- Add 完成添加类库
  4. 4.
    添加AnalysysAgent.bundle资源文件：Targets->ProjectName -> Build Phases -> Copy Bundle Resources -> 添加文件
Xcode配置
swift 集成配置
  • 若使用手动集成，请添加如下依赖框架：
    选择工程 - Targets - “项目名称” - Build Phase - Link Binary With Libraries 依赖库如下：
类库
用途
AdSupport.framework
广告标识
CoreTelephony.framework
运营商信息
SystemConfiguration.framework
网络状态
libz.tbd
数据压缩（Xcode7以下:libz.dylib）
libicucore.tbd
websocket可视化连接
libsqlite3.tbd
数据存储
  • 为支持SDK中category，请在Targets - “项目名称” - Build Settings - Other Linker Flags，添加-ObjC选项（注意大小写）
若使用 Swift 语言工程开发集成，则除上述配置外还需要添加桥接文件，该文件可以使用以下两种方式之一创建：
  • 在工程中添加 XXX-Bridging-Header.h 文件（XXX为工程名称），并在 Build Setting - Objective-C Bridging Header 中添加桥接文件路径。
  • 在工程中创建 Objective-C 文件，系统会提示是否创建桥接文件，选择创建即可生成桥接文件
创建完成之后，在 XXX-Bridging-Header.h 文件并引入类库：
#import <AnalysysAgent/AnalysysAgent.h>

基础模块介绍

以下接口生效依赖于基础SDK模块，需集成基础SDK相关AnalysysAgent.framework文件，请正确集成。

初始化接口

  • Objective-C 代码示例
  • 请确保初始化SDK在 (BOOL)application:(UIApplication )application didFinishLaunchingWithOptions:(NSDictionary )launchOptions中主线程初始化
在Xcode工程文件~AppDelegate.m 中导入头文件"#import <AnalysysAgent/AnalysysAgent.h>"。接口如下：
+ (AnalysysAgent *)startWithConfig:(AnalysysAgentConfig *)config;
AnalysysAgentConfig 类为配置信息类。参数如下：
  • appKey：在网站获取的 AppKey
  • channel：应用下发渠道
  • autoProfile：设置是否追踪新用户的首次属性。默认：YES
  • autoInstallation：是否开启渠道追踪功能。默认值：NO
  • autoTrackDeviceId：是否上报设备标识。默认值：NO
  • encryptType：设置数据上传时的加密方式，目前只支持 AES 加密，AES 加密分为AnalysysEncryptAES（128位密钥，ECB 加密模式）和 AnalysysEncryptAESCBC128（128位密钥，CBC 加密模式）；如不设置此参数，数据上传不加密。
  • allowTimeCheck：是否允许时间校准，默认值：NO
  • autoTrackCrash：是否允许崩溃追踪，默认值：NO
  • maxDiffTimeInterval：最大允许时间误差，单位：秒，默认值：30秒
  • autoPageViewDuration：是否自动采集页面时长
示例：
// 导入SDK
#import <AnalysysAgent/AnalysysAgent.h>
​
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 设置key，77a52s552c892bn442v721为样例数据，请根据实际情况替换相应内容
// AnalysysAgent 配置信息
AnalysysConfig.appKey = @"77a52s552c892bn442v721";
// 设置渠道
AnalysysConfig.channel = @"App Store";
// 设置追踪新用户的首次属性
AnalysysConfig.autoProfile = YES;
// 设置上传数据使用AES加密，需添加加密模块
// AnalysysConfig.encryptType = AnalysysEncryptAES;
// 设置渠道追踪
// AnalysysConfig.autoInstallation = YES;
// 是否上报设备标识
// AnalysysConfig.autoTrackDeviceId = YES;
// 设置服务器时间校验
// AnalysysConfig.allowTimeCheck = YES;
// 设置时间最大允许偏差为5分钟
// AnalysysConfig.maxDiffTimeInterval = 5 * 60;
// 使用配置初始化SDK
[AnalysysAgent startWithConfig:AnalysysConfig];
// 4.4.5之后需要将以下设置放置到初始化后，否则可能无法正常上报
#ifdef DEBUG
[AnalysysAgent setDebugMode:AnalysysDebugButTrack];
#else
[AnalysysAgent setDebugMode:AnalysysDebugOff];
#endif
​
// 设置上传地址
[AnalysysAgent setUploadURL:@"https://url:port"];
​
return YES;
}
​
  • Swift代码示例
在桥接文件中导入类库 #import <AnalysysAgent/AnalysysAgent.h>，并在 ~AppDelegate.m 中配置。
示例:
import AnalysysAgent
​
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
// AnalysysAgent 配置信息
AnalysysAgentConfig.shareInstance()?.appKey = "77a52s552c892bn442v721"
AnalysysAgentConfig.shareInstance()?.channel = "App Store"
//AnalysysAgentConfig.shareInstance()?.autoProfile = true
//AnalysysAgentConfig.shareInstance()?.autoInstallation = true
//AnalysysAgentConfig.shareInstance()?.autoTrackDeviceId = true
//AnalysysAgentConfig.shareInstance()?.allowTimeCheck = true
//AnalysysAgentConfig.shareInstance()?.maxDiffTimeInterval = 5 * 60
// 使用配置信息初始化SDK
AnalysysAgent.start(with: AnalysysAgentConfig.shareInstance())
// 4.4.5之后需要将以下设置放置到初始化后，否则可能无法正常上报
#if DEBUG
AnalysysAgent.setDebugMode(.butTrack)
#else
AnalysysAgent.setDebugMode(.off)
#endif
AnalysysAgent.setUploadURL("https://url:port")
​
}
默认 SDK 为非调试模式，不能查看日志，若要查看日志请调用 setDebugMode: 方法设置。请在正式发布 App 时使用 AnalysysDebugOff 模式！

设置上传地址

自定义上传地址，接口设置后，所有事件信息将上传到该地址。接口如下：
+ (void)setUploadURL:(NSString *)uploadURL;
  • uploadURL：数据上传地址，格式为 scheme://host + :port(不包含 / 后的内容)。scheme 必须以 http:// 或 https:// 开头，host 只支持域名和 IP，取值长度为1-255个字符，port 端口号必须携带
示例：
// 设置自定义上传地址为`scheme://host + :port`
[AnalysysAgent setUploadURL:@"/*设置为实际地址*/"];
Swift示例:
AnalysysAgent.setUploadURL("/*设置为实际地址*/")

Debug 接口

Debug 接口主要用于开发者测试。可以开/关日志，查看tag为[analysys]的Log日志。接口如下：
+ (void)setDebugMode:(AnalysysDebugMode)debugMode;
  • debugMode：debug 模式，默认关闭状态。注意：发布版本时 debugMode 模式设置为 AnalysysDebugOff。
    • AnalysysDebugOff：表示关闭
    • AnalysysDebugOnly：表示打开 Debug 模式，但该模式下发送的数据仅用于调试，不计入平台数据统计
    • AnalysysDebugButTrack：表示打开 Debug 模式，该模式下发送的数据可计入平台数据统计
示例：
[AnalysysAgent setDebugMode:AnalysysDebugOff];
Swift代码示例:
AnalysysAgent.setDebugMode(.off)

App启动来源监测

此接口需在SDK初始化前进行设置
+ (void)monitorAppDelegate:(id<UIApplicationDelegate>)delegate launchOptions:(NSDictionary *)launchOptions;
  • delegate：遵循UIApplicationDelegate的对象，iOS默认为AppDelegate类
  • launchOptions：启动参数
参数
说明
icon
点击图标启动
msg
点击通知
url
URL唤醒
3D
3D touch
0（默认）
其他，如home键切换、后台热启动
示例：
#import <AnalysysAgent/AnalysysAgent.h>
​
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
​
/*** 请在初始化易观SDK前调用 ***/
// 启动方式监测
[AnalysysAgent monitorAppDelegate:self launchOptions:launchOptions];
​
// 易观SDK初始化代码
// .....
​
return YES;
}
​
Swift代码示例:
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
​
/*** 请在初始化易观SDK前调用 ***/
// 启动方式监测
AnalysysAgent.monitorAppDelegate(self, launchOptions: launchOptions)
// 易观SDK初始化代码
// ....
return true
}
​

统计页面接口

页面跟踪，SDK 默认设置跟踪所有页面(继承自UIViewController的控制器)，支持自定义页面信息。接口如下:
+ (void)pageView:(NSString *)pageName;
​
+ (void)pageView:(NSString *)pageName properties:(NSDictionary *)properties;
  • pageName：页面标识，为字符串，取值长度 1 - 255 字符
  • properties：页面信息，K-V键值对。最多包含100条，且key是以字母开头的字符串，必须由字母、数字、下划线组成，字母不区分大小写，不支持乱码、中文、空格等，长度范围1-99字符；value 支持类型：NSString/NSNumber/NSArray<NSString *>/NSSet<NSString *>/NSDate/NSURL，若为字符串，取值长度为1-255个字符。
示例1：
// 正在开展某个活动，需要统计活动页面
[AnalysysAgent pageView:@"活动页"];
示例2：
// 访问手机活动页面，活动页面内容为优惠出售iPhone手机，手机价格为5000元
NSDictionary *properties = @{@"commodityName": @"iPhone", @"commodityPrice": @5000};
[AnalysysAgent pageView:@"商品页" properties:properties];
Swift代码示例：
let properties = ["commodityName": "iPhone", "commodityPrice": 5000] as [String : Any]
AnalysysAgent.pageView("商品页", properties: properties)

​

打开/关闭自动采集页面

自动采集页面信息开关，打开时自动记录用户访问的页面。默认为打开状态。接口如下：
+ (void)setAutomaticCollection:(BOOL)isAuto
  • isAuto：开关值，默认为YES打开，设置NO为关闭
示例：
// 关闭页面自动采集
[AnalysysAgent setAutomaticCollection:NO];
Swift代码示例:
必须使用 包名.类名
AnalysysAgent.setAutomaticCollection(false);

忽略部分页面自动采集

开发者可以设置某些页面不被自动采集，设置后自动采集时将会忽略这些页面。接口如下:
+ (void)setPageViewBlackListByPages:(NSSet<NSString *> *)controllers;
  • controllers：需要忽略的控制器名称，字符串数组。
示例：
// 忽略页面'NextViewController'自动采集
[AnalysysAgent setPageViewBlackListByPages:[NSSet setWithObject:@"NextViewController"]];
Swift代码示例:
必须使用 包名.类名
AnalysysAgent.setPageViewBlackListByPages(["packageName.NextViewController"]);

页面自动采集添加自定义信息

若用户开启页面自动采集功能，可将自定义页面信息添加至$pageview事件中。SDK对外提供一个协议<ANSAutoPageTracker>供继承至UIViewController的类使用，若类遵循该协议，则须实现registerPageProperties方法，并将自定义参数返回，SDK会将此部分信息添加至$pageview事件的自定义参数中，且自定义参数优先级高于自动采集参数（即：相同key情况下，用户key会覆盖自动采集key）。
  • 前提：页面自动采集功能未手动关闭
  • 自定义参数只能获取页面生命周期viewDidAppear:及之前的参数，之后参数无法获取到。如：需要添加页面标题，但标题是通过网络请求获取，但响应时间较长，晚于页面生命周期viewDidAppear:才返回标题信息，则该信息无法添加至自动采集的页面属性中。
/**
* @protocol
* 页面自动采集协议
*
* @abstract
* 当页面开启自动采集时，追加页面自定义参数
*
* @discussion
* 继承至UIViewController的子类，若遵循该协议，可将自定义页面的属性信息增加至$pageview事件中
*/
@protocol ANSAutoPageTracker <NSObject>
​
@optional
- (NSDictionary *)registerPageProperties;
​
/** 自定义页面标识，返回信息将覆盖$url字段 */
- (NSString *)registerPageUrl;
​
@end
​
示例：
/** 若使用SDK自动采集功能，且需要添加页面自定义参数，遵循protocol <ANSAutoPageTracker>*/
@interface PageDetailViewController ()<ANSAutoPageTracker>
​
@end
​
@implementation PageDetailViewController
​
/**
实现ANSAutoPageTracker协议
​
@return 页面自定义参数信息
*/
- (NSDictionary *)registerPageProperties {
// $title为自动采集使用key，用户可覆盖
// 增加商品标识(productID)
return @{@"$title": @"详情页"};
}
​
/**
页面$url字段，将覆盖SDK默认字段
​
@return 页面标识
*/
- (NSString *)registerPageUrl {
return @"HomePage";
}
​
@end
Swift代码示例:
class PageDetailViewController: UIViewController, ANSAutoPageTracker {
func registerPageProperties() -> [AnyHashable : Any]! {
return ["$title": "详情页", "$url": "/homepage/detailpage", "productID": "1001"]
}
func registerPageUrl() -> String! {
return "DetailPage"
}
}

统计事件接口

用户行为追踪，可以设置自定义属性。接口如下：
+ (void)track:(NSString *)event;
​
+ (void)track:(NSString *)event properties:(NSDictionary *)properties;
  • event：自定义事件ID标识，以字母开头的字符串，必须由字母、数字、下划线组成，$ 开头为预置事件/属性，不支持乱码、中文、空格等，长度范围1-99字符。
  • properties：自定义属性，K-V键值对，用于对事件描述。最多包含100条，且key是以字母开头的字符串，必须由字母、数字、下划线组成，字母不区分大小写，不支持乱码、中文、空格等，长度范围1-99字符；value 支持类型：NSString/NSNumber/NSArray<NSString *>/NSSet<NSString *>/NSDate/NSURL，若为字符串，取值长度为1-255个字符。
    ​
示例：
// 收藏事件
[AnalysysAgent track:@"collect"];
​
....
​
// 用户购买手机
NSMutableDictionary *properties = [NSMutableDictionary dictionary];
properties[@"type"] = @"Phone";
properties[@"name"] = @"iPhone XS Max";
properties[@"money"] = [NSNumber numberWithFloat:9599.0];
properties[@"count"] = @1;
[AnalysysAgent track:@"pay" properties:properties];
Swift代码示例:
let properties = ["type": "Phone",
"name": "iPhone XS Max",
"money": 9599.0,
"count": 1] as [String: Any]
AnalysysAgent.track("pay", properties: properties)

匿名ID与用户关联

用户关联的主要作用是打通用户登录前后的行为，以及多屏登录后的行为。做过用户关联的用户在登录前后的行为在方舟系统里面会被认为是一个用户。方舟系统目前支持 一台设备只能绑定一个用户 ID，一个用户 ID 只能绑定一台设备。设备和用户 ID 绑定后，就无法再和其他用户或者设备进行绑定。例如一个用户的设备 ID 是 ABC 用户的登录 ID 是 123，绑定成功后会对应同一个 ID，这样在统计或者分析时会被认为是一个用户。在用户注册成功或者登录成功后客户端需要调用 alias 接口，建议埋点时观看下 方舟 SDK 接入视频 接口描述如下：
用户 id 关联接口。将需要绑定的用户ID 和匿名ID进行关联，计算时会认为是一个用户的行为。接口如下：
+ (void)alias:(NSString *)aliasId;
  • aliasId：需要关联的用户ID。 取值长度为1-255个字符
示例：
// 登陆账号时调用，只设置当前登陆账号即可和之前行为打通
[AnalysysAgent alias:@"sanbo"];
Swift代码示例：
AnalysysAgent.alias("zhangsan")

匿名ID设置

唯一匿名ID标识设置，接口如下：
+ (void)identify:(NSString *)xwho;
  • distinctId：自定义设备身份标识，取值长度 1 - 255 字符
示例：
// 设置匿名ID为`fangke009901`，注意此方法需要在初始化之前调用
[AnalysysAgent identify:@"fangke009901"];
Swift代码示例：
AnalysysAgent.identify("fangke009901")

匿名ID获取

获取用户通过identify接口设置或自动生成的id，优先级如下： 用户设置的id > 代码自动生成的id，接口如下：
+ (NSString *)getDistinctId;
示例：
NSString *distinctID = [AnalysysAgent getDistinctId];
Swift代码示例：
let distinctID = AnalysysAgent.getDistinctId() as String

用户属性设置

用户属性是一个标准的 K-V 结构，K 和 V 均有相应的约束条件，如不符合则丢弃该次操作。
约束条件如下：
  • 属性名称
    以字母开头的字符串，必须由字母、数字、下划线组成，字母不区分大小写，$ 开头为预置事件/属性，不支持乱码、中文、空格等，长度范围1-99字符。
  • 属性值
    支持部分类型：NSString/NSNumber/NSArray<NSString *>/NSSet<NSString *>/NSDate/NSURL； 若为字符串，取值长度为1-255个字符； 若为数组或集合，则最多包含 100条，且 key 约束条件与属性名称一致，value 取值长度为1-255个字符

设置用户属性

给用户设置单个或多个属性，如果之前不存在，则新建，否则覆盖。接口如下：
+ (void)profileSet:(NSDictionary *)property;
​
+ (void)profileSet:(NSString *)propertyName value:(id)propertyValue;
示例1：
// 设置用户的 `Job` 是 `Engineer`
[AnalysysAgent profileSet:@"Job" propertyValue:@"Engineer"];
​
...
​
// 统计用户昵称和爱好信息
NSDictionary *properties = @{@"nickName":@"小叮当",@"hobby":@[@"Singing", @"Dancing"]};
[AnalysysAgent profileSet:properties];
Swift代码示例：
AnalysysAgent.profileSet(["nickName": "小叮当", "hobby": ["Singing", "Dancing"]])

设置用户固有属性

设置用户的固有属性，只在首次设置时有效的属性。 如：应用的激活时间、首次登录时间等。如果被设置的用户属性已存在，则这条记录会被忽略而不会覆盖已有数据，如果属性不存在则会自动创建。接口如下：
// 多个属性
+ (void)profileSetOnce:(NSDictionary *)property;
​
// 单个属性
+ (void)profileSetOnce:(NSString *)propertyName propertyValue:(id)propertyValue;
示例1：统计用户的出生日期
// 单个属性设置
[AnalysysAgent profileSetOnce:@"Birthday" propertyValue:@"1995-01-01"];
示例2：
// 统计应用激活时间
[AnalysysAgent profileSetOnce:@{@"activationTime": @"1521594686781"}];
Swift代码示例：
AnalysysAgent.profileSetOnce("Birthday", propertyValue: "1995-01-01")
​
AnalysysAgent.profileSetOnce(["activationTime": "1521594686781"])

设置用户属性相对变化值

设置用户属性的相对变化值(相对增加，减少)，只能对数值型属性进行操作，如果这个 Profile 之前不存在，则初始值为 0。接口如下：
// 多个属性
+ (void)profileIncrement:(NSDictionary *)property;
​
// 单个属性
+ (void)profileIncrement:(NSString *)propertyName propertyValue:(NSNumber *)propertyValue;
示例1：
// 增加用户消费金额
[AnalysysAgent profileIncrement:@"Consume" propertyValue:@10];
示例2：
// 增加用户登录次数加1次，积分增加10分
NSDictionary *dic = @{@"UseCount": [NSNumber numberWithInt:1],@"point": [NSNumber numberWithInt:10]};
[AnalysysAgent profileIncrement:dic];
Swift代码示例：
AnalysysAgent.profileIncrement("Consume", propertyValue: 10)
​
AnalysysAgent.profileIncrement(["UseCount": 1])

增加列表类型的属性

用户列表属性增加元素。接口如下：
// 增加单个属性
+ (void)profileAppend:(NSString *)propertyName value:(id)propertyValue;
​
// 增加多个属性
+ (void)profileAppend:(NSDictionary *)property;
​
// 增加多个属性
+ (void)profileAppend:(NSString *)propertyName propertyValue:(NSSet *)propertyValue;
示例1：
// 增加用户购买书籍，属性 `Books` 为: `["西游记", "三国演义"]`，属性 `Drinks` 为：`orange juice`
[AnalysysAgent profileAppend:@{@"Books": @[@"西游记", @"三国演义"],@"Drinks": @"orange juice"}];
示例2：
// 再次设定该属性，属性 `Books` 为: `["西游记", "三国演义", "红楼梦", "水浒传"]`
[AnalysysAgent profileAppend:@"Books" propertyValue:[NSSet setWithObjects:@"红楼梦", @"水浒传", nil]];
Swift代码示例：
AnalysysAgent.profileAppend("Books", propertyValue: ["红楼梦", "水浒传"])

删除设置的属性值

删除已设置的用户属性值。接口如下：
// 删除当前用户单个属性值
+ (void)profileUnset:(NSString *)propertyName;
​
// 删除当前用户所有属性值
+ (void)profileDelete;
示例1：
// 删除当前用户已设置的`hobby`用户属性值
[AnalysysAgent profileUnset:@"hobby"];
示例2：
// 删除当前用户已设置的所有用户属性
[AnalysysAgent profileDelete];
Swift代码示例：
AnalysysAgent.profileUnset("hobby")
​
AnalysysAgent.profileDelete()

通用属性

通用属性是每次上传事件信息都会带有的属性，通用属性是一个标准的 K-V 结构，K 和 V 均有相应的约束条件，如不符合则丢弃该次操作。
约束条件如下:
  • 属性名称
    以字母开头的字符串，必须由字母、数字、下划线组成，字母不区分大小写，$ 开头为预置事件/属性，不支持乱码、中文、空格等，长度范围1-99字符。
  • 属性值
    支持部分类型：NSString/NSNumber/NSArray<NSString *>/NSSet<NSString *>/NSDate/NSURL； 若为字符串，取值长度为1-255个字符； 若为数组或集合,则最多包含 100条，且 key 约束条件与属性名称一致，value 取值长度为1-255个字符

注册通用属性

某一个体，在固定范围内，持续拥有的属性，每次数据上传都会携带。接口如下:
// 注册多个通用属性
+ (void)registerSuperProperties:(NSDictionary *)superProperties;
​
// 注册单个通用属性
+ (void)registerSuperProperty:(NSString *)superPropertyName value:(id)superPropertyValue;
示例：
// 在某视频平台，购买一年会员，该年内只需设置一次即可
[AnalysysAgent registerSuperProperties:@{@"member": @"VIP"}];
成功设置事件通用属性后，事件通用属性会被添加进每个事件中，例如：
// 记录用户购买商品事件
[AnalysysAgent track:@"buy" properties:@{@"product":@"iPhone"}];