PREMIUM エンティティの属性

エンティティ属性を使用して、製品やコンテンツの情報をAdobe Target Recommendationsに渡します。

エンティティとは、レコメンデーションする項目を指します。エンティティには、製品、コンテンツ(記事、スライドショー、画像、映画、テレビ番組)、ジョブリスト、レストランなどが含まれます。

Recommendations は、アルゴリズム内で使用されている productId または productPurchasedId(コード内では entity.id)を送信します。

次の点に留意してください。

  • entity.id は、注文確認ページに productPurchasedId 送信されたものと、 productId 製品レポートで Adobe Analytics 使用されたものと一致する必要があります。
  • Recommendationsに渡すエンティティ属性値は、61日後に有効期限が切れます。 Adobeでは、各エンティティ属性の最新値を、カタログ内の各品目に対して1か月に1回以上Recommendationsに渡すことをお勧めします。

ほとんどの定義済みパラメーターは、単一の値のみを受け取り、新しい値が古い値を上書きします。 categoryId パラメーターは、その商品を含む各カテゴリ用の値のコンマ区切りリストを受け取ることができます。新しい categoryId の値は既存の値を上書きせず、代わりにエンティティ更新の際に追加されます(上限 250 文字)。

at.js 1を使用している場合、一般に、表示情報mboxは次の例のようになります。** xwith mboxCreate.エンティティのパラメーター属性はすべて大文字と小文字が区別されます。

メモ

at.js 2を使用している場合。x, mboxCreate (次の例で使用されている)はサポートされなくなりました。at.js 2を使用して、製品またはコンテンツの情報をRecommendationsに渡す。xtargetPageParamsを使用します。例については、Recommendationsの計画と実装を参照してください。

<div class="mboxDefault"></div><script language="JavaScript1.2"> 
 
mboxCreate('productPage', 
 
'entity.id=67833', 
 
'entity.name=GIANTS VS ROCKIES 5/12', 
 
'entity.categoryId=BASEBALL, GIANTS, SF BAY AREA', 
 
'entity.pageUrl=/help/baseball/giants-tix/giantsvrockies5.12.2000-67833', 
 
'entity.venue=AT&T PARK', 
 
'entity.secondary=ROCKIES', 
 
'entity.thumbnailUrl=/help/baseball/giants-tix/giants-136px.gif', 
 
'entity.message=FAMILY SPECIAL', 
 
'entity.value=15.99', 
 
'entity.inventory=1' 
 
); 
 
</script>
メモ

Recommendations は、サイト上のすべての環境から送信されるデータを受信するので、pageUrl および thumbnailUrl には、絶対 URL ではなく相対 URL を指定することをお勧めします。相対 URL を使用すると、ステージングサーバーや開発サーバーへのハードコーディングされたリンクを回避できます。

mbox が商品ページにある場合、商品 ID とカテゴリ ID の両方を含めることができます。そのどちらが表示されるかは選択されているアルゴリズムで決定されます。商品 ID は親和性アルゴリズムで使用され、カテゴリ ID はカテゴリアルゴリズムで使用されます。

使用できる変数

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

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には、サブセクションのサブセクションに含めるカーディガン(例えば、女性、女性:セーター、女性:セーター:カーディガン)など、複数のカテゴリを含めることができます。 複数のカテゴリはコンマで区切る必要があります。

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

メモ

カテゴリページでカテゴリに基づいてレコメンデーションを表示するには、1 つの categoryId のみ、特定のレコメンデーションの表示に使用される mbox に渡すことができます。categoryId の値は、商品詳細ページで渡される entity.categoryIdの値と完全に一致する必要があります。

例:

  • 商品詳細ページの例:女性、女性:セーター、女性:セーター:カーディガン
  • カテゴリページ「セーター」の例:女性:セーター
  • カテゴリページ「カーディガン」の例:女性:セーター:カーディガン

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

例えば、次のコードでは、女性のカテゴリが複数のサブカテゴリに分かれています。

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&nbsp;special'

entity.inventory

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

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

例:'entity.inventory=1'

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

同様に、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'

entity.custom

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

品目について追加情報を提供するカスタム変数を最大 100 個まで定義できます。カスタム属性のそれぞれに対し、未使用の属性名を指定できます。例えば、entity.genreという名前のカスタム属性を作成して、書籍や映画を定義できます。 チケット業者は、スポーツイベントでの来訪チームやコンサートの前座など、第2のパフォーマーのイベント会場の属性を作成できます。

制限事項:

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

例:

'entity.venue=AT&T&nbsp;Park'

'entity.secondary=Rockies'

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

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

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

entity.event.detailsOnly

単一値のみ。

mbox の呼び出しによって、アルゴリズムの行動データカウンターが増加することを回避するために使用します。

例:'entity.event.detailsOnly=true'

下の例では、最初のmbox呼び出しによって、カタログと行動データが更新されます。 2回目のmbox呼び出しは、カタログのみを更新します。

mboxCreate('myMbox', 'profile.geo.city = new york', 'profile.geo.state = new york',  'entity.id = 'entity.inventory = 4' )
mboxCreate('myMbox',  'profile.geo.city = new york', 'profile.geo.state = new york',  'entity.id = 123', 'entity.inventory = 4' 'entity.event.detailsOnly=true' )

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now