Rokt Pay+のデータ統合
Rokt Pay+のパートナーは、広告主とキャンペーンタイプの完全なスケールを解放するために、支払い/バッグおよび確認ページ全体で、SDK、サーバー間通信、または同等の方法を介して以下の属性を統合する必要があります。「If Avail.」とマークされた属性は、開始時には必須ではありませんが、キャンペーンの適格性とターゲティングを最大化し、最終的には収益を向上させるために優先的に統合する必要があります。
コア属性コア属性 への直接リンク
これらの属性を変更する必要がある場合は、アカウントマネージャーと協力してください。
| 説明 | 属性名 | 支払いページ | 確認ページ | フォーマット | ペイロード例 |
|---|---|---|---|---|---|
| メール | If Avail. | 必須 | 文字列 | john.smith@rokt.com | |
| 名 | firstname | If Avail. | 必須 | 文字列 | John |
| 姓 | lastname | If Avail. | 必須 | 文字列 | Smith |
| 請求先郵便番号 | billingzipcode | If Avail. | 必須 | 文字列 | 10014 または 10014-1234 |
| 金額 | amount | 必須 | 必須 | 小数 | 300.5 金額を参照 |
| ユーザーの請求国 | country | 必須 | 必須 | ISO Alpha-2 国コード | 例 |
| 通貨 | currency | 必須 | 必須 | 文字列 | USD 通貨を参照 |
| 言語 | language | 必須 | 必須 | 文字列 | EN |
| 支払いサービスプロバイダー | paymentserviceprovider | If Avail. | N/A | カンマ区切り文字列 (受け入れられる支払い方法1, 受け入れられる支払い方法2, など) | cardpayment,klarna,paypal |
| 支払いタイプ | paymenttype | N/A | 必須 | カンマ区切り文字列 (プラットフォーム, カードブランド, 支払いネットワーク)。パイプ(|)は分割支払いを区切る | ギフトカード | Chase, Visa 支払いタイプを参照 |
| カートアイテム | cartitems | 必須 | 必須 | サポートされる任意の複雑なデータ型 (配列, オブジェクト, 文字列) | カートアイテムデータを参照 |
| CCBIN | ccbin | N/A | 必須 | カードBINの最初の6-8桁 | 123456 または 12345678 |
| 確認参照 | confirmationref | N/A | 必須 | 文字列 | XYZ123 確認参照を参照 |
| 携帯電話 | mobile | If Avail. | 必須 | 文字列 | 7325558585 |
| 年齢 | age | If Avail. | 必須 | 整数 | 29 |
| 性別 | gender | If Avail. | 必須 | 文字列 | m |
| 請求先住所1 | billingaddress1 | If Avail. | 必須 | 許可される特殊文字: -'´`",.:;#&/()+@ °ºᵃª_ \ | 123 Main St |
| 請求先住所2 | billingaddress2 | If Avail. | 必須 | 許可される特殊文字: -'´`",.:;#&/()+@ °ºᵃª_ \ | Apt 32 |
| 注文を作成した顧客 | clientcustomerid | If Avail. | If Avail. | ID | abcdefgh1234567 |
| 注文に対応するカートID | cartid | If Avail. | If Avail. | ID | 7654321hgfedcba |
| 税金や送料が適用されていない注文の合計 | subtotal | If Avail. | If Avail. | 小数 | 200.25 |
| 注文の税金の合計額 | totaltax | If Avail. | If Avail. | 小数 | 20.5 |
| 注文の送料の合計額 | totalshipping | If Avail. | If Avail. | 小数 | 5.00 |
| 販売時の平均利益率 | margin | If Avail. | If Avail. | 小数 | 2.00 |
| ユーザーの請求先の都市または地域 | billingcity | If Avail. | If Avail. | 文字列 | San Francisco |
| 支払いタイプの州 | billingstate | If Avail. | If Avail. | 文字列 | California または CA |
| 注文が発送される場所の最初の行 | shippingaddress1 | If Avail. | If Avail. | 許可される特殊文字: -'´`",.:;#&/()+@ °ºᵃª_ \ | 123 Main St |
| 注文が発送される場所の2行目 | shippingaddress2 | If Avail. | If Avail. | 許可される特殊文字: -'´`",.:;#&/()+@ °ºᵃª_ \ | Apt 32 |
| 注文が発送される都市 | shippingcity | If Avail. | If Avail. | 文字列 | San Francisco |
| 注文が発送される州 | shippingstate | If Avail. | If Avail. | 文字列 | California または CA |
| 注文が発送される場所の郵便番号 | shippingzipcode | If Avail. | If Avail. | 郵便番号 | 10014 または 10014-1234 |
| 注文が発送される国 | shippingcountry | If Avail. | If Avail. | ISO Alpha-2 国コード | 例 |
| 顧客のタイプの説明 (例: ゲストまたはメンバー) | customertype | If Avail. | If Avail. | 文字列 | guest |
| 顧客がロイヤルティプログラムのメンバーかどうかを定義します。 | isloyalty | If Avail. | If Avail. | ブール値 | true |
| プログラムのメンバーである顧客のためのロイヤリティ階層の説明。 | loyaltytier | もし利用可能なら | もし利用可能なら | String | Gold |
カートアイテムデータカートアイテムデータ への直接リンク
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 | 製品の製品名。 |
詳細情報詳細情報 への直接リンク
支払いタイプ支払いタイプ への直接リンク
パートナーは、支払いに関連するすべての情報を paymentType フィールドに提供する必要があります。フォーマットは以下の通りです：
- 属性値はカンマ区切り (,) にする必要があります（例：プラットフォーム、カードブランド、支払いネットワーク）。
- パイプ (|) は分割支払いを区切ります（例：ギフトカード + クレジットカード）。
- 分割支払いは別々の属性としてキャプチャされます（例：paymentType, paymentType2）。これにより、既存の下流システムとの互換性が維持されます。ローンチ時には、1つの取引につき最大2つの支払い方法をキャプチャします。2つ以上の方法を送信するクライアントは、取引残高の最大部分を占める2つの方法を最初に配置する必要があります。
支払いサービスプロバイダー支払いサービスプロバイダー への直接リンク
パートナーは、paymentserviceprovider 属性にすべての適格な支払いサービスプロバイダーを提供する必要があります。これにより、支払いキャンペーンがリアルタイムでフィルタリングされ、このリストの値のいずれかと一致する支払いタイプを持つクリエイティブのみが適格となります。注意: これは必須属性ではありません。この属性が提供されない場合、すべてのクリエイティブが適格のままです（デフォルトの動作）。
- 属性値はカンマ区切り (,) の文字列にする必要があります。
- リストの順序は重要ではありません（アルファベット順は任意です）。
- 値は小文字でスペースなしで送信してください。
- 以下は現在受け入れられている値です：
- affirm
- afterpay
- alipay
- applepay
- googlepay
- paypal
- klarna
- venmo
- amazonpay
- cardpayment
- rakutenpay
- affirmautofill
- サンプル属性値:
affirm,applepay,paypal
AmountAmount への直接リンク
amount属性を通じてRokt Placementに提供される値は、ページ上で顧客に表示される全価格を反映しています。チェックアウトまたは支払いページでは、amountは小計であるべきです。
| 受け入れ可能な値 |
|---|
| 任意の整数、または小数点以下2桁までの有効数字を持つ倍精度浮動小数点数。 |
Country and languageCountry and language への直接リンク
countryの下に提供される値は店舗の地域を反映し、languageの下に提供される値はウェブページのコンテンツを反映します。Roktの配置は、表示されるウェブページと同じ言語でオファーを表示し、顧客のショッピングロケーションに関連する製品を表示します。
| Country | Language | Store locale |
|---|---|---|
| United States | English | en_US |
CurrencyCurrency への直接リンク
提供される場合、この属性は特定のロケールに対して通貨をフォーマットします。値を提供することで、顧客のロケールに適した通貨で価格を表示することを保証します。
Confirmation referenceConfirmation reference への直接リンク
確認参照IDを提供することで、報告目的で個別の取引をカウントすることができます。