---
title: "Personalize APIフロー実行"
slug: "personalize-api-flow-execution"
abstract: "オブジェクト属性とPersonalize REST API(Sitecore Personalize)で使用されているfriendlyIDを記述します。"
---
# Personalize APIフロー実行

Personalize REST APIフロー実行サービスを使って、インタラクティブな実験や体験のためのフローを実行できます。これはウェブベースやモバイルアプリケーションを通じて行えるため、リアルタイムで動的なオファーやコンテンツをパーソナライズできます。例えば、ゲストを次のページに誘導したり、商品をカートや注文に追加するよう促したりできます。

フロー実行サービスの特徴:

-   インタラクティブな体験や実験におけるパーソナライズを促進します
-   リアルタイム応答を呼び起こす
-   意思決定モデルをインタラクティブな実験で活用し、次に最良のオファーやアクションを返すことをサポートします

フロー実行リクエストを送信する際、これらの属性のうち1つしか使用できません。 browserId、email、またはidentifiers。フローを実行する際にはbrowserId属性を使用することを推奨します。これにより、マーケターがインタラクティブな実験や体験に追加した目標が正しいブラウザセッションに帰属し、コンバージョンがカウントされ、[パフォーマンス分析を閲覧](https://doc.sitecore.com/personalize/en/users/sitecore-personalize/en/view-performance-analytics-in-sitecore-personalize.html)した際にアトリビューション率が正確であることが保証されます。

例えば、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"

email

ストリング

ゲストのメールアドレス。

"john.doe@gmail.com"

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\*を渡します。アステリックスを使って辞書順を適用し、ページターゲティングやリアルタイムオーディエンスフィルターなど他の条件を一致・クリアする最初のライブ経験を実行することができます。