Last updated 2023年9月12日

パートナー属性

SDKの統合に豊富で詳細なデータを含めることで、ターゲティングの向上とより良いパーソナライゼーションの能力が向上し、収益の増加と顧客体験の向上につながります。これらの属性は、Web、iOS、Android、またはReact Nativeの統合の一部として定義する必要があります。

以下のセクションで、事前定義されたRokt属性の完全なリストを見つけることができます。また、標準の統合を補完するために、任意のカスタム属性を定義することもできます。

属性の検証

サービスの信頼性を確保するために、当社のプラットフォームは、パートナーがAPI SDK統合やブラウザを介して統合したRokt固有のIDとクライアントデータ属性を検証します。検証により、データがRoktプラットフォームの処理要件を満たすようにフォーマットされていることが確認されます。たとえば、空の文字列のチェックやデータ型の解析可能性のチェックなどが行われます。その他の検証チェックでは、正確性と適切な値を確認します。たとえば、誕生日が特定の範囲内にあるか、電話番号が有効かどうかなどです。

コア属性

^{最初の10の属性は、顧客に関連するオファーを成功裏に提供するために不可欠です}

説明	属性名	フォーマット	ペイロードの例
メール	email	string	john.smith@rokt.com
名前	firstname	string	John
確認参照	confirmationref	string	XYZ123
金額	amount	decimal	300.5
支払いタイプ	paymenttype	string	クレジットカード
クレジットカードBIN	ccbin	string	372888
郵便番号	zipcode	string	10014
国	country	ISO Alpha-2 国コード	例
言語	language	string	EN
カートデータ	cartItems	任意の複雑なデータ型をサポート（配列、オブジェクト、文字列）	カートアイテムデータを参照
姓	lastname	string	Smith
年齢	age	integer	28
性別	gender	string	m
携帯電話番号	mobile	string	7325558585
通貨	currency	string	USD

カートアイテムデータ

cartItemsは、顧客のカートに関連するすべてのデータを表します。各製品には、製品名、製品カテゴリ、数量、価格、SKUなどが含まれます。カートデータを含む任意の複雑なデータ型をサポートし、カート内の各製品に対して以下のプロパティを含める必要があります。

説明	属性名	フォーマット	ペイロードの例
製品の主要カテゴリ、または製品タクソノミの第1レベルとしても知られるもの。	majorCat	string	アパレル＆アクセサリー
製品の主要カテゴリID。	majorCatID	string	123456
製品のマイナーカテゴリ、または製品タクソノミの第2レベルとしても知られるもの。	minorCat1	string	衣料品
マイナーカテゴリの商品ID	minorCat1ID	string	123456
商品のタクソノミーの第3レベル	minorCat2	string	アクティブウェア
商品のタクソノミーの第4レベル	minorCat3	string	自転車用アクティブウェア
商品のタクソノミーの第5レベル	minorCat4	string	自転車用タイツ
商品のSKU	sku	string	1234
商品の名前	productName	string	バイパーレッド女性用サイクリングタイツ
カート内の各商品の数量	quantity	number	3
商品の価格	price	number	89.9
購入した商品の総数	numberOfProducts	number	1
商品の説明	productDescription	string	反射デザインが特徴のロングサイクリングパンツ...
商品画像のURL	productImageURL	URL	https://www.cycling.com/womenstights

チケットとエンターテイメント

説明	属性名	フォーマット	ペイロードの例
メールアドレス	email	string	john.smith@rokt.com
名前	firstname	string	John
姓	lastname	string	Smith
住所1	address1	string	123 Fake Street
住所2	address2	string	Building A
市区町村	city	string	New York
州	state	string	NY
郵便番号	zipcode	string	10014
携帯電話番号	mobile	string	7325558585
確認番号	confirmationref	string	XYZ123
通貨	currency	string	USD
金額	amount	decimal	300.5
支払い方法	paymenttype	string	クレジットカード
クレジットカードBIN	ccbin	string	372888
国	country	ISO Alpha-2国コード	例
言語	language	string	EN
メジャーカテゴリ	majorcat	string	コンサート
マイナーカテゴリ	minorcat	string	R&B
チケットの数	notickets	number	4
イベント名	eventname	string	John Smith Featuring the Smiths: Live
イベントID	eventid	string	E017448281A
イベントの説明	eventdescription	string	地球上で最も信じられないショーです。
イベントの日付	eventdate	yyyymmdd	20200822
イベントの時間	eventtime	24時間形式	0800
イベントの郵便番号	eventzipcode	郵便番号	フォーマットの例
イベントの会場	eventvenue	string	オースティンビッグスタジアム
主要アーティストの名前	primaryartistname	string	ジョンメイヤー

旅行

