Criteo

您可以使用 Adjust Criteo 插件，集成 Adjust iOS SDK 与 Criteo 事件。

设置环境

Cocoapods
Carthage

添加下列行至您的 Podfile：

pod 'Adjust/Criteo'

添加下列行至您的 Cartfile：

github "adjust/ios_sdk" "criteo"

通过源代码安装

您也可以按照下列步骤操作，集成 Adjust 和 Criteo 事件：

前往发布页面，找到下载文件中的插件/Criteo 文件夹。
将 ADJCriteo.h 和 ADJCriteo.m 文件拖拽至您项目中的 Adjust 文件夹。
在对话框中选择添加这些文件的选项。如有需要，请确保勾选 Copy items 复选框，选择 Create groups 的选项。

处理 Criteo 事件

设置好环境后，您就可以开始通过 Adjust SDK 记录 Criteo 事件了。

1
let event = ADJEvent(eventToken: "{viewListingEventToken}")
2
let productIds = ["productId1", "productId2", "product3"]
3
ADJCriteo.injectViewListing(into: event, productIds: productIds)
4
Adjust.trackEvent(event)

1
#import "ADJCriteo.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:@"{viewListingEventToken}"];
4
NSArray *productIds = @[@"productId1", @"productId2", @"product3"];
5
[ADJCriteo injectViewListingIntoEvent:event productIds:productIds];
6
[Adjust trackEvent:event];

浏览产品

Swift
Objective-C

1
let event = ADJEvent(eventToken: "{viewProductEventToken}")
2
ADJCriteo.injectViewProduct(into: event, productId: "productId1")
3
Adjust.trackEvent(event)

1
#import "ADJCriteo.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:@"{viewProductEventToken}"];
4
[ADJCriteo injectViewProductIntoEvent:event productId:@"productId1"];
5
[Adjust trackEvent:event];

购物车

Swift
Objective-C

1
let event = ADJEvent(eventToken: "{cartEventToken}")
2

3
let product1 = ADJCriteoProduct(id: "productId1", price: 100.0, quantity: 1)
4
let product2 = ADJCriteoProduct(id: "productId2", price: 77.7, quantity: 3)
5
let product3 = ADJCriteoProduct(id: "productId3", price: 50, quantity: 2)
6
let products = [product1, product2, product3]
7

8
ADJCriteo.injectCart(into: event, products: products)
9

10
Adjust.trackEvent(event)

1
#import "ADJCriteo.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:@"{cartEventToken}"];
4

5
ADJCriteoProduct *product1 = [ADJCriteoProduct productWithId:@"productId1" price:100.0 quantity:1];
6
ADJCriteoProduct *product2 = [ADJCriteoProduct productWithId:@"productId2" price:77.7 quantity:3];
7
ADJCriteoProduct *product3 = [ADJCriteoProduct productWithId:@"productId3" price:50 quantity:2];
8
NSArray *products = @[product1, product2, product3];
9

10
[ADJCriteo injectCartIntoEvent:event products:products];
11

12
[Adjust trackEvent:event];

交易已确认

Swift
Objective-C

1
let event = ADJEvent(eventToken: "{transactionConfirmedEventToken}")
2

3
let product1 = ADJCriteoProduct(id: "productId1", price: 100.0, quantity: 1)
4
let product2 = ADJCriteoProduct(id: "productId2", price: 77.7, quantity: 3)
5
let product3 = ADJCriteoProduct(id: "productId3", price: 50, quantity: 2)
6
let products = [product1, product2, product3]
7

8
ADJCriteo.injectTransactionConfirmed(into: event, products: products)
9

10
Adjust.trackEvent(event)

1
#import "ADJCriteo.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:@"{transactionConfirmedEventToken}"];
4

