亚马逊引流洞察 API 相关问题疑难解答

本疑难解答指南分为三个部分： 账户授权、标签应用和报告。请仔细阅读此页面上的问题，确认您已正确应用了标签，并确认了对报告的期望。

账户授权

要使用亚马逊引流洞察 API，您的 API 开发人员账户必须有权访问广告主的广告配置文件。如需进一步了解授权方法，请参阅入门指南。请注意，设置中的某些方面（例如 URL 域名）可能会有所不同，具体取决于广告主的地理区域。

我调用了配置文件接口，但在响应中看不到广告主的配置文件

您的广告主必须授予您对其配置文件的访问权限，然后配置文件应在两个小时内出现在配置文件接口的响应列表中。如果您正在使用 API 测试域，请改用生产域。请参阅入门指南并确认您已完成所有设置步骤。

尽管我已获得授权，但当我使用广告主的配置文件调用亚马逊引流洞察接口时，我收到了 403 错误

该广告主的配置文件可能不符合亚马逊引流洞察的条件。如需进一步了解资格要求，请参阅概览。

标签应用

我点击了我的标签，但广告活动完全没有显示在报告中

这可能与以下原因有关：

• 您可能已将标签应用于无效的落地页。标签仅在应用于亚马逊商品详情页或品牌旗舰店页面时才起作用。
• 您必须先使用广告主的配置文件调用标签检索接口，然后才能衡量该广告主的广告活动。这是因为接口有隐藏的副作用，可以实现成效衡量。如果您跳过了该广告主的该步骤，请检索标签并重试。
• 首次点击后，广告活动创建可能需要多达四小时的时间。请尝试等待四个小时，然后再次查看。
• 您可能以影响标签功能的方式更改了该标签。请确保包含所有原始参数，没有重复项，并且 URL 的格式正确。

我点击了我的标签，在报告中看到了广告活动，但是点击量和转化量都为零

这可能与以下原因有关：

• 您可能需要等待 24 小时才能显示点击量，需要多达 48 小时才能显示转化量。
• 对于点击量低于 10 的数据行，亚马逊的报告阈值将掩盖其所有指标（显示为零）。点击标签十次后，指标应在 48 小时内显示。

我在报告中看到我的广告活动有一些点击量，但没有转化量（DPV、ATC、销量）

这可能是由以下原因造成的：

• 转化量可能需要多达 48 小时才能填充报告。请尝试等待，然后再次查看。
• 您将一个站点的标签应用于另一个站点的落地页。例如，美国账户的标签被应用于加拿大账户的落地页。
• 您将一个广告主配置文件的标签应用于某个商品或品牌旗舰店页面，而其对应的商品属于另一个广告主配置文件。标签衡量的转化量对应的商品只能属于与该标签配置文件关联的销售账户。
• 您的标签使用的参数值过长或使用了非法字符。值必须少于 255 个字符（扩展宏后），并且不得包含以下字符（即使经过 URL 转义）：/、&、=、#、?、+、’、”、%、$。
• 您的 aa_campaign_id 值已被另一个广告主或另一个站点重复使用。请确保每个站点的每个广告主都使用唯一的广告活动 ID。
• 您对包含 ref_ 和/或 tag 参数的 URL 应用了标签。由于归因标签使用自己的 ref_ 和 tag 参数，因此您 URL 中的这些参数会影响亚马逊引流洞察对您广告活动的衡量能力。从 URL 中删除 ref_ 或 tag 参数，保留归因标签中的参数。
• 您的落地页是未分配任何 ASIN 的亚马逊品牌旗舰店。如果您的亚马逊品牌旗舰店页面仅使用动态小部件来选择要实时显示的 ASIN（而不是每次都显示相同的 ASIN），那么亚马逊引流洞察可能不会将这些 ASIN 与您的广告活动相关联。要解决此问题，请向您的品牌旗舰店页面添加静态 ASIN 或使用其他落地页。
• 您以影响标签功能的方式更改了该标签，例如删除了参数，或将其附加到 URL 而未遵循标准 URL 格式规则。有效的 URL 格式将包含（按顺序）：亚马逊域名、商品或品牌旗舰店页面的路径、? 字符，然后是一个由参数名称值配对（name=value）构成的列表，每个名称值配对以 & 字符分隔。

报告显示了一个名为 {campaignid} 或类似名称的广告活动，为什么显示的不是我的实际广告活动 ID？

大括号中的短语是供特定出版商使用的宏，该出版商应将其替换为广告活动 ID 的值。如果您在报告中看到大括号而不是实际的 ID 值，则表示出版商无法处理该宏。这可能是由以下原因造成的：

• 该标签可能用于另一个出版商（例如 Google 广告活动中使用了 Facebook 标签）。
• 标签可能是在出版商广告管理器的错误字段中应用的，或者有其他事项影响了出版商对宏的处理，例如封装标签中的 URL 转义不正确。
• 如果您使用的是亚马逊引流洞察的非宏标签，则在准备链接时，您自己的系统必须填写 ID 参数。

我在多个落地页上使用了相同的标签，或者我将一个标签从一个落地页移到了另一个落地页，但指标看起来不正确

每个标签只能在一个落地页上使用。如果您想为同一个广告组中的多个落地页添加标签或将标签移至新的落地页，请为每个落地页使用唯一的创意 ID，但要使用相同的广告组 ID 和广告活动 ID。

报告

为什么我最近的报告看起来不完整？ 是否存在延迟？

在给定日期后 48 小时以内，该日期的报告应视为部分完成。通常，点击量会在 24 小时内报告。如果您正确应用了标签，则只需要等待，您的指标就会显示在报告中。

为什么自从我第一次提取报告以来，我的一些旧的转化指标发生了变化？

指标可能会在多达 28 天后重述，例如根据商品退货进行调整。亚马逊建议您偶尔提取最近 28 天的报告，并更新您在该时间段内存储的所有数据。

我的广告活动为品牌旗舰店页面引流，为什么页面上的所有商品都没有作为促销商品与我的广告活动相关联？

如果您的亚马逊品牌旗舰店页面仅使用动态小部件来选择要实时显示的 ASIN（而不是每次都显示相同的 ASIN），那么亚马逊引流洞察可能不会将这些 ASIN 与您的广告活动相关联。要解决此问题，请向您的品牌旗舰店页面添加静态 ASIN 或使用其他落地页。

为什么我在报告中看不到某个指标或维度？

每种报告类型都支持特定选择的维度和指标，而您选择的报告类型可能不支持您要查找的维度和指标。例如，Products（商品）报告不包括点击量指标或 aa_creativeid 维度，但 Performance（效果）报告包含这二者。可以通过访问 ReportRequestBody 参数和说明来查看每种报告可用的维度和指标。

报告类型	包含的维度	汇总级别	指标	可用的报告日期
Performance（效果）	aa_campaignid、aa_adgroupid、aa_creativeid、publisher	您可以选择在 CAMPAIGN、ADGROUP 或 CREATIVE 级别进行汇总（默认： CREATIVE）	点击量以及所有推广量和总转化量指标。如需进一步了解完整列表，请参阅报告接口。	最近 13 个月
Products（商品）	aa_campaignid、aa_adgroupid、publisher、productName、productGroup、productCategory、productSubcategory、brandName、productAsin、productConversionType	始终在广告组级别汇总	只有“前 100 个推广的商品”和“前 100 个品牌光环商品”的转化指标，没有点击量。（如需了解完整列表，请参阅报告接口。） 仅限排名前 100 的商品。	最近 90 天

为什么我提取过去 90 天前的 Products（商品）报告时会出错？

由于数据可用性限制，您只能提取 StartDate 在过去 90 天内的 Products（商品）报告

当我尝试一次提取所有报告时，为什么会出现错误？

如果您有大量数据，亚马逊建议使用分页来批量提取报告。您可以包含 “count” 参数来表明您希望每批提取多少条记录，并使用 “cursorId” 参数提取后续批次。如需进一步了解，请参阅报告接口相关参考。

为什么我看不到浏览转化量？**

亚马逊引流洞察 API 仅将转化归因于点击量，而非展示量。

为什么我的亚马逊引流洞察广告活动报告显示的点击量与广告出版商的广告活动报告显示的点击量不同？

如果仅在广告活动中的部分广告中添加了亚马逊引流洞察标签，则可能会发生这种情况。或者，如果您已将标签作为跟踪模板进行应用，请注意，如果在同一个广告活动的不同级别上应用了多个跟踪模板，则只有最低级别的模板才会触发，因此触发的可能是其他跟踪模板，而不是您的亚马逊引流洞察的归因标签。

为什么我的 API 报告显示的数字与亚马逊广告平台不同？

这种差异可能是我们的报告汇总阈值造成的。为了保护顾客的隐私，如果任何报告行表明标签或标签组在生命周期内获得的点击量低于 10，则亚马逊引流洞察将掩盖该报告行的数据。例如，在广告组级别汇总的报告对于点击量超过 10 的广告组将显示所有数据，即使该广告组中的部分标签的点击量低于 10。在超过点击量阈值之前，被掩盖的行会将指标值显示为零。预算很少或向很少的受众展示的广告活动可能需要一些时间才能超过这个阈值。

要在广告活动或广告组级别显示报告，您应该请求这些特定汇总级别的效果报告，而不是自己汇总数据，以确保您的报告包含所有可用数据并与亚马逊广告平台相匹配。

如果我希望在报告中包含第三方出版商维度，我能否使用与默认标签中不同的宏？

可以，您可以修改标签并添加或删除宏以满足您的需求。如果您希望这样做，亚马逊建议将其附加在 aa_creativeid 参数值的末尾，使用下划线或短划线将其与实际的创意 ID 分隔开。如果您希望删除任何宏，也可以这样做，前提是要确保最终的创意 ID 值是唯一的。

需要注意的是，如果数据行代表点击量低于 10 的标签或标签组，亚马逊报告阈值将在报告中掩盖此类数据行的数据，因此不要添加以下宏：将导致标签过于详细的宏（例如，一行中有多个宏），或对应少量受众或个人的宏（例如，一个用户 ID 或点击 ID），或使报告无法超过阈值的宏。