Sociomantic

您可以集成 Adjust SDK 和 Sociomantic 事件。

设置环境

Cocoapods
Carthage

添加下列行至您的 Podfile：

pod 'Adjust/Sociomantic'

添加下列行至您的 Cartfile：

github "adjust/ios_sdk" "sociomantic"

通过源代码安装

您可以通过以下方法手动将 Adjust Sociomantic 插件加入项目中：

在从发布页面下载的存档中找到 plugin/Sociomantic 文件夹。
将 ADJSociomantic.h 和 ADJSociomantic.m 文件拖拽至您项目中的 Adjust 文件夹。
Choose options for adding these files (选择添加文件选项)对话框出现时，勾选 Copy items if needed 并选择 Create groups 。

Sociomantic 事件

安装 Sociomantic 插件后，您就能调用 Sociomantic 事件方法和下列常量。您应当将它们用作目录中的属性名称。

NSString *const SCMCategory;
NSString *const SCMProductName;
NSString *const SCMSalePrice;
NSString *const SCMProductURL;
NSString *const SCMProductImageURL;
NSString *const SCMBrand;
NSString *const SCMDescription;
NSString *const SCMTimestamp;
NSString *const SCMValidityTimestamp;
NSString *const SCMQuantity;
NSString *const SCMScore;
NSString *const SCMProductID;
NSString *const SCMAmount;
NSString *const SCMCurrency;
NSString *const SCMActionConfirmed;
NSString *const SCMActionConfirmed;
NSString *const SCMCustomerAgeGroup;
NSString *const SCMCustomerEducation;
NSString *const SCMCustomerGender;
NSString *const SCMCustomerID;
NSString *const SCMCustomerMHash;
NSString *const SCMCustomerSegment;
NSString *const SCMCustomerTargeting;

在发送任何 Sociomantic 事件之前，您应当按照下方呈现的方式设置合作伙伴 ID：

Swift
Objective-C

1
ADJSociomantic.injectPartnerId(intoSociomanticEvents: "{sociomanticPartnerId}")

1
#import "ADJSociomantic.h"
2

3
[ADJSociomantic injectPartnerIdIntoSociomanticEvents:@"{sociomanticPartnerId}"];

设置好合作伙伴 ID 后，就可以集成不同的 Sociomantic 事件了。

示例

1
let event = ADJEvent(eventToken: ANY_TOKEN)
2
let customerData = [
3
    SCMCustomerID: "123456"
4
]
5

6
ADJSociomantic.injectCustomerData(into: event, withData: customerData)
7
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:ANY_TOKEN];
4
NSDictionary *customerData = @{
5
    SCMCustomerID: @"123456"
6
};
7

8
[ADJSociomantic injectCustomerDataIntoEvent:event withData:customerData];
9
[Adjust trackEvent:event];

查看主页

Swift

1
let event = ADJEvent(eventToken: HOMEPAGE_TOKEN)
2

3
ADJSociomantic.injectHomePage(into: event)
4
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:HOMEPAGE_TOKEN];
4

5
[ADJSociomantic injectHomePageIntoEvent:event];
6
[Adjust trackEvent:event];

查看产品页面

Swift
Objective-C

1
let event = ADJEvent(eventToken: LISTING_TOKEN)
2
let categories = ["category_1", "category_2", "category_3"]
3
let date = "1427792434"
4

5
ADJSociomantic.injectViewListing(into: event, withCategories: categories)
6
// You also can provide a date like this
7
ADJSociomantic.injectViewListing(into: event, withCategories: categories, withDate: date)
8
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:LISTING_TOKEN];
4
NSArray *categories = @[@"category_1", @"category_2", @"category_3"];
5
NSString *date = @"1427792434";
6

7
[ADJSociomantic injectViewListingIntoEvent:event withCategories:categories];
8
// You also can provide a date like this
9
[ADJSociomantic injectViewListingIntoEvent:event withCategories:categories withDate:date];
10
[Adjust trackEvent:event];

浏览产品

Swift
Objective-C

1
let event = ADJEvent(eventToken: PRODUCT_VIEW_TOKEN)
2
let params = [
3
    SCMCategory: ["cat1", "cat2"],
4
    SCMProductName: "stuff",
5
    SCMDescription: "pure awesomeness"
6
]
7

8
ADJSociomantic.injectViewProduct(into: event, productId: "productId_4", withParameters: params)
9
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event      = [ADJEvent eventWithEventToken:PRODUCT_VIEW_TOKEN];
4
NSDictionary *params = @{
5
    SCMCategory     : @[@"cat1", @"cat2"],
6
    SCMProductName  : @"stuff",
7
    SCMDescription  : @"pure awesomeness"
8
};
9

10
[ADJSociomantic injectViewProductIntoEvent:event productId:@"productId_4" withParameters:params];
11
[Adjust trackEvent:event];

