【第589回】Personalization：Sitemap Builder の Schema を確認する
前回の記事では、Salesforce Personalization の Sitemap Builder で作成した Event を Page Type に設定し、
Product View
Add to Cart
Customer Confirm Email
Customer Identification
Purchase
を実際の Web サイト上の操作と紐付けました。
今回は Schema タブを確認します。
Schema は、Web サイトから送信する Event を Data 360 がどのようなデータ構造として受け取るのかを定義するものです。
Sitemap Builder では、これまで設定してきた Event や Profile Attributes をもとに、必要な Schema が自動的に生成されます。
Personalization 基礎シリーズ
Sitemap Builder シリーズ
Data 360 設定シリーズ
Personalization 設定シリーズ
Schema タブを開く
Sitemap Builder の Schema タブを開きます。
画面上部では、Resolver を使用して追加した Attribute の Data Type や Required を指定できます。
今回の TrailNest では、Standard Events の catalog に、
Price
Name
が表示されています。
それぞれ、
Price → Number
Name → Text
として設定されています。デフォルトのままで問題ありません。
今回は Price を Number、Name を Text とします。どちらも Product View の追加情報として利用する Attribute のため、Required は設定しません。
これは、Product View で設定した Product Price と Product Name に対応しています。
Custom Events
今回作成した、
Customer Confirm Email
Customer Identification
は Custom Event ですが、どちらにも Interaction Attributes は追加していません。
そのため Custom Events には、
No resolver-based attributes to configure.
と表示されます。
Profile Attributes
続いて Profile Attributes を確認します。
今回作成した、
Email Capture
Customer Identification
が表示されています。
Email Capture
Email Capture には、
があります。
今回は Email Address を文字列として取得するため、
Type：Text
Required：Yes
とします。
Customer Identification
続いて Customer Identification を確認します。
ここには、
IDNameWeb
IDType
userId
があります。
今回の TrailNest では、
IDNameWeb：TrailNest Customer ID
IDType：Customer ID
userId：Checkout Customer ID
として設定しています。
それぞれ Customer ID を Party Identification として扱うために使用します。
Salesforce の Web Connector Mapping では、
IDNameWeb → Identification Name
IDType → Party Identification Type
userId → Identification Number
として Party Identification に Mapping されます。
今回はこれらを Text として扱います。
IDNameWeb
- Type：Text
- Required：YesIDType
- Type：Text
- Required：YesuserId
- Type：Text
- Required：Yes
Schema Preview を確認
画面下部の Schema Preview では、自動生成された Schema を確認できます。
今回の構成では、次の 10 種類の Schema が生成されています。
Catalog
Cart
Cart Item
Order
Order Item
Consent Log
userEngagement
Contact Point Email
Party Identification
Identity
今回新たに追加されたのは、
Order Item
Party Identification
です。
Party Identification
Customer Identification を設定したことで、Schema Preview には Party Identification が生成されています。
Party Identification では、
Identification Name
Party Identification Type
Identification Number
が確認できます。
今回の Schema では、それぞれ、
Identification Name → IDNameWeb
Party Identification Type → IDType
Identification Number → userId
として生成されています。
3 項目とも、
Type：Text
Required：Yes
です。
Order と Order Item
今回の Purchase Event では、Order ID や Total Value だけでなく、購入商品の Line Items も設定しています。
そのため Schema Preview には、
Order
Order Item
がそれぞれ生成されています。
Order は注文全体を表し、Order Item はその注文に含まれる商品明細を表します。
Order Item では、
orderEventId
catalogObjectId
catalogObjectType
quantity
price
totalPrice
などが確認できます。
このうち orderEventId には、親となる Order Event の eventId が設定されるため、どの Order に属する商品明細なのかを関連付けることができます。
共通項目も自動生成される
Schema Preview を見ると、それぞれの Event に、
deviceId
eventId
dateTime
eventType
sessionId
pageView
sourcePageType
sourceUrl
などの共通項目も用意されています。
これらをすべて Sitemap Builder の Resolver で作成する必要はありません。
Salesforce Interactions SDK と Data 360 Event Beacon によって、Event の処理に必要な共通情報が付与されます。
そのため Sitemap Builder では、Product ID や Email Address など、Web サイトから取得したい値を中心に設定できます。
いかがでしたでしょうか。
今回は Sitemap Builder の Schema タブを確認しました。
Sitemap Builder では、これまで設定してきた Event や Profile Attributes をもとに Schema が自動生成されるため、JSON Schema を一から作成する必要はありません。
ただし、実際に利用する前に、
追加した Attribute
Profile Attributes
Order / Order Item
Data Type
Required
生成された Schema
が意図した内容になっているか確認しておくことが重要です。
次回は Debug を使用して、ここまで設定してきた Sitemap が実際の TrailNest 上で正しく動作するか確認していきます。
今回は以上です。
