パートナー属性

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

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

属性の検証

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

コア属性

^{このコア属性のリストは、お客様に関連するオファーを成功裏に提供するために不可欠です}

説明	属性名	フォーマット	ペイロード例
メール	email	string	john.smith@rokt.com
名	firstname	string	John
姓	lastname	string	Smith
確認参照	confirmationref	string	XYZ123
請求先Zip	billingzipcode	string	10014 OR 10014-1234
金額	amount	decimal	300.5
支払いタイプ	paymenttype	カンマ区切りの文字列、パイプ (|) で分割支払いを区切る	Gift card | Chase, Visa
クレジットカードBIN	ccbin	string	372888
携帯電話	mobile	string	7325558585
国	country	ISO Alpha-2 Country Code	例
年齢	age	integer	28
性別	gender	string	m
言語	language	string	EN
請求先住所	billingaddress1	string	175 Varick St
請求先住所2	billingaddress2	string	Floor 10
通貨	currency	string	USD
カートデータ	cartItems	任意の複雑なデータ型（配列、オブジェクト、文字列）	カートアイテムデータ を参照

注記

以下のデータ属性は請求情報から取得する必要があります:

• 名
• 姓
• 通貨
• 支払いタイプ
• クレジットカードBIN
• 住所1行目
• 住所2行目
• Zipまたは郵便番号
• 国

amount は、すべての手数料（税金、送料など）が含まれた後の最終注文金額から取得する必要があります。

カートアイテムデータ

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

説明	属性名	フォーマット	ペイロード例
製品の主要カテゴリ、製品分類の第一レベルとも呼ばれます。	majorCat	string	Apparel & Accessories
主要製品カテゴリID。	majorCatID	string	123456
製品のマイナーカテゴリ、製品分類の第二レベルとも呼ばれます。	minorCat1	string	Clothing
マイナーカテゴリ製品ID。	minorCatID	string	123456
製品分類の第三レベル。	minorCat2	string	Activewear
製品分類の第四レベル。	minorCat3	string	Bicycle Activewear
製品分類の第五レベル。	minorCat4	string	Bicycle Tights
製品のSKU	sku	string	1234
製品の製品名。	productName	string	Viper Red Women’s Cycling Tights
カート内の各製品の数量。	quantity	number	3
製品の価格。	price	number	89.9
購入された製品の総数。	numberOfProducts	number	1
製品の説明。	productDescription	string	Sporting a reflective design, our long cycling pants for…
製品画像のURL。	productImageURL	URL	https://www.cycling.com/womenstights

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

説明	属性名	フォーマット	ペイロード例
メール	email	string	john.smith@rokt.com
名	firstname	string	John
姓	lastname	string	Smith
確認参照	confirmationref	string	XYZ123
請求先郵便番号	billingzipcode	string	10014 OR 10014-1234
金額	amount	decimal	300.5
支払いタイプ	paymenttype	カンマ区切りの文字列、パイプ (|) で分割支払いを区切る	Gift card | Chase, Visa
クレジットカードBIN	ccbin	string	372888
モバイル	mobile	string	7325558585
国	country	ISO Alpha-2 国コード	Examples
年齢	age	integer	28
性別	gender	string	m
言語	language	string	EN
請求先住所	billingaddress1	string	175 Varick St
請求先住所2	billingaddress2	string	Floor 10
市	city	string	New York
州	state	string	NY
通貨	currency	string	USD
イベント名	eventname	string	John Smith Featuring the Smiths: Live
イベントID	eventid	string	E017448281A
主要カテゴリ	majorcat	string	Concerts
副カテゴリ	minorcat	string	R&B
チケット枚数	notickets	number	4
イベント説明	eventdescription	string	The most incredible show on earth.
イベント日	eventdate	yyyymmdd	20200822
イベント時間	eventtime	24時間形式	0800
イベント郵便番号	eventzipcode	zipcode	Format Examples
イベント会場	eventvenue	string	Austin Big Stadium
主なアーティスト名	primaryartistname	string	John Mayer

旅行

説明	属性名	フォーマット	ペイロード例
メール	email	string	john.smith@rokt.com
名	firstname	string	John
姓	lastname	string	Smith
確認参照	confirmationref	string	XYZ123
請求先郵便番号	billingzipcode	string	10014 OR 10014-1234
金額	amount	decimal	300.5
支払いタイプ	paymenttype	カンマ区切りの文字列、パイプ (|) で分割支払いを区切る	Gift card | Chase, Visa
クレジットカードBIN	ccbin	string	372888
モバイル	mobile	string	7325558585
国	country	ISO Alpha-2 Country Code	例
年齢	age	integer	28
性別	gender	string	m
言語	language	string	EN
請求先住所	billingaddress1	string	175 Varick St
請求先住所2	billingaddress2	string	Floor 10
市	city	string	New York
州	state	string	NY
通貨	currency	string	USD
旅行日	traveldate	yyyymmdd	20200408
旅行時間	traveltime	24時間形式	1930
目的地の市	destcity	string	New York
目的地の空港	destairport	コード (IATA)	例
目的地空港郵便番号	destairportzipcode	郵便番号	例
出発地の市	departcity	String	Sydney
出発地の空港	departairport	コード (IATA)	例
出発地空港郵便番号	departairportzipcode	郵便番号	例
乗客数	pax	number	2
旅行タイプ	triptype	string	Business
ロイヤルティプログラム	loyaltyprogram	string	Star Alliance
ロイヤルティティア	loyaltytier	string	1
超過手荷物	excessbaggage	boolean	No
旅行クラス	travelclass	string	Business
キャリア	carrier	string	Nippon Airways
ホテル予約済み	bookedhotel	boolean	Yes
保険購入済み	purchasedinsurance	boolean	No
車予約済み	carbooked	boolean	Yes

