メインコンテンツまでスキップ

パートナー属性

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

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

属性の検証

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

コア属性

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

説明属性名フォーマットペイロード例
メールemailstringjohn.smith@rokt.com
firstnamestringJohn
lastnamestringSmith
確認参照confirmationrefstringXYZ123
請求先Zipbillingzipcodestring10014 OR 10014-1234
金額amountdecimal300.5
支払いタイプpaymenttypeカンマ区切りの文字列、パイプ (|) で分割支払いを区切るGift card | Chase, Visa
クレジットカードBINccbinstring372888
携帯電話mobilestring7325558585
countryISO Alpha-2 Country Code
年齢ageinteger28
性別genderstringm
言語languagestringEN
請求先住所billingaddress1string175 Varick St
請求先住所2billingaddress2stringFloor 10
通貨currencystringUSD
カートデータcartItems任意の複雑なデータ型(配列、オブジェクト、文字列)カートアイテムデータ を参照
注記

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

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

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

カートアイテムデータ

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

説明属性名フォーマットペイロード例
製品の主要カテゴリ、製品分類の第一レベルとも呼ばれます。majorCatstringApparel & Accessories
主要製品カテゴリID。majorCatIDstring123456
製品のマイナーカテゴリ、製品分類の第二レベルとも呼ばれます。minorCat1stringClothing
マイナーカテゴリ製品ID。minorCatIDstring123456
製品分類の第三レベル。minorCat2stringActivewear
製品分類の第四レベル。minorCat3stringBicycle Activewear
製品分類の第五レベル。minorCat4stringBicycle Tights
製品のSKUskustring1234
製品の製品名。productNamestringViper Red Women’s Cycling Tights
カート内の各製品の数量。quantitynumber3
製品の価格。pricenumber89.9
購入された製品の総数。numberOfProductsnumber1
製品の説明。productDescriptionstringSporting a reflective design, our long cycling pants for…
製品画像のURL。productImageURLURLhttps://www.cycling.com/womenstights

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

説明属性名フォーマットペイロード例
メールemailstringjohn.smith@rokt.com
firstnamestringJohn
lastnamestringSmith
確認参照confirmationrefstringXYZ123
請求先郵便番号billingzipcodestring10014 OR 10014-1234
金額amountdecimal300.5
支払いタイプpaymenttypeカンマ区切りの文字列、パイプ (|) で分割支払いを区切るGift card | Chase, Visa
クレジットカードBINccbinstring372888
モバイルmobilestring7325558585
countryISO Alpha-2 国コードExamples
年齢ageinteger28
性別genderstringm
言語languagestringEN
請求先住所billingaddress1string175 Varick St
請求先住所2billingaddress2stringFloor 10
citystringNew York
statestringNY
通貨currencystringUSD
イベント名eventnamestringJohn Smith Featuring the Smiths: Live
イベントIDeventidstringE017448281A
主要カテゴリmajorcatstringConcerts
副カテゴリminorcatstringR&B
チケット枚数noticketsnumber4
イベント説明eventdescriptionstringThe most incredible show on earth.
イベント日eventdateyyyymmdd20200822
イベント時間eventtime24時間形式0800
イベント郵便番号eventzipcodezipcodeFormat Examples
イベント会場eventvenuestringAustin Big Stadium
主なアーティスト名primaryartistnamestringJohn Mayer

旅行

説明属性名フォーマットペイロード例
メールemailstringjohn.smith@rokt.com
firstnamestringJohn
lastnamestringSmith
確認参照confirmationrefstringXYZ123
請求先郵便番号billingzipcodestring10014 OR 10014-1234
金額amountdecimal300.5
支払いタイプpaymenttypeカンマ区切りの文字列、パイプ (|) で分割支払いを区切るGift card | Chase, Visa
クレジットカードBINccbinstring372888
モバイルmobilestring7325558585
countryISO Alpha-2 Country Code
年齢ageinteger28
性別genderstringm
言語languagestringEN
請求先住所billingaddress1string175 Varick St
請求先住所2billingaddress2stringFloor 10
citystringNew York
statestringNY
通貨currencystringUSD
旅行日traveldateyyyymmdd20200408
旅行時間traveltime24時間形式1930
目的地の市destcitystringNew York
目的地の空港destairportコード (IATA)
目的地空港郵便番号destairportzipcode郵便番号
出発地の市departcityStringSydney
出発地の空港departairportコード (IATA)
出発地空港郵便番号departairportzipcode郵便番号
乗客数paxnumber2
旅行タイプtriptypestringBusiness
ロイヤルティプログラムloyaltyprogramstringStar Alliance
ロイヤルティティアloyaltytierstring1
超過手荷物excessbaggagebooleanNo
旅行クラスtravelclassstringBusiness
キャリアcarrierstringNippon Airways
ホテル予約済みbookedhotelbooleanYes
保険購入済みpurchasedinsurancebooleanNo
車予約済みcarbookedbooleanYes