5
ADJCriteoProduct *product1 = [ADJCriteoProduct productWithId:@"productId1" price:100.0 quantity:1];
6
ADJCriteoProduct *product2 = [ADJCriteoProduct productWithId:@"productId2" price:77.7 quantity:3];
7
ADJCriteoProduct *product3 = [ADJCriteoProduct productWithId:@"productId3" price:50 quantity:2];
8
NSArray *products = @[product1, product2, product3];
9

10
[ADJCriteo injectTransactionConfirmedIntoEvent:event products:products
11
  transactionId:@"transactionId1" newCustomer:@"newCustomerId"];
12

13
[Adjust trackEvent:event];

用户级别

Swift
Objective-C

1
let event = ADJEvent(eventToken: "{userLevelEventToken}")
2

3
ADJCriteo.injectUserLevel(into: event, uiLevel: 1)
4

5
Adjust.trackEvent(event)

1
#import "ADJCriteo.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:@"{userLevelEventToken}"];
4

5
[ADJCriteo injectUserLevelIntoEvent:event uiLevel:1];
6

7
[Adjust trackEvent:event];

用户状态

Swift
Objective-C

1
let event = ADJEvent(eventToken: "{userStatusEventToken}")
2

3
ADJCriteo.injectUserStatus(into: event, uiStatus: "uiStatusValue")
4

5
Adjust.trackEvent(event)

1
#import "ADJCriteo.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:@"{userStatusEventToken}"];
4

5
[ADJCriteo injectUserStatusIntoEvent:event uiStatus:@"uiStatusValue"];
6

7
[Adjust trackEvent:event];

成就解锁

Swift
Objective-C

1
let event = ADJEvent.eventToken("{achievementUnlockedEventToken}")
2

3
ADJCriteo.injectAchievementUnlocked(into: event, uiAchievement: "uiAchievementValue")
4

5
Adjust.trackEvent(event)

1
#import "ADJCriteo.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:@"{achievementUnlockedEventToken}"];
4

5
[ADJCriteo injectAchievementUnlockedIntoEvent:event uiAchievement:@"uiAchievementValue"];
6

7
[Adjust trackEvent:event];

自定义事件

Swift
Objective-C

1
let event = ADJEvent.eventToken("{customEventEventToken}")
2

3
ADJCriteo.injectCustomEvent(into: event, uiData: "uiDataValue")
4

5
Adjust.trackEvent(event)

1
#import "ADJCriteo.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:@"{customEventEventToken}"];
4

5
[ADJCriteo injectCustomEventIntoEvent:event uiData:@"uiDataValue"];
6

7
[Adjust trackEvent:event];

自定义事件 2

Swift
Objective-C

