Sociomantic

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

環境を設定する

Maven

Mavenを使用している場合は、build.gradleファイルに下記のdependencyを追加します。

dependencies {
   implementation 'com.adjust.sdk:adjust-android:4.38.5'
   implementation 'com.adjust.sdk:adjust-android-criteo:4.38.5'
}

JAR

プラグインは、リリースページからJARファイルとして追加することもできます。

Sociomanticイベント

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

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を設定する必要があります。

Java

1
import com.adjust.sdk.plugin.AdjustSociomantic;
2

3
AdjustSociomantic.injectPartnerIdInSociomanticEvents("{sociomanticPartnerId}");

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

例

カスタマーイベント

Java

1
import com.adjust.sdk.plugin.AdjustSociomantic;
2

3
AdjustEvent event = new AdjustEvent(HOMEPAGE_TOKEN);
4
Map<String, String> customerData = new HashMap<>();
5
customerData.put(AdjustSociomantic.SCMCustomerAgeGroup, "0");
6

7
AdjustSociomantic.injectCustomerDataIntoEvent(event, customerData);
8
Adjust.trackEvent(event);

ホームページの閲覧

Java

1
import com.adjust.sdk.plugin.AdjustSociomantic;
2

3
AdjustEvent event = new AdjustEvent(HOMEPAGE_TOKEN);
4
Adjust.trackEvent(event);

リストの閲覧

Java

1
import com.adjust.sdk.plugin.AdjustSociomantic;
2

3
AdjustEvent event = new AdjustEvent(LISTING_TOKEN);
4
List<string> categories = Arrays.asList("cat1", "cat2", "cat3");
5
String date = "1427792434"
6

7
AdjustSociomantic.injectViewListingIntoEvent(event, categories);
8
Adjust.trackEvent(event);
9

10
// You also can provide a date like this.
11
AdjustSociomantic.injectViewListingIntoEvent(event, categories, date);
12
Adjust.trackEvent(event);

商品の閲覧

Java

1
import com.adjust.sdk.plugin.AdjustSociomantic;
2

3
AdjustEvent event = new AdjustEvent(PRODUCT_VIEW_TOKEN);
4
Map<String, Object> product = new HashMap<>();
5
List<string> categories = Arrays.asList("cat1", "cat2", "cat3");
6
product.put(AdjustSociomantic.SCMCategory, categories);
7

8
AdjustSociomantic.injectProductIntoEvent(event, "123456");
9
Adjust.trackEvent(event);
10

11
// You can also provide product information.
12
AdjustSociomantic.injectProductIntoEvent(event, "123456", product);
13
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担当者と相談してから行ってください。

カート

Java

1
import com.adjust.sdk.plugin.AdjustSociomantic;
2

3
AdjustEvent event = new AdjustEvent(BASKET_TOKEN);
4
Map<String, Object> product1 = new HashMap<>();
5
product1.put(AdjustSociomantic.SCMProductID, "1");
6
product1.put(AdjustSociomantic.SCMAmount, 42);
7
product1.put(AdjustSociomantic.SCMCurrency, "EUR");
8
product1.put(AdjustSociomantic.SCMQuantity, 1);
9

10
Map<String, Object> product2 = new HashMap<>();
11
product2.put(AdjustSociomantic.SCMProductID, "2");
12

13
String product3 = "3";
14

15
List<object> products = Arrays.asList(product1, product2, product3);
16
AdjustSociomantic.injectCartIntoEvent(event, products);
17
Adjust.trackEvent(event);

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

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

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

Java

1
import com.adjust.sdk.plugin.AdjustSociomantic;
2

3
AdjustEvent event = new AdjustEvent(SALE_TOKEN);
4
Map<String, Object> product1 = new HashMap<>();
5
product1.put(AdjustSociomantic.SCMProductID, "1");
6
product1.put(AdjustSociomantic.SCMAmount, 42);
7
product1.put(AdjustSociomantic.SCMQuantity, 1);
8

