动态产品目录

工作原理

动态产品目录通过展示来自您产品目录（Product Catalog）的个性化产品推荐，让您的广告活动更具影响力。 每个产品都链接到其产品详情页，为购物者提供从发现到购买的无缝路径。 对于拥有 5 个或更多 SKU 的品牌，动态产品目录可以创造更相关的购物体验，并持续带来更高的业绩，广告主通常会看到转化指标提升 10–25%。

开始使用

要使用动态产品目录，请先通过目录管理器配置您的产品目录。

有三种方法可以添加您的产品目录。 要从中进行选择：

  1. 在 Ads Manager 中，点击标签图标以打开 目录 管理器。
  2. 在目录名称旁，点击铅笔图标以打开 编辑目录 页面。
  3. 从以下三个 数据源 选项中选择一个：
    1. 来自 Axon Pixel
    2. 从文件导入
    3. 连接 Shopify

以下部分将介绍这三个选项。

1. 来自 Axon Pixel（推断方法）

来自 Axon Pixel。使用 Axon Pixel 事件数据自动生成目录并导入产品

对于不提供 CSV 流的非 Shopify 网站，推断目录是默认的目录创建方法。 此方法使用在 pixel 事件中注册的信息来构建产品目录。 如需更精细地控制目录中包含哪些商品，请选择方法 2 和 3。

推断方法的重要数据要求

  • 验证您的 pixel 是否在所有 purchase 和 view_item 事件中发送了 item_id 和 item_variant_id，并具有正确的层级结构
    • item_id：代表独立于其变体的父商品。 多个 item_variant_id 可能会共享相同的 item_id。
    • item_variant_id：例如父商品的尺寸或颜色变体。 目录中的每个变体都必须有一个不与任何其他变体或商品共享的 item_variant_id。
    • 随 purchase 事件传递的 item_id 和 item_variant_id 值应与随 view_item 事件传递的值相匹配。
  • 确保 image_url 随 view_item 事件一起传递，并且该 URL 链接到具有正确文件扩展名的高质量图片。
  • item_category_id 是高度推荐的字段。

2. 从文件导入（CSV 馈送）

从文件导入。使用电子表格导入您的产品目录

CSV 流目录使您能够更精细地控制产品目录中包含哪些产品。 您可以通过两种方式集成 CSV 流式目录：

  1. 数据馈送提供商： 您可以利用 第三方目录馈送 页面上列出的合作伙伴之一，插入通过馈送提供商生成的目录 CSV 馈送。
  2. 自定义 CSV 文件： 您可以向 AppLovin 提供一个端点，AppLovin 每天会从该端点下载 .csv 格式的产品目录。 操作步骤：
    • 将您的目录信息添加到 目录 CSV 模板。
    • 将您的 CSV 上传到可公开访问的位置。 请参阅此示例。
    • 每当您的目录发生变化时更新此 CSV（AppLovin 建议您每日更新）。 AppLovin 每天同步一次您的目录流。
    • 确保 salesPrice 永远不超过 price，因为出于数据完整性考虑，这会导致目录同步问题。
    • 确保所有字段都不包含逗号（您只能使用逗号来分隔字段）。

如果您的 CSV 数据中的条目包含双引号字符（"），并且您没有正确转义这些字符，则可能会导致 CSV 解析器出错。 您可以通过在双引号字符前加上反斜杠（\）来进行转义，例如：

     id,name,itemId…
     v0001,Lee \"Scratch\" Perry,i001…
     v1234,Never Say \"Never Again\",i987…
     ⋮

CSV 馈送方法的重要数据要求

  • 验证您的 pixel 是否在所有 purchase 事件中发送了 item_id 和 item_variant_id，并具有正确的层级结构
    • item_id：代表独立于其变体的父商品。 多个 item_variant_id 可能会共享相同的 item_id。
    • item_variant_id：例如父商品的尺寸或颜色变体。 目录中的每个变体都必须有一个不与任何其他变体或商品共享的 item_variant_id。
  • 随 purchase 事件传递的这些字段（item_id 和 item_variant_id）应与 CSV 中对应列（itemId 和 id）中发送的值相匹配

3. 连接 Shopify

连接 Shopify。直接从您的 Shopify 商店同步和导入您的产品

如果您集成了 Shopify 应用 pixel，则可以使用目录管理器中的 连接 Shopify 方法来同步您的产品目录。 此方法的一个好处是，您的目录会更新为您网站上的最新产品，包括产品价格和库存情况。

如何在广告活动中启用动态目录

在使用上述方法之一同步目录后，请在创建广告活动时激活 启用动态目录（Enable Dynamic Catalog）并选择要使用的目录。

附加信息

术语表

术语定义
catalog目录包含您打算销售的产品。AppLovin 建议您所有的产品只使用一个目录。
variant变体是要销售的单个 SKU。每个 SKU 都应该是一个独立的变体。目录管理器将具有相同 itemId 的变体视为同一商品的变体。例如，同一品牌的红色小号衬衫、红色大号衬衫和蓝色大号衬衫各自都是独立的变体，但共享相同的 itemId。

Variant 对象

字段类型是否必填？描述
additionalImageUrlsString[]否与变体关联的其他图片。有效的扩展名为 .jpg、.jpeg 和 .png。请使用分号而不是逗号来分隔此数组中的项目。
additionalVideoUrlsString[]否与变体关联的其他视频。有效的扩展名为 mp4。请使用分号而不是逗号来分隔此数组中的项目。
ageGroupString否ADULTS、ALL_AGES、INFANT、KIDS、NEWBORN 或 TODDLER 之一
brandString否如果存在另一个具有相同 itemId 的变体，则忽略此字段。长度不能超过 256 个字符。
categoryIdInteger是Google 品类 ID
descriptionString是变体的简短描述。描述应简明扼要且信息丰富，长度不能超过 8192 个字符。
genderString否FEMALE、MALE 或 UNISEX 之一
idString是变体的 ID。这必须与您 pixel 中的 item_variant_id 相匹配。长度不能超过 64 个字符。
isAvailableBoolean是变体是否有货或缺货
isBundleBoolean是变体是否是组合销售的多个商品的集合
itemIdString是商品的变体之间共享的 ID。这必须与您 pixel 中的 item_id 相匹配。长度不能超过 64 个字符。
multipackQuantityNumber否单个包装中相同商品的数量
nameString是变体的名称。长度不能超过 1024 个字符。
numberOfReviewsNumber否变体的总评论数
priceDecimal是变体的价格。如果变体正在促销，价格应为促销前的原价。
primaryImageUrlString是与变体关联的主图片，在展示变体时默认显示。有效的扩展名为 .jpg、.jpeg 和 .png。长度不能超过 2048 个字符。
primaryVideoUrlString否与变体关联的主视频，在展示变体时默认显示。有效的扩展名为 mp4。长度不能超过 2048 个字符。
ratingDecimal否变体的评分，范围为 0 到 5。如果没有评分，则为 null。
rewardEndDateDateTime否rewardPercent 有效期结束的时间。根据 ISO-8601 将其格式化为 UTC 时间，不带时区偏移（例如：2025-01-07T00:00:00）。如果 rewardStartDate 和 rewardEndDate 均为 null，则 rewardPercent 不生效。如果仅 rewardEndDate 为 null，则 rewardPercent 自 rewardStartDate 起生效。
rewardPercentNumber否客户购买该变体所获得的奖励百分比，表示为 0 到 100 之间的数字
rewardStartDateDateTime否rewardPercent 开始生效的时间。根据 ISO-8601 将其格式化为 UTC 时间，不带时区偏移（例如：2025-01-01T00:00:00）。如果 rewardStartDate 和 rewardEndDate 均为 null，则 rewardPercent 不生效。如果仅 rewardEndDate 为 null，则 rewardPercent 自 rewardStartDate 起生效。
salePriceDecimal否变体的促销价格。如果变体未在促销，则为 null。
salePriceEndDateDateTime否salePrice 有效期结束的时间。根据 ISO-8601 将其格式化为 UTC 时间，不带时区偏移（例如：2025-01-07T00:00:00）。如果 salePriceStartDate 和 salePriceEndDate 均为 null，则 salePrice 不生效。如果仅 salePriceEndDate 为 null，则 salePrice 自 salePriceStartDate 起生效。
salePriceStartDateDateTime否salePrice 开始生效的时间。根据 ISO-8601 将其格式化为 UTC 时间，不带时区偏移（例如：2025-01-01T00:00:00）。如果 salePriceStartDate 和 salePriceEndDate 均为 null，则 salePrice 不生效。如果仅 salePriceStartDate 为 null，则 salePrice 持续生效至 salePriceEndDate。
webUrlString是产品落地页 URL。此页面必须运行 pixel 并触发 view item 事件。

如果您的 CSV 数据中的条目包含双引号字符（"），并且您没有正确转义这些字符，则可能会导致 CSV 解析器出错。 您可以通过在双引号字符前加上反斜杠（\）来进行转义，例如：

id,name,itemId…
v0001,Lee \"Scratch\" Perry,i001…
v1234,Never Say \"Never Again\",i987…
⋮
这篇文章有帮助吗？
PREVIOUS
关于动态目录
NEXT
动态产品目录
axon logoaxon logo
axon logoaxon logo
© 2026 AppLovin. All rights reserved.
政策中心使用条款发布商政策需求方合作伙伴政策平台管控隐私隐私选项CPRACookies Settings
这篇文章有帮助吗？
search