Typy reklam

Google Ads obsługuje różne typy reklam, np. tekstowe, graficzne i mobilne. Z tego przewodnika dowiesz się, jak tworzyć i pobierać reklamy oraz generować raporty na ich temat za pomocą skryptów Google Ads. Listę wszystkich typów reklam obsługiwanych przez Google Ads znajdziesz w przewodniku po interfejsie API.

na podstawie trendów

Skrypty mogą tworzyć reklamy za pomocą metody newAd() w instancjach AdGroup. Zwraca on kod AdBuilderSpace, który tworzy konstruktora dla obsługiwanych typów reklam.

Ten fragment kodu pokazuje, jak utworzyć rozszerzoną reklamę tekstową:

let 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();

Inspekcja

Niektóre informacje powiązane ze wszystkimi typami reklam są od razu dostępne w Ad, np. identyfikator reklamy i stan zatwierdzenia. Każdą reklamę można też wstrzymać, włączyć lub usunąć.

Aby uzyskać dostęp do pól specyficznych dla danego typu reklamy, takich jak opis rozszerzonej reklamy tekstowej, utwórz AdViewSpace za pomocą metody asType(). Daje to dostęp do rozszerzonej wersji Ad, która udostępnia metody związane z konkretnymi typami.

Ten fragment kodu zawiera opis każdej rozszerzonej reklamy tekstowej:

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

Zwróć uwagę, że warunek Type = EXPANDED_TEXT_AD zapewnia, że każda reklama z iteratora jest rozszerzoną reklamą tekstową. Próba wyświetlenia reklamy o nieprawidłowym typie spowoduje błąd, który wstrzyma wykonanie skryptu, dlatego ważne jest, by wyświetlać pola związane z konkretnym typem reklamy tylko wtedy, gdy typ reklamy jest znany.

Ten fragment kodu pokazuje, jak za pomocą metody Ad.isType() ustalić, czy reklama jest właściwego typu:

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

Raportowanie

Widoku ad_group_ad można też używać do wysyłania zapytań dotyczących pól reklam określonego typu oprócz standardowych statystyk, np. do ad_group_ad.expanded_text_ad.headline_part1. Ten fragment kodu pokazuje, jak pobierać statystyki wszystkich rozszerzonych reklam tekstowych, które zawierają w nagłówku 1 hasło „wyprzedaż z rabatem”:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
         "ad_group_ad.id, " +
         "ad_group_ad.expanded_text_ad.headline_part1, " +
         "ad_group_ad.expanded_text_ad.headline_part2, " +
         "metrics.clicks, " +
         "metrics.impressions, " +
         "metrics.cost" +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.expanded_text_ad.headline_part1 = 'Discount Sales' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let headlinePart1 = row.adGroupAd.expandedTextAd.headlinePart1;
  let headlinePart2 = row.adGroupAd.expandedTextAd.headlinePart2;
  ...
}

Więcej informacji o raportowaniu w skryptach znajdziesz w przewodniku po raportach.