如果您需要执行以下操作,结构化数据文件 (SDF) 会很有帮助:
- 快速创建多个广告系列、广告订单或订单项
- 同时批量修改多个广告系列、广告订单或订单项
本文将简要介绍如何使用 Display & Video 360 的结构化数据文件 (SDF) 执行一些最常见的任务。欢迎您详细了解不同的结构化数据文件版本及其功能。
如要修改或创建 SDF,建议采用 CSV 格式。
请避免使用 Excel、Python、TextEditor 或其他工具修改或创建 SDF。
使用其他格式或工具可能会损坏您的定位设置、以意想不到的方式更改您的定位设置,或导致您无法成功上传文件。详细了解如何下载、修改和上传 SDF。
创建新的广告系列、广告订单和订单项
SDF 既可用于直接创建新的广告订单和订单项,也可用于向现有广告订单添加订单项。
-
首先,查看 SDF 规范。
-
在 Display & Video 360 中,前往广告客户的广告订单页面,然后依次点击更多选项 上传,即可(针对广告订单、订单项、YouTube 广告组和 YouTube 广告)上传 SDF 文件。
使用临时标识符关联文件
如果您要在一个新广告订单中同时创建多个新订单项(或者在一个新 YouTube 广告组中同时创建多个新 YouTube 广告),请务必上传带有临时自定义标识符(临时 ID)的 SDF 文件,以便将您的各个文件关联起来。
临时 ID 的格式为“
ext[自定义标识符]
”(例如,ext123
)。系统会自动将临时 ID 填入 Io Id 字段(用于将订单项关联到广告订单)和 Ad Group Id 字段(用于将 YouTube 广告关联到 YouTube 广告组)。待您的文件上传并处理完毕后,系统会将所有临时 ID 替换为由 Display & Video 360 生成的唯一 ID,并且所有内容都会根据您的临时标识符保持适当的关联。
请务必同时上传所有相互关联的文件。
注意:如果您使用的 SDF 版本低于 5.3,那么在返回的文件中,与成功上传的内容对应的临时标识符将不会被替换。请先使用新生成的 ID 替换
SDF-{EntityName}-Failed-ResultFile.csv
文件和SDF-{EntityName}-Unprocessed-ResultFile.csv
文件中的临时标识符,然后再重新上传实体。 -
选择您的 CSV 文件,然后点击上传。
-
Display & Video 360 会验证您的各个文件并显示每个文件的状态。(您还会收到一封电子邮件,要么会确认广告订单、订单项、YouTube 广告和 YouTube 广告组已成功创建完毕,要么会将制作您的广告系列时遇到的所有错误告知您。)
-
已应用更新:已成功应用了您对 SDF 做出的所有更新。若要确认相关更新,请先点击下载文件以下载
SDF-ResultFile.zip
文件,接着将该文件解压缩以找到SDF-{EntityName}-Updated-ResultFile.csv
文件,然后在这个文件中确认相关更新。 -
只成功上传了部分内容:仅成功应用了您对一个或多个文件做出的部分更新。若要查明错误,请先点击下载文件以下载
SDF-ResultFile.zip
文件,接着将该文件解压缩以找到SDF-{EntityName}-Updated-ResultFile.csv
和SDF-{EntityName}-Failed-ResultFile.csv
文件,然后打开SDF-{EntityName}-Failed-ResultFile.csv
文件以查明并纠正错误。完成后,重新上传文件。 -
失败:未能成功应用您对 SDF 做出的更新。若要查明错误,请先点击下载文件以下载
SDF-ResultFile.zip
文件,接着将该文件解压缩以找到SDF-{EntityName}-Failed-ResultFile.csv
文件,然后打开这个文件以查明并纠正错误。完成后,重新上传文件。
-
-
执行完所有操作后,点击关闭敲定更改。
向现有广告订单添加新订单项
-
在 Display & Video 360 中,确保待添加订单项的广告订单(一个或多个)已创建完毕。
如果您能够自行创建格式正确的结构化数据文件,则可直接跳至第 4 步(见下文)。 -
找到相应广告客户名下的订单项列表,然后依次点击操作和下载 SDF。
-
在随即打开的窗口中,选择您想创建什么类型的内容(订单项、YouTube 广告组和/或 YouTube 广告),然后点击下载按钮以下载相应的 SDF。
您也可以使用这些 SDF 同时修改多项现有内容。 -
将您要创建的订单项的所有详细信息填入到 SDF 中(点击此处可查看 SDF 规范)。
-
在 Display & Video 360 中,依次点击操作和上传,从相应广告客户的广告订单页面中上传 SDF。
-
选择您的 CSV 文件,然后点击上传。
-
Display & Video 360 会验证您的各个文件并显示每个文件的状态。(您还会收到一封电子邮件,该邮件要么会确认您的内容已成功创建完毕,要么会将系统遇到的所有错误告知您)
-
已应用更新:已成功应用了您对 SDF 做出的所有更新。若要确认相关更新,请先点击下载文件以下载
SDF-ResultFile.zip
文件,接着将该文件解压缩以找到SDF-{EntityName}-Updated-ResultFile.csv
文件,然后在这个文件中确认相关更新。 -
只成功上传了部分内容:仅成功应用了您对一个或多个文件做出的部分更新。若要查明错误,请先点击下载文件以下载
SDF-ResultFile.zip
文件,接着将该文件解压缩以找到SDF-{EntityName}-Updated-ResultFile.csv
和SDF-{EntityName}-Failed-ResultFile.csv
文件,然后打开SDF-{EntityName}-Failed-ResultFile.csv
文件以查明并纠正错误。完成后,重新上传文件。 -
失败:未能成功应用您对 SDF 做出的更新。若要查明错误,请先点击下载文件以下载
SDF-ResultFile.zip
文件,接着将该文件解压缩以找到SDF-{EntityName}-Failed-ResultFile.csv
文件,然后打开这个文件以查明并纠正错误。完成后,重新上传文件。
-
-
执行完所有操作后,点击关闭敲定更改。
修改现有的广告系列、广告订单和订单项
Display & Video 360 API 助您节省时间
您可通过两种方式下载广告订单和订单项:一是使用 Display & Video 360 API 下载;二是从 Display & Video 360 界面下载。若想了解如何使用 Display & Video 360 API,请参阅 SDF Create Task API 规范。
如果您熟知如何使用 Display & Video 360 API 下载现有的订单项,则可跳至第 3 步(见下文)。
-
在 Display & Video 360 中,找到相应广告客户名下的广告订单列表/订单项列表或单个广告订单中的订单项列表。
-
选择下列某一选项,了解如何下载您的现有订单项:
下载一个或多个广告订单中的所有订单项- 首先,前往下列任一位置:
- 广告客户 > 广告订单
- 广告客户 > 订单项
- 广告客户 > 广告订单 > 订单项
- 在右侧依次点击更多选项图标 > 下载,然后按照相应步骤将您的订单项下载到 SDF 中。
- (可选)您也可点击“保存到 Google 表格”,从而将您的订单项导出到 Google 表格中。
-
首先,找到相应广告客户名下的订单项列表(或单个广告订单中的订单项列表),然后选中您想修改的订单项旁边的复选框。
-
点击订单项列表顶部菜单栏中的操作 > 下载。系统即会将您的订单项下载到 SDF 中。
-
(可选)您也可点击“保存到 Google 表格”,从而将您的订单项导出到 Google 表格中。
- 首先,前往下列任一位置:
-
在下载的 SDF 中,更改您的订单项,然后保存该文件。请务必将该 SDF 保存为 CSV 文件。请注意,如要使用 Excel 进行更改,请勿修改 SDF 中的任何时间戳,因为时间戳可能会因修改而受损,进而造成 Display & Video 360 无法导入文件。
-
在 Display & Video 360 中,前往广告客户的广告订单页面,依次点击操作和上传电子表格,从而上传 SDF。
-
选择您的 CSV 文件,然后点击上传。
-
Display & Video 360 会验证您的各个文件并显示每个文件的状态。您还会收到一封电子邮件,其中会显示每个文件的详细信息。(这封电子邮件要么会确认订单项已成功创建完毕,要么会将系统在创建您的订单项时遇到的所有错误告知您)
-
已应用更新:已成功应用了您对 SDF 做出的所有更新。若要确认相关更新,请先点击下载文件以下载
SDF-ResultFile.zip
文件,接着将该文件解压缩以找到SDF-{EntityName}-Updated-ResultFile.csv
文件,然后在这个文件中确认相关更新。 -
只成功上传了部分内容:仅成功应用了您对一个或多个文件做出的部分更新。若要查明错误,请先点击下载文件以下载
SDF-ResultFile.zip
文件,接着将该文件解压缩以找到SDF-{EntityName}-Updated-ResultFile.csv
和SDF-{EntityName}-Failed-ResultFile.csv
文件,然后打开SDF-{EntityName}-Failed-ResultFile.csv
文件以查明并纠正错误。完成后,重新上传文件。 -
失败:未能成功应用您对 SDF 做出的更新。若要查明错误,请先点击下载文件以下载
SDF-ResultFile.zip
文件,接着将该文件解压缩以找到SDF-{EntityName}-Failed-ResultFile.csv
文件,然后打开这个文件以查明并纠正错误。完成后,重新上传文件。
-
-
执行完所有操作后,点击关闭敲定更改。
下载广告资源来源
-
找到“我的广告资源”页面中的广告资源来源列表。
-
根据需要选择以下选项之一,以了解如何以 SDF 的形式下载广告资源来源:
所有广告资源来源- 依次点击更多选项 > 下载 SDF。整个广告资源来源列表即会下载到一个 SDF 中。
-
选中您要下载的广告资源来源旁边的复选框。
-
在广告资源来源列表顶部的蓝色栏中点击下载 SDF。您所选的广告资源来源将会下载到一个 SDF 中。
创建、修改和上传广告资源来源
详细了解 SDF 中不同的行,包括何时可以使用哪些字段、不同类型,以及在上传时可否写入值。
-
将广告资源来源下载为 SDF 后,在您自选的应用中打开该 CSV 文件以进行更改。如果您要使用 Excel 进行更改,请确保您没有修改 SDF 中的任何时间戳,因为时间戳可能会因被修改而受损,进而致使文件无法导入 Display & Video 360 中。
-
从以下选项中选择所需的操作,以了解如何创建和修改广告资源来源:
修改现有广告资源来源- 找到您要修改的广告资源来源对应的行,然后根据需要更改相应的广告资源来源字段。
注意:预订型交易只能在交易结束日期过后归档。暂停现有广告资源来源(仅限预订型交易)- 找到您要归档的广告资源来源对应的行。
- 对于“Status”(状态)字段,请输入 Archived(已归档)。
- 找到您要暂停的广告资源来源对应的行。
- 对于“Status”(状态)字段,请输入 Paused(已暂停)。
- 对于“Pause Reason”(暂停原因)字段,请输入暂停此广告资源来源的原因。
- 找到要解除暂停状态的广告资源来源对应的行。
- 对于“Status”(状态)字段,请输入 Active(有效)。
- (可选)对于“Pause Reason”(暂停原因)字段,请删除您在为此广告资源来源解除暂停状态之前暂停它的原因。
- 为每个新广告资源来源分别创建一个新行。
- 为每个新广告资源来源填写以下字段:
- Exchange(广告交易平台)(注意:一经保存,便无法更改)
- Deal ID(交易 ID)(注意:一经保存,便无法更改)
- Name(名称)
- Deal Type(交易类型)
- (可选)Seller Name(卖方名称)
- Floor CPM(CPM 底价,格式如下:$X.XX)
- Currency Code(币种代码)
- Start Date(开始日期)
- End Date(结束日期)
- 已获权限的广告客户
-
完成后,保存您的 CSV 文件。
-
返回到 Display & Video 360 中的“我的广告资源”页面(您先前下载广告资源来源的页面),依次点击更多选项 > 上传 SDF。选择您的 CSV 文件,然后点击上传。(请务必将此 SDF 上传到它所下载自的合作伙伴)
-
Display & Video 360 会验证您的文件并显示每个文件的状态:
-
已应用更新:已成功应用了您对 SDF 做出的所有更新。若要确认相关更新,请先点击下载文件以下载
SDF-ResultFile.zip
文件,接着将该文件解压缩以找到SDF-{EntityName}-Updated-ResultFile.csv
文件,然后在这个文件中确认相关更新。 -
只成功上传了部分内容:仅成功应用了您对一个或多个文件做出的部分更新。若要查明错误,请先点击下载文件以下载
SDF-ResultFile.zip
文件,接着将该文件解压缩以找到SDF-{EntityName}-Updated-ResultFile.csv
和SDF-{EntityName}-Failed-ResultFile.csv
文件,然后打开SDF-{EntityName}-Failed-ResultFile.csv
文件以查明并纠正错误。完成后,重新上传文件。 -
失败:未能成功应用您对 SDF 做出的更新。若要查明错误,请先点击下载文件以下载
SDF-ResultFile.zip
文件,接着将该文件解压缩以找到SDF-{EntityName}-Failed-ResultFile.csv
文件,然后打开这个文件以查明并纠正错误。完成后,重新上传文件。
-
-
执行完所有操作后,点击关闭敲定更改。
下载元数据
- 前往广告客户 > 广告系列 > 更多选项 > 下载元数据,以下载一个包含 SDF 所用各种实体的名称-ID 映射关系的文件。
- 元数据文件可能非常大,具体取决于您的广告客户设置。
- 您可点击页面顶部的批量操作状态图标 来跟踪元数据文件的下载进度。了解详情
限制
SDF 不支持以下功能:
- 定位到已安装的应用类别
- 采用地理围栏的商家定位
- 为合作伙伴的精选订单项采用 GRP 购买方式
- 移动应用安装订单项
我们建议您定期将 Display & Video 360 中的广告系列设置与 developers.google.com 上的可用 SDF 字段进行比较。
常见问题解答
Display & Video 360 能否在处理完我的 SDF 后向其他人员发送电子邮件?能。所有 SDF 电子邮件也可发送至管理员电子邮件地址。如果您想让某个团队分发列表中的所有成员看到 SDF 处理电子邮件,或想使用某个系统来解析这些电子邮件,该操作可能会非常有用。“管理员”电子邮件地址可在相应合作伙伴或广告客户的“基本详情”的“结构化数据文件”部分中进行设置。
能。若要下载和上传涵盖同一合作伙伴名下多个广告客户的数据文件,请找到此合作伙伴的广告客户列表,选择相应广告客户,然后从操作菜单中下载 SDF。待修改完 SDF 后,请返回到广告客户列表页面以上传文件。
能。您可在合作伙伴一级和广告客户一级更改 SDF 版本。
- 合作伙伴一级:您可在合作伙伴一级更改 SDF 版本,只需前往[合作伙伴名称] > 设置 > 基本详情执行所需操作即可。在该页面的“结构化数据文件”部分中,点击下拉菜单即可选择 SDF 版本。
- 广告客户一级:您可在广告客户一级更改 SDF 版本,只需前往[广告客户名称] > 设置 > 基本详情执行所需操作即可。在该页面的“结构化数据文件”部分中,点击下拉菜单即可选择 SDF 版本。此外,您还可选择覆盖合作伙伴一级的设置。
我们建议您尽可能使用最新版本的 SDF。
您可通过两种方法下载订单项:一是通过 Display & Video 360 API 下载;二是在 Display & Video 360 内手动下载。
1. 使用 API:若要使用 API 下载 SDF,请参阅 developers.google.com 中的结构化数据部分。
2. 使用界面:若要从 Display & Video 360 界面手动下载订单项,请前往 Display & Video 360 中的下列位置之一:
- 广告客户 > 广告订单 > 操作 > 下载
- 广告客户 > 订单项 > 操作 > 下载
- 广告客户 > 广告订单 > 订单项 > 下载
请参阅上文中的创建新的广告订单和订单项或修改现有的广告订单和订单项部分。
能。Display & Video 360 会按照上传顺序将 SDF 文件排入队列并加以处理。请确保您熟知如何使用临时标识符关联文件。
但为了避免出错,如有多个文件包含相同的订单项,请不要同时上传这些文件。
下载包含您想复制的订单项的 SDF,然后从 SDF 中移除这些订单项的 Line Item Id
。不含 Line Item Id
的 SDF 行会指示 Display & Video 360 创建新的订单项。然后,将这些订单项的名称更改为新名称。
如果您想跨广告订单复制订单项,请务必更新 Io Id
字段。
实体读取文件是指 Google Cloud Storage 中包含 Display & Video 360 实体(如地理位置、广告素材、受众群体名单等)的查询值的平面文件。这些查询值可用于按 ID 向订单项分配广告素材和定位条件。
能。不过,有些定位设置是相应广告客户的专有设置,例如渠道、受众群体名单以及广告客户专用的广告资源来源(例如交易)。
因此,如果您从“广告客户 A”下载了订单项的 SDF,然后想将相应订单项上传到“广告客户 B”,请务必先从 SDF 中移除任何渠道或第一方受众群体名单,因为它们无法与其他广告客户搭配使用。
请参阅 developers.google.com 上的 Display & Video 360 结构化数据文件,了解有关受支持的定位选项的信息。