Sociomantic

Adjust SDKとイベントを連携することができます。

環境を設定する

Cocoapods
Carthage

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

pod 'Adjust/Sociomantic'

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

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］（グループを作成） のラジオボタンを選択します。

Sociomanticイベント

Sociomanticプラグインをインストールすると、Sociomanticイベントメソッドや、以下の定数にアクセスできるようになります。これらは、辞書のプロパティ名として使用する必要があります。

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イベントを送信する前に、以下のようにパートナーIDを設定する必要があります。

Swift
Objective-C

1
ADJSociomantic.injectPartnerId(intoSociomanticEvents: "{sociomanticPartnerId}")

1
#import "ADJSociomantic.h"
2

3
[ADJSociomantic injectPartnerIdIntoSociomanticEvents:@"{sociomanticPartnerId}"];

パートナーIDを設定すると、さまざまなSociomanticイベントを連携できるようになります。

例

1
let event = ADJEvent(eventToken: ANY_TOKEN)
2
let customerData = [
3
    SCMCustomerID: "123456"
4
]
5

6
ADJSociomantic.injectCustomerData(into: event, withData: customerData)
7
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:ANY_TOKEN];
4
NSDictionary *customerData = @{
5
    SCMCustomerID: @"123456"
6
};
7

8
[ADJSociomantic injectCustomerDataIntoEvent:event withData:customerData];
9
[Adjust trackEvent:event];

ホームページの閲覧

Swift

1
let event = ADJEvent(eventToken: HOMEPAGE_TOKEN)
2

3
ADJSociomantic.injectHomePage(into: event)
4
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:HOMEPAGE_TOKEN];
4

5
[ADJSociomantic injectHomePageIntoEvent:event];
6
[Adjust trackEvent:event];

リストの閲覧

Swift
Objective-C

1
let event = ADJEvent(eventToken: LISTING_TOKEN)
2
let categories = ["category_1", "category_2", "category_3"]
3
let date = "1427792434"
4

5
ADJSociomantic.injectViewListing(into: event, withCategories: categories)
6
// You also can provide a date like this
7
ADJSociomantic.injectViewListing(into: event, withCategories: categories, withDate: date)
8
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:LISTING_TOKEN];
4
NSArray *categories = @[@"category_1", @"category_2", @"category_3"];
5
NSString *date = @"1427792434";
6

7
[ADJSociomantic injectViewListingIntoEvent:event withCategories:categories];
8
// You also can provide a date like this
9
[ADJSociomantic injectViewListingIntoEvent:event withCategories:categories withDate:date];
10
[Adjust trackEvent:event];

商品の閲覧

Swift
Objective-C

1
let event = ADJEvent(eventToken: PRODUCT_VIEW_TOKEN)
2
let params = [
3
    SCMCategory: ["cat1", "cat2"],
4
    SCMProductName: "stuff",
5
    SCMDescription: "pure awesomeness"
6
]
7

8
ADJSociomantic.injectViewProduct(into: event, productId: "productId_4", withParameters: params)
9
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event      = [ADJEvent eventWithEventToken:PRODUCT_VIEW_TOKEN];
4
NSDictionary *params = @{
5
    SCMCategory     : @[@"cat1", @"cat2"],
6
    SCMProductName  : @"stuff",
7
    SCMDescription  : @"pure awesomeness"
8
};
9

10
[ADJSociomantic injectViewProductIntoEvent:event productId:@"productId_4" withParameters:params];
11
[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 Analytics、 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担当者と相談してから行ってください。

カート

Swift
Objective-C

1
let event = ADJEvent(eventToken: CART_TOKEN)
2
let product5 = [
3
    SCMAmount: NSNumber(value: 100),
4
    SCMCurrency: "EUR",
5
    SCMQuantity: NSNumber(value: 1),
6
    SCMProductID: "productId_5"
7
]
8
let product6 = "productId_6"
9
let product7 = [
10
    SCMProductID: "productId_7"
11
]
12

13

14
let productList = [product5, product6, product7]
15

16
ADJSociomantic.injectCart(into: event, cart: productList)
17
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:CART_TOKEN];
4
NSDictionary *product5 = @{
5
    SCMAmount    : @100,
6
    SCMCurrency  : @"EUR",
7
    SCMQuantity  : @1,
8
    SCMProductID : @"productId_5",
9
};
10
NSString *product6 = @"productId_6";
11
NSDictionary *product7 = @{
12
    SCMProductID : @"productId_7"
13
};
14

15
NSArray * productList = @[product5, product6, product7];
16

17
[ADJSociomantic injectCartIntoEvent:event cart:productList];
18
[Adjust trackEvent:event];

使用可能なカートパラメーター

パラメーター名	要件	説明	注意事項
`SCMProductID`	必須	製品ID	色やサイズのバリエーションについては、サブIDを付けずに商品IDを指定してください。
`SCMAmount`	オプション	製品価格（10進値）（例：2.99）	小数点の記号にはドットを使用し、3桁ごとの区切り文字は使用しないでください。数量が1以上の場合でも、製品単価のみを指定してください。
`SCMCurrency`	オプション	ISO 4217形式の通貨コード（例：EUR）	固定の通貨コード。トラッキングコードのサンプルですでに提供されています。
`SCMQuantity`	オプション	選択された商品の数量	整数値で指定してください。

未確定のトランザクション

Swift
Objective-C

