広告の種類

AdWords では、テキスト広告、画像広告、モバイル広告などのさまざまな種類の広告を使用できます。ここでは、AdWords スクリプトを使用して広告の作成や取得を行う方法と、広告のレポートを作成する方法について説明します。AdWords で使用できるすべての広告の種類の概要については、API ガイドをご覧ください。

作成

AdWords スクリプトでは、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();

検査

すべての広告の種類に関連付けられる情報の一部(広告の ID や承認状況など)は、広告から直接取得できます。さらに広告の一時停止、有効化、削除を行うことができます。

広告の種類固有のフィールド(拡張テキスト広告の説明など)にアクセスするには、asType() メソッドを使用して AdViewSpace を作成します。この操作によって広告の拡張版にアクセス可能になるため、広告の種類固有のメソッドを参照できます。

次のコードで、すべての拡張テキスト広告の説明を表示できます。

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"];
  ...
}

スクリプトを使ったレポート作成については、こちらのガイドをお読みください。

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。