Criteoプラグインと連携
Adjust SDKとCriteoイベントを連携するには、Adjust Criteoプラグインを使用します。
事前準備 ご利用の条件 まずお使いのプラットフォーム用のAdjust SDKをダウンロードして設定してください。以下のリンク先の説明に従って、設定を開始してください。
⚙️ iOS / Android
環境を設定する iOS 全て展開する
CocoaPodsを使用している場合は、以下の行をPodfileファイルに追加できます。
Carthageを使用している場合は、以下の行を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](グループを作成) のラジオボタンを選択します。 Android 全て展開する
Mavenを使用している場合は、build.gradle
ファイルに下記の依存関係を追加します。
dependencies {
implementation 'com.adjust.sdk:adjust-android:4.28.2'
implementation 'com.adjust.sdk:adjust-android-criteo:4.28.2'
}
プラグインは、リリースページ からJARファイルとして追加することもできます。
Criteoイベントを操作する 環境を設定したら、Adjust SDKを使用してCriteoイベントの記録を開始できます。
リストの閲覧
#import "ADJCriteo.h"
ADJEvent *event = [ADJEvent eventWithEventToken:@"{viewListingEventToken}"];
NSArray *productIds = @[@"productId1", @"productId2", @"product3"];
[ADJCriteo injectViewListingIntoEvent:event productIds:productIds];
[Adjust trackEvent:event];
商品の閲覧
#import "ADJCriteo.h"
ADJEvent *event = [ADJEvent eventWithEventToken:@"{viewProductEventToken}"];
[ADJCriteo injectViewProductIntoEvent:event productId:@"productId1"];
[Adjust trackEvent:event];
Cart
#import "ADJCriteo.h"
ADJEvent *event = [ADJEvent eventWithEventToken:@"{cartEventToken}"];
ADJCriteoProduct *product1 = [ADJCriteoProduct productWithId:@"productId1" price:100.0quantity:1];
ADJCriteoProduct *product2 = [ADJCriteoProduct productWithId:@"productId2" price:77.7 quantity:3];
ADJCriteoProduct *product3 = [ADJCriteoProduct productWithId:@"productId3" price:50 quantity:2];
NSArray *products = @[product1, product2, product3];
[ADJCriteo injectCartIntoEvent:event products:products];
[Adjust trackEvent:event];
トランザクションの確認
#import "ADJCriteo.h"
ADJEvent *event = [ADJEvent eventWithEventToken:@"{transactionConfirmedEventToken}"];
ADJCriteoProduct *product1 = [ADJCriteoProduct productWithId:@"productId1" price:100.0quantity:1];
ADJCriteoProduct *product2 = [ADJCriteoProduct productWithId:@"productId2" price:77.7 quantity:3];
ADJCriteoProduct *product3 = [ADJCriteoProduct productWithId:@"productId3" price:50 quantity:2];
NSArray *products = @[product1, product2, product3];
[ADJCriteo injectTransactionConfirmedIntoEvent:event products:products
transactionId:@"transactionId1" newCustomer:@"newCustomerId"];
[Adjust trackEvent:event];
ユーザーレベル
#import "ADJCriteo.h"
ADJEvent *event = [ADJEvent eventWithEventToken:@"{userLevelEventToken}"];
[ADJCriteo injectUserLevelIntoEvent:event uiLevel:1];
[Adjust trackEvent:event];
ユーザーステータス
#import "ADJCriteo.h"
ADJEvent *event = [ADJEvent eventWithEventToken:@"{userStatusEventToken}"];
[ADJCriteo injectUserStatusIntoEvent:event uiStatus:@"uiStatusValue"];
[Adjust trackEvent:event];
Achievement Unlocked
#import "ADJCriteo.h"
ADJEvent *event = [ADJEvent eventWithEventToken:@"{achievementUnlockedEventToken}"];
[ADJCriteo injectAchievementUnlockedIntoEvent:event uiAchievement:@"uiAchievementValue"];
[Adjust trackEvent:event];
カスタムイベント
#import "ADJCriteo.h"
ADJEvent *event = [ADJEvent eventWithEventToken:@"{customEventEventToken}"];
[ADJCriteo injectCustomEventIntoEvent:event uiData:@"uiDataValue"];
[Adjust trackEvent:event];
カスタムイベント2
#import "ADJCriteo.h"
ADJEvent *event = [ADJEvent eventWithEventToken:@"{customEvent2EventToken}"];
[ADJCriteo injectCustomEvent2IntoEvent:event uiData2:@"uiDataValue2" uiData3:3];
[Adjust trackEvent:event];
ハッシュ化されたメール ハッシュ化されたメールを各Criteoイベントに付与できます。これを行うには、injectHashedEmailIntoCriteoEvents
メソッドを呼び出します。SDKは、アプリのライフサイクル中に、ハッシュ化されたメールを各Criteoイベントと共に送信します。つまり、アプリを再起動したときは、再度設定する必要があります。ハッシュ化されたメールを削除するには、injectHashedEmailIntoCriteoEvents
値をnil
に設定します。
#import "ADJCriteo.h"
[ADJCriteo injectHashedEmailIntoCriteoEvents:@"8455938a1db5c475a87d76edacb6284e"];
日付を検索する チェックインとチェックアウトの日付を各Criteoイベントに付与できます。これを行うには、injectViewSearchDatesIntoCriteoEvent
メソッドを呼び出します。SDKは、アプリのライフサイクル中に、日付を各Criteoイベントと共に送信します。つまり、アプリを再起動したときは、再度設定する必要があります。
検索日付を削除するには、injectViewSearchDatesIntoCriteoEvent
値をnil
に設定します。
#import "ADJCriteo.h"
[ADJCriteo injectViewSearchDatesIntoCriteoEvents:@"2015-01-01" checkOutDate:@"2015-01-07"];
パートナーID パートナーIDを各Criteoイベントに付与できます。これを行うには、injectPartnerIdIntoCriteoEvents
メソッドを呼び出します。SDKは、アプリのライフサイクル中に、パートナーIDを各Criteoと共に送信します。つまり、アプリを再起動したときは、再度設定する必要があります。
パートナーIDを削除するには、injectPartnerIdIntoCriteoEvents
値をnull
に設定します。
#import "ADJCriteo.h"
[ADJCriteo injectPartnerIdIntoCriteoEvents:@"{criteoPartnerId}"];
ディープリンクを送信する ディープリンク情報をCriteoイベントに追加できます。これを行うには、イベントとURLを指定してinjectDeeplinkIntoEvent
メソッドを呼び出します。
#import "ADJCriteo.h"
- (BOOL) application:(UIApplication *)application openURL:(NSURL *)url
sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
ADJEvent *event = [ADJEvent eventWithEventToken:@"{deeplinkEventToken}"];
[ADJCriteo injectDeeplinkIntoEvent:event url:url];
[Adjust trackEvent:event];
//...
}
カスタマーID カスタマーIDを各Criteoイベントに付与できます。これを行うには、injectCustomerIdIntoCriteoEvents
メソッドを呼び出します。SDKは、アプリのライフサイクル中に、カスタマーIDを各Criteoイベントと共に送信します。つまり、アプリを再起動したときは、再度設定する必要があります。
カスタマーIDを削除するには、injectCustomerIdIntoCriteoEvents
値をnil
に設定します。
#import "ADJCriteo.h"
[ADJCriteo injectCustomerIdIntoCriteoEvents:@"{CriteoCustomerId}"];
ユーザーセグメント ユーザーセグメントを各Criteoイベントに付与できます。これを行うには、injectUserSegmentIntoCriteoEvents
メソッドを呼び出します。SDKは、アプリのライフサイクル中に、ユーザーセグメントを各Criteoイベントと共に送信します。つまり、アプリを再起動したときは、再度設定する必要があります。
ユーザーセグメントを削除するには、injectUserSegmentIntoCriteoEvents
値をnil
に設定します。
#import "ADJCriteo.h"
[ADJCriteo injectUserSegmentIntoCriteoEvents:@"{CriteoUserSegment}"];