Criteo

Adjust Criteo 플러그인을 사용하여 Adjust iOS SDK와 Criteo를 연동할 수 있습니다.

환경 설정

Cocoapods
Carthage

Podfile에 다음 줄을 추가합니다.

pod 'Adjust/Criteo'

Cartfile에 다음 줄을 추가합니다.

github "adjust/ios_sdk" "criteo"

소스로부터의 설치

다음 방법 중 하나를 수행하여 Criteo 이벤트와 adjust를 통합하세요.

배포 페이지에서 다운로드한 아카이브 내에 있는 plugin/Criteo 폴더를 찾습니다.
ADJCriteo.h 및 ADJCriteo.m 파일을 프로젝트 내 Adjust 폴더에 드래그합니다.
대화창에서 해당 파일을 추가하기 위한 옵션을 선택합니다. 필요한 경우 아이템 복사 체크박스를 선택한 뒤, 라디오 버튼을 선택하여 그룹을 생성 합니다.

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

Cart

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

Custom 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];

해시(Hashed)된 이메일

모든 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

모든 Criteo 이벤트에 파트너 ID를 추가할 수 있습니다. 해당 기능 사용을 원하는 경우 injectPartnerIdIntoCriteoEvents 메서드를 호출합니다. SDK는 앱의 라이프사이클 동안 모든 Criteo 관련 파트너 ID를 전송합니다. 즉, 앱이 다시 시작될 경우 재설정되어야 합니다.

파트너 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

모든 Criteo 이벤트에 고객 ID를 추가할 수 있습니다. 해당 기능 사용을 원하는 경우 injectCustomerIdIntoCriteoEvents 메서드를 호출합니다. SDK는 앱의 라이프사이클 동안 모든 Criteo 이벤트 관련 고객 ID를 전송합니다. 즉, 앱이 다시 시작될 경우 재설정되어야 합니다.

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