エンティティの属性
エンティティの属性を使用して、製品やコンテンツの情報をに渡します。 Adobe Target Recommendations.
エンティティとは、レコメンデーションする項目を指します。エンティティには、製品、コンテンツ(記事、スライドショー、画像、映画、テレビ番組)、求人情報、レストランなどが含まれます。
Recommendations は productId
または productPurchasedId
( entity.id
(コード内)を参照してください )。
次の点に留意してください。
entity.id
は、productPurchasedId
を注文確認ページに送信し、productId
使用される Adobe Analytics 製品レポート。- に渡すエンティティ属性値 Recommendations は 61 日後に期限切れになります。 Adobeでは、各エンティティ属性の最新の値をに渡すことをお勧めします。 Recommendations カタログの各項目に対して、少なくとも 1 ヶ月に 1 回は必要です。
ほとんどの事前定義パラメーターでは、単一の値のみを受け取り、新しい値によって古い値が上書きされます。 categoryId
パラメーターは、その商品を含む各カテゴリ用の値のコンマ区切りリストを受け取ることができます。新しい categoryId
の値は既存の値を上書きせず、代わりにエンティティ更新の際に追加されます(上限 250 文字)。
一般に、表示情報 mbox は、at.js 1.x 次を使用 mboxCreate
. エンティティのパラメーター属性はすべて、大文字と小文字が区別されます。
mboxCreate
(次の例で使用)はサポートされなくなりました。 製品またはコンテンツの情報をに渡すには Recommendations at.js 2.x,使用 targetPageParams. For an example, see Plan and implement 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>
pageUrl
および thumbnailUrl
には、絶対 URL ではなく相対 URL を指定することをお勧めします。相対 URL を使用すると、ステージングサーバーや開発サーバーへのハードコーディングされたリンクを回避できます。mbox が商品ページにある場合、商品 ID とカテゴリ ID の両方を含めることができます。そのどちらが表示されるかは選択されているアルゴリズムで決定されます。商品 ID は親和性アルゴリズムで使用され、カテゴリ ID はカテゴリアルゴリズムで使用されます。
使用できる変数
次のリストで、使用できる変数について説明します。
entity.id
単一値のみ。
この必須パラメーターで商品を識別します。様々な商品の品目を識別してそのデータを共有するために、この英数字 ID は、使用するすべての Adobe Experience Cloud 製品(Analytics を含む)で同じにする必要があります。
The entity.id
値は not には、REST API 呼び出しで渡される際に URL エンコーディングが必要なスペース、スラッシュ、アンパサンド、疑問符、パーセント記号、コンマ、その他の句読点が含まれます。 ハイフンとアンダースコアを使用できます。 entity.id
値に無効な句読点を含めると、一部の Recommendations 機能が正常に動作しなくなることがあります。
例:'entity.id=67833'
entity.name
単一値のみ。
商品がレコメンデーションされる際に Web サイトに表示される商品名。
例:'entity.name=Giants& vs& Rockies& 5/12'
entity.categoryId
複数値(コンマ区切りリスト)をサポート。
現在のページのカテゴリです。entity.categoryID には、サブセクションのカーディガン ( 例えば、 womens
, womens:sweaters
, womens:sweaters:cardigans
) をクリックします。 複数のカテゴリはコンマで区切る必要があります。
The categoryId
の値は 250 文字に制限されます。
categoryId
を、その特定のレコメンデーションの表示に使用される mbox に渡すことができます。 の値 categoryId
は、次の値と完全に一致する必要があります: entity.categoryId
渡された Product Detail ページに貼り付けます。例:
- 製品の詳細ページの例:
womens
,womens:sweaters
,womens:sweaters:cardigans
- カテゴリページセーターの例:
womens:sweaters
- カテゴリページのカーディガンの例:
womens:sweaters:cardigans
カテゴリベースのレコメンデーションの場合、カテゴリ値はコンマで区切られます。 コンマで区切られた値はカテゴリになります。また、別の区切り文字(コロン(:)など)を使用してカテゴリ値内のサブカテゴリを区切ることで、サブカテゴリを定義できます。
例えば、次のコードでは、Women's カテゴリが複数のサブカテゴリに分割されています。
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
:本または映画を定義します。 チケット業者は、スポーツイベントでの来訪チームやコンサートの前座など、イベントの第 2 のパフォーマーに関する属性を作成できます。
制限事項:
- 事前定義されたエンティティの属性名はカスタムエンティティの属性に使用できません。
- 属性 entity.environment はシステムによって予約されており、カスタムエンティティの属性には使用できません。targetPageParams、フィードまたは API を使用して entity.environment を渡そうとしても無視されます。
例:
'entity.venue=AT&T Park'
'entity.secondary=Rockies'
カスタムエンティティの属性では、複数の値がサポートされます。文字および値の制限については、カスタムエンティティの属性を参照してください。
例:'entity.secondary=["band1", "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' )