[Premium]{class="badge positive" title="Target Premium に含まれる機能を確認してください。"}
エンティティの属性
エンティティ属性を使用して、製品またはコンテンツの情報を Adobe Target Recommendations に渡します。
エンティティとは、レコメンデーションする項目を指します。エンティティには、製品、コンテンツ(記事、スライドショー、画像、ムービー、テレビ番組など)、求人情報、レストランなどが含まれます。
Recommendations は、アルゴリズムで使用される productId
または productPurchasedId
(コードでは entity.id
と呼ばれます)を送信します。
次の点に留意してください。
- 注文確認ペ
entity.id
ジに送信されるproductPurchasedId
と、製品レポートで使用されるproductId
と一致 Adobe Analytics る必要があります。 - に渡すエンティティ属性値は Recommendations61 日後に期限切れになります。 Adobeでは、各エンティティ属性の最新の値を、カタログの各項目に対して月に 1 回以上 Recommendations に渡すことをお勧めします。
ほとんどの定義済みパラメーターは、1 つの値のみを受け付け、新しい値が古い値を上書きします。 categoryId
パラメーターは、その商品を含む各カテゴリ用の値のコンマ区切りリストを受け取ることができます。新しい categoryId
の値は既存の値を上書きせず、代わりにエンティティ更新の際に追加されます(上限 250 文字)。
at.js 1 を使用している場合、一般的に、ディスプレイ情報 mbox は次の例のようになります。x と mboxCreate
すべてのエンティティパラメーター属性では、大文字と小文字が区別されます。
mboxCreate
(次の例で使用)はサポートされなくなりました。 at.js を使用して製品またはコンテンツの情報を Recommendations に渡す方法 2.x の場合は、targetPageParams を使用します。 例については、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 を含む)で同じにする必要があります。
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 サブサブサブサブセクション(例:womens
、womens:sweaters
、womens:sweaters:cardigans
)など、複数のカテゴリを含めることができます。 複数のカテゴリはコンマで区切る必要があります。
categoryId
の値は 250 文字に制限されています。
categoryId
は 1 つだけです。 categoryId
の値は、Product Detail ページで渡された entity.categoryId
の値と完全に一致する必要があります。例:
- 製品詳細ページの例:
womens
、womens:sweaters
、womens: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 配列が必要です。正しい構文情報は、 カスタムエンティティ属性を参照してください。
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' )