可用产品参数

参数名称	要求	描述	请注意
`SCMCategory`	必要参数	产品类别 (整个类别路径)	类别或列表页面跟踪代码中提供的类别信息，应当与动态或产品页面跟踪代码中的类别信息一致。
`SCMProductName`	必要参数	产品名称	特殊字符不需要编码，但应当以正确的 UTF-8 格式发送。请不要使用任何 HTML 标记。
`SCMSalePrice`	必要参数	十进制值促销价格 (例如：2.99)	请使用点 (.) 作为小数分隔符，不要使用任何千位数分隔符。
`SCMAmount`	必要参数	十进制值正常价格 (例如：3.99)	请使用点 (.) 作为小数分隔符，不要使用任何千位数分隔符。
`SCMCurrency`	必要参数	ISO 4217 格式货币代码 (例如：EUR)	固定货币代码。应当已在跟踪代码示例中为您提供。
`SCMProductURL`	必要参数	产品 URL (深度链接)	请提供能够正常运作的深度链接，最好不要带有任何点击跟踪参数 (如 Google Analytics、HURRA、Eulerian 等)，务必始终使用带 http:// 的深度链接 `http://`
`SCMProductImageURL`	必要参数	产品图片 URL	请提供大小适宜的图片。为了在广告中达到最佳展示效果，图片应当至少为 200x200px，并保持相同的长宽比。
`SCMBrand`	必要参数	产品品牌	特殊字符不需要编码，但应当以正确的 UTF-8 格式发送 (与上文 SCMProductName 相同)。请不要使用任何 HTML 标记。
`SCMDescription`	可选	简短产品描述	特殊字符不需要编码，但应当以正确的 UTF-8 格式发送 (与上文 SCMProductName 相同)。请不要使用任何 HTML 标记。
`SCMTimestamp`	可选	产品可用期限的截止时间戳 (请使用格林尼治标准时间)	请提供访客搜索过的日期。该时间戳应当为包装在 NSNumber 中的 NSTimeInterval (参见示例)。
`SCMValidityTimestamp`	可选	产品可用期限的截止时间戳 (请使用格林尼治标准时间)	请提供产品可用期限的截止 unix 时间戳。对于始终可用的产品，请使用 0。该时间戳应当为包装在 NSNumber 中的 NSTimeInterval (与上文 SCMTimestamp 相同)。
`SCMQuantity`	可选	库存产品数量	请先与您的 Sociomantic 联系人讨论，确定后再集成该字段
`SCMScore`	可选	产品优先级分数 ( 0 - 10.0 之间的值)	请先与您的 Sociomantic 联系人讨论，确定后再集成该字段

购物车

Swift
Objective-C

1
let event = ADJEvent(eventToken: CART_TOKEN)
2
let product5 = [
3
    SCMAmount: NSNumber(value: 100),
4
    SCMCurrency: "EUR",
5
    SCMQuantity: NSNumber(value: 1),
6
    SCMProductID: "productId_5"
7
]
8
let product6 = "productId_6"
9
let product7 = [
10
    SCMProductID: "productId_7"
11
]
12

13

14
let productList = [product5, product6, product7]
15

16
ADJSociomantic.injectCart(into: event, cart: productList)
17
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:CART_TOKEN];
4
NSDictionary *product5 = @{
5
    SCMAmount    : @100,
6
    SCMCurrency  : @"EUR",
7
    SCMQuantity  : @1,
8
    SCMProductID : @"productId_5",
9
};
10
NSString *product6 = @"productId_6";
11
NSDictionary *product7 = @{
12
    SCMProductID : @"productId_7"
13
};
14

15
NSArray * productList = @[product5, product6, product7];
16

17
[ADJSociomantic injectCartIntoEvent:event cart:productList];
18
[Adjust trackEvent:event];

可用购物车参数

参数名称	要求	描述	请注意
`SCMProductID`	必要参数	产品 ID	该产品 ID 不应包含任何色彩与尺寸衍类的子 ID。
`SCMAmount`	可选	十进制值产品价格 (例如：2.99)	请使用点 (.) 作为小数分隔符，不要使用任何千位数分隔符。即便产品数量值大于 1，也请提供单个产品价格。
`SCMCurrency`	可选	ISO 4217 格式货币代码 (例如：EUR)	固定货币代码。应当已在跟踪代码示例中为您提供。
`SCMQuantity`	可选	选定产品数量	请使用整数值。

未确认交易

Swift
Objective-C

1
let event = ADJEvent(eventToken: TRANSACTION_TOKEN)
2
let product5 = "productId_5"
3
let product6 = [
4
    SCMQuantity: NSNumber(value: 3),
5
    SCMProductID: "productId_6"
6
]
7
let productList = [product5, product6]
8