9
Map<String, Object> product2 = new HashMap<>();
10
product2.put(AdjustSociomantic.SCMProductID, "2");
11

12
String product3 = "3";
13

14
List<object> products = Arrays.asList(product1, product2, product3);
15
AdjustSociomantic.injectTransactionIntoEvent(event, "123456", products);
16
Adjust.trackEvent(event);

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

Java

1
import com.adjust.sdk.plugin.AdjustSociomantic;
2

3
AdjustEvent event = new AdjustEvent(SALE_TOKEN);
4
Map<String, Object> product1 = new HashMap<>();
5
product1.put(AdjustSociomantic.SCMProductID, "1");
6
product1.put(AdjustSociomantic.SCMAmount, 42);
7
product1.put(AdjustSociomantic.SCMQuantity, 1);
8

9
Map<String, Object> product2 = new HashMap<>();
10
product2.put(AdjustSociomantic.SCMProductID, "2");
11

12
String product3 = "3";
13

14
List<object> products = Arrays.asList(product1, product2, product3);
15
Map<String, Object> parameters = new HashMap<>();
16
parameters.put(AdjustSociomantic.SCMCurrency, "EUR");
17
parameters.put(AdjustSociomantic.SCMAmount, 42);
18

19
AdjustSociomantic.injectTransactionIntoEvent(event, "123456", products, parameters);
20

21
Adjust.trackEvent(event);

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

Java

1
import com.adjust.sdk.plugin.AdjustSociomantic;
2

3
AdjustEvent event = new AdjustEvent(SALE_TOKEN);
4
Map<String, Object> product1 = new HashMap<>();
5
product1.put(AdjustSociomantic.SCMProductID, "1");
6
product1.put(AdjustSociomantic.SCMAmount, 42);
7
product1.put(AdjustSociomantic.SCMQuantity, 1);
8

9
Map<String, Object> product2 = new HashMap<>();
10
product2.put(AdjustSociomantic.SCMProductID, "2");
11

12
String product3 = "3";
13

14
List<object> products = Arrays.asList(product1, product2, product3);
15
AdjustSociomantic.injectConfirmedTransactionIntoEvent(event, "123456", products);
16
Adjust.trackEvent(event);

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

Java

1
import com.adjust.sdk.plugin.AdjustSociomantic;
2

3
AdjustEvent event = new AdjustEvent(SALE_TOKEN);
4
Map<String, Object> product1 = new HashMap<>();
5
product1.put(AdjustSociomantic.SCMProductID, "1");
6
product1.put(AdjustSociomantic.SCMAmount, 42);
7
product1.put(AdjustSociomantic.SCMQuantity, 1);
8

9
Map<String, Object> product2 = new HashMap<>();
10
product2.put(AdjustSociomantic.SCMProductID, "2");
11

12
String product3 = "3";
13

14
List<object> products = Arrays.asList(product1, product2, product3);
15
Map<String, Object> parameters = new HashMap<>();
16
parameters.put(AdjustSociomantic.SCMCurrency, "EUR");
17
parameters.put(AdjustSociomantic.SCMAmount, 42);
18

19
AdjustSociomantic.injectConfirmedTransactionIntoEvent(event, "123456", products, parameters);
20
Adjust.trackEvent(event);

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

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

リードイベント

Java

1
import com.adjust.sdk.plugin.AdjustSociomantic;
2

3
AdjustEvent event = new AdjustEvent(LEAD_TOKEN);
4
AdjustSociomantic.injectLeadIntoEvent(event, "123456");
5
Adjust.trackEvent(event);

または確定したリード

Java

1
import com.adjust.sdk.plugin.AdjustSociomantic;
2

3
AdjustEvent event = new AdjustEvent(LEAD_TOKEN);
4
AdjustSociomantic.injectLeadIntoEvent(event, "123456", Boolean.TRUE);
5
Adjust.trackEvent(event);