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

パートナー属性

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

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

属性の検証

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

コア属性

このコア属性リストは、顧客に関連するオファーを成功裏に提供するために不可欠です
説明属性名フォーマットペイロード例
メールemailstringjohn.smith@rokt.com
名前firstnamestringJohn
lastnamestringSmith
確認参照confirmationrefstringXYZ123
請求先郵便番号billingzipcodestring10014 または 10014-1234
金額amountdecimal300.5
支払いタイプpaymenttypeコンマで区切られた文字列、パイプ (|) は分割支払いを区別Gift card | Chase, Visa
クレジットカードBINccbinstring372888
携帯電話mobilestring7325558585
countryISO Alpha-2 国コード
年齢ageinteger28
性別genderstringm
言語languagestringEN
請求先住所billingaddress1string175 Varick St
請求先住所 行2billingaddress2stringFloor 10
通貨currencystringUSD
カートデータcartItems任意の複雑なデータ型 (配列, オブジェクト, 文字列)カートアイテムデータ を参照
注記

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

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

amount は、含まれる手数料(税金、送料など)を差し引いた最終注文金額から取得する必要があります。

カートアイテムデータ

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

説明属性名フォーマットペイロード例
製品の主要カテゴリで、製品分類の第1レベルとしても知られています。majorCatstringApparel & Accessories
製品の主要カテゴリID。majorCatIDstring123456
製品のマイナーカテゴリで、製品分類の第2レベルとしても知られています。minorCat1stringClothing
マイナーカテゴリ製品ID。minorCatIDstring123456
製品分類の第3レベル。minorCat2stringActivewear
製品分類の第4レベル。minorCat3stringBicycle Activewear
製品分類の第5レベル。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 または 10014-1234
金額amountdecimal300.5
支払いタイプpaymenttypeカンマ区切りの文字列、スプリットペイメントはパイプ(|)で区切るGift card | Chase, Visa
クレジットカード BINccbinstring372888
携帯番号mobilestring7325558585
countryISO Alpha-2 Country CodeExamples
年齢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 CodeExamples
年齢ageinteger28
性別genderstringm
言語languagestringEN
請求先住所billingaddress1string175 Varick St
請求住所ライン2billingaddress2stringFloor 10
都市citystringNew York
statestringNY
通貨currencystringUSD
旅行日traveldateyyyymmdd20200408
旅行時間traveltime24時間形式1930
目的地の都市destcitystringNew York
目的地の空港destairportコード (IATA)Examples
目的地の空港郵便番号destairportzipcodezipcodeExamples
出発都市departcityStringSydney
出発空港departairportコード (IATA)Examples
出発空港郵便番号departairportzipcodezipcodeExamples
乗客数paxnumber2
旅行タイプtriptypestringBusiness
ロイヤルティプログラムloyaltyprogramstringStar Alliance
ロイヤルティティアloyaltytierstring1
超過手荷物excessbaggagebooleanNo
旅行クラスtravelclassstringBusiness
キャリアcarrierstringNippon Airways
ホテル予約bookedhotelbooleanYes
保険購入purchasedinsurancebooleanNo
車の予約carbookedbooleanYes

小売

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

食品と飲料

説明属性名形式ペイロード例
メールemailstringjohn.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

説明属性名フォーマットペイロード例
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
発送タイプ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
オーストリアAT
ベルギーBE
カナダCA
デンマークDK
フィンランドFI
フランスFR
ドイツDE
アイルランドIE
日本JP
Netherlands (の)NL
ニュージーランドNZ
ノルウェーNO
シンガポールSG
スペインES
スウェーデンSE
イギリスUK
アメリカ合衆国US
この記事は役に立ちましたか?