使用できる変数

次のリストで、使用できる変数について説明します。

entity.id

単一値のみ。

この必須パラメーターで商品を識別します。様々な商品の品目を識別してそのデータを共有するために、この英数字 ID は、使用するすべての Adobe Experience Cloud 製品(Analytics を含む)で同じにする必要があります。

entity.id の値には、スペース、スラッシュ、アンパサンド、疑問符、パーセント記号、コンマ、または REST API 呼び出しで渡す際に URL エンコーディングが必要なその他の句読点を含める 指定しない 必要があります。 ハイフンとアンダースコアを使用できます。 entity.id 値に無効な句読点を含めると、一部の Recommendations 機能が正常に動作しなくなることがあります。

例:'entity.id=67833'

entity.name

単一値のみ。

商品がレコメンデーションされる際に Web サイトに表示される商品名。

例:'entity.name=Giants& vs& Rockies& 5/12'

entity.categoryId

複数値(コンマ区切りリスト)をサポート。

現在のページのカテゴリです。entity.categoryID には、cardigans サブサブサブサブセクション(例:womenswomens:sweaterswomens:sweaters:cardigans)など、複数のカテゴリを含めることができます。 複数のカテゴリはコンマで区切る必要があります。

categoryId の値は 250 文字に制限されています。

NOTE
Category ページ内のカテゴリに基づくレコメンデーションを表示するには、その特定のレコメンデーションの表示に使用される mbox に渡せる categoryId は 1 つだけです。 categoryId の値は、Product Detail ページで渡された entity.categoryId の値と完全に一致する必要があります。

例:

  • 製品詳細ページの例:womenswomens:sweaterswomens:sweaters:cardigans
  • カテゴリページのセーターの例:womens:sweaters
  • カテゴリページ Cardigans の例:womens:sweaters:cardigans

カテゴリベースのレコメンデーションの場合、カテゴリ値をコンマで区切ります。 コンマで区切られた値はカテゴリになります。また、別の区切り文字(コロン(:)など)を使用してカテゴリ値内のサブカテゴリを区切ることで、サブカテゴリを定義できます。

例えば、以下のコードでは、女性のカテゴリはいくつかのサブカテゴリに分割されています。

mboxCreate('mboxName', 'entity.id=343942-32', 'entity.categoryId= Womens, Womens:Outerwear, Womens:Outerwear:Jackets, Womens:Outerwear:Jackets:Parka, Womens:Outerwear:Jackets:Caban', 'entity.thumbnailUrl=...', 'entity.message=...', );

mbox 配信の場合、最も長い属性名がキーに使用されます。同じ長さの場合、最後の属性が使用されます。上記の例では、カテゴリキーは Womens:Outerwear:Jackets:Caban です。

entity.brand

単一値のみ。

品目のブランド名を表示します。

例:'entity.brand=brandxyz'

entity.pageUrl

単一値のみ。

その品目を購入できるページの相対 URL を定義します。

例:'entity.pageUrl=baseball/giants-tix/giantsvrockies5.12.2000-67833'

entity.thumbnailUrl

単一値のみ。

品目と共に表示されるサムネールの相対 URL を定義します。

例:'entity.thumbnailUrl=baseball/giants-tix/giants-136px.gif'

entity.message

単一値のみ。

「特価」や「クリアランス」など、レコメンデーションに表示する商品についてのメッセージです。メッセージは通常、商品名よりも長いものとなります。entity.message を使用して、テンプレート内の製品に表示する追加情報を定義します。

例:'entity.message=Family special'

entity.inventory

単一値のみ。整数値または long 値が必要です。

品目の在庫レベルを表示します。

例:'entity.inventory=1'

空の在庫属性処理: 配信について、entity.inventory > 0 または entity.inventory = 0 のインクルージョンルール、コレクションルールまたは条件が設定されていて、製品に在庫が設定されていない場合、Target はこの値を TRUE と評価し、在庫が設定されていない製品を含めます。 その結果、在庫が設定されていない商品がレコメンデーション結果に表示されます。

同様に、entity.inventory = 0 で entity.inventory が設定されていないグローバル除外ルールがある場合は、Target はこのルールを TRUE と評価し、その商品を除外します。

既知の問題: 製品検索が、設定されていない在庫値属性の配信と一致しません。 例えば、entity.inventory = 0 のルールの場合、在庫値が設定されていない製品は製品検索で表示されません。

entity.value

単一値のみ。

品目の価格や価値を定義します。

例:'entity.value=15.99'

entity.value は、10 進数形式のみ(例:15.99)をサポートします。 コンマ形式(15,99)はサポートされていません。

entity.margin

単一値のみ。

その品目の利益幅またはその他の価値。

例:'entity.margin=1.00'

エンティティ。custom

複数値(JSON 配列)をサポートします。

品目について追加情報を提供するカスタム変数を最大 100 個まで定義できます。カスタム属性のそれぞれに対し、未使用の属性名を指定できます。例えば、entity.genre というカスタム属性を作成して、ブックやムービーを定義できます。 チケット販売者は、スポーツイベントの訪問チームやコンサートの開会行為など、二次演奏者のイベント会場の属性を作成することができる。

制限事項:

  • 事前定義されたエンティティの属性名はカスタムエンティティの属性に使用できません。
  • 属性 entity.environment はシステムによって予約されており、カスタムエンティティの属性には使用できません。targetPageParams、フィードまたは API を使用して entity.environment を渡す試みは無視されます。

例:

'entity.venue=AT&T Park'

'entity.secondary=Rockies'

カスタムエンティティの属性では、複数の値がサポートされます。文字および値の制限については、カスタムエンティティの属性を参照してください。

例:'entity.secondary=["band1", "band2"]'

複数値のカスタムエンティティの属性には、有効な JSON 配列が必要です。正しい構文情報は、 カスタムエンティティ属性を参照してください。

Target