Personalize APIフロー実行
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Personalize REST APIフロー実行サービスを使って、インタラクティブな実験や体験のためのフローを実行できます。これはウェブベースやモバイルアプリケーションを通じて行えるため、リアルタイムで動的なオファーやコンテンツをパーソナライズできます。例えば、ゲストを次のページに誘導したり、商品をカートや注文に追加するよう促したりできます。
フロー実行サービスの特徴:
- インタラクティブな体験や実験におけるパーソナライズを促進します
- リアルタイム応答を呼び起こす
- 意思決定モデルをインタラクティブな実験で活用し、次に最良のオファーやアクションを返すことをサポートします
フロー実行リクエストを送信する際、これらの属性のうち1つしか使用できません。 browserId、email、またはidentifiers。フローを実行する際にはbrowserId属性を使用することを推奨します。これにより、マーケターがインタラクティブな実験や体験に追加した目標が正しいブラウザセッションに帰属し、コンバージョンがカウントされ、パフォーマンス分析を閲覧した際にアトリビューション率が正確であることが保証されます。
例えば、browserIdが永続化されていない場合など、browserId属性を使ってフローを実行できない場合もあります。また、意思決定モデルの出力をリアルタイムでマーケティングクラウドのような外部システムに送信する場合も、browserId属性が関係ない場合などがあります。これらのシナリオの両方において、フローを実行する際にemail属性またはidentifiers属性を使用することを推奨します。
以下の表はフロー実行モデルの属性を説明します。
属性
種類
概要
例
clientKey
ストリング
クライアントキーはSitecore Personalizeから取得しました。
"mhbWwbHYfhpheu86hp60oR76S4jQMmZr"
channel
文字列(大文字)
チャンネルはゲストが訪れた各ページに映像を収めていました。
デフォルトは "WEB"です。
"WEB", "MOBILE_WEB", "MOBILE_APP"
language
文字列(2文字のISO 639言語コード)
ゲストが訪れる各ページに表現された言語。
"EN", "FR", "DE"
currencyCode
3文字 ISO 4217
あなたの組織の通貨コード。
"EUR", "USD", "NZD"
pointOfSale
文字列(組織によってあらかじめ定義)
販売時点の使用。
"myretailsite.com", "retailsite.co.uk"
browserId
ストリング
Sitecore Personalizeによって生成されたブラウザのID。
"56860bff-94ba-4d84-aa37-2b5a83d5411b"
ストリング
ゲストのメールアドレス。
identifiers
JSON オブジェクト
ゲストの固有の識別子。
該当なし
params
JSON オブジェクト
パラメータは訪問者の現在のURLから返されました。
該当なし
以下の表はidentifiersオブジェクト属性を説明します。
属性
概要
種類
例
provider
識別子提供者です。
ストリング
"ProfileSystem"
id
識別子識別。
ストリング
"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41"
以下の表はparamsオブジェクト属性を説明します。
属性
概要
種類
例
utm.campaign
訪問者の現在のURLに含まれるUTMキャンペーンパラメータ。
ストリング
"content_promotion"
utm.source
訪問者の現在のURLに含まれるUTMソース。
ストリング
"bing"
utm.medium
訪問者の現在のURLに含まれるUTMメディア。
ストリング
"social"
utm.content
訪問者の現在のURLに含まれるUTMコンテンツ。
ストリング
"call_to_action"
フレンドリーIDです
friendlyID属性を使って、プログラム的に実験や体験を実行できます。実験や体験を作成すると、Sitecore Personalize実験や体験に名前を付けると自動的にIDが作成されます。例えば、実験をProduct Recommenderと名付けると、Sitecore Personalize自動的に「product_recommender」という名前のIDを生成します。
組織によっては、Product Recommenderという実験のいくつかのバリエーションがあり、それぞれ異なるページターゲットやオーディエンスフィルター、その他の条件を満たす必要があります。
同じ例を使うと、マーケティングキャンペーン終了後にユーザーが意図的に「Product Recommender」と名付けられた実験の一部を削除することがあります。これは地域間でよく起こり得ます。参照の整合性を保つために、Sitecore Personalize作成した実験名が削除された実験名と同一の場合、自動的にfriendlyID属性の値に数字を付け加えます。例えば、Sitecore Personalizeは自動的に数字2を付け加え、 friendlyID属性の値はproduct_recommender_2となります。
Sitecore PersonalizefriendlyIdの最初の辞書順マッチングを実行するためにファジィマッチングを適用するには、friendlyID属性の値としてproduct_recommender*を渡します。アステリックスを使って辞書順を適用し、ページターゲティングやリアルタイムオーディエンスフィルターなど他の条件を一致・クリアする最初のライブ経験を実行することができます。