Typy reklam

Google Ads obsługuje różne typy reklam, np. tekstowe, graficzne i mobilne. Z tego przewodnika dowiesz się, jak tworzyć, pobierać i raportować reklamy za pomocą skryptów Google Ads. Omówienie 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 przypadku instancji AdGroup. Zwraca to obiekt AdBuilderSpace, który tworzy kreatory dla obsługiwanych typów reklam.

Poniższy 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, np. opisu rozszerzonej reklamy tekstowej, użyj metody asType(), aby utworzyć AdViewSpace. Zapewnia to dostęp do rozszerzonej wersji interfejsu Ad, która udostępnia metody specyficzne dla typu.

Ten fragment kodu pobiera 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 zatrzyma działanie skryptu. Dlatego ważne jest, aby wyświetlać pola specyficzne dla danego typu tylko wtedy, gdy typ reklamy jest znany.

Poniższy fragment kodu pokazuje, jak sprawdzić, czy reklama jest odpowiedniego typu, za pomocą metody Ad.isType():

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

Raportowanie

Widok ad_group_ad może też służyć do wysyłania zapytań o pola reklam specyficzne dla danego typu, oprócz zwykłych statystyk, takich jak ad_group_ad.expanded_text_ad.headline_part1. Poniższy fragment kodu pokazuje, jak pobrać statystyki wszystkich rozszerzonych reklam tekstowych, które w nagłówku 1 zawierają tekst „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.