Last updated

データ統合

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

コア属性 - 支払いページ

重要

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

この表は、Rokt配置を選択して表示するために必要なコア属性を示しています。これらの属性は、支払いページで使用可能な場合に統合する必要があります。

説明	属性名	形式	ペイロード例
金額	amount	decimal	300.5
メール（存在する場合）	email	string	john.smith@rokt.com
名	firstname	string	John
姓	lastname	string	Smith
請求先郵便番号	billingzipcode	string	10014 OR 10014-1234
国	country	ISO Alpha-2 Country Code	Examples
言語	language	string	EN
通貨	currency	string	USD
カートデータ	cartItems	サポートされている任意の複雑なデータ型（配列、オブジェクト、文字列）	カートアイテムデータ 参照

コア属性 - 確認ページ

最適化を向上し、支払いページの配置の関連性を高めるために、以下の属性を確認ページの統合に追加することが非常に重要です。すでに利用可能でない場合は、次を追加してください：

説明	属性名	フォーマット	ペイロードの例
Email	email	string	john.smith@rokt.com
名前	firstname	string	John
名字	lastname	string	Smith
確認参照	confirmationref	string	XYZ123
請求先郵便番号	billingzipcode	string	10014 または 10014-1234
金額	amount	decimal	300.5
支払いタイプ	paymenttype	コンマ区切り文字列 (プラットフォーム, カードブランド, 支払いネットワーク)。パイプ (	) は分割支払いを分ける
クレジットカードBIN	ccbin	string	372888
モバイル	mobile	string	7325558585
国	country	ISO Alpha-2 国コード	事例
年齢	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フィールドに提供する必要があります:

• 属性値はカンマ(,)で区切るべきです（例: platform, card brand, payment network）。
• パイプ(|)は分割支払いを区切ります（例: ギフトカード + クレジットカード）。
• 分割支払いは別々の属性としてキャプチャされます（つまり、paymentType, paymentType2）。これは既存の下流システムとの互換性を保ちます。開始時には、1つのトランザクションにつき最大2つの支払い方法をキャプチャします。クライアントが2つを超える方法を送信する場合、トランザクション残高の大部分を占めた2つの方法を最初に配置するべきです。

金額

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

受け入れられる値
任意の整数、または小数点の後に最大2桁の有効数字があるダブル。

国と言語

countryの項目には、ストアの地域を反映した値を設定し、languageの項目にはウェブページの内容を反映した値を設定します。Roktの配置は、表示されるウェブページと同じ言語でのみオファーを表示し、顧客のショッピングエリアに関連する製品を提供します。

Country	Language	Store locale
United States	English	en_US

重要

現在のところ、Payments Marketplaceでは他の国や言語はサポートされていません。

通貨

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

確認リファレンス

確認リファレンスIDを提供することで、レポート目的のために異なる取引を計上することができます。