説明	属性名	フォーマット	ペイロードの例
メールアドレス	email	string	john.smith@rokt.com
名前（名）	firstname	string	ジョン
名前（姓）	lastname	string	スミス
住所1	address1	string	123フェイクストリート
住所2	address2	string	ビルA
市区町村	city	string	ニューヨーク
州	state	string	NY
国	country	ISO Alpha-2国コード	例
郵便番号	zipcode	string	10014
携帯電話番号	mobile	string	7325558585
確認番号	confirmationref	string	XYZ123
通貨	currency	string	USD
言語	language	string	EN
金額	amount	decimal	300.5
支払い方法	paymenttype	string	クレジットカード
クレジットカードBIN	ccbin	string	372888
旅行時間	traveltime	24時間形式	1930
旅行日	traveldate	yyyymmdd	20200408
目的地の都市	destcity	string	ニューヨーク
目的地の空港	destairport	コード（IATA）	例
目的地の空港の郵便番号	destairportzipcode	郵便番号	例
出発地の都市	departcity	string	シドニー
出発地の空港	departairport	コード（IATA）	例
出発地の空港の郵便番号	departairportzipcode	郵便番号	例
乗客数	pax	number	2
旅行の種類	triptype	string	ビジネス
ロイヤリティプログラム	loyaltyprogram	string	スターアライアンス
ロイヤリティティア	loyaltytier	string	1
超過手荷物	excessbaggage	boolean	No
旅行クラス	travelclass	string	ビジネス
キャリア	carrier	string	日本航空
予約済みホテル	bookedhotel	boolean	Yes
購入済み保険	purchasedinsurance	boolean	No
予約済みの車	carbooked	boolean	Yes

小売

説明	属性名	フォーマット	ペイロードの例
Email	email	string	john.smith@rokt.com
First name	firstname	string	John
Last name	lastname	string	Smith
Address line 1	address1	string	123 Fake Street
Address Line 2	address2	string	Building A
City	city	string	New York
State	state	string	NY
Country	country	ISO Alpha-2 Country Code	Examples
ZIP or postal code	zipcode	string	10014
Mobile	mobile	string	7327572923
Amount	amount	decimal	300.5
Currency	currency	string	USD
Credit card BIN	ccbin	string	372888
Payment type	paymenttype	string	Credit Card
Confirmation reference	confirmationref	string	XYZ123
Coupon Code	couponcode	string	VIP10
Language	language	string	EN
Client Customer ID	clientcustomerid	string	123-xyz-456
Customer type	customertype	guest / member	guest
Loyalty program	loyaltyprogram	string	Macy’s Rewards
Loyalty tier	loyaltytier	string	1
Gift	gift	boolean	Yes
Retail Credit Card	retailcreditcard	boolean	Yes
Price	price	decimal	300.5
Quantity	quantity	integer	3
Major Category	majorcat	string	Clothing
Minor Category	minorcat	string	Shoes
Product Name	productname	string	Brooks Brothers Brown Loafer
Sku	string	string	DSC-HX99

飲食料品

Description	Attribute name	Format	Payload example
Email	email	string	john.smith@rokt.com
First name	firstname	string	John
Last name	lastname	string	Smith
Address line 1	address1	string	123 Fake Street
Address line 2	address2	string	Building A
City	city	string	New York
State	state	string	NY
ZIP or postal code	zipcode	string	10014
Country	country	ISO Alpha-2 Country Code	Examples
Mobile	mobile	string	7325558585
Confirmation reference	confirmationref	string	XYZ123
Language	language	string	EN
Currency	currency	string	USD
Amount	amount	decimal	300.5
Payment type	paymenttype	string	Credit Card
Credit card BIN	ccbin	string	372888
Delivery	delivery	boolen	Yes/no
Mobile	mobile	string	7327572923
Loyalty program	loyaltyprogram	string	Chipotle Rewards
Loyalty tier	loyaltytier	string	1
Price	price	decimal	300.5
Quantity	quantity	integer	3
Major Category	majorcat	string	Mexican Food
Minor Category	minorcat	string	Tacos
製品名	productname	string	ステーキタコスとグアカモーレ
Sku	string	string	DSC-HX99

B2B

説明	属性名	フォーマット	ペイロードの例
メール	email	string	john.smith@rokt.com
名前	firstname	string	John
姓	lastname	string	Smith
住所1	address1	string	123 Fake Street
住所2	address2	string	Building A
市	city	string	ニューヨーク
州	state	string	NY
郵便番号	zipcode	string	10014
国	country	ISO Alpha-2 Country Code	Examples
言語	language	string	EN
確認参照	confirmationref	string	XYZ123
通貨	currency	string	USD
金額	amount	decimal	300.5
支払い方法	paymenttype	string	クレジットカード
クレジットカードBIN	ccbin	string	372888
配送タイプ	shippingtype	string	優先エクスプレス
製品名	productname	string	LGスタンディングデスク
会社名	businessname	string	Rokt
ロイヤリティプログラム	loyaltyprogram	string	スターアライアンス
ロイヤリティティア	loyaltytier	string	1
携帯電話	mobile	string	7325558585
価格	price	decimal	300.5
数量	quantity	integer	3
主要カテゴリ	majorcat	string	オフィス用品
副カテゴリ	minorcat	string	デスク
製品名	productname	string	LGスタンディングデスク
Sku	string	string	DSC-HX99

付録

国	ISO Alpha-2 Country Code
オーストラリア	AU
オーストリア	AT
ベルギー	BE
カナダ	CA
デンマーク	DK
フィンランド	FI
フランス	FR
ドイツ	DE
アイルランド	IE
日本	JP
オランダ	NL
ニュージーランド	NZ
ノルウェー	NO
シンガポール	SG
スペイン	ES
スウェーデン	SE
イギリス	UK
アメリカ合衆国	US