[Premium]{class="badge positive" title="Target Premium に含まれる機能を確認してください。"}
フィード
フィードを使用して、Adobe Target Recommendationsに読み込まれたエンティティを取得します。 エンティティは、CSV ファイル、Google Product Search フィード形式、Adobe Analytics製品の分類を使用して送信できます。
フィードの概要 concept_D1E9C7347C5D4583AA69B02E79607890
フィードを使用すると、 エンティティ を渡したり、ページ上で利用できない情報や、ページから直接送信できない情報でmbox データを拡張したりできます。 たとえば、マージン、売上原価(COGS)などがあります。
フィードでは、製品ID、カテゴリ、名前、メッセージ、その他の属性など、詳細な項目情報をRecommendationsに渡すこともできます。
Target製品分類ファイルまたはGoogle Product Search ファイルから、Recommendations サーバーに送信する列を選択できます。
各項目に関するこれらのデータは、次のことに使用できます。
- デザインの値の表示
- 基準の包含ルールの定義
- アイテムを異なるコレクションに並べ替える
- レコメンデーションへの除外の適用
アイテムの説明は、フィードまたはmboxを使用してTargetに渡すことができます。 Targetがエンティティフィードとmboxの両方を使用してデータを収集すると、最新のデータが優先されます。 通常、mbox のほうが頻繁に閲覧されるので、mbox のデータが最新になります。 まれにエンティティフィードのデータと mbox のデータが同時に収集されたものである場合、mbox のデータが使用されます。
フィード リスト (Recommendations > フィード)には、作成したフィードに関する情報が表示されます。
フィード ページには、次の列が含まれています。
- 名前:作成中に指定されたフィードの名前。 フィードの名前を編集するには、フィード自体を編集する必要があります。 新しい名前でフィードを保存すると、フィードが更新されます。
- ステータス:フィードの現在のステータス。
- タイプ: タイプには、CSV、Google Product FeedおよびAnalytics分類が含まれます。
- 項目:フィード内の項目数を表示します。
- スケジュール: フィードの更新スケジュールを表示します:毎日、毎週、Every 2 Weeks、またはなし。
- 最終更新日:フィードが最後に更新された日時とフィードを更新した人物の名前を表示します。
表をカスタマイズ アイコン (
情報 アイコン (
詳細アクション アイコン (
- カタログの内容が期限切れにならないように、フィードは少なくとも毎月実行する必要があります。
- フィードファイルから項目を削除しても、その項目はカタログから削除されません。 カタログからアイテムを削除するには、Target UIまたはAPIを使用して、手動でアイテムを削除します。 または、アイテム属性(在庫など)を変更して、そのアイテムが検討から除外されるようにします。
Source タイプ
エンティティは、CSV ファイル、Google Product Search フィード形式、Adobe Analytics製品の分類を使用して送信できます。
CSV section_65CC1148C7DD448FB213FDF499D35FCA
Adobe独自のCSV アップロード形式を使用して.csv ファイルを作成できます。 このファイルには、製品の予約済み属性とカスタム属性に関する表示情報が含まれています。 個々の環境に合った属性をアップロードするためには、ヘッダー行の CustomN を、使用する属性名に変更します。 以下の例では、entity.Custom1 が entity.availability に変更されています。 このファイルを Recommendations サーバーに一括アップロードできます。
.csv形式を使用すると、Google フィード形式よりも次の利点があります。
- .csv形式では、フィールドマッピングは必要ありません。
- .csv形式は、複数の値の属性をサポートします(以下の例を参照)。
- .csv形式では、最大100個のカスタム属性をサポートします。 必要なカスタム属性が 100 個を超える場合は、2 つ目のフィードファイルを作成し、カスタム属性の別のセットを指定できます。
ページにmboxがない場合や、サイトで使用できない項目で表示情報を補足する場合は、一括アップロード方法を使用して表示情報を送信します。 例えば、サイトに公開されていない可能性のある在庫情報の送信などができます。
.csv ファイル、Google Product Feed、または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 Product Search フィードの種類は、Adobe独自のCSV形式ではなくGoogle形式を使用します。 既存のGoogle Product Feedを再利用して、商品データをRecommendationsにインポートできます。
Recommendationsは、Google フィード仕様に従い、Google🔗によって定義された属性を使用する.xml、.txt、および.tsv ファイルを受け入れます。 フィードのURLまたはFTPの場所を指定して、Recommendations サーバーがファイルを取得し、カタログを構築できるようにします。
次の要件と制限事項を念頭に置いてください。
- 商品ページ mboxは、そのページにレコメンデーションを表示したり、ビューベースのアルゴリズムに対する商品ビューを追跡したりするために、引き続き必要です。
- Google フィードでは、カスタム属性の複数の値をサポートしていません。
フィードは、保存してアクティブ化すると実行され、最初の実行時間よりも1時間遅れて毎日のフィードが実行されます。
次の例は、.xml形式のGoogle Product Search フィードを示しています。
<?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
Adobe Analytics製品分類は、推奨事項に使用できる唯一の分類です。 この分類ファイルについて詳しくは、分析コンポーネント ガイドの分類についてを参照してください。 レコメンデーションに必要なすべての情報が現在の実装で使用できるわけではないので、分類ファイルに追加する場合は、このユーザーガイドに従ってください。
- エンティティ属性を更新すると、最大で 24 時間の遅延が生じます。
- Targetは製品分類のみをサポートしています。 Analytics製品SKUは、Recommendations
entity.idと同じレベルにマッピングする必要があります。 カスタム Analytics分類は、Adobe Consulting サービス を使用して設計できます。 ご質問がある場合は、アカウントマネージャーにお問い合わせください。
フィードの作成 steps
フィードを作成して、製品やサービスについての情報を Recommendations に挿入します。
-
Target インターフェイス内から、Recommendations > Feeds > Create Feedをクリックします。
-
フィードにわかりやすい名前を指定します。
-
Sourceの種類を選択します。
- CSV
- Google製品フィード
- Analytics分類
CSVおよびGoogle Product Feed フィードの種類について詳しくは、 フィードの概要を参照してください。 また、 モデル CSV ガイドをダウンロード して、フィードを正しくフォーマットできます。
-
(条件付き) CSVまたは Google Product Feed を選択した場合は、フィードにアクセスできる場所を指定します。
-
FTP:FTP を選択した場合は、FTP サーバー情報、ログイン資格情報、ファイル名、FTP ディレクトリを指定します。 より安全なアップロードのために、FTPとSSL (FTPS)を使用できます。
accordion サポートされているFTP サーバー設定 - FTP および FTPS は、パッシブ FTP を使用するように設定する必要があります。
- FTPSの場合は、明示的なFTPS接続を受け入れるようにサーバーを設定します。
- 接続を開始するポートを手動で指定できます(例:
ftp://ftp.yoursite.com:2121)。 ポートを指定しない場合、デフォルト FTP または FTPS ポートが使用されます。
+++
-
SFTP: SFTP サーバーのホスト名またはIP アドレス、ポート(デフォルト:22)、ユーザー名、ディレクトリ、およびファイル名を入力します。 認証には、パスワード、SSH秘密鍵、またはその両方を入力します。
accordion サポートされているSFTP サーバー設定と制限 - 認証は、パスワード、SSH秘密鍵、またはその両方を使用します。 少なくとも1つは必要です。
- お客様がキーペアを生成して所有します。 SFTP ユーザーの
authorized_keysファイルに公開鍵をインストールし、秘密鍵をPEM テキストとしてTargetに貼り付けます。 使用可能なキータイプは、RSA、Ed25519、ECDSAで、PEM (-----BEGIN RSA PRIVATE KEY-----)、PKCS#8 (-----BEGIN PRIVATE KEY-----)、またはOpenSSH (-----BEGIN OPENSSH PRIVATE KEY-----)形式です。 - パスフレーズで保護された秘密鍵はサポートされていません。フィードを保存することはできません。
- Targetは秘密鍵を暗号化して保存し、再表示しません。 回転させるには、フィードを編集して新しいキーを入力します。
sftp://接頭辞、ポート、またはパスを使用せずに、裸のホスト名またはIP アドレスを入力します。 デフォルト以外のポートには、「ポート」フィールドを使用します。- サーバーホストキーは最初の接続時に受け入れられます。Adobeとの指紋交換は必要ありません。
- SFTPは、Target インターフェイスおよびRecommendations APIで使用できますが、従来のRecommendations Classic管理インターフェイスでは使用できません。 AdobeはSFTP エンドポイントをホストしません。お客様がホストするサーバーを使用してください。
- SFTP サーバーは、インターネットからアクセス可能であり、Adobe Targetのダウンロードアドレスからのインバウンド接続を許可する必要があります。 本番IP リストは、このアップデートを公開する前に、エンジニアリングによって確認する必要があります。
+++
- URL: URLを選択した場合は、URLを指定します。
-
-
(条件付き) Analytics Classificationsを選択した場合は、ドロップダウンリストからレポートスイートを選択します。
-
次へ矢印をクリックして、 スケジュール オプションを表示します。
-
更新オプションを選択します。
- 日別
- 週単位
- 2週間ごとに
- なし:更新をスケジュールしません。 このフィードを実行したくない場合に、これを選択します。
-
フィードを実行する時間を指定します。
このオプションは、ブラウザーで使用されるタイムゾーンに基づいています。 別のタイムゾーンの時間を使用したい場合、タイムゾーンに応じて時間を計算する必要があります。
-
次矢印をクリックして マッピング オプションを表示し、データをTarget定義にマッピングする方法を指定します。
-
(オプション)フィードを環境(ホストグループ)に所属させたい場合、ホストグループを選択します。
デフォルトでは、フィードはすべてのホストグループに所属しています。 これで、このフィードの品目はどの環境でも利用できるようになります。 詳しくは、ホストを参照してください。
-
「Save」をクリックします。
フィードを作成または編集すると、すぐに実行され、設定に従って更新されます。 フィードは、データが使用可能になる前に同期、処理、およびインデックスを作成する必要があります。 進捗状況については、 フィード リストの フィードのステータス を確認してください。 Targetを閉じても、処理は続行されます。
索引付け時には、製品とフィードのヘッダーが個々の値の前に表示されるため、索引付けが完了する前に製品を検索し、コレクション、除外、デザイン、アクティビティを作成できます。
「Success」ステータスは、ファイルが見つかり、正しく解析されたことを意味します。 そのデータはRecommendationsでインデックス作成の後にのみ利用できます。ファイル サイズに応じて時間がかかります。 エラーは、誤ったURLまたはFTP情報、不足しているファイル、または解析エラーが原因で発生する可能性があります。
フィードのステータスとインジケーター concept_E475986720D1400999868B3DFD14A7A0
フィードのステータスとそのインジケーターについて説明します。
フィードステータス status
次に、フィードのステータスを示します。
Targetは、フィード ファイルをコンテンツ配信システムに読み込みました。 コンテンツ配信システムでアイテム属性が変更され、近日中に配信レコメンデーションに反映される予定です。 予想される変更が表示されない場合は、もう一度試して、推奨事項を含むページを更新します。
メモ:
- アイテムの属性に対する変更により、アイテムがレコメンデーションから除外された場合、除外はすぐに反映されます。 アイテムが新しく追加された場合、または属性に変更を加えた結果、アイテムがもはや レコメンデーションから除外されなくなった場合、次のアルゴリズムの更新(24時間以内に発生)まで反映されません。
- このステータスが表示されている場合、更新が カタログ検索 UIにまだ反映されていない可能性があります。 カタログ検索には、検索可能なカタログが最後に更新された日時を示す別のステータスが一覧表示されます。
以前は、すべての行がアップロードされなかったときでも、フィードは成功としてマークされていました。 したがって、フィードが正常に表示されたときに、すべての行がアップロードされたという誤った印象を与えます。
ここでは、フィードの部分的なインポートが発生する可能性がある理由を示します。
- 実稼動環境用のフィードファイル(100行など)をアップロードしました。
- フィードは、それらの行のうち80行を実行してアップロードし、誤った書式設定、フィールドが文字を超えているなどの理由で20行をドロップしました。
- フィードはUIで成功とマークされ、100行がすべてアップロードされたという印象を与えます。
- これらの20の製品のいくつかをアクティビティの配信に期待していますが、実行されていません。
- 該当する製品の製品詳細を含むフィードをアップロードしたので、この時点で戸惑います。 Entity APIを使用してクエリを実行すると、バックエンドに表示されません。これは、バックエンドにないことを示します。
この混乱を取り除くために、メッセージはフィードで何が起こったのかを正確に伝えるために改善されます。 成功としてマークするのではなく、部分的な読み込みに失敗としてマークされるようになりました。
フィードを更新するには(例えば、フィード構成やフィードファイルを変更する場合など)、フィードを開き、必要な変更をおこなってから、「保存」をクリックします。
フィードステータスのインジケーター section_3C8A236C5CB84C769A9E9E36B8BFABA4
次のフィードステータスのインジケーターは、ステータス列に表示されます。
次の例をご覧ください。
例 1:
- 初日:午前9時(太平洋標準時)から毎日の給餌プロセス。
- 2日目:午後3時30分で、フィードは昨日の午前9時から実行されていません。
インデックスは約 6.5 時間前に実行されているはずだったので、ステータスは黄色になります。 6.5 時間 +24 はフィード期間の 127%です。
例 2:
- 1月1日:PSTの午前9時に毎月のフィード処理。
- 2月3日午前10時で、フィードは1か月、1日、1時間前に実行されていません。
インデックスは約 1 日と 1 時間前に実行されているはずだったので、ステータスは黄色になります。 これは、わずか(31+(1/25))/30 = 1.03%の頻度設定にもかかわらず、1 日の遅延の最大値を上回ります。
トレーニングビデオ
以下のビデオは、この記事で説明した概念についてさらに詳しく説明しています。
Recommendationsのフィードについて(3:01)
このビデオには、次の情報が含まれています。
- フィードの目的の説明
- フィードの値の説明
フィードの作成(6:44)
このビデオには、次の情報が含まれています。
- フィードの設定
- 使用するフィードのタイプの説明