Personalize APIフローの実行
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Personalize REST APIフロー実行サービスを使用して、対話型の実験またはエクスペリエンスのフローを実行できます。これは、Webベースまたはモバイルアプリケーションを介して行うことができるため、動的なオファーやコンテンツをリアルタイムでパーソナライズできます。たとえば、ゲストを次のページに誘導したり、カートや注文に商品を追加するように促したりできます。
フロー実行サービスの特性:
-
インタラクティブな体験や実験でのパーソナライゼーションを促進
-
リアルタイムの応答を呼び出します
-
対話型実験で意思決定モデルを使用して、次善のオファーまたはアクションを返すことをサポートします
フロー実行要求を送信する場合、これらの属性の1つだけを使用できます。 browserId、email、またはidentifiers。 browserId属性を使用してフローを実行することをお勧めします。これにより、マーケターがインタラクティブなテストやエクスペリエンスに追加したゴールは、正しいブラウザーセッションに結び付けられ、コンバージョンがカウントされ、マーケターが パフォーマンス分析を表示する際のアトリビューション率が正確になります。
browserId属性を使用してフローを実行できないシナリオがいくつかあります (たとえば、browserIdが永続化されていない場合など)。別の例としては、意思決定モデルの出力をリアルタイムでマーケティングクラウドなどの外部システムに送信する場合で、browserId属性は関係ありません。どちらのシナリオでも、email属性またはidentifiers属性を使用してフローを実行することをお勧めします。
次の表では、フロー実行モデルの属性について説明します。
|
属性 |
種類 |
形容 |
使用例 |
|---|---|---|---|
|
clientKey |
糸 |
Sitecore Personalizeから取得したクライアント キー。 |
"mhbWwbHYfhpheu86hp60oR76S4jQMmZr" |
|
channel |
string (大文字) |
ゲストが訪れた各ページでキャプチャされたチャンネル。 デフォルトは "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 |
識別子の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" |
friendlyIDの
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 PersonalizeがfriendlyIdの最初の辞書式一致を実行するようにするには、friendlyID属性の値としてproduct_recommender* を渡します。アステリックスを使用して辞書式の順序を適用し、ページターゲティングやリアルタイムのオーディエンスフィルターなどの他の条件に一致して合格する最初のライブエクスペリエンスを実行できます。