パートナー属性
SDK統合において、詳細で粒度の高いデータを含めることで、ターゲティングの強化とパーソナライゼーション機能の向上が可能となり、収益の増加と顧客体験の向上につながります。これらの属性は、Web、iOS、Android、またはReact Nativeの統合の一部として定義する必要があります。
以下のセクションで、事前定義されたRokt属性の完全なリストを見つけることができます。また、標準的な統合を補完するために任意のカスタム属性を定義することもできます。
属性の検証
サービスの信頼性を確保するために、私たちのプラットフォームは、API SDK統合および/またはブラウザを介してパートナーによって統合されたRokt固有のIDとクライアントデータ属性を検証します。検証は、データがRoktプラットフォームの処理要件を満たすようにフォーマットされていることを確認します。例えば、空の文字列のチェックやデータ型が解析可能かどうかの確認です。他の検証チェックは、正確さと適切な値を確認します。例えば、生年月日が特定の範囲内であるか、電話番号が有効であるかどうかです。
コア属性
このコア属性のリストは、お客様に関連するオファーを成功裏に提供するために不可欠です
| 説明 | 属性名 | フォーマット | ペイロード例 |
|---|---|---|---|
| メール | 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 |
チケットとエンターテインメント
| 説明 | 属性名 | フォーマット | ペイロード例 |
|---|---|---|---|
| メール | 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 |
旅行
| 説明 | 属性名 | フォーマット | ペイロード例 |
|---|---|---|---|
| メール | 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 |
小売
| 説明 | 属性名 | フォーマット | ペイロード例 |
|---|---|---|---|
| メール | 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 |
食品および 飲料
| 説明 | 属性名 | フォーマット | ペイロード例 |
|---|---|---|---|
| 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
| 説明 | 属性名 | フォーマット | ペイロード例 |
|---|---|---|---|
| メール | 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 |