开发人员指南概述

亚马逊广告 API 概览

Amazon Marketing Stream

本文简要介绍 Amazon Marketing Stream,该服务目前处于面向集成合作伙伴和其他广告主的公开测试阶段。我们将介绍主要功能、限制条件、常见问题、常见用例并提供示例查询。如果您已准备开始使用 Amazon Marketing Stream,请参阅入门指南

提示

自 2023 年 2 月起,Amazon Marketing Stream 现已在亚马逊广告 API 支持的所有地区推出。

跳转到关键功能 | 数据集 | 限制 | 适用地区 | 一般常见问题 | 查询示例 | AWS 研讨会

概述

Amazon Marketing Stream 是一种数据流服务,合作伙伴或广告主可以用它来订阅广告数据集。Amazon Marketing Stream 可以近乎实时地将数据传送到合作伙伴或广告主拥有的 AWS 目标位置,从而让您不必一整天反复调用 API。借助 Amazon Marketing Stream,合作伙伴和广告主能够以原生方式使用 AWS 服务来接收和处理广告数据。Amazon Marketing Stream 可以减少当日广告活动优化通常需要的 API 调用次数,从而帮助改善数据集成模式和运营效率。

主要功能

与基于 API 的报告方法相比,Amazon Marketing Stream 提供了一些新功能:

Amazon Marketing Stream 数据集

目前,Amazon Marketing Stream 包含两类数据:报告和信息传递。要获取有关 Amazon Marketing Stream 提供的所有数据的详细描述,请参阅 Amazon Marketing Stream 数据指南

报告数据

Amazon Marketing Stream 报告包含广告主的已处理(非原始、已汇总)效果数据,包括每小时发送一次的流量和转化量,以及分析所需的数据维度。

信息传递数据

Amazon Marketing Stream 信息传递可近乎实时地发送有关实体状态更改和其他事件的通知。目前,这种信息传递包括预算消耗,每当您的预算分配变动 5% 或以上时,它就会发送通知。将来,我们还会扩大信息传递的范围,以提供有关商品使用资格、竞价建议和其他事件的通知。

限制条件

Amazon Marketing Stream 目前处于公开测试阶段,随着我们继续与合作伙伴和广告主合作收集反馈,我们计划增加更多功能。此阶段的一些主要限制包括:

适用地区

Amazon Marketing Stream 可供全球广告主使用。广告主的站点决定了您在创建队列和订阅数据集时应使用哪个 AWS 地区。使用下表了解支持的国家/地区,以及每个国家/地区应使用的 API 接口和 AWS 地区。

站点 地区 API 接口 AWS 地区
阿联酋 (AE)、德国 (DE)、埃及 (EG)、西班牙 (ES)、法国 (FR)、比利时 (BE)、英国 (UK)、印度 (IN)、意大利 (IT)、荷兰 (NL)、波兰 (PL)、沙特阿拉伯 (SA)、瑞典 (SE)、土耳其 (TR) 欧洲 https://advertising-api-eu.amazon.com eu-west-1
巴西 (BR)、美国 (US)、加拿大 (CA)、墨西哥 (MX) 北美 https://advertising-api.amazon.com us-east-1
新加坡 (SG)、澳大利亚 (AU)、日本 (JP) 远东 https://advertising-api-fe.amazon.com us-west-2

常见问题

