# APP Retargeting Feed 指南
这是 Retargeting feed 的介绍说明,以方便的可以在 clientgear 产品中更好的使用.
# 说明
Feed是一个由产品列表组成的文件，这些产品使用以独特方式定义每个产品的属性分组。该文件包含许多产品详细信息，例如产品图像价格 颜色 大小等。
# 支持的格式
clientgear 支持多种feed格式,每种格式可以参考下面的示例.
| 格式 | 描述 | 示例 |
|---|---|---|
| tsv | tsv是基于制表符分隔的文件格式. | 示例 |
| csv | csv是基于逗号分隔的文件格式。 | 示例 |
| xml | xml是使用 xml 结构的文件格式. | 示例 |
# 字段说明
对每个字段都进行说明讲解.
| 字段 | 描述 | 必填 | 要求 | 列子 |
|---|---|---|---|---|
| id | Id是唯一的产品标识符，代表一个且仅一个产品。 将ID分配给产品并导入后，该ID可能不会用于其他产品，特定产品的ID也不会更改。 如果您还填充了item_group_id，请使用子ID / SKU填充id | 必须 | 字符要求：Id必须只包含ASCII字符，并且不得包含引号. | 示例: cloth-white-83.3 |
| title | Title 是产品的名称，通常显示在产品的详细信息页面上。 这将用作给定产品的横幅中的主要文本描述符 | 必须 | 字符要求：标题必须以字母或数字开头限制 | 示例：牙刷 - 大小 1.3 |
| description | Description 是一段简短的文本，除了名称外，还提供有关产品的更多信息。 由于横幅的设计，较短的描述（低于50个字符）更可能适合 Clientgear 的格式和布局，但是，并非所有格式和布局都有描述 | 必须 | 字符要求：描述必须以字母或数字开头。 从此字段中删除所有HTML标记，包括样式，嵌入，对象和锚标签 | 示例：非常适合日常使用 |
| link | Link是产品的专用详细信息页面。 链接通常是，但不一定是给定产品的唯一。 此网址上的产品信息应与Feed中提供的相应信息一致。 请为所有网址指定协议（http://或https://） | 必须 | 字符要求：链接必须以 protocol（http：//或https://）后跟产品详细信息页面的完整URL。 必须对所有符号进行编码。 | 示例：http://www.example.com/product/toothbrush |
| image_link | Image_link是一个URL，用于指定给定产品图像的文件路径。 Image_link将用于在横幅中显示产品的图像。 理想情况下，图像应至少为800x800像素，大小不超过16MB,必须是一个可用访问的 URL. | 必须 | 字符要求：Image_link 必须 以http://或https://开头，后跟产品图片的完整网址。 必须对所有符号进行编码。 | 示例：http：//www.example.com/product/image/toothbrush.png |
| mobile_link | 利用 mobile_link [移动版链接] 属性，您可以添加移动版着陆页的网址。如果用户使用手机或平板电脑之类的移动设备，就会看到这个移动版本的着陆页。 | 必须(app 投放) | 字符要求：链接必须以 protocol（http：//或https://）后跟产品详细信息页面的完整URL。 必须对所有符号进行编码。 | 示例：http://m.example.com/product/toothbrush |
| additional_image_link | 除了使用 image_link [图片链接] 属性提供主图外，您还可以使用 additional_image_link [附加图链接] 属性来提供更多与商品相关的图片。商品的额外图片可向潜在客户展示，通常用于从不同的角度或者搭配商品场景元素来展示商品。 | 可选 | 字符要求：Image_link 必须 以http://或https://开头，后跟产品图片的完整网址。 必须对所有符号进行编码。 | 示例：http：//www.example.com/product/image/toothbrush.png |
| availability | Availability 表示是否可以在站点上购买产品。 您可以使用3个可能的值填充可用性：预订（商品当前未发货，但仍可购买），缺货（商品未发货且您不接受此商品的订单）和库存（商品已发货） 并且可以为此项目下订单）。 标记为缺货的项目将被排除在横幅中显示 | 必须 | 字符要求：必须使用以下三个值之一填充可用性： - 预订 - 缺货 - 库存 | 示例：库存中 |
| availability_date | 使用发货日期 [availability_date] 属性来告知客户预订或缺货待补商品的发货日期。 | 可选 | 字符要求：1-25个字符内的日期、时间和时区，需符合 ISO 8601 标准 （YYYY-MM-DDThh:mm[±hhmm] 或 YYYY-MM-DDThh:mmZ） | 示例：2016-12-25T13:00-0800 |
| cost_of_goods_sold | 在报告购物车数据反映的转化情况时，您可以使用销货成本 [cost_of_goods_sold] 属性来额外获取有关毛利润的报告。请注意，要想使用这类报告，您必须报告每次转化对应的商品级信息。 | 可选 | 字符要求：数字和货币（使用 ISO 4217 标准） | 示例：10.01 USD |
| expiration_date | 使用下架日期 [expiration_date] 属性来使商品在特定的日期停止展示。例如，您可以针对库存有限或季节性的商品进行此操作。 | 可选 | 字符要求：1-25个字符内的日期、时间和时区，需符合 ISO 8601 标准 （YYYY-MM-DDThh:mm[±hhmm] 或 YYYY-MM-DDThh:mmZ） | 2016-02-24T00:30-0800 |
| price | 此产品的销售价格。 如果给定的产品是“在售”，价格字段将填充更高的价格。 价格应与网站的货币相同。 仅使用句点（.）作为小数点分隔符填充价格，并且没有千位分隔符 | 必须 | 字符要求：小数点分隔符必须是句点（.），没有千位分隔符 | 示例：1299.99 |
| sale_price | 此产品在网站上可以购买产品的价格，如果给定的产品是“正在销售”，则sale_price将以较低的价格填充。 Sale_price应与网站使用相同的货币。 仅使用句点（.）作为小数点分隔符填充sale_price并使用千位分隔符。 | 可选 | 字符要求：小数点分隔符必须是句点（.），没有千位分隔符 | 示例：1099.99 |
| sale_price_effective_date | 使用促销价有效期 [sale_price_effective_date] 属性可告知我们您希望向用户展示特定促销价的时长。 | 可选 | 字符要求：0-51个字符的日期范围（使用 ISO 8601 标准）。提交开始日期和结束日期，并采用 YYYY-MM-DDThh:mm[±hhmm] 或 YYYY-MM-DDThh:mmZ 作为时间和时区格式 [以正斜线 (/) 分隔]（例如2016-02-24T13:00-0800/2016-02-29T15:30-0800） | 示例：2016-02-24T13:00-0800/2016-02-29T15:30-0800 |
| unit_pricing_measure | 使用价格计量单位 [unit_pricing_measure] 属性定义商品的计量单位和尺寸。此值可帮助用户了解商品的确切单价。 | 可选 | 字符要求：正数加单位，支持的单位 ：重量（oz、lb、mg、g、kg ），容积（（美式英制单位）：floz、pt、qt、gal）， 容积（（公制单位）：ml、cl、l、cbm）， 长度（in、ft、yd、cm、m）， 面积（sqft、sqm）， 每单位（ct） | 示例：750ml |
| installment | 使用分期付款 [installment] 属性告知客户您为商品提供的按月分期付款方案的详情。 | 可选 | 字符要求：数字和货币 | 示例：6:50 BRL |
| subscription_cost | 利用订阅费用 [subscription_cost] 属性，详细说明绑定了通信服务合约的无线通讯商品（手机或平板电脑）的按月或按年付款方案。 | 可选 | 字符要求：Unicode 字符（建议仅使用 ASCII 字符） | 示例：month:12:50 EUR |
| loyalty_points | 使用积分 [loyalty_points] 属性，您可以指定客户购买商品时获得的积分点数和类型 | 可选 | 字符要求：Unicode 字符（建议仅使用 ASCII 字符） | 示例：对于包含 100 积分且等于“0.5 个货币单位”的计划 A，请提交： Program A : 100 : 0.5 |
| google_product_category | 类别级别属性表示根据Google产品分类标准提交的产品类别。 如果您的产品可以链接到多个类别，我们只需要最相关的产品。 | 可选 | 字符要求：我们接受ID和完整类别路径 | 示例：女装>鞋子>工作靴 |
| product_type | Product_type是产品所属的类别（或类别列表）。 Product_type字段列出了此商品的商品推销类别或商品推销类别。它必须与您的网站类别相匹配。层次结构中的每个级别都需要用“>”分隔。如果产品有多个类别，请先将不同类别作为逗号（,）与主要类别分隔。 product_type是区分大小写的，因此如果您将女性用于一个产品而女性用于另一个产品，Clientgear 会将这些视为两个不同的类别 | 可选 | 字符要求：Product_type必须以字母或数字开头，并且只能包含ASCII字符。类别之间的分隔符必须>（>对于XML Feed）。我们只支持完整的类别路径。如果产品有多个类别，请先将逗号（,）分隔的主要类别发送给不同的类别。我们不接受路径的类别ID。必须在product_type_key字段中填充ID | 示例：单个：计算>键盘和鼠标>鼠标>无线鼠标多个：计算>键盘和鼠标>鼠标>无线鼠标，礼物>爸爸>鼠标 |
| canonical_link | 请为有资格在 Google 上的非付费商品详情中展示的商品提交 Google 搜索索引链接 [canonical_link] 属性，并利用该属性来确保相关商品与 Google 的搜索索引中的正确网址关联。此属性中的网址不会向用户显示，但会增进 Google 对商品的了解 | 可选 | 字符要求：1 – 2000 个字符内的网址（包括 http 或 https），仅限 ASCII 字符并遵守 RFC 3986 标准 | 示例：http://www.example.com/writing/google-pens |
| brand | 使用brand [品牌]属性来指明商品的品牌名称。该品牌用于帮助识别您的商品并会向用户显示。品牌名称应该清晰地展示在商品包装或标签的正面。品牌名称应该是包装的一部分，而不是人为添加到商品图片中的 | 可选 | 字符要求：字符串（Unicode 字符。建议：仅使用 ASCII 字符） | |
| mpn | 使用 MPN [mpn] 属性提交商品的制造商部件号 (MPN)。MPN 用于以唯一的方式标识同一制造商生产的所有商品中的具体商品。购物者可能会直接搜索 MPN，因此提供 MPN 有助于确保您的商品在相关情境中显示。 | 必须为没有制造商指定的 GTIN 的所有商品提交此属性 | 字符要求：1 - 70 个字符内的字符串（字母数字，Unicode 字符。建议：仅使用 ASCII 字符） | 示例：GO12345OOGLE |
| identifier_exists | 您可以使用是否有 ID [identifier_exists] 属性指明您的商品没有唯一商品标识码 (UPI)。使用 GTIN [gtin]、MPN [mpn] 和品牌 [brand] 属性提交唯一商品标识码。 | 用于没有 GTIN、MPN 或品牌的商品。 | 字符类型：布尔值 | 示例：否 |
| condition | 借助使用情况 [condition] 属性向潜在客户说明您销售的商品的使用情况。请务必正确设置此值，因为该值可用于优化搜索结果。 | 对于每件新商品，此属性为可选属性；对于每件二手商品和翻新商品，此属性为必需属性 | 字符要求：英文的new、refurbished、used | 示例：used [二手] |
| adult | 如果个别商品包含裸露、性暗示内容等成人内容或为性增强用品，请使用成人 [adult] 属性指明这些商品仅面向成人。 | 如果商品包含裸露、性暗示内容等成人内容或为性增强用品，则必须提供此属性 | 字符要求：布尔值 | 示例：是 [yes] |
| multipack | 您可以使用多件组合装 [multipack] 属性指明您将多件相同的商品组合在一起，作为一件商品销售。通过此属性，我们可以将您的商品与制造商所制作的多件组合装、套装和其他商品进行区分，从而在恰当的时机展示您的商品。 | 可选 | 字符要求：数字 | 示例：6 |
| is_bundle | 您可以使用套装 [is_bundle] 属性指明自己创建了套装：即用一个价格，将一件主商品与其他不同的商品组合起来作为一个套装销售。 通过此属性，我们可以将您的商品与制造商所制作的多件组合装和其他不含配件的商品进行区分，从而在恰当的时机展示您的商品。 | 可选 | 字符要求：布尔值 | 示例：是 |
| age_group | 使用年龄段 [age_group] 属性可设置您的商品所面向的受众人群。 使用此属性时，您的商品可能会出现在按年龄过滤的搜索结果中。例如，用户可以使用“女性”（而非“女孩”）来过滤搜索结果。您还可以结合使用年龄段属性和性别 [gender] 属性，帮助确保客户看到正确的尺寸信息。 | 可选 | 字符要求：支持的值（支持的值 newborn ，infant ，toddler ，kids ，adult） | 示例：adult |
| color | 使用 color [颜色] 属性来描述您的商品的颜色。此信息可帮助用户创建精确的过滤条件，从而缩小搜索结果范围。如果您的商品有多个款式，每个款式的颜色都各不相同，则请通过此属性提供相应信息。 | 可选 | 字符要求：字符串（Unicode 字符。建议：仅使用 ASCII 字符） | 示例：亮芒果橙 |
| gender | 您可以使用适用性别 [gender] 属性指定商品的适用性别。如果提供了此信息，潜在客户可以按适用性别精确地过滤商品，从而缩小搜索范围。请注意，我们会将您提供的性别信息与尺寸 [size] 和年龄段 [age_group] 属性值结合在一起，从而向用户展示标准化的尺寸信息。 | 可选 | 字符要求:英文提交，可选值（male,femalem,unisex） | 示例：male |
| material | 使用材质 [material] 属性说明商品采用的主要面料或材质。例如，尖头细高跟鞋可能采用皮革、牛仔布或绒面革。此信息可帮助客户创建准确的过滤条件，缩小搜索结果范围。如果您的商品有多个款式/规格，每个款式/规格采用不同的材质，请通过此属性提供材质信息。 | 可选 | 字符要求：0-200个字符内的 Unicode 字符（建议：仅使用 ASCII 字符），不区分大小写 | 示例：Leather |
| pattern | 使用“图案 [pattern]”属性来说明商品上印刷的图案或图形。例如，某件 T 恤可能印有一个运动队（熊队或虎队）的徽标，在这种情况下您可以提交“熊”或“老虎”作为属性值。此信息可帮助客户创建准确的过滤条件，缩小搜索结果范围。如果您的商品有多个款式/规格，每个款式/规格采用不同的图案，请通过此属性提供图案信息。 | 可选 | 字符要求：0-100个字符内的Unicode 字符（建议：仅使用 ASCII 字符） | 示例：条纹 |
| size | 使用 size [尺寸] 属性描述商品的标准尺寸。使用此属性时，您的商品可能会出现在按尺寸过滤的搜索结果中。您提交的尺寸还会影响各商品款式/规格的展示效果。 | 可选 | 字符要求：字符串（Unicode 字符。建议：仅使用 ASCII 字符） | 示例：XL |
| size_type | 请使用“尺码类型 [size_type]”属性来描述商品的剪裁样式。此信息可帮助客户创建准确的过滤条件，缩小搜索结果范围。 | 可选 | 字符要求：可选的值（ regular、petite、plus、tall、big、maternity） | 示例：petite [小号]、maternity [孕妇] |
| size_system | 通过尺码体系 [size_system] 属性，您可以说明自己的商品使用的是哪个国家/地区的尺码体系。此信息可帮助客户创建准确的过滤条件，缩小搜索结果范围。您提交的尺码体系会影响搜索和过滤结果，以及各种款式/规格商品的展示效果。 | 可选 | 字符要求：可选的值（AU 、BR、CN、DE、EU 、FR、IT、JP、MEX、UK、US） | 示例：US |
| item_group_id | 您可以使用商品组 ID [item_group_id] 属性对商品数据中的商品款式进行分组。款式是一组相似的商品，相互之间的区别在于商品详情，例如尺寸 [size]、颜色 [color]、材质 [material]、图案 [pattern]、年龄段 [age_group] 和适用性别 [gender]。 | 可选 | 字符要求：1-50个字符内的 Unicode 字符（建议：仅使用 ASCII 字符）：字母数字字符、下划线和短划线 | 示例：AB12345 |
| product_highlight | 使用商品亮点 [product_highlight] 属性可简单列出商品最相关的亮点。您提交的亮点应该向购物者展示通俗易懂、清晰明了的词句，能够解答最常见的消费者问题，或者重点介绍商品最重要的特性。 | 可选 | 字符要求：1-150个字符（每个亮点）的 字符串（Unicode 字符。建议：仅使用 ASCII 字符） | 示例："支持数千种应用，包括 Netflix、YouTube、HBO Now、Spotify、Showtime、Pandora、Google Play 电影","最大分辨率为 1080p","支持 2.4 Ghz 和 5 Ghz Wi-Fi 网络","支持 iOS、Mac OS、Windows、Chrome 操作系统和 Android 设备" |
| ads_redirect | 使用 Ads 重定向 [ads_redirect] 属性可以在商品页面上指定您要用于购物广告的其他着陆页参数。请注意，如果您为“Ads 重定向”属性提交跟踪网址，则系统会将客户定向到该网址，而不是您为链接 [link] 或移动版链接 [mobile_link] 属性提交的网址。 | 可选 | 字符要求：1-2000个字符内的 网址（包括 http 或 https），仅限 ASCII 字符，须遵循 RFC 3986 标准 | 示例：https://tracking.example.com?product=ballpoint-pens |
| custom_label0 | 您可以利用自定义标签（从 custom_label_0 [自定义标签0] 到 custom_label_4 [自定义标签4]）创建可在购物广告系列中使用的特定过滤条件。这些过滤条件可用于针对商品组生成报告和出价。您在这类属性中添加的信息不会向用户显示。 | 可选 | 字符要求：字符串（Unicode 字符。建议：仅使用 ASCII 字符） | 示例：夏季 |
| promotion_id | 使用促销活动功能的零售商可同时在商品数据和促销数据中使用促销 ID [promotion_id] 属性，以便将商品与促销活动进行匹配。了解促销活动。 | 可选 | 字符要求：1-50个字符内的Unicode 字符（建议：仅使用 ASCII 字符）：字母数字字符、下划线和短划线 | 示例：tbby123_us |
| excluded_destination | 使用禁止展示位置 [excluded_destination] 属性以防止您的商品出现在所选位置。 | 可选 | 字符要求：可选的值（Shopping_ads、Buy_on_Google_listings、Display_ads、Local_inventory_ads、Free_listings、Free_local_listings） | 示例：Display_ads |
| included_destination | 除“禁止展示位置 [excluded_destination]”属性之外，您还可以使用“允许展示位置 [included_destination]”属性来控制您的商品可以展示在哪些位置。 | 可选 | 字符要求：可选的值（Shopping_ads、Buy_on_Google_listings、Display_ads、Local_inventory_ads、Free_listings、Free_local_listings） | 示例：Display_ads |
| shopping_ads_excluded_country | 您可以使用禁止展示购物广告的国家/地区 [shopping_ads_excluded_country] 属性来控制可以宣传您的购物广告商品的不同国家/地区。如果您需要覆盖 Feed 中某些商品的 Feed 国家/地区设置，则可以使用此属性。 | 可选 | 字符要求：2 个字符。必须是 ISO-3166-1 Alpha 2 国家/地区代码 | 示例：CH,AT |
| pause | 如果您希望暂时停止在广告（包括购物广告、展示广告和本地商品目录广告）中展示商品（最多 14 天），可以使用暂停 [pause] 属性来告知 Google。 | 可选 | 字符要求：可选的值（ads） | ads |
| shipping_label | 使用配送标签 [shipping_labe] 属性对商品进行分组，以便在 Merchant Center 中配置特定的运费。您在这类属性中添加的信息不会向客户显示。 | 可选 | 字符要求：Unicode 字符（建议：仅使用 ASCII 字符） | 示例：超大 |
| shipping_weight | 借助运送包裹总重 [shipping_weight] 属性，您可以添加通过 Merchant Center 设置计算运费时所用的重量。例如，使用运输公司运费标准时，您需要提交运送包裹总重属性。 | 可选 | 字符要求：数字加单位 | 示例：3kg |
| ships_from_country | 发货国家/地区 [ship_from_country] 属性可用于指明您的商品通常是从哪个国家/地区发货的。您可以让潜在客户了解您的商品是在本地发货还是从境外发货，从而帮助客户决定是否购买。 | 可选 | 字符要求：2 个字符。必须是 ISO-3166-1 Alpha 2 国家/地区代码 | 示例：DE |
| transit_time_label | 如果不同商品组的运送时间不同，请使用运送时间标签 [transit_time_label]，并将此属性应用于 Feed 中的相应产品。使用 Merchant Center“配送设置”中的运送时间标签，为先前定义的每个商品组指定特定的运送时间。运送时间标签有助于为您的客户提供更准确的预计送达日期，而预计送达日期会影响客户的购买决策。 | 可选 | 字符要求：Unicode 字符（建议：仅使用 ASCII 字符） | 示例：狗粮 |
| tax | 通过税费 [tax] 属性，您可以覆盖自己在 Merchant Center 中设置的美国税费。如需修改或覆盖个别商品的税费，请使用此属性。 | 可选 | 字符要求：Unicode 字符（建议仅使用 ASCII 字符） | 示例：此属性的格式取决于提交的属性值及其具体顺序。先添加 tax，然后在括号中添加您要提交的子属性的名称，以英文冒号 ( : ) 分隔。 名称 tax(country:rate) 可能的值 6.49 |
| tax_category | 通过“税种 [tax_category]”属性，您可以根据自定义税务规则来整理商品。例如，某些服装在美国的某些州可以免税，而某些商品可享受低于正常税率的税率优惠。使用此属性可确保您的商品在美国显示正确的税率。 | 可选 | 字符要求：1-100个字符内的 字符串（Unicode 字符。建议：仅使用 ASCII 字符） | 示例：服装 |
| mobile_ios_app_link | ios 系统中,提供的应用进入商品页面的深度链接. | 必须(app 投放) | 字符要求：字符串（Unicode 字符。建议：仅使用 ASCII 字符） | example://product/detail?productId=100000000007 |
| mobile_ios_app_store_id | ios 系统中,应用在app 商店的id | 必须(app 投放) | 字符要求：字符串（Unicode 字符。建议：仅使用 ASCII 字符） | 382720283 |
| mobile_ios_app_name | ios 系统中,应用的名称 | 必须(app 投放) | 字符要求：字符串（Unicode 字符。建议：仅使用 ASCII 字符） | example app |
| mobile_android_app_link | android 系统中,提供的应用进入商品页面的深度链接. | 必须(app 投放) | 字符要求：字符串（Unicode 字符。建议：仅使用 ASCII 字符） | example://product/detail?productId=100000000007 |
| mobile_android_app_package | android 系统中,应用的包名 | 必须(app 投放) | 字符要求：字符串（Unicode 字符。建议：仅使用 ASCII 字符） | com.example.app |
| mobile_android_app_name | android 系统中,应用的名称 | 必须(app 投放) | 字符要求：字符串（Unicode 字符。建议：仅使用 ASCII 字符） | example app |