广告类型

AdWords 可支持多种广告类型,如文字、图片和移动广告。本指南介绍了如何使用 AdWords 脚本制作和检索广告,并生成报告。有关 AdWords 支持的所有广告类型的概述,请参阅 API 指南

制作

通过对 AdGroup 实例使用 newAd() 方法,脚本可以制作广告。这会返回为所支持广告类型创建构建器AdBuilderSpace

下面的代码段演示了如何制作加大型文字广告:

var adOperation = adGroup.newAd().expandedTextAdBuilder()
    .withHeadlinePart1("First headline part")
    .withHeadlinePart2("Second headline part")
    .withDescription("Ad description")
    .withFinalUrl("http://www.example.com")
    .withPath1("path1") // optional
    .withPath2("path2") // optional
    .build();

检验

可即刻从 Ad 获得广告的 ID 和审批状态等与所有广告类型相关联的一些信息。此外,任何广告都可被暂停、启用或移除。

要访问某广告类型所特有的字段,如加大型文字广告的广告内容描述,请使用 asType() 方法创建 AdViewSpace。这实现了对公开针对特定类型的方法的扩展版 Ad 的访问。

下面的代码段可查找每个加大型文字广告的广告内容描述:

var iterator = AdWordsApp.ads().withCondition("Type = EXPANDED_TEXT_AD").get();
while (iterator.hasNext()) {
  var ad = iterator.next();
  var expandedTextAd = ad.asType().expandedTextAd();
  var description = expandedTextAd.getDescription();
}

请注意,条件 Type = EXPANDED_TEXT_AD 确保迭代器的每一个广告都是加大型文字广告。试图查看类型不正确的广告将发生错误,导致脚本停止执行,因此,一定要确保只有当广告类型为已知时,才查看针对类型的字段。

下面的代码段显示了如何使用 Ad.isType() 方法判断广告类型是否正确:

if (ad.isType().expandedTextAd()) {
  var expandedTextAd = ad.asType().expandedTextAd();
  var headlinePart1 = expandedTextAd.getHeadlinePart1();
  var headlinePart2 = expandedTextAd.getHeadlinePart2();
}

报告

除了常规统计信息之外,此 AD_PERFORMANCE_REPORT 也可以用来查询针对特定类型的广告字段,如加大型文字广告字段。下面的代码段显示了如何检索在标题 1 中包含“Discount Sales”的所有加大型文字广告的统计信息:

var report = AdWordsApp.report(
    "SELECT AdGroupId, Id, HeadlinePart1, HeadlinePart2, Clicks, Impressions, Cost " +
    "FROM   AD_PERFORMANCE_REPORT " +
    "WHERE HeadlinePart1 CONTAINS 'Discount Sales' " +
    "DURING LAST_7_DAYS");

var rows = report.rows();
while (rows.hasNext()) {
  var row = rows.next();
  var headlinePart1 = row["HeadlinePart1"];
  var headlinePart2 = row["HeadlinePart2"];
  ...
}

有关在脚本中使用报告功能的详细信息,请参阅报告指南

发送以下问题的反馈:

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