1
let event = ADJEvent(eventToken: TRANSACTION_TOKEN)
2
let product5 = "productId_5"
3
let product6 = [
4
    SCMQuantity: NSNumber(value: 3),
5
    SCMProductID: "productId_6"
6
]
7
let productList = [product5, product6]
8

9
ADJSociomantic.injectTransaction(into: event, transactionId: "123456", withProducts: productList)
10
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN];
4
NSString *product5 =  @"productId_5";
5
NSDictionary *product6 = @{
6
    SCMQuantity  : @3,
7
    SCMProductID : @"productId_6"
8
};
9
NSArray * productList = @[product5, product6];
10

11
[ADJSociomantic injectTransactionIntoEvent:event transactionId:@"123456" withProducts:productList];
12
[Adjust trackEvent:event];

またはパラメーターを含む場合

Swift
Objective-C

1
let event = ADJEvent(eventToken: TRANSACTION_TOKEN)
2
let product5 = "productId_5"
3
let product6 = [
4
    SCMQuantity: NSNumber(value: 3),
5
    SCMProductID: "productId_6"
6
]
7
let productList = [product5, product6]
8
let parameters = [
9
    SCMQuantity: NSNumber(value: 4 /* 3 times product6 and 1 product5 */)
10
]
11

12
ADJSociomantic.injectTransaction(into: event, transactionId: "123456", withProducts: productList, withParameters: parameters)
13
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN];
4
NSString *product5 =  @"productId_5";
5
NSDictionary *product6 = @{
6
    SCMQuantity  : @3,
7
    SCMProductID : @"productId_6"
8
};
9
NSArray *productList = @[product5, product6];
10
NSDictionary *parameters = @{
11
    SCMQuantity: @4  // 3 times product6 and 1 product5
12
};
13

14
[ADJSociomantic injectTransactionIntoEvent:event transactionId:@"123456" withProducts:productList withParameters:parameters];
15
[Adjust trackEvent:event];

確定したトランザクション

Swift
Objective-C

1
let event = ADJEvent(eventToken: TRANSACTION_TOKEN)
2
let product5 = "productId_5"
3
let product6 = [
4
    SCMQuantity: NSNumber(value: 3),
5
    SCMProductID: "productId_6"
6
]
7
let productList = [product5, product6]
8

9
ADJSociomantic.injectConfirmedTransaction(into: event, transactionId: "123456", withProducts: productList)
10
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN];
4
NSString *product5 =  @"productId_5";
5
NSDictionary *product6 = @{
6
    SCMQuantity  : @3,
7
    SCMProductID : @"productId_6"
8
};
9
NSArray * productList = @[product5, product6];
10

11
[ADJSociomantic injectConfirmedTransactionIntoEvent:event transactionId:@"123456" withProducts:productList];
12
[Adjust trackEvent:event];

またはパラメーターを含む場合

Swift
Objective-C

1
let event = ADJEvent(eventToken: TRANSACTION_TOKEN)
2
let product5 = "productId_5"
3
let product6 = [
4
    SCMQuantity: NSNumber(value: 3),
5
    SCMProductID: "productId_6"
6
]
7
let productList = [product5, product6]
8
let parameters = [
9
    SCMQuantity: NSNumber(value: 4 /* 3 times product6 and 1 product5 */)
10
]
11

12
ADJSociomantic.injectConfirmedTransaction(into: event, transactionId: "123456", withProducts: productList, withParameters: parameters)
13
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:TRANSACTION_TOKEN];
4
NSString *product5 =  @"productId_5";
5
NSDictionary *product6 = @{
6
    SCMQuantity  : @3,
7
    SCMProductID : @"productId_6"
8
};
9
NSArray *productList = @[product5, product6];
10
NSDictionary *parameters = @{
11
    SCMQuantity: @4  // 3 times product6 and 1 product5
12
};
13

14
[ADJSociomantic injectConfirmedTransactionIntoEvent:event transactionId:@"123456" withProducts:productList withParameters:parameters];
15
[Adjust trackEvent:event];

使用可能なカートパラメーター

パラメーター名	要件	説明	注意事項
`SCMAmount`	オプション	製品価格（10進値）（例：2.99）	小数点の記号にはドットを使用し、3桁ごとの区切り文字は使用しないでください。数量が1以上の場合でも、製品単価のみを指定してください。
`SCMCurrency`	オプション	ISO 4217形式の通貨コード（例：EUR）	固定の通貨コード。トラッキングコードのサンプルですでに提供されています。
`SCMQuantity`	オプション	選択された商品の数量	整数値で指定してください。

リードイベント

Swift
Objective-C

1
let event = ADJEvent(eventToken: LEAD_TOKEN)
2

3
ADJSociomantic.injectLead(into: event, leadID: "123456789")
4
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:LEAD_TOKEN];
4

5
[ADJSociomantic injectLeadIntoEvent:event leadID:@"123456789"];
6
[Adjust trackEvent:event];

または確定したリード

Swift
Objective-C

1
let event = ADJEvent(eventToken: LEAD_TOKEN)
2

3
ADJSociomantic.injectLead(into: event, leadID: "123456789", andConfirmed: true)
4
Adjust.trackEvent(event)

1
#import "ADJSociomantic.h"
2

3
ADJEvent *event = [ADJEvent eventWithEventToken:LEAD_TOKEN];
4

5
[ADJSociomantic injectLeadIntoEvent:event leadID:@"123456789" andConfirmed:YES];
6
[Adjust trackEvent:event];