Last updated 2023年9月12日

データ統合

Roktが承認された支払いプロバイダのサインアップまたは申請フローをロードするために、適切なデータ要素を統合することが重要です。 アカウントマネージャーは、必要な情報を収集するためにあなたと協力し、それからあなたの特定のニーズに基づいたカスタムスニペットを提供します。

コア属性 - 支払いページ

重要

これらの属性のいずれかを変更する必要がある場合は、アカウントマネージャーと連携してください。

このテーブルは、Roktの配置を選択して表示するために必要なコア属性を示しています。

属性名	タイプ	受け入れられる値	説明
amount	decimal	数値	ページ上で顧客に表示される注文の合計金額（小計）。
country	ISO 3166 国コード	US	サイトの地域に対応する国コードです。
language	ISO 639-3 言語コード	eng	サイトの言語です。
currency	string	- USD - AUD - CAD - EUR - GBP - NZD	注文の通貨です。
cartItems	任意の複雑なデータ型がサポートされています。	カートアイテムの属性を参照してください。	顧客のカートに関連するすべてのデータを表すデータ構造です。各製品について、製品名、製品カテゴリ、数量、価格、SKUなどが含まれます。カートデータを含む任意の複雑なデータ型をサポートします。多次元配列、オブジェクト、または文字列などが含まれます。
Email (if present)	string	@とドメインを含める必要があります。	顧客のメールアドレスです。

コア属性 - 確認ページ

最適化を向上させ、支払いページの配置により関連性を高めるために、確認ページの統合に次の属性を追加することは非常に重要です。

属性名	タイプ	受け入れられる値	説明
Email	string	@とドメインを含める必要があります。	顧客のメールアドレスです。
ccbin/iin	number	6桁の数字です。	クレジットカード番号の最初の6桁です。
payment type	string	- debit - credit - chargeCard - payPal - applePay - googlePay - grabPay - weChatPay - aliPay - affirm - sezzle - zip - afterpay - clearpay - klarna - Splitit - giftCard - customerCredit - cash	注文の支払い方法です。

カートアイテムデータ

cartItemsは、配列、オブジェクト、または文字列のいずれの形式でも提供できます。カート内の各製品には、以下のプロパティが含まれる必要があります。

属性名	タイプ	説明
majorCat	string	製品のメジャーカテゴリー、または製品タクソノミーの第1レベルとしても知られています。
majorCatID	string	メジャー製品カテゴリーのIDです。
minorCat1	string	製品のマイナーカテゴリー、または製品タクソノミーの第2レベルとしても知られています。
minorCat1ID	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		注文を行う会社の名前（該当する場合）です。
paymentMethod	string	- デジタル決済 - カード決済 - 銀行振込 - 現金決済	支払い方法は、支払いが行われる支払い手続きを指定します。
paymentSubMethod	string	デジタル決済の場合： - Buy Now Pay Later - デジタルウォレット カード決済の場合： - クレジットカード - デビットカード - プリペイドカード 銀行振込の場合： - 銀行振込 - 直接デビット 現金決済の場合：- 現金 - 小切手	これは顧客が選択した具体的な支払い方法を表します。 なお、支払いサブメソッドは支払い方法によって異なりますのでご注意ください。
paymentBrand	string	一般的な例には以下が含まれます： - Paypal - Venmo - Apple Pay - Google Pay - Amazon Pay - Afterpay - AMEX	支払いに関連するブランドです。
paymentIssuer	string	一般的な例には以下が含まれます： - Barclays - Citibank - Bank of America - AMEX - JPMorgan Chase - Discover - Wells Fargo - Capital One - HSBC	支払い発行者は個人や企業に支払いカードを提供する銀行や金融機関です。
paymentNetwork	string	一般的な例には以下が含まれます： - Mastercard - Visa - Discover - American Express - JCB - Interac - UnionPay	支払いネットワークは、商人、顧客の銀行、支払いプロセッサー間で支払い情報を安全に送信するためのインフラストラクチャとルールを提供します。
billingAddress1	address	許可される特殊文字： -'´`",.:;#&/()+@ °ºᵃª_ \	支払いタイプの住所の1行目です。
billingAddress2	address	許可される特殊文字： -'´`",.:;#&/()+@ °ºᵃª_ \	支払いタイプの住所の2行目です。
billingCity	string		請求ユーザーの都市または郊外、地域によって異なります。
billingState	string		支払いタイプの州です。
billingZipcode	zipcode	国際郵便連合の住所システムに従った検証です。	請求タイプの郵便番号または郵便番号です。
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		顧客の生年月日です。

追加情報

金額

amount属性を通じてRokt Placementに提供される値は、顧客がページ上で表示される完全な価格を反映しています。 チェックアウトや支払いページでは、金額は小計になるべきです。

受け入れられる値
整数または小数点以下の桁数が最大2桁の倍精度浮動小数点数。

国と言語

countryの値は、店舗の地域を反映し、languageの値はウェブページのコンテンツを反映する必要があります。 Roktの配置は、表示されるウェブページと同じ言語でのみオファーを表示し、顧客のショッピング場所に関連する製品を表示します。

国	言語	ストアのロケール
アメリカ合衆国	英語	en_US

注意

現時点では、他の国や言語は支払いマーケットプレイスではサポートされていません。

通貨

提供された場合、この属性は指定されたロケールの通貨をフォーマットします。値を提供することで、顧客のロケールに応じて正しい通貨で価格を表示します。

確認参照

確認参照IDを提供することで、報告目的で個別のトランザクションをカウントすることができます。