1
let event = ADJEvent(eventToken: "{customEvent2EventToken}"
2

3
ADJCriteo.injectCustomEvent2(into: event, uiData2: "uiDataValue2", uiData3: 3)
4

5
Adjust.trackEvent(event)

1
#import "ADJCriteo.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:@"{customEvent2EventToken}"];
4

5
[ADJCriteo injectCustomEvent2IntoEvent:event uiData2:@"uiDataValue2" uiData3:3];
6

7
[Adjust trackEvent:event];

经哈希处理的电子邮件

您也可以向每个 Criteo 事件附加一个经过哈希处理的电子邮件。为此，请调用injectHashedEmailIntoCriteoEvents方法。这样，在整个应用生命周期中，SDK 就会针对每个 Criteo 事件发送一封经过哈希处理的电子邮件。应用重新启动时，您需要再次进行该设置。您可以将injectHashedEmailIntoCriteoEvents值设置为nil，移除哈希电子邮件发送。

Swift
Objective-C

1
ADJCriteo.injectHashedEmail(intoCriteoEvents: "8455938a1db5c475a87d76edacb6284e")

1
#import "ADJCriteo.h"
2

3
[ADJCriteo injectHashedEmailIntoCriteoEvents:@"8455938a1db5c475a87d76edacb6284e"];

搜索日期

您可以向每个 Criteo 事件附加 check-in (如酒店的入住时间) 和 check-out (如酒店的退房时间) 日期。为此，请调用injectViewSearchDatesIntoCriteoEvent方法。这样，在整个应用生命周期中，SDK 就会针对每个 Criteo 事件发送日期信息。应用重新启动时，您需要再次进行该设置。

您可以将 injectViewSearchDatesIntoCriteoEvent 值设置为 nil，移除搜索日期发送。

Swift
Objective-C

1
ADJCriteo.injectViewSearchDates(intoCriteoEvents: "2015-01-01", checkoutDate: "2015-01-07")

1
#import "ADJCriteo.h"
2

3
[ADJCriteo injectViewSearchDatesIntoCriteoEvents:@"2015-01-01" checkOutDate:@"2015-01-07"];

合作伙伴 ID

您也可以向每个 Criteo 事件附加一个合作伙伴 ID。为此，请调用injectPartnerIdIntoCriteoEvents方法。这样，在整个应用生命周期中，SDK 就会针对每个 Criteo 事件发送合作伙伴 ID 信息。应用重新启动时，您需要再次进行该设置。

您可以将 injectPartnerIdIntoCriteoEvents 值设置为 null，移除合作伙伴 ID 发送。

Swift
Objective-C

1
ADJCriteo.injectPartnerId(intoCriteoEvents: "{criteoPartnerId}"

1
#import "ADJCriteo.h"
2

3
[ADJCriteo injectPartnerIdIntoCriteoEvents:@"{criteoPartnerId}"];

发送深度链接

您可以添加深度链接信息至 Criteo 事件。为此，请使用事件和 URL 调用 injectDeeplinkIntoEvent 方法。

Swift
Objective-C

1
func application(
2
    _ application: UIApplication?,
3
    open url: URL?,
4
    sourceApplication: String?,
5
    annotation: Any?
6
) -> Bool {
7
    let event = ADJEvent(eventToken: "{deeplinkEventToken}")
8

9
    ADJCriteo.injectDeeplink(into: event, url: url)
10

11
    Adjust.trackEvent(event)
12

13
    //...
14
}

1
#import "ADJCriteo.h"
2

3
- (BOOL)  application:(UIApplication *)application openURL:(NSURL *)url
4
    sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
5
{
6
    ADJEvent *event = [ADJEvent eventWithEventToken:@"{deeplinkEventToken}"];
7

8
    [ADJCriteo injectDeeplinkIntoEvent:event url:url];
9

10
    [Adjust trackEvent:event];
11

12
    //...
13
}

客户 ID

您也可以向每个 Criteo 事件附加一个客户 ID。为此，请调用injectCustomerIdIntoCriteoEvents方法。这样，在整个应用生命周期中，SDK 就会针对每个 Criteo 事件发送客户 ID 信息。应用重新启动时，您需要再次进行该设置。

您可以将 injectCustomerIdIntoCriteoEvents 值设置为 nil，移除客户 ID 发送。

Swift
Objective-C

1
ADJCriteo.injectCustomerId(intoCriteoEvents: "{CriteoCustomerId}")

1
#import "ADJCriteo.h"
2

3
[ADJCriteo injectCustomerIdIntoCriteoEvents:@"{CriteoCustomerId}"];

用户分群

您也可以向每个 Criteo 事件附加用户分群。为此，请调用injectUserSegmentIntoCriteoEvents方法。这样，在整个应用生命周期中，SDK 就会针对每个 Criteo 事件发送用户分群信息。应用重新启动时，您需要再次进行该设置。

您可以将 injectUserSegmentIntoCriteoEvents 值设置为 nil，移除用户分群发送。

Swift
Objective-C

1
ADJCriteo.injectUserSegment(intoCriteoEvents: "{CriteoUserSegment}")

1
#import "ADJCriteo.h"
2

3
[ADJCriteo injectUserSegmentIntoCriteoEvents:@"{CriteoUserSegment}"];