标签

标签可让您对广告系列、广告组、广告和关键字进行分类,并使用这些类别通过各种方式简化工作流程。

本指南介绍了执行以下操作所需的步骤:

  • 创建标签。
  • 将标签分配给广告系列。
  • 使用 CampaignService get()query() 请求,按标签提取和过滤报告结果。

本指南主要关注广告系列,但您也可以对广告组、广告和关键字使用同样的方法。

应用情形

下面列出了一些典型的标签应用情形:

  • 您帐号的某些广告系列只在一年中的特定时间段启用,您希望轻松地在报告中加入或排除这些广告系列。
  • 您向广告组中添加了一组新关键字,希望将其统计信息与广告组中的其他关键字进行比较。
  • 您 AdWords 帐号的用户各自管理一部分广告系列,您需要一种简单的方法来为每个用户确定相应的一组广告系列。
  • 您的应用需要将某些对象的状态标记为已处理、已审核、已突出显示等。

有关其他信息以及标签在 AdWords 中的工作方式的示例,请参阅帮助中心有关标签运用的文章

创建标签

您可以使用 TextLabel 对象创建标签。要创建 TextLabel,请按以下步骤操作:

  1. 创建 TextLabel 对象。
  2. 设置其名称。
  3. TextLabel 封装在 LabelOperation 中,并将其发送到 LabelService.mutate()

您会在后续步骤中用到新标签的 ID,因此请务必从 mutate 调用的响应中捕获它们,或使用 LabelService.get()LabelService.query() 提取 ID。

为广告系列、广告组、条件或广告分配标签

使用 mutateLabels 操作分配标签。例如,要为广告系列分配标签,请使用带有一个或多个 CampaignLabel 对象的 CampaignService.mutateLabels,每个对象都包含以下内容:

  • labelId - 标签的 ID
  • campaignId - 广告系列的 ID

为要添加的每个标签/广告系列对创建一个 CampaignLabel 对象,使用 ADD 运算符将其封装在 CampaignLabelOperation 中,然后发送到 CampaignService.mutateLabels

使用标签提取对象

您已经为广告系列分配了标签,接下来就可以使用标签字段来提取具有一个或多个特定标签的对象。例如,以下是一个 CampaignService.query AWQL 语句,它将选择与三个标签 ID 中任一个相关联的每个广告系列的 ID、名称和标签。

SELECT Id, Name, Labels
WHERE Labels CONTAINS_ANY [123456, 789012, 345678]

在使用标签设定过滤条件时,请注意以下几点提示:

  1. 请确保按标签 ID 而不是标签名称过滤。
  2. 只支持运算符 CONTAINS_ALLCONTAINS_ANYCONTAINS_NONE

在报告中使用标签字段

以下每个报告都有 LabelsLabelIds 字段:

与其他类型为 List 的字段一样,您可以使用 CONTAINS_ANYCONTAINS_ALLCONTAINS_NONELabelIds 过滤报告结果。

报告服务在 LabelsLabelIds 字段中返回一个以分号分隔的标签名称和 ID 的列表,例如:

CAMPAIGN_PERFORMANCE_REPORT (Jul 1, 2014-Jul 7, 2014)
Campaign ID,Labels,Label IDs
1999999,Label 1; Label 2,456; 678
2999999,Label 2;678
Total, --, --

代码示例

每个客户端库Campaign Management 文件夹中都包含用于向广告系列添加标签和按标签提取广告系列的代码示例:

发送以下问题的反馈:

此网页
AdWords API
AdWords API
需要帮助?请访问我们的支持页面