ヘルプセンター
|
Sociomanticプラグインと連携
Adjust SDKとSociomanticイベントを連携させるには、以下のいずれかのメソッドを実行します。
事前準備
まずお使いのプラットフォーム用のAdjust SDKをダウンロードして設定してください。以下のリンク先の説明に従って、設定を開始してください。
環境を設定する
iOS
Cocoapods
Cocoapodsを使用している場合は、Podfileに下記のコードを追加してAdjust Sociomanticプラグインを連携します。
pod 'Adjust/Sociomantic'
Carthage
Carthageを使用している場合は、Cartfileに下記のコードを追加してAdjust Sociomanticプラグインを連携します。
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](グループを作成) のラジオボタンを選択します。
Android
Maven
Mavenを使用している場合は、build.gradle
ファイルに下記のdependencyを追加します。
dependencies {
implementation 'com.adjust.sdk:adjust-android:4.28.2'
implementation 'com.adjust.sdk:adjust-android-criteo:4.28.2'
}
JARとして追加する
プラグインは、リリースページからJARファイルとして追加することもできます。
Sociomanticイベント
Sociomanticプラグインをインストールすると、Sociomanticイベントメソッドや、以下の定数にアクセスできるようになります。これらは、辞書のプロパティ名として使用する必要があります。
Sociomantic定数(iOS)
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定数(Android)
final static String SCMCategory;
final static String SCMProductName;
final static String SCMSalePrice;
final static String SCMAmount;
final static String SCMCurrency;
final static String SCMProductURL;
final static String SCMProductImageURL;
final static String SCMBrand;
final static String SCMDescription;
final static String SCMTimestamp;
final static String SCMValidityTimestamp;
final static String SCMQuantity;
final static String SCMScore;
final static String SCMProductID;
final static String SCMActionConfirmed;
final static String SCMCustomerAgeGroup;
final static String SCMCustomerEducation;
final static String SCMCustomerGender;
final static String SCMCustomerID;
final static String SCMCustomerMHash;
final static String SCMCustomerSegment;
final static String SCMCustomerTargeting;
final static String SCMTransaction;
Sociomanticイベントを送信する前に、以下のようにパートナーIDを設定する必要があります。
Objective-C
Swift
Java
#import "ADJSociomantic.h"
[ADJSociomantic injectPartnerIdIntoSociomanticEvents:@"{sociomanticPartnerId}"];
パートナーIDを設定すると、さまざまなSociomanticイベントを連携できるようになります。
例
カスタマーイベント
Objective-C
Swift
Java
#import "ADJSociomantic.h"
ADJEvent *event = [ADJEvent eventWithEventToken:ANY_TOKEN];
NSDictionary *customerData = @{
SCMCustomerID: @"123456"
};
[ADJSociomantic injectCustomerDataIntoEvent:event withData:customerData];
[Adjust trackEvent:event];
ホームページの閲覧
Objective-C
Swift
Java
#import "ADJSociomantic.h"
ADJEvent *event = [ADJEvent eventWithEventToken:HOMEPAGE_TOKEN];
[ADJSociomantic injectHomePageIntoEvent:event];
[Adjust trackEvent:event];
リストの閲覧
Objective-C
Swift
Java
#import "ADJSociomantic.h"
ADJEvent *event = [ADJEvent eventWithEventToken:LISTING_TOKEN];
NSArray *categories = @[@"category_1", @"category_2", @"category_3"];
NSString *date = @"1427792434";
[ADJSociomantic injectViewListingIntoEvent:event withCategories:categories];
// You also can provide a date like this
[ADJSociomantic injectViewListingIntoEvent:event withCategories:categories withDate:date];
[Adjust trackEvent:event];
商品の閲覧
注意:
Objective-C
Swift
Java
#import "ADJSociomantic.h"
ADJEvent *event = [ADJEvent eventWithEventToken:PRODUCT_VIEW_TOKEN];
NSDictionary *params = @{
SCMCategory : @[@"cat1", @"cat2"],
SCMProductName : @"stuff",
SCMDescription : @"pure awesomeness"
};
[ADJSociomantic injectViewProductIntoEvent:event productId:@"productId_4" withParameters:params];
[Adjust trackEvent:event];
使用可能な商品パラメーター
パラメータ名 | 要件 | 説明 | 注意 |
---|---|---|---|
SCMCategory | 必須* | 商品のカテゴリー(カテゴリーパス全体) | カテゴリーページやリストページのトラッキングコードで提供されるカテゴリー情報は、商品ページのトラッキングコード、またはフィードで提供されるカテゴリー情報と一致していることが必要です。 |
SCMProductName | 必須* | 商品名 | 特殊文字はエンコードせず、正しいUTF-8を使用してください。HTMLマークアップは一切使用しないでください。 |
SCMSalePrice | 必須* | 販売価格(10進値)(例:2.99) | 小数点の記号にはドットを使用し、3桁ごとの区切り文字は使用しないでください。 |
SCMAmount | 必須* | 通常価格(10進値)(例:3.99) | 小数点の記号にはドットを使用し、3桁ごとの区切り文字は使用しないでください。 |
SCMCurrency | 必須* | ISO 4217形式の通貨コード(例:EUR) | 固定の通貨コード。トラッキングコードのサンプルですでに提供されています。 |
SCMProductURL> | 必須* | 商品のURL(ディープリンク) | できれば、クリック トラッキング パラメーター(Google アナリティクス、HURRA、Eulerianなど)を使用せずに機能するディープリンクを指定します。必ずhttp://を付けたディープリンクを使用してください。 |
SCMProductImageURL | 必須* | 商品画像のURL | 適度なサイズの画像をご用意ください。広告表示を最適化するには、画像は200x200ピクセル以上、同じアスペクト比である必要があります。 |
SCMBrand | 必須* | 商品ブランド | 特殊文字はエンコードせず、正しいUTF-8を使用してください(上記のSCMProductNameと同様)。HTMLマークアップは一切使用しないでください。 |
SCMDescription | オプション | 商品の簡単な説明 | 特殊文字はエンコードせず、正しいUTF-8を使用してください(上記のSCMProductNameと同様)。HTMLマークアップは一切使用しないでください。 |
SCMTimestamp | オプション | 商品の在庫期限のタイムスタンプ(GMTで指定)。 | ユーザーが検索した日付を指定してください。NSTimeIntervalをNSNumberにラップしたものである必要があります(サンプルを参照)。 |
SCMValidityTimestamp | オプション | 商品の在庫期限のタイムスタンプ(GMTで指定)。 | 商品の在庫期限のUNIXタイムスタンプを指定してください。常に在庫のある商品の場合、0としてください。NSTimeIntervalをNSNumberにラップしたものである必要があります(上記のSCMTimestampと同様)。 |
SCMQuantity | オプション | 商品の在庫数 | このフィールドを連携する場合は、必ずSociomantic担当者と相談してから行ってください。 |
SCMScore | オプション | 商品の優先度スコア(値の範囲は0~10.0) | このフィールドを連携する場合は、必ずSociomantic担当者と相談してから行ってください。 |
Cart
Objective-C
Swift
Java
#import "ADJSociomantic.h"
ADJEvent *event = [ADJEvent eventWithEventToken:CART_TOKEN];
NSDictionary *product5 = @{
SCMAmount : @100,
SCMCurrency : @"EUR",
SCMQuantity : @1,
SCMProductID : @"productId_5",
};
NSString *product6 = @"productId_6";
NSDictionary *product7 = @{
SCMProductID : @"productId_7"
};
NSArray * productList = @[product5, product6, product7];
[ADJSociomantic injectCartIntoEvent:event cart:productList];
[Adjust trackEvent:event];
使用可能なカートパラメーター
パラメータ名 | 要件 | 説明 | 注意 |
---|---|---|---|
SCMProductID | 必須 | 製品ID | 色やサイズのバリエーションについては、サブIDを付けずに商品IDを指定してください。 |
SCMAmount | オプション | 商品価格(10進値)(例:2.99) | 小数点の記号にはドットを使用し、3桁ごとの区切り文字は使用しないでください。数量が1以上の場合でも、商品単価のみを指定してください。 |
SCMCurrency | オプション | ISO 4217形式の通貨コード(例:EUR) | 固定の通貨コード。トラッキングコードのサンプルですでに提供されています。 |
SCMQuantity | オプション | 選択された商品の数量 | 整数値で指定してください。 |
未確定のトランザクション
Objective-C
Swift
Java
#import "ADJSociomantic.h"
ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN];
NSString *product5 = @"productId_5";
NSDictionary *product6 = @{
SCMQuantity : @3,
SCMProductID : @"productId_6"
};
NSArray * productList = @[product5, product6];
[ADJSociomantic injectTransactionIntoEvent:event transactionId:@"123456" withProducts:productList];
[Adjust trackEvent:event];
またはパラメーターを含む場合
Objective-C
Swift
Java
#import "ADJSociomantic.h"
ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN];
NSString *product5 = @"productId_5";
NSDictionary *product6 = @{
SCMQuantity : @3,
SCMProductID : @"productId_6"
};
NSArray *productList = @[product5, product6];
NSDictionary *parameters = @{
SCMQuantity: @4 // 3 x product6、1 x product5
};
[ADJSociomantic injectTransactionIntoEvent:event transactionId:@"123456" withProducts:productList withParameters:parameters];
[Adjust trackEvent:event];
確定したトランザクション
Objective-C
Swift
Java
#import "ADJSociomantic.h"
ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN];
NSString *product5 = @"productId_5";
NSDictionary *product6 = @{
SCMQuantity : @3,
SCMProductID : @"productId_6"
};
NSArray * productList = @[product5, product6];
[ADJSociomantic injectConfirmedTransactionIntoEvent:event transactionId:@"123456" withProducts:productList];
[Adjust trackEvent:event];
またはパラメーターを含む場合
Objective-C
Swift
Java
#import "ADJSociomantic.h"
ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN];
NSString *product5 = @"productId_5";
NSDictionary *product6 = @{
SCMQuantity : @3,
SCMProductID : @"productId_6"
};
NSArray *productList = @[product5, product6];
NSDictionary *parameters = @{
SCMQuantity: @4 // 3 x product6、1 x product5
};
[ADJSociomantic injectConfirmedTransactionIntoEvent:event transactionId:@"123456" withProducts:productList withParameters:parameters];
[Adjust trackEvent:event];
使用可能なカートパラメーター
パラメータ名 | 要件 | 説明 | 注意 |
---|---|---|---|
SCMAmount | オプション | 商品価格(10進値)(例:2.99) | 小数点の記号にはドットを使用し、3桁ごとの区切り文字は使用しないでください。数量が1以上の場合でも、商品単価のみを指定してください。 |
SCMCurrency | オプション | ISO 4217形式の通貨コード(例:EUR) | 固定の通貨コード。トラッキングコードのサンプルですでに提供されています。 |
SCMQuantity | オプション | 選択された商品の数量 | 整数値で指定してください。 |
リードイベント
Objective-C
Swift
Java
#import "ADJSociomantic.h"
ADJEvent *event = [ADJEvent eventWithEventToken:LEAD_TOKEN];
[ADJSociomantic injectLeadIntoEvent:event leadID:@"123456789"];
[Adjust trackEvent:event];
または確定したリード
Objective-C
Swift
Java
#import "ADJSociomantic.h"
ADJEvent *event = [ADJEvent eventWithEventToken:LEAD_TOKEN];
[ADJSociomantic injectLeadIntoEvent:event leadID:@"123456789" andConfirmed:YES];
[Adjust trackEvent:event];