9
ADJSociomantic.injectTransaction(into: event, transactionId: "123456", withProducts: productList)
10
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN];
4
NSString *product5 =  @"productId_5";
5
NSDictionary *product6 = @{
6
    SCMQuantity  : @3,
7
    SCMProductID : @"productId_6"
8
};
9
NSArray * productList = @[product5, product6];
10

11
[ADJSociomantic injectTransactionIntoEvent:event transactionId:@"123456" withProducts:productList];
12
[Adjust trackEvent:event];

或带参数：

Swift
Objective-C

1
let event = ADJEvent(eventToken: TRANSACTION_TOKEN)
2
let product5 = "productId_5"
3
let product6 = [
4
    SCMQuantity: NSNumber(value: 3),
5
    SCMProductID: "productId_6"
6
]
7
let productList = [product5, product6]
8
let parameters = [
9
    SCMQuantity: NSNumber(value: 4 /* 3 times product6 and 1 product5 */)
10
]
11

12
ADJSociomantic.injectTransaction(into: event, transactionId: "123456", withProducts: productList, withParameters: parameters)
13
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN];
4
NSString *product5 =  @"productId_5";
5
NSDictionary *product6 = @{
6
    SCMQuantity  : @3,
7
    SCMProductID : @"productId_6"
8
};
9
NSArray *productList = @[product5, product6];
10
NSDictionary *parameters = @{
11
    SCMQuantity: @4  // 3 times product6 and 1 product5
12
};
13

14
[ADJSociomantic injectTransactionIntoEvent:event transactionId:@"123456" withProducts:productList withParameters:parameters];
15
[Adjust trackEvent:event];

已确认交易

Swift
Objective-C

1
let event = ADJEvent(eventToken: TRANSACTION_TOKEN)
2
let product5 = "productId_5"
3
let product6 = [
4
    SCMQuantity: NSNumber(value: 3),
5
    SCMProductID: "productId_6"
6
]
7
let productList = [product5, product6]
8

9
ADJSociomantic.injectConfirmedTransaction(into: event, transactionId: "123456", withProducts: productList)
10
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN];
4
NSString *product5 =  @"productId_5";
5
NSDictionary *product6 = @{
6
    SCMQuantity  : @3,
7
    SCMProductID : @"productId_6"
8
};
9
NSArray * productList = @[product5, product6];
10

11
[ADJSociomantic injectConfirmedTransactionIntoEvent:event transactionId:@"123456" withProducts:productList];
12
[Adjust trackEvent:event];

或带参数：

Swift
Objective-C

1
let event = ADJEvent(eventToken: TRANSACTION_TOKEN)
2
let product5 = "productId_5"
3
let product6 = [
4
    SCMQuantity: NSNumber(value: 3),
5
    SCMProductID: "productId_6"
6
]
7
let productList = [product5, product6]
8
let parameters = [
9
    SCMQuantity: NSNumber(value: 4 /* 3 times product6 and 1 product5 */)
10
]
11

12
ADJSociomantic.injectConfirmedTransaction(into: event, transactionId: "123456", withProducts: productList, withParameters: parameters)
13
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN];
4
NSString *product5 =  @"productId_5";
5
NSDictionary *product6 = @{
6
    SCMQuantity  : @3,
7
    SCMProductID : @"productId_6"
8
};
9
NSArray *productList = @[product5, product6];
10
NSDictionary *parameters = @{
11
    SCMQuantity: @4  // 3 times product6 and 1 product5
12
};
13

14
[ADJSociomantic injectConfirmedTransactionIntoEvent:event transactionId:@"123456" withProducts:productList withParameters:parameters];
15
[Adjust trackEvent:event];

可用购物车参数

参数名称	要求	描述	请注意
`SCMAmount`	可选	十进制值产品价格 (例如：2.99)	请使用点 (.) 作为小数分隔符，不要使用任何千位数分隔符。即便产品数量值大于 1，也请提供单个产品价格。
`SCMCurrency`	可选	ISO 4217 格式货币代码 (例如：EUR)	固定货币代码。应当已在跟踪代码示例中为您提供。
`SCMQuantity`	可选	选定产品数量	请使用整数值。

Lead 事件

Swift
Objective-C

1
let event = ADJEvent(eventToken: LEAD_TOKEN)
2

3
ADJSociomantic.injectLead(into: event, leadID: "123456789")
4
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:LEAD_TOKEN];
4

5
[ADJSociomantic injectLeadIntoEvent:event leadID:@"123456789"];
6
[Adjust trackEvent:event];

或已确认的 lead：

Swift
Objective-C

1
let event = ADJEvent(eventToken: LEAD_TOKEN)
2

3
ADJSociomantic.injectLead(into: event, leadID: "123456789", andConfirmed: true)
4
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:LEAD_TOKEN];
4

5
[ADJSociomantic injectLeadIntoEvent:event leadID:@"123456789" andConfirmed:YES];
6
[Adjust trackEvent:event];