小売

説明属性名フォーマットペイロード例
メールemailstringjohn.smith@rokt.com
firstnamestringJohn
lastnamestringSmith
確認リファレンスconfirmationrefstringXYZ123
請求先郵便番号billingzipcodestring10014 OR 10014-1234
金額amountdecimal300.5
支払いタイプpaymenttypeカンマ区切りの文字列、パイプ (|) で分割支払いを区切るGift card | Chase, Visa
クレジットカードBINccbinstring372888
モバイルmobilestring7327572923
countryISO Alpha-2 国コードExamples
言語languagestringEN
請求先住所billingaddress1string175 Varick St
請求先住所ライン2billingaddress2stringFloor 10
citystringNew York
statestringNY
通貨currencystringUSD
クーポンコードcouponcodestringVIP10
クライアント顧客IDclientcustomeridstring123-xyz-456
顧客タイプcustomertypeguest / memberguest
ロイヤルティプログラムloyaltyprogramstringMacy’s Rewards
ロイヤルティティアloyaltytierstring1
ギフトgiftbooleanYes
小売クレジットカードretailcreditcardbooleanYes
価格pricedecimal300.5
数量quantityinteger3
大カテゴリmajorcatstringClothing
小カテゴリminorcatstringShoes
製品名productnamestringBrooks Brothers Brown Loafer
SKUstringstringDSC-HX99
配送先住所shippingddress1string175 Varick St
配送先住所ライン2shippingaddress2stringFloor 10
配送先郵便番号shippingzipcodestring10014 OR 10014-1234

食品および飲料

説明属性名フォーマットペイロード例
Emailemailstringjohn.smith@rokt.com
firstnamestringJohn
lastnamestringSmith
確認参照confirmationrefstringXYZ123
請求先郵便番号billingzipcodestring10014 OR 10014-1234
金額amountdecimal300.5
支払いタイプpaymenttypeカンマ区切りの文字列、パイプ (|) で分割支払いを区切るGift card | Chase, Visa
クレジットカードBINccbinstring372888
携帯電話mobilestring7325558585
countryISO Alpha-2 国コードExamples
言語languagestringEN
通貨currencystringUSD
年齢ageinteger28
性別genderstringm
請求先住所billingaddress1string175 Varick St
請求先住所2billingaddress2stringFloor 10
citystringNew York
statestringNY
配達deliveryboolenYes/no
携帯電話mobilestring7327572923
ロイヤルティプログラムloyaltyprogramstringChipotle Rewards
ロイヤルティティアloyaltytierstring1
価格pricedecimal300.5
数量quantityinteger3
大カテゴリmajorcatstringMexican Food
小カテゴリminorcatstringTacos
商品名productnamestringSteak Tacos with Guacamole
SKUstringstringDSC-HX99

B2B

説明属性名フォーマットペイロード例
メールemailstringjohn.smith@rokt.com
firstnamestringJohn
lastnamestringSmith
確認リファレンスconfirmationrefstringXYZ123
請求先郵便番号billingzipcodestring10014 OR 10014-1234
金額amountdecimal300.5
支払いタイプpaymenttypeカンマ区切りの文字列、パイプ (|) で分割支払いを区切るGift card | Chase, Visa
クレジットカードBINccbinstring372888
携帯電話mobilestring7325558585
countryISO Alpha-2 Country CodeExamples
言語languagestringEN
通貨currencystringUSD
年齢ageinteger28
性別genderstringm
請求先住所billingaddress1string175 Varick St
請求先住所2行目billingaddress2stringFloor 10
citystringNew York
statestringNY
配送タイプshippingtypestringPriority Express
商品名productnamestringLG Standing Desk
会社名businessnamestringRokt
ロイヤルティプログラムloyaltyprogramstringStar Alliance
ロイヤルティティアloyaltytierstring1
携帯電話mobilestring7325558585
価格pricedecimal300.5
数量quantityinteger3
大カテゴリmajorcatstringOffice Supplies
小カテゴリminorcatstringDesks
商品名productnamestringLG Standing Desk
SKUstringstringDSC-HX99

付録

国名ISO Alpha-2 国コード
AustraliaAU
AustriaAT
BelgiumBE
CanadaCA
DenmarkDK
FinlandFI
FranceFR
GermanyDE
IrelandIE
JapanJP
Netherlands (the)NL
New ZealandNZ
NorwayNO
SingaporeSG
SpainES
SweedenSE
United KingdomUK
United StatesUS
この記事は役に立ちましたか?