小売

説明	属性名	フォーマット	ペイロード例
メール	email	string	john.smith@rokt.com
名	firstname	string	John
姓	lastname	string	Smith
確認リファレンス	confirmationref	string	XYZ123
請求先郵便番号	billingzipcode	string	10014 OR 10014-1234
金額	amount	decimal	300.5
支払いタイプ	paymenttype	カンマ区切りの文字列、パイプ (|) で分割支払いを区切る	Gift card | Chase, Visa
クレジットカードBIN	ccbin	string	372888
モバイル	mobile	string	7327572923
国	country	ISO Alpha-2 国コード	Examples
言語	language	string	EN
請求先住所	billingaddress1	string	175 Varick St
請求先住所ライン2	billingaddress2	string	Floor 10
市	city	string	New York
州	state	string	NY
通貨	currency	string	USD
クーポンコード	couponcode	string	VIP10
クライアント顧客ID	clientcustomerid	string	123-xyz-456
顧客タイプ	customertype	guest / member	guest
ロイヤルティプログラム	loyaltyprogram	string	Macy’s Rewards
ロイヤルティティア	loyaltytier	string	1
ギフト	gift	boolean	Yes
小売クレジットカード	retailcreditcard	boolean	Yes
価格	price	decimal	300.5
数量	quantity	integer	3
大カテゴリ	majorcat	string	Clothing
小カテゴリ	minorcat	string	Shoes
製品名	productname	string	Brooks Brothers Brown Loafer
SKU	string	string	DSC-HX99
配送先住所	shippingddress1	string	175 Varick St
配送先住所ライン2	shippingaddress2	string	Floor 10
配送先郵便番号	shippingzipcode	string	10014 OR 10014-1234

食品および飲料

説明	属性名	フォーマット	ペイロード例
Email	email	string	john.smith@rokt.com
名	firstname	string	John
姓	lastname	string	Smith
確認参照	confirmationref	string	XYZ123
請求先郵便番号	billingzipcode	string	10014 OR 10014-1234
金額	amount	decimal	300.5
支払いタイプ	paymenttype	カンマ区切りの文字列、パイプ (|) で分割支払いを区切る	Gift card | Chase, Visa
クレジットカードBIN	ccbin	string	372888
携帯電話	mobile	string	7325558585
国	country	ISO Alpha-2 国コード	Examples
言語	language	string	EN
通貨	currency	string	USD
年齢	age	integer	28
性別	gender	string	m
請求先住所	billingaddress1	string	175 Varick St
請求先住所2	billingaddress2	string	Floor 10
市	city	string	New York
州	state	string	NY
配達	delivery	boolen	Yes/no
携帯電話	mobile	string	7327572923
ロイヤルティプログラム	loyaltyprogram	string	Chipotle Rewards
ロイヤルティティア	loyaltytier	string	1
価格	price	decimal	300.5
数量	quantity	integer	3
大カテゴリ	majorcat	string	Mexican Food
小カテゴリ	minorcat	string	Tacos
商品名	productname	string	Steak Tacos with Guacamole
SKU	string	string	DSC-HX99

B2B

説明	属性名	フォーマット	ペイロード例
メール	email	string	john.smith@rokt.com
名	firstname	string	John
姓	lastname	string	Smith
確認リファレンス	confirmationref	string	XYZ123
請求先郵便番号	billingzipcode	string	10014 OR 10014-1234
金額	amount	decimal	300.5
支払いタイプ	paymenttype	カンマ区切りの文字列、パイプ (|) で分割支払いを区切る	Gift card | Chase, Visa
クレジットカードBIN	ccbin	string	372888
携帯電話	mobile	string	7325558585
国	country	ISO Alpha-2 Country Code	Examples
言語	language	string	EN
通貨	currency	string	USD
年齢	age	integer	28
性別	gender	string	m
請求先住所	billingaddress1	string	175 Varick St
請求先住所2行目	billingaddress2	string	Floor 10
市	city	string	New York
州	state	string	NY
配送タイプ	shippingtype	string	Priority Express
商品名	productname	string	LG Standing Desk
会社名	businessname	string	Rokt
ロイヤルティプログラム	loyaltyprogram	string	Star Alliance
ロイヤルティティア	loyaltytier	string	1
携帯電話	mobile	string	7325558585
価格	price	decimal	300.5
数量	quantity	integer	3
大カテゴリ	majorcat	string	Office Supplies
小カテゴリ	minorcat	string	Desks
商品名	productname	string	LG Standing Desk
SKU	string	string	DSC-HX99

付録

国名	ISO Alpha-2 国コード
Australia	AU
Austria	AT
Belgium	BE
Canada	CA
Denmark	DK
Finland	FI
France	FR
Germany	DE
Ireland	IE
Japan	JP
Netherlands (the)	NL
New Zealand	NZ
Norway	NO
Singapore	SG
Spain	ES
Sweeden	SE
United Kingdom	UK
United States	US