可使用信息源将实体导入到 Adobe Target Recommendations 中。可以使用 CSV 文件、Google Product Search 信息源格式和 Adobe Analytics 产品分类来发送实体。
信息源允许您传递实体,或者使用页面上没有提供或不能直接从页面安全发送(例如利润、COGS 等)的信息来扩充您的 mbox 数据。
信息源允许您将详细的项目信息传递到 Recommendations,如产品ID、类别、名称、消息和其他属性。
您可以从 Target 产品分类文件或 Google Product Search 文件中选择要发送到 Recommendations 服务器的列。
然后,有关每个项目的这些数据段可用于:
物料描述可以传递到 Target 使用信息源或mbox。 如果同时通过实体源和 mbox 收集数据,则采用最新的数据。通常,最新的数据来自 mbox,因为 mbox 的查看频率更高。在极少数情况下,实体源数据和 mbox 数据的时间相同,这时使用 mbox 数据。
“信息源”列表(推荐 > 信息源)提供了有关您创建的所有信息源的信息。
“信息源”页面包含以下列:
上传的实体和实体属性会在61天后过期。 这意味着:
可以使用 CSV 文件、Google Product Search 信息源格式和 Adobe Analytics 产品分类来发送实体。
您可以使用 Adobe 专有的 CSV 上传格式创建 .csv 文件。该文件包含有关产品的保留属性和自定义属性的显示信息。要上传特定于您的实施的属性,请将标头行中的 CustomN
替换为您要使用的属性的名称。在下面的示例中,entity.Custom1
被替换为 entity.availability
。然后,您可以将文件批量上传到 Recommendations 服务器。
与 Google 信息源格式相比,使用 .csv 格式具有以下优势:
如果在您的页面上没有 mbox,或如果您要增加您网站上没有的项目的显示信息,则可以使用批量上传方法发送显示信息。例如,您可能想要发送不会在您的网站上发布的库存信息。
使用 .csv 文件、Google 产品信息源或 Analytics 产品分类信息源上传的任何数据都会覆盖我们数据库中的现有实体属性值。如果您通过 mbox 请求发送价格信息,然后使用文件发送不同的价格值,则文件中的值将覆盖使用 mbox 请求设置的值。一个例外是 categoryId
实体属性,该属性会附加类别值,而不是被覆盖以符合 250 个字符限制。
在 .csv 文件中,不要用双引号 (") 引住值,除非是有意为之。如果用双引号引住值,则必须使用另一组双引号将其引住来进行转义。未转义的双引号会导致推荐信息源无法正确加载。
例如,以下语法不正确:
"Apples "Bananas" Grapes"",
以下语法正确:
"Apples ""Bananas"" Grapes""",
无法使用空白值覆盖现有值。您必须在其位置传递另一个值以覆盖它。 对于销售价格,常用的解决方案是通过一个实际的“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 Product Search 信息源类型使用 Google 格式。这与 Adobe 专有的 CSV 上传格式不同。
如果您已有 Google 产品信息源,则可以将其用作导入文件。
无需使用 Google 数据。Recommendations 使用与 Google 相同的格式。您可以使用此方法上传您的任何数据,并且还可以使用可用的计划功能。但是,您必须在设置文件时保留 Google 的预定义属性名称。
大多数零售商会将产品上传到 Google,因此当访客使用 Google Product Search 时,他们的产品将会显示出来。Recommendations 完全遵循 Google 对实体源的规范要求。实体馈送可以发送到 Recommendations 通过.xml、.txt或.tsv,并且可以使用 由Google定义的属性. 可以在 Google 购物页面上搜索结果。
托管 Google 信息源内容的服务器上必须可以使用 POST 方法。
因为 Recommendations 用户已将.xml或.txt馈送配置为通过URL或FTP发送到Google,实体馈送将接受这些产品数据并使用这些数据构建Recommendations目录。 指定此信息源存在的位置后,推荐服务器随即会检索数据。
如果在使用 Google Product Search 进行实体信息源上传时,想要在此显示推荐或跟踪产品浏览次数以根据浏览次数进行算法交付,则页面上仍需要有产品页面 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 & 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 产品分类是唯一可用于推荐的分类。有关此分类文件的更多信息,请参阅 关于分类 在 Analytics组件 指南。 推荐需要的所有信息并非都可通过当前的实施获得,因此,如果要在分类文件中添加新内容,请按此用户指南操作。
将实体数据导入之前 Recommendations 使用Analytics产品分类时,请注意,这不是首选方法。
请注意以下事项:
entity.id
. 可以使用 Adobe 咨询服务对自定义 Analytics 分类进行工程方面的处理。如有任何疑问,请联系您的帐户管理员。可创建一个信息源,以将有关产品或服务的信息插入到 Recommendations 中。
在 Target 界面中,单击推荐 > 信息源 > 创建信息源。
为您的信息源指定一个描述性名称。
选择源类型。
有关 CSV 和“Google 产品信息源”信息源类型的信息,请参阅信息源概述。您还可以 下载模型CSV指南 以帮助您正确设置信息源的格式。
(视情况而定)如果您选择 CSV 或者 Google 产品信息源,请指定可以访问信息源的位置。
FTP:如果您选择 FTP,请提供 FTP 服务器信息、登录凭据、文件名和 FTP 目录。您可以选择使用带有 SSL 的 FTP (FTPS) 进行更安全的上传。
支持的 FTP 服务器设置:
ftp://ftp.yoursite.com:2121
)。如果未指定端口,则将使用默认的 FTP 或 FTPS 端口。URL:如果您选择 URL,请指定 URL。
(视情况而定)如果您选择 Analytics 分类,请从下拉列表中选择报表包。
单击下一步箭头以显示计划选项。
选择一个更新选项:
指定要运行信息源的时间。
此选项基于浏览器中使用的时区。如果您想要使用不同时区的时间,则必须根据您所在的时区计算该时间。
单击下一步箭头以显示映射选项,然后指定您希望如何将数据映射到 Target 定义。
(可选)如果您希望信息源属于某个环境(主机组),请选择该主机组。
默认情况下,信息源属于所有主机组。这可确保此信息源中的项目可在任何环境中使用。有关更多信息,请参阅主机。
单击保存。
创建或编辑信息源后,该信息源会立即运行,然后将根据您设置的参数进行更新。所有信息需要一段时间才能使用。首先,信息源必须同步,接着必须对其进行处理并将其编入索引,然后才能对其发布并使其可供使用。当前状态显示在“信息源”列表中的信息源状态下。在该过程完成之前,您可以关闭 Target,该过程会继续执行。
编入索引期间,在将各个值编入索引之前,将会显示产品和信息源标头。这使您可以搜索和查看产品,以便在编入索引完成之前创建收藏集、排除项、设计和活动。
如果状态显示为“成功”,则表示文件已找到且已正确解析。在将该文件编入索引之前,无法在 Recommendations 中使用相应的信息,编入索引可能需要一些时间,具体取决于文件的大小。如果该过程失败,则表示未找到文件(例如,您使用的 URL 不正确或您的 FTP 信息不正确),或者存在解析错误。
有关可能的信息源状态及其指示器的信息。
以下是信息源可能具有的几种状态:
状态 | 描述 |
---|---|
正在同步 | 正在将信息源设置详细信息保存到 Target。 |
同步失败 | 无法将信息源设置详细信息保存到 Target。请重试。 |
未运行信息源 | 您已创建一个信息源,但尚未设置运行计划(频率设置为“从不”)。 |
已计划在 <日期和时间>** 运行 | 信息源尚未运行,但已计划在指定的日期和时间运行。 |
正在等待下载 | Target 正准备下载信息源文件。 |
正在下载信息源文件 | Target 正在下载信息源文件。 |
正在导入项目 | Target 正在从信息源文件中导入项目。 |
已在指定时间成功导入信息源 | Target 已将信息源文件导入其内容交付系统。已在内容交付系统中对项目属性进行了更改,并且此更改将很快地反映在交付的推荐中。如果没有看到预期的更改,请稍后重试并刷新包含推荐的页面。 注释:
|
未能编入索引 | 索引操作失败。请重试。 |
未找到服务器 | FTP 或 URL 位置无效或无法访问。 |
要更新信息源(例如,更改信息源配置或信息源文件),请打开该信息源,进行任何所需更改,然后单击保存。
上传的实体会在 61 天后过期。这意味着您应该至少每 60 天上传一次信息源文件,以避免对您的推荐活动造成干扰。如果某个项目未至少每60天包含在信息源文件(或其他实体更新方法)中, Adobe Target 推断该项目不再相关,并将其从目录中删除。
以下信息源状态指示器将显示在“状态”列中:
状态指示器 | 描述 |
---|---|
绿色状态指示器 | 当成功将信息源编入索引时,会显示绿色状态圆点,以指示该信息源处于成功状态。 |
黄色状态指示器 | 当信息源或信息源索引延迟的时间为信息源频率的 25% 时,会显示黄色状态圆点。例如,对于设置为每日运行的信息源,如果在计划时间后的六小时内没有完成索引,则会显示黄色圆点。注意:如果信息源状态为“正在等待索引队列”,则最近更新的值可在交付和标准处理过程中使用。 |
白色状态指示器 | 当未设置信息源运行计划时,会显示白色状态圆点,以指示信息源尚未运行。 |
红色状态指示器 | 如果信息源未能将数据上传到服务器,则会显示红色状态指示器。 |
请仔细研究下面的示例:
示例 1:
状态应为黄色,因为索引原本应在大约 6.5 小时之前运行。6.5 小时 + 24 等于信息源运行期限的 127%。
示例 2:
状态应为黄色,因为索引原本应在大约一天零一小时之前运行。虽然这只是频率设置的 (31+(1/25))/30 = 1.03%,但它超过了延迟一天的最大值。
以下视频包含有关本文中所讨论概念的详细信息。
本视频包含以下信息:
本视频包含以下信息: