PREMIUMPlanとRecommendationsの実装

Recommendations アクティビティを作成する前に知っておくべきこと。

Recommendations の計画と実装

Recommendations アクティビティを作成する前に知っておくべきこと。

Recommendations では、次の情報の階層が設定されている必要があります。

手順	情報	詳細
	JavaScript ライブラリ	各ページには、at.js バージョン 0.9.1（またはそれ以降）か mbox.js バージョン 55（またはそれ以降）への参照が必要です。この実装の手順は、Target アクティビティを使用するすべてのページで必要です。商品 ID やカテゴリ ID などのキーを含めることができます。 at.js について詳しくは、at.js の実装を参照してください。 mbox.js について詳しくは、Mbox.js の実装を参照してください。
	キー	キーは、レコメンデーションに表示される製品やコンテンツのタイプを決定します。例えば、製品カテゴリをキーにできます。レコメンデーションキーに基づくレコメンデーションの設定を参照してください。
	属性	属性を使用すると、表示したい製品についてさらに細かい情報を提供できます。例えば、ある価格帯の製品や、在庫のしきい値を満たしている品目を表示することができます。属性は、mbox 内またはフィード. 詳しくは、インクルージョンルールの 指定を参照してください。
	除外	除外によって、レコメンデーションに表示しない特定の品目を決めることができます。 除外を参照してください。
	購入の詳細	購入の詳細は、購入した品目や購入が完了した際の注文についての情報を提供します。

ベースとなる実装

ベースとなる実装では、どの商品やサービスがレコメンデーションに表示されるかを決定するパラメーターをページに渡す必要があります。

Recommendations アクティビティの設定を開始する前に、商品データが Recommendations に提供される方法を理解し、どの方法が要件に最適かを判断する必要があります。

Recommendations に商品やサービスの情報を提供する方法は 2 とおりあります。

上記の方法は、次の例のように個別に使用することも、組み合わせて使用することもできます。

例 1：ページとフィードの組み合わせ

ある一般的な Recommendations の実装オプションでは、ページパラメーターとフィードの両方が使用されています。

この方法は、相対的に設定された商品カタログがあるものの、特定の季節の品目や特価の品目を強調したい小売店などに好まれます。ほとんどの顧客は主にフィードを経由して情報を提供し、特定の場合のみページの調整をおこないます。

頻繁に変更されない情報の提供には、フィードを使用します。CSV ファイルと Google フィードのどちらを使用する場合でも、次のパラメーターを使用します。

• 必須パラメーター

  • entity.id

• 便利なパラメーター

  • entity.name
  • entity.categoryId
  • entity.brand
  • entity.pageUrl
  • entity.thumbnailUrl
  • entity.message
  • すべてのカスタム属性

フィードが設定されて Recommendations に渡されたら、頻繁に（つまり 1 日 2 回以上）変更する属性のページにパラメーターを渡します。

• 必須パラメーター

  • entity.id
  • entity.categoryId

• 便利なパラメーター

  • entity.inventory
  • entity.value

最後に実行されたデータセットが優先されます。フィードを渡してからページパラメーターを更新すると、フィードで渡された情報は上書きされ、ページパラメーターの変更事項が表示されます。

例 2：商品（内容）詳細ページのすべてのパラメーターを渡す

ページのすべてのパラメーターを渡すと、ページの更新によってすばやく更新することができます。組織によっては、IT 部門や Web デザインチームの関与が必要になります。

この例は、とりわけ内容が常に変化するメディア企業にとって有用です。

• 必須パラメーター

  • entity.id
  • entity.categoryId
  • その他の全属性

サンプルコード

例えば、商品またはコンテンツページのヘッダーセクションで以下のコードを使用できます。

function targetPageParams() {
 return {
    "entity": {
       "id": "32323",
       "categoryId": "My Category",
       "value": 105.56,
       "inventory": 329
    }
 }
}

様々なタイプのページで使用できるコードの例については、ページタイプに従った実装.

ページタイプに従った実装

ページのタイプは Recommendations の実装に影響します。

例えば、製品ページ上で表示したいレコメンデーションのタイプと、カテゴリのページまたはホームページで表示したいレコメンデーションのタイプとは異なる場合があります。各ページで、mbox 呼び出しの前に特有の関数を実行すると、適切なレコメンデーションを表示することができます。

この例で使用されている属性について詳しくは、エンティティの属性を参照してください。

有効な JSON 形式である必要があります。

後述の targetPageParams 関数は、ページの実装にタグ管理ソリューションを使用している場合に特に便利です。Adobe Experience Platform Launch at.js/mbox.js参照と targetPageParams 関数をページに配置し、値を設定できます。この関数は、at.js／mbox.js 呼び出しの前に置くか、at.js／mbox.js の Extra JavaScript セクションに置く必要があります。

すべてのページ

レコメンデーションを含むすべてのページ上で、at.js または mbox.js への参照が必要です。レコメンデーションのあるすべてのページに以下のうちいずれかの参照を追加してください。

<script src="/docs/target/at.js /></script>

<script src="/docs/target/mbox.js /></script>

この実装は、以下を満たしている必要があります。

• at.js バージョン 0.9.2（またはそれ以降）か mbox.js バージョン 55（またはそれ以降）

• mbox.js は target.js への参照を含む（at.js は target.js への参照を必要としません）

at.js の実装について詳しくは、at.js のデプロイ方法を参照してください。

mbox.js の実装について詳しくは、Mbox.js の実装を参照してください。

この 2 つの Target JavaScript ライブラリの違いについて詳しくは、at.js のメリットを参照してください。

カテゴリページ

カテゴリページでは、製品やコンテンツのレコメンデーションをそのカテゴリ内に制限したい場合が多いでしょう。カテゴリページの設定には、ページで使用するキーの設定が必要です。キーについて詳しくは、レコメンデーションキーに基づくレコメンデーションの設定を参照してください。

function targetPageParams() { 
   return { 
      "entity": { 
         "categoryId": "My Category" 
      } 
   } 
}

製品紹介ページ

製品紹介ページでは、ある品目や、特定の価格や在庫レベルの品目をレコメンデーションしたい場合があります。また、カテゴリページに必要なキーの他に頻繁に変更される属性（価値や在庫など）を設定することもできます。

function targetPageParams() { 
   return { 
      "entity": { 
         "id": "32323", 
         "categoryId": "My Category", 
         "value": 105.56, 
         "inventory": 329 
      } 
   } 
}

買い物かごページ

買い物かごページでは、例えば既に買い物かごにある品目など、レコメンデーションからいくつかの品目を除外したい場合があるでしょう。

<script type="text/javascript">
function targetPageParams() {
   return {
      "excludedIds": [352, 223, 23432, 432, 553]
      }
}
</script>

「ありがとうございます」ページ

「ありがとうございます」ページでは、別の品目のレコメンデーションをおこなわずに、注文の合計、注文 ID、購入した製品を表示することができます。2 つ目の mbox を実装し、注文情報を取得できます。

• at.js を使用している場合は、コンバージョンの追跡.
• mbox.js を使用している場合、注文の確認 mbox の作成 - mbox.js を参照してください。

設定

設定を使用して Recommendations の実装を管理します。

Recommendations設定オプションにアクセスするには、Adobe Experience CloudでTargetを開き、Recommendations/設定​をクリックします。

以下のオプションがあります。