[Premium]{class="badge positive" title="檢視Target Premium包含的內容。"}

摘要

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

使用摘要來將實體匯入Adobe Target Recommendations。實體可以使用CSV檔案、Google產品搜尋摘要格式和Adobe Analytics產品分類來傳送。

摘要概觀 concept_D1E9C7347C5D4583AA69B02E79607890

摘要可讓您傳遞Entities，或使用頁面上沒有提供或直接從頁面傳送很不安全的資訊（例如利潤、COGS等）來擴增mbox資料。

摘要可讓您將詳細的專案資訊傳遞至Recommendations，例如產品ID、類別、名稱、訊息和其他屬性。

您可以選取要將Target產品分類檔案或Google Product Search檔案中的哪些欄位傳送至Recommendations伺服器。

然後，有關每個專案的這些資料片段可用於：

在設計中顯示值
定義條件包含規則
將專案排序為不同的集合
將排除專案套用至建議

可使用摘要或mbox將專案說明傳遞至Target。如果資料是同時由實體摘要和 mbox 所收集，則採用最近的資料。通常最近的資料是來自 mbox，因為它較常被檢視。同時點選實體摘要資料和 mbox 資料的情形不常見，這時會使用 mbox 資料。

Feeds清單( Recommendations > Feeds)提供您已建立的任何摘要的相關資訊。

摘要頁面

Feeds頁面包含下列資料行：

名稱: 建立期間指定的摘要名稱。若要編輯摘要的名稱，您必須編輯摘要本身。當您以新名稱儲存摘要時，摘要會重新整理。
類型: 類型包含 CSV、Google 產品摘要以及 Analytics 分類。
狀態: 摘要的目前狀態。
排程：顯示摘要的更新排程： Daily、Weekly、Every 2 Weeks或Never。
項目: 顯示摘要中的項目數量。
上次更新: 顯示上次更新摘要的日期與時間，以及更新摘要的使用者名稱。如果Last Updated摘要顯示「未定義」，表示摘要來自Recommendations Classic，且無法從Target Premium Recommendations內變更。

按一下「資訊」圖示，即可顯示卡片，其中顯示上次上傳日期以及摘要的URL。

按一下省略符號圖示以存取下列動作： Deactivate、Edit、Copy和Delete。

IMPORTANT

上傳的實體和實體屬性會在61天後過期。這表示:

您的摘要應至少每月執行一次，以確保您的目錄內容不會過期。
從摘要檔案中移除專案並不會從目錄中移除該專案。若要從目錄移除專案，請透過Target UI或API手動刪除專案。或者，修改料號屬性（例如inventory），以確保不會考慮該料號。

Source型別

實體可以使用CSV檔案、Google產品搜尋摘要格式和Adobe Analytics產品分類來傳送。

CSV section_65CC1148C7DD448FB213FDF499D35FCA

您可以使用Adobe專有的CSV上傳格式來建立.csv檔案。此檔案包含產品的保留屬性和自訂屬性相關的顯示資訊。若要上傳實作特有的屬性，請以您要使用的屬性名稱取代標題列中的 CustomN。在下列範例中,entity.Custom1 已取代為 entity.availability。然後您可以將檔案大量上傳至 Recommendations 伺服器。

使用 .csv 格式比 Google Feed 格式更好的理由如下:

.csv格式不需要欄位對應。
.csv格式支援多值屬性（請參閱下面的範例）。
.csv格式支援最多100個自訂屬性。如果需要超過 100 個自訂屬性，您可以建立第二個摘要檔案，並指定一組不同的自訂屬性。

如果您的頁面上沒有mbox，或您想要使用網站上沒有的專案來補充您的顯示資訊，請使用大量上傳方法來傳送顯示資訊。例如，您可能想要傳送未在網站上發佈的庫存資訊。

使用.csv檔案、Google產品摘要或Analytics產品分類摘要來上傳的任何資料會覆寫資料庫中現有的實體屬性值。如果您透過 mbox 要求傳送價格資訊，之後又以檔案傳送不同的價格數值，則檔案中的值會覆寫以 mbox 要求設定的值。categoryId 實體屬性是此作法的例外，類別值會附加其後而不會覆寫，但有最多 250 個字元的上限。

IMPORTANT

請勿在您的 .csv 檔案中將值含括在雙引號 ( " ) 中，除非是刻意的操作。如果您將值含括在雙引號中，則必須藉由將它們含括在另一組雙引號中才能將其逸出。未逸出的雙引號會使建議摘要無法正確載入。

例如，下列語法不正確:

"Apples "Bananas" Grapes"",

下列語法正確:

"Apples ""Bananas"" Grapes""",

NOTE

您不能以空白值來覆寫現有值。在其位置傳遞另一個值以覆寫它。若是售價，常見的解決方案是傳入實際的「NULL」或其他訊息。然後，您可以撰寫範本規則來排除含有該值的項目。

產品在成功上傳其實體大約兩小時之後，就可以在管理介面中使用。

下列是 .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 產品摘要，則可用來當作匯入檔案。

NOTE

不一定要使用 Google 資料。Recommendations使用與Google相同的格式。您可以使用此方法上傳任何您有的資料，並且使用可用的排程功能。不過，您在設定檔案時，必須保留 Google 預先定義的屬性名稱。

大部分零售商都會將產品上傳至Google，因此當訪客使用Google產品搜尋時，會顯示其產品。 Recommendations 的實體摘要完全遵循 Google 的規格。實體摘要可透過.xml、.txt或.tsv傳送至Recommendations，並可使用Google🔗定義的屬性。結果可供 Google 購物頁面上搜尋。

NOTE

託管 Google 摘要內容的伺服器上必須允許使用 POST 方法。

由於Recommendations使用者已設定.xml或.txt摘要透過URL或FTP傳送至Google，實體摘要會接受該產品資料並將其用於建置建議目錄。指定該摘要存在何處及供 Recommendations 伺服器擷取資料的位置。

如果您使用Google產品搜尋來上傳實體摘要，而且想要在那裡顯示建議或根據檢視追蹤演演算法傳送的產品檢視，您仍然必須在頁面上擁有產品頁面mbox。

Google 摘要不支援一個自訂屬性有多個值。

摘要會在您儲存並啟動時執行。它會在您儲存摘要時執行，然後在一小時後每天執行。

下列是 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 &amp; 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 &amp; 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

Analytics產品分類是建議唯一可用的分類。如需此分類檔案的詳細資訊，請參閱 Analytics元件 指南中的關於分類。目前的實作中不一定有建議所需的所有資訊，因此，如果您想要新增至分類檔案，請遵循此使用者指南。

IMPORTANT

在使用Analytics產品分類將實體資料匯入到Recommendations之前，請注意這不是推薦的方法。

請注意下列警告:

更新實體屬性會引起額外延遲，最多 24 小時。
Target僅支援Product Classifications。 Analytics產品SKU必須對應到與Recommendations entity.id相同的等級。可使用Adobe Consulting Services設計自訂Analytics分類。如有疑問，請聯絡您的客戶經理。

建立摘要 steps

建立摘要以將關於您的產品或服務的資訊插入 Recommendations。

在Target介面中，按一下 Recommendations > Feeds > Create Feed。
為摘要指定描述性名稱。
選取 Source Type。
- CSV
- Google Product Feed
- Analytics Classifications
如需CSV和Google Product Feed摘要型別的相關資訊，請參閱摘要概觀。您也可以下載模型CSV指南，協助您正確地格式化摘要。
（視條件而定）如果您已選取 CSV 或 Google Product Feed，請指定可存取摘要的位置。
- FTP: 如果您已選取 FTP，請提供 FTP 伺服器資訊、登入認證、檔案名稱和 FTP 目錄。您可以使用FTP搭配SSL (FTPS)，以更安全地上傳。
  
  支援的 FTP 伺服器設定:
  - FTP 和 FTPS 必須設定為使用被動式 FTP。
  - 對於FTPS，請將伺服器設定為接受明確FTPS連線。
  - 不支援 SFTP。
  - 您可以手動指定起始連線的連線埠（例如，ftp://ftp.yoursite.com:2121）。如果您未指定連接埠，則會使用預設 FTP 或 FTPS 連接埠。
- URL：如果您選取URL，請指定URL。
（視條件而定）如果您已選取 Analytics Classifications，請從下拉式清單選擇報表套裝。
按一下 Next 箭頭以顯示Schedule選項。
選取更新選項:
- Daily
- Weekly
- Every 2 Weeks
- Never：不排程更新。如果不想執行此摘要，請選取此選項。
指定您要執行摘要的時間。

此選項是根據瀏覽器中使用的時區。如果要使用不同時區的時間，則必須根據您的時區來計算該時間。
按一下 Next 箭頭以顯示Mapping選項，然後指定如何將資料對應至Target定義。
(可選) 如果要讓摘要屬於某個環境 (主機群組)，請選取主機群組。

依預設，摘要會屬於所有主機群組。這可確保此摘要中的項目可以在任何環境中使用。如需詳細資訊，請參閱主機。
按一下 Save。

在您建立或編輯摘要後，摘要會立即執行。然後會根據您設定的引數更新摘要。需要一些時間才能提供資訊。首先，摘要必須同步，然後必須經過處理和編列索引，才能發佈和可供使用。目前的狀態會顯示在[摘要]清單中的摘要狀態下。您可以在處理程序完成之前關閉 Target，處理程序會繼續。

編列索引進行時，在個別值已編列索引之前，產品和摘要標題會先出現。這可讓您搜尋及檢視產品，以便於在完成索引前建立集合、排除專案、設計和活動。

當狀態顯示「成功」時，表示找到檔案且剖析正確。在檔案編列索引之前，Recommendations 內沒有資訊可用，這需要一些時間，視檔案大小而定。如果程式失敗，則表示找不到檔案。例如，您使用不正確的URL，或FTP資訊不正確，或存在剖析錯誤。

摘要狀態和指示器 concept_E475986720D1400999868B3DFD14A7A0

關於可能的摘要狀態和其指示器的資訊。

摘要狀態 status

摘要的可能狀態如下:

狀態

說明

Syncing

摘要設定詳細資料正在儲存至Target。

Sync Failed

無法將摘要設定詳細資料儲存至Target。再試一次。

No Feed Run

您已建立摘要，但尚未排程（頻率設為「從不」）。

排定在 日期和時間

摘要尚未執行，但已排定在指定的日期和時間執行。

Waiting for Download

Target正在準備下載摘要檔案。

Downloading Feed File

Target正在下載摘要檔案。

Importing Items

Target正在從摘要檔案匯入專案。

已於時間成功匯入摘要

Target已將摘要檔案匯入其內容傳遞系統。已在內容傳遞系統中進行專案屬性的變更，這些變更很快會反映在已傳送的建議中。如果沒有看到預期的變更，請再試一次，並重新整理包含建議的頁面。
附註：

如果專案屬性的變更導致建議排除了該專案，則會立即反映排除。如果專案是新增的專案，或屬性變更導致建議中不再包含專案，該專案要等到下次演演算法更新時才會反映出來，這會在24小時內發生。
顯示此狀態時，更新可能尚未反映在Catalog Search UI中。 Catalog Search中會列出另一個狀態，表示上次更新可搜尋目錄的時間。

Failed to Index

編列索引作業失敗。再試一次。

Server Not Found

FTP 或 URL 位置無效或無法觸達。

若要更新摘要（例如，若要變更摘要組態或摘要檔案），請開啟摘要、進行任何所需變更，然後按一下 Save。

IMPORTANT

上傳的實體會在 61 天後過期。這表示應至少每隔 60 天上傳摘要檔案，以免建議活動中斷。如果專案未至少每隔60天包含在摘要檔案（或其他實體更新方法）中，Target會推斷該專案已不再相關，並且會將其從目錄中移除。