Criteo

Adjust iOS SDKとCriteoイベントを連携するには、Adjust Criteoプラグインを使用します。

環境を設定する

Cocoapods
Carthage

以下をPodfileファイルに追加します：

pod 'Adjust/Criteo'

以下をCartfileファイルに追加します：

github "adjust/ios_sdk" "criteo"

ソースからインストールする

以下の手順に従って、AdjustとCriteoイベントを連携することもできます。

リリースページからダウンロードしたアーカイブ内で、plugin/Criteoフォルダを確認します。
ADJCriteo.hおよびADJCriteo.mファイルをプロジェクト内のAdjustフォルダにドラッグします。
［Choose options for adding these files］（ファイル追加のオプションを選択）ダイアログで、 ［Copy items if needed］（必要に応じて項目をコピー） チェックボックスにチェックを入れ、 ［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];

Achievement Unlocked

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イベントに付与できます。これを行うには、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

パートナーIDを各Criteoイベントに付与できます。これを行うには、injectPartnerIdIntoCriteoEventsメソッドを呼び出します。SDKは、アプリのライフサイクルを通して、パートナーIDを各Criteoイベントと共に送信します。つまり、アプリを再起動したときは、再度設定する必要があります。

パートナーIDを削除するには、injectPartnerIdIntoCriteoEvents値をnullに設定します。

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

顧客IDを各Criteoイベントに付与できます。これを行うには、injectCustomerIdIntoCriteoEventsメソッドを呼び出します。SDKは、アプリのライフサイクルを通して、顧客IDを各Criteoイベントと共に送信します。つまり、アプリを再起動したときは、再度設定する必要があります。

顧客IDを削除するには、injectCustomerIdIntoCriteoEvents値をnilに設定します。

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}"];