データ統合
適切なデータ要素を統合することは、Roktが承認された各支払いプロバイダーのサインアップまたはアプリケーションフローを読み込むために重要です。アカウントマネージャーは必要な情報を収集し、特定のニーズに基づいてカスタムスニペットを提供します。
コア属性 - 支払いページ
これらの属性を変更する必要がある場合は、アカウントマネージャーと協力してください。
この表は、Roktの配置を選択して表示するために必要なコア属性を示しています。これらの属性は、確認ページで利用可能な場合に統合する必要があります。
| 説明 | 属性名 | フォーマット | ペイロードの例 |
|---|---|---|---|
| 金額 | amount | decimal | 300.5 |
| 電子メール（存在する場合） | string | john.smith@rokt.com | |
| 名 | firstname | string | John |
| 姓 | lastname | string | Smith |
| 請求先郵便番号 | billingzipcode | string | 10014 OR 10014-1234 |
| 国 | country | ISO Alpha-2 国コード | Examples |
| 言語 | language | string | EN |
| 通貨 | currency | string | USD |
| カートデータ | cartItems | サポートされている任意の複雑なデータ型（配列、オブジェクト、文字列） | Cart item data を参照 |
コア属性 - 確認ページ
確認ページの統合に以下の属性を追加することは、既に利用可能でない場合、最適化を強化し、支払いページの配置により関連性を持たせるために極めて重要です:
| 説明 | 属性名 | 形式 | ペイロード例 |
|---|---|---|---|
| メール | 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 | カンマ区切りの文字列 (プラットフォーム、カードブランド、決済ネットワーク)。分割払いをパイプ (|) で区切る | ギフトカード | チェイス、ビザ |
| クレジットカード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 | サポートされている任意の複雑なデータ型 (配列、オブジェクト、文字列) | カートアイテムデータ を参照 |
カートアイテムデータ
cartItems は、配列、オブジェクト、文字列など任意の形式で提供でき、カート内の各製品に対して以下のプロパティを含める必要があります。
| 属性名 | タイプ | 説明 |
|---|---|---|
| majorCat | string | 製品の主要カテゴリであり、製品分類の第1レベルとしても知られています。 |
| majorCatID | string | 主要製品カテゴリID。 |
| minorCat1 | string | 製品のマイナーカテゴリであり、製品分類の第2レベルとしても知られています。 |
| minorCatID | string | マイナーカテゴリ製品ID。 |
| minorCat2 | string | 製品分類の第3レベル。 |
| minorCat3 | string | 製品分類の第4レベル。 |
| minorCat4 | string | 製品分類の第5レベル。 |
| sku | string | 製品の在庫管理単位またはSKU。 |
| productName | string | 製品の製品名。 |
最適化と分析属性
Roktでは、トランザクションに関するデータ属性を入力することで、顧客が見るオファーをよりパーソナライズするのを支援します。これらのデータ要素を統合に含めることで、ターゲティングと最適化の機能が向上し、それによりエンゲージメントの向上、収益の増加、および顧客体験の向上を実現します。
以下にリストされている多くの属性は、Roktがeコマーストランザクションに関連する分析とレポートを提供する上でも重要です。例えば、トランザクション収益やカートコンバージョン率に関するレポートです。
| 属性名 | タイプ | 許容値（利用可能な場合） | 説明 |
|---|---|---|---|
| customerid | string | 注文を作成した顧客。 | |
| cartid | id | この注文になったカートの対応するID。 | |
| subtotal | number | 税金や送料が適用されていない注文の合計。 | |
| totalTax | number | 注文に対する税金の合計額。 | |
| totalShipping | number | 注文に対する発送手数料の合計額。 | |
| margin | amount | 販売の平均利益率。 | |
| currency | currency code | 注文の通貨。 | |
| shippingAddress1 | address | 注文を発送する第1行目の住所。 | |
| shippingAddress2 | address | 注文を発送する第2行目の住所。 | |
| shippingCity | string | 注文を発送する都市。 | |
| shippingState | string | 注文を発送する州。 | |
| shippingZipcode | zipcode | Universal Postal Union の住所体系による検証。 | 注文が発送される郵便番号または郵便コード。 |
| shippingCountry | string | 注文が発送される国。 | |
| shippingCompanyName | string | 注文を行う会社の名前（該当する場合）。 | |
| billingAddress1 | address | 許可される特殊文字: -'´`",.:;#&/()+@ °ºᵃª_ \ | 支払いタイプの住所の第一行。 |
| billingAddress2 | address | 許可される特殊文字: -'´`",.:;#&/()+@ °ºᵃª_ \ | 支払いタイプの住所の第二行。 |
| billingCity | string | 請求ユーザーの都市または地域によっては郊外。 | |
| billingState | string | 支払いタイプの州。 | |
| billingZipcode | zipcode | Universal Postal Union の住所体系による検証。 | 請求タイプの郵便番号または郵便コード。 |
| billingCountry | string | 支払いタイプの国。 | |
| title | string | - Mr - Mrs - Miss - Mx | 顧客の敬称またはタイトル。 |
| firstName | string | 顧客の名。 | |
| lastName | string | 顧客の姓。 | |
| customerType | string | 顧客の種類に関する説明。 | |
| hasAccount | boolean | - True - False | 顧客がログインしているかどうかを説明。 |
| isReturning | boolean | - True - False | 顧客が以前にサイトを利用したかどうかを説明。 |
| lastVisited | datetime | 有効な日付と時間。 | 顧客が最後にサイトを利用した日付と時間。 |
| isLoyalty | boolean | - True - False | 顧客がロイヤリティプログラムのメンバーであるかどうかを定義。 |
| loyaltyTier | string | ロイヤリティプログラムのメンバーである顧客のロイヤリティティアの説明。 | |
| age | integer | 顧客の年齢。 | |
| gender | string | 顧客の認識された性別。 | |
| dob | date | 顧客の生年月日。 |
さらなる情報
支払いタイプ
パートナーは、支払いに関するすべての情報を paymentType フィールドに提供する必要があります。フォーマットは以下の通りです:
- 属性値はカンマ (,) で区切られるべきです (例: プラットフォーム、カードブランド、支払いネットワーク)。
- パイプ (|) はスプリットペイメントを分けるために使用されます (例: ギフトカード + クレジットカード)。
- スプリットペイメントは別々の属性としてキャプチャされます (つまり、paymentType, paymentType2)。これにより、既存のダウンストリームシステムとの互換性が維持されます。ローンチ時には、1つの取引につき最大2つの支払い方法をキャプチャします。2つ以上の方法を送信するクライアントは、取引残高の最大部分を占める2つの方法を最初に設定してください。
金額
amount 属性を通じて Rokt Placement に提供される値は、ページ上で顧客に表示される総額を反映しています。チェックアウトまたは支払いページでは、金額は小計であるべきです。
| 受け入れ可能な値 |
|---|
| 任意の整数、または小数点の後に最大2桁の有効数字を持つ倍精度数。 |
国と言語
country に指定する値は、あなたのストアの地域を反映し、language に指定する値はあなたのウェブページのコンテンツを表すべきです。Roktの配置は、表示されるウェブページと同じ言語でオファーを表示し、顧客のショッピング位置に関連する製品を提供します。
| 国名 | 言語 | ストアロケール |
|---|---|---|
| United States | English | en_US |
現在、他の国および言語はPayments Marketplaceではサポートされていません。
通貨
この属性が提供されると、指定されたロケールに対して通貨がフォーマットされます。値を提供することで、顧客のロケールに適した通貨で価格を表示できます。
確認参照
確認参照IDを提供することで、報告目的で個別の取引をカウントすることができます。