使用 Amazon Marketing Stream 是否会产生相关费用? 可能会。对于使用 Amazon Marketing Stream 或将数据存储在亚马逊管理的服务中,亚马逊不会向广告主收取任何费用。但是,可能会产生与使用 AWS 相关的费用,具体取决于您的数据范围。[进一步了解 AWS 定价] (https://aws.amazon.com/pricing/)

是否任何在亚马逊上做推广的用户都可以使用 Amazon Marketing Stream? 可以。无论您是集成合作伙伴、代理商还是自助广告主,都可以申请访问 Amazon Marketing Stream。通过 [Amazon Marketing Stream 入门指南] (guides/amazon-marketing-stream/onboarding) 进一步了解请求访问权限。

我作为亚马逊广告合作伙伴正在进行集成。我能使用现有的基于 API 的身份验证吗?还是需要专门用于 Amazon Marketing Stream 的新凭据? 如果您有 API 凭据,则 *不* 需要额外的身份验证。您可以使用现有凭据来调用 Amazon Marketing Stream API。

使用 Amazon Marketing Stream 是否需要开发人员资源或其他专业技能? 需要,至少在最初阶段是如此,您需要开发人员资源来建立 Amazon Marketing Stream 订阅 API 连接。Amazon Marketing Stream 数据将流式传输到合作伙伴或广告主拥有的 SQS 队列。您的开发人员将使用订阅 API 来创建、确认和管理订阅。通过身份验证后,您将收到用于访问数据的 URL,然后不再需要进行 API 调用。 此外,我们建议您充分了解 AWS 的工作方式,以便最有效地使用 Amazon Marketing Stream。

通过 Amazon Marketing Stream 传输数据时,亚马逊如何确保数据安全? Amazon Marketing Stream 可确保仅向有权访问广告主数据的订阅提供数据。

Amazon Marketing Stream 何时正式推出? 目前还没有具体日期,但我们预计 Amazon Marketing Stream 将于 2023 年全面推出。同时,我们将在公开测试阶段继续逐步改进 Amazon Marketing Stream。我们将通过网络研讨会和其他常用沟通渠道向您告知 Amazon Marketing Stream 路线图的最新进展。

我该如何开始 Amazon Marketing Stream 入门流程? 当您准备好开始后,可通过 [Amazon Marketing Stream 入门指南](../../guides/amazon-marketing-stream/onboarding.html) 了解获取 API 访问权限、与 AWS 集成以及使用 Amazon Marketing Stream API 订阅数据集的过程。

有关查询数据的其他常见问题,请参阅 [Amazon Marketing Stream 查询常见问题] (guides/amazon-marketing-stream/querying-data#faq)。

使用案例

Amazon Marketing Stream 的主要用例包括对一段时间内的效果数据进行当日洞察的能力。这些数据可帮助您了解如何全天调整竞价和预算以更好地优化广告活动。您还可以使用 Amazon Marketing Stream 在高流量活动(例如亚马逊 Prime 会员日)期间利用近乎实时的效果数据,以便相应地更改竞价和预算:

示例查询

订阅 Amazon Marketing Stream 数据并将其存储在数据库中后,您可以根据要查看的数据参数运行查询。以下是一个示例,展示了如果您想要在特定时间窗口内针对特定关键词获取流量数据时,这些查询可能返回的内容。要获取更多示例并进一步了解,请参阅使用 Amazon Marketing Stream 进行数据查询

提取关键词的流量数据

查询

该查询显示了关键词在 08:00 时间段内的效果变化。

警告

该查询基于一个假设的设置,即假设 Amazon Marketing Stream 数据存储在名为 amazon-marketing-stream.sp-traffic 的表中。您的数据实现过程可能使用不同的数据库结构或命名约定,因此在尝试运行此查询之前,请确保更新 WHERE 子句。

SELECT *
FROM "amazon-marketing-stream"."sp-traffic"
WHERE keyword_id = '12345678'and time_window_start = '2022-02-01T10:00:00-08:00'
ORDER BY day, hour DESC;

输出示例

以下代码段显示了查询可能返回的表格数据。根据此查询,您可以了解广告位(列 I),即在所选时间窗口内展示相关产品广告的位置。在这个示例中,我们已经筛选并显示“亚马逊上的商品详情页 (Detail Page on-Amazon)”。 如果您查看指标字段(列 N - P),您可以看到增量数据,即随着流量验证和修正,数据的变化情况。

示例输出的片段视图如下

要获取更多示例并进一步了解,请参阅Amazon Marketing Stream 数据指南

AWS 研讨会

本研讨会提供了使用 Amazon Marketing Stream 和 AWS 技术构建的无服务器数据分析和托管机器学习平台的示例。开发人员、数据分析师和架构师可以利用研讨会实际了解如何实施 Stream 来帮助拓展您的业务。

观看研讨会:

下一步: Amazon Marketing Stream 入门指南