[Premium]{class="badge positive" title="Target Premium に含まれる機能を確認してください。"}
フィード
フィードを使用したに読み込んだエンティティの取得 Adobe Target Recommendations. エンティティは、CSV ファイル、Google Product Search フィード形式、および Adobe Analytics 製品の分類。
フィードの概要 concept_D1E9C7347C5D4583AA69B02E79607890
フィードによって エンティティ または、ページ上で使用できない、またはページから直接送信するのは安全でない情報（利益幅や売上原価など）を mbox データに追加します。
フィードを使用すると、詳細な項目情報をに渡すことができます。 Recommendations製品 ID、カテゴリ、名前、メッセージ、その他の属性など。
Target の製品分類ファイル、または Google による製品検索のファイルのどの列を Recommendations サーバーに送信するかを選択できます。
各項目に関するこれらのデータは、次の目的で使用できます。
- デザインでの値の表示
- 条件インクルージョンルールの定義
- 項目を別のコレクションに並べ替える
- レコメンデーションへの除外の適用
項目の説明は、 Target フィードまたは mbox の使用。 エンティティフィードと mbox の両方でデータが収集される場合、どちらか最新のほうが使用されます。通常、mbox のほうが頻繁に閲覧されるので、mbox のデータが最新になります。まれにエンティティフィードのデータと mbox のデータが同時に収集されたものである場合、mbox のデータが使用されます。
The フィード リスト ( Recommendations > フィード) には、作成したフィードに関する情報が表示されます。
The フィード ページには次の列が含まれます。
- 名前：作成中に指定されたフィードの名前。フィードの名前を編集するには、フィード自体を編集する必要があります。フィードを新しい名前で保存すると、フィードは更新されます。
- タイプ：タイプには、CSV、Google 製品フィードおよび Analytics 分類が含まれます。
- ステータス：フィードの現在のステータス。
- スケジュール：フィードの更新スケジュールを表示します。 毎日, 毎週, Every 2 Weeksまたは なし.
- 項目：フィード内の項目数を表示します。
- 最終更新日：フィードが最後に更新された日時とフィードを更新した人物の名前を表示します。最終更新日フィードが「未定義」である場合、そのフィードは Recommendations Classic フィードです。Target Premium Recommendations 内では変更できません。
情報アイコンをクリックすると、最後のアップロード日とフィードの URL を示すカードが表示されます。
省略記号アイコンをクリックして、次のアクションにアクセスします。 非アクティブ化, Edit, コピー、および 削除.
- カタログのコンテンツが期限切れにならないように、フィードは少なくとも毎月実行する必要があります。
- フィードファイルから項目を削除しても、カタログからはその項目は削除されません。 カタログから項目を削除するには、 Target UI または API。 または、品目の属性（在庫など）を変更して、品目が考慮から除外されるようにします。
ソースのタイプ
エンティティは、CSV ファイル、Google Product Search フィード形式、および Adobe Analytics 製品の分類。
CSV section_65CC1148C7DD448FB213FDF499D35FCA
.csv ファイルを作成するには、 Adobe 独自の CSV アップロード形式。 このファイルには、製品の予約済み属性とカスタム属性に関する表示情報が含まれています。個々の環境に合った属性をアップロードするためには、ヘッダー行の CustomN を、使用する属性名に変更します。以下の例では、entity.Custom1 が entity.availability に変更されています。このファイルを Recommendations サーバーに一括アップロードできます。
.csv 形式は、Google フィード形式よりも次の点で優れています。
- .csv 形式では、フィールドマッピングは必要ありません。
- .csv 形式は、複数値の属性をサポートします（以下の例を参照）。
- .csv 形式では、最大 100 個のカスタム属性をサポートします。 必要なカスタム属性が 100 個を超える場合は、2 つ目のフィードファイルを作成し、カスタム属性の別のセットを指定できます。
ページに mbox がない場合や、サイトで使用できない項目で表示情報を補完する場合は、一括アップロード方法を使用して表示情報を送信します。 例えば、サイトに公開されていない可能性のある在庫情報の送信などができます。
.csv ファイル、Google製品フィード、または Analytics 製品分類フィードは、データベース内の既存のエンティティ属性値を上書きします。 Mbox リクエストで価格情報を送信し、ファイルで異なる価格値を送信した場合、mbox リクエストで送信された値は、ファイル内の値で上書きされます。この例外は、categoryId エンティティの属性で、この場合、カテゴリの値は上書きされる代わりに 250 文字制限まで追加されます。
例えば、以下の構文は間違っています。
"Apples "Bananas" Grapes"",
以下の構文は、正しいです。
"Apples ""Bananas"" Grapes""",
商品のエンティティが正常にアップロードされてから約 2 時間後に、この商品が管理者インターフェイスで使用できるようになります。
.csv ファイルのコードのサンプルは次のとおりです。
## RECSRecommendations Upload File
## RECS''## RECS'' indicates a Recommendations pre-process header. Please do not remove these lines.
## RECS
## RECSUse this file to upload product display information to Recommendations. Each product has its own row. Each line must contain 19 values and if not all are filled a space should be left.
## RECSThe last 100 columns (entity.custom1 - entity.custom100) are custom. The name 'customN' can be replaced with a custom name such as 'onSale' or 'brand'.
## RECSIf the products already exist in Recommendations then changes uploaded here will override the data in Recommendations. Any new attributes entered here will be added to the product''s entry in Recommendations.
## RECSentity.id,entity.name,entity.categoryId,entity.message,entity.thumbnailUrl,entity.value,entity.pageUrl,entity.inventory,entity.margin,entity.last_updated_by,entity.multi_english,entity.availability,entity.tax_country,entity.tax_region,entity.tax_rate,entity.product_type,entity.item_group_id,entity.color,entity.size,entity.brand,entity.gtin
na3456,RipCurl Watch with Titanium Dial,Watches & Sport,Cutting edge titanium with round case,https://example.com/s7/na3456_Viewer,425,https://example.com/shop/en-us/na3456_RipCurl,24,0.25,csv,"[""New"",""Web"",""Sales"",""[1,2,34,5]""]",in stock,US,CA,9.25,Shop by Category > Watches,dz1,Titanium,44mm,RipCurl,"075380 01050 5"
na3457,RipCurl Watch with Black Dial,Watches & Sport,Cutting edge matte black with round case,https://example.com/s7/na3457_Viewer,275,https://example.com/shop/en-us/na3457_RipCurl,24,0.27,csv,"[""New"",""Web"",""Sales"",""[1,2,34,5]""]",in stock,US,CA,9.25,Shop by Category > Watches,dz1,Black,44mm,RipCurl,"075340 01060 7"
Google section_8EFA98B5BC064140B3F74534AA93AFFF
フィードのタイプが Google による製品検索の場合は、Google の形式が使用されます。これは、 Adobe 独自の CSV アップロード形式。
Google 製品フィードを利用している場合は、それをインポートファイルとして使用できます。
ほとんどの小売業者は製品をGoogleにアップロードするので、訪問者がGoogle製品検索を使用すると、その製品が表示されます。 Recommendations では、Google の仕様に厳密に従ったエンティティフィードを使用します。エンティティフィードは .xml、.txt、.tsv のいずれかの形式で Recommendations に送信でき、また Google により定義された属性を使用できます。結果は Google のショッピングページで検索できます。
Recommendations の使用時に、URL または FTP 経由で Google に送信する .xml フィードまたは .txt フィードを既に設定しているので、エンティティフィードはこの商品データを受け取り、このデータを使用して recommendations カタログを作成します。フィードの場所を指定すると、recommendations サーバーでデータが取得されます。
エンティティフィードのアップロードにGoogle製品検索を使用する場合、レコメンデーションをそこで表示したり、ビューに基づいてアルゴリズム配信の製品ビューを追跡したりするには、ページに製品ページ mbox が必要です。
Google フィードは、カスタム属性での複数の値には対応していません。
フィードは、保存してアクティブ化した時点で実行されます。 フィードを保存した時点で実行され、1 時間後に毎日実行されます。
Google Product Search フィードの .xml ファイルのコードのサンプルは次のとおりです。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<feed xmlns="https://www.w3.org/2005/Atom" xmlns:ns2="https://base.google.com/ns/1.0" xmlns:ns3="https://base.google.com/cns/1.0">
<title>Product Feed</title>
<link href="https://example.com"/>
<updated>2017-12-13T08:45:04.918-08:00</updated>
<author>
<name>Product Feed Author</name>
</author>
<id>https://example.com</id>
<entry>
<title>RipCurl Watch with Titanium Dial</title>
<description>Cutting edge Titanium with Round case</description>
<ns2:id>na3452</ns2:id>
<ns2:link>https://example.com/shop/en-us/na3452_RipCurl</ns2:link>
<ns2:availability>in stock</ns2:availability>
<ns2:condition>NEW</ns2:condition>
<ns2:google_product_category>Watches & Sport</ns2:google_product_category>
<ns2:gtin>075380 01050 5</ns2:gtin>
<ns2:image_link>https://example.com/s7/na3452_Viewer</ns2:image_link>
<ns2:mobile_link>https://m.example.com/s7/na3452_Viewer</ns2:mobile_link>
<ns2:mpn>71050</ns2:mpn>
<ns2:price>425</ns2:price>
<ns2:product_review_average>5.0</ns2:product_review_average>
<ns2:product_review_count>30</ns2:product_review_count>
<ns2:product_type>Shop by Category > Watches </ns2:product_type>
<ns2:brand>RipCurl</ns2:brand>
<ns2:sale_price>375</ns2:sale_price>
<ns2:tax>
<ns2:country>US</ns2:country>
<ns2:region>CA</ns2:region>
<ns2:rate>9.25</ns2:rate>
<ns2:tax_ship>y</ns2:tax_ship>
</ns2:tax>
<ns2:is_bundle>N</ns2:is_bundle>
</entry>
<entry>
<title>RipCurl Watch with Black Dial</title>
<description>Cutting edge matte black with Round case</description>
<ns2:id>na3453</ns2:id>
<ns2:link>https://example.com/shop/en-us/na3453_RipCurl</ns2:link>
<ns2:availability>in stock</ns2:availability>
<ns2:condition>NEW</ns2:condition>
<ns2:google_product_category>Watches & Sport</ns2:google_product_category>
<ns2:gtin>075380 013450 5</ns2:gtin>
<ns2:image_link>https://example.com/s7/na3453_Viewer</ns2:image_link>
<ns2:mobile_link>https://m.example.com/s7/na3453_Viewer</ns2:mobile_link>
<ns2:mpn>71050</ns2:mpn>
<ns2:price>275</ns2:price>
<ns2:product_review_average>4.8</ns2:product_review_average>
<ns2:product_review_count>23</ns2:product_review_count>
<ns2:product_type>Shop by Category > Watches </ns2:product_type>
<ns2:brand>RipCurl</ns2:brand>
<ns2:sale_price>249</ns2:sale_price>
<ns2:tax>
<ns2:country>US</ns2:country>
<ns2:region>CA</ns2:region>
<ns2:rate>9.25</ns2:rate>
<ns2:tax_ship>y</ns2:tax_ship>
</ns2:tax>
<ns2:is_bundle>N</ns2:is_bundle>
</entry>
</feed>
Google Product Search フィードの .tsv ファイルのコードのサンプルは次のとおりです。
id title description link price condition availability image_link tax shipping_weight shipping google_product_category product_type item_group_id color size gender age_group pattern brand gtin mpn
na3454 RipCurl Watch with Titanium Dial Cutting edge titanium with round case https://example.com/shop/en-us/na3454_RipCurl 425 new in stock https://example.com/s7/na3452_Viewer US:CA:9.25:y 1.5 oz US:::0.00 USD Watches & Sport Shop by Category > Watches dz1 Black 44mm male adult Solid RipCurl 075380 01050 5 DZ1437
na3455 RipCurl Watch with Black Dial Cutting edge matte black with round case https://example.com/shop/en-us/na3455_RipCurl 275 new in stock https://example.com/s7/na3452_Viewer US:CA:9.25:y 1.5 oz US:::0.00 USD Watches & Sport Shop by Category > Watches dz1 Black 44mm male adult Solid RipCurl 075340 01060 7 DZ1446
Analytics 製品の分類 section_79E430D2C75443BEBC9AA0916A337E0A
The Analytics レコメンデーションで使用できる分類は、製品の分類のみです。 この分類ファイルについて詳しくは、 分類について （内） Analytics コンポーネント ガイド。 レコメンデーションに必要なすべての情報が、現在の実装で利用できるとは限りません。したがって、ご使用の分類ファイルを追加する場合は、このユーザーガイドを参照してください。
- エンティティ属性を更新すると、最大で 24 時間の遅延が生じます。
- Target サポート 製品の分類 のみ。 The Analytics 製品 SKU は、 Recommendations
entity.id. カスタム Analytics 分類は、 Adobeコンサルティングサービス. ご質問は、担当のアカウントマネージャーにお問い合わせください。
フィードの作成 steps
フィードを作成して、製品やサービスについての情報を Recommendations に挿入します。
-
Target インターフェイスから、レコメンデーション／フィード／フィードを作成 をクリックします。
-
フィードにわかりやすい名前を指定します。
-
「ソースタイプ」を選択します。
- CSV
- Google 製品フィード
- Analytics 分類
詳しくは、 CSV および Google Product Feed フィードのタイプについては、 フィードの概要. また、 モデル CSV ガイドのダウンロード を使用して、フィードを正しく書式設定できます。
-
（条件付き）CSV または Google 製品フィード を選択した場合、フィードがアクセスできる場所を指定します。
-
FTP：FTP を選択した場合は、FTP サーバー情報、ログイン資格情報、ファイル名、FTP ディレクトリを指定します。より安全なアップロードのために、SSL を使用した FTP(FTPS) を使用できます。
サポートされる FTP サーバー設定：
- FTP および FTPS は、パッシブ FTP を使用するように設定する必要があります。
- FTPS の場合、明示的な FTPS 接続を受け入れるようにサーバーを設定します。
- SFTP はサポートされていません。
- 接続を開始するポートを手動で指定できます（例： ）。
ftp://ftp.yoursite.com:2121) をクリックします。 ポートを指定しない場合、デフォルト FTP または FTPS ポートが使用されます。
-
URL：選択した URL」に値を入力する場合は、URL を指定します。
-
-
（条件付き）Analytics 分類 を選択した場合、ドロップダウンリストからレポートスイートを選択します。
-
「次へ」矢印をクリックして、「スケジュール」オプションを表示します。
-
更新オプションを選択します。
- 毎日
- 毎週
- 2 週間ごと
- なし：更新をスケジュールしません。 このフィードを実行したくない場合に、これを選択します。
-
フィードを実行する時間を指定します。
このオプションは、ブラウザーで使用されるタイムゾーンに基づいています。別のタイムゾーンの時間を使用したい場合、タイムゾーンに応じて時間を計算する必要があります。
-
「次へ」矢印をクリックして「マッピング」オプションを表示してから、データを Target 定義にマッピングする方法を指定します。
-
（オプション）フィードを環境（ホストグループ）に所属させたい場合、ホストグループを選択します。
デフォルトでは、フィードはすべてのホストグループに所属しています。これで、このフィードの品目はどの環境でも利用できるようになります。詳しくは、ホストを参照してください。
-
「保存」をクリックします。
フィードを作成または編集すると、そのフィードは直ちに実行されます。 次に、設定したパラメーターに従ってフィードが更新されます。 情報が利用可能になるまでに時間がかかります。 まず、フィードの同期が実行され、処理をおこなってインデックスが構築された上で、発行されて使用可能になります。現在のステータスは、フィードリストのフィードステータスに表示されます。処理が終了する前に Target を閉じても構いません。処理は継続されます。
インデックス構築中は、個々の値のインデックスが作成されるまでは、製品とフィードのヘッダーが表示されます。これにより、製品を検索して表示できるので、インデックス作成が完了する前に、コレクション、除外、デザイン、アクティビティを作成することができます。
「ステータス」に表示される「成功」は、ファイルが見つかり、正しく解析されたことを示します。ファイルのインデックスが作成されるまで、Recommendations 内で情報は使用できません。インデックスの作成には時間がかかります。かかる時間はファイルのサイズによって異なります。プロセスが失敗した場合は、ファイルが見つからなかったことを意味します。例えば、間違った URL を使用したか、FTP 情報が正しくなかったか、解析エラーが発生しました。
フィードのステータスとインジケーター concept_E475986720D1400999868B3DFD14A7A0
フィードのステータスとそのインジケーターについて説明します。
フィードステータス status
次に、フィードのステータスを示します。
Target は、フィードファイルをそのコンテンツ配信システムに読み込みました。コンテンツ配信システムで項目属性に対する変更がおこなわれ、配信されたレコメンデーションには近日中に反映されます。 期待された変更が表示されない場合は、もう一度試して、レコメンデーションを含むページを更新してください。
メモ:
- 項目の属性に対する変更によって項目がレコメンデーションから除外されると、除外が直ちに反映されます。 項目が新しく追加された場合、または属性に対する変更によって項目が追加された場合 今後は レコメンデーションから除外され、次のアルゴリズム更新（24 時間以内におこなわれる）まで反映されません。
- このステータスが表示されると、更新が カタログ検索 UI 別のステータスが カタログ検索 検索可能なカタログが最後に更新された時刻を示す
フィードを更新するには（例えば、フィード構成やフィードファイルを変更する場合など）、フィードを開き、必要な変更をおこなってから、「保存」をクリックします。
フィードステータスのインジケーター section_3C8A236C5CB84C769A9E9E36B8BFABA4
次のフィードステータスのインジケーターは、ステータス列に表示されます。
次の例をご覧ください。
例 1：
- 1 日目：毎日のフィードが午前 9:00 PST に処理されます。
- 2 日目：午後 3:30 時点で、昨日の午前 9:00 以降、フィードが実行されていません。
インデックスは約 6.5 時間前に実行されているはずだったので、ステータスは黄色になります。6.5 時間 +24 はフィード期間の 127％です。
例 2：
- 1 月 1 日：毎月のフィードが午前 9:00 PST に処理されます。
- 2 月 3 日：午前 10 時で、1 か月、1 日、1 時間前にフィードが実行されていません。
インデックスは約 1 日と 1 時間前に実行されているはずだったので、ステータスは黄色になります。これは、わずか（31+（1/25））/30 = 1.03％の頻度設定にもかかわらず、1 日の遅延の最大値を上回ります。
トレーニングビデオ
以下のビデオは、この記事で説明した概念についてさらに詳しく説明しています。
Recommendations のフィードの説明（3:01）
このビデオには、次の情報が含まれています。
- フィードの目的の説明
- フィードの値の説明
フィードの作成（6:44）
このビデオには、次の情報が含まれています。
- フィードの設定
- 使用するフィードのタイプの説明