Google Ads obsługuje różne typy reklam, takich jak reklamy tekstowe, graficzne i mobilne. Z tego przewodnika dowiesz się, jak tworzyć reklamy, pobierać je i tworzyć na ich temat raporty 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 instancjach AdGroup
. Zwraca to obiekt AdBuilderSpace
, który tworzy kreatorów 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 związane ze wszystkimi typami reklam są dostępne od razu na stronie Ad
, np. identyfikator reklamy i jej stan. Dodatkowo każdą reklamę możesz wstrzymać, włączyć lub usunąć.
Aby uzyskać dostęp do pól związanych z danym typem reklamy, np. do opisu rozszerzonej reklamy tekstowej, użyj metody asType()
, aby utworzyć obiekt AdViewSpace
.
Daje to dostęp do rozszerzonej wersji interfejsu Ad
, który udostępnia metody zależne od 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 wykonywanie skryptu. Dlatego ważne jest, aby wyświetlać pola związane z typem tylko wtedy, gdy wiesz, jaki jest typ reklamy.
Ten fragment kodu pokazuje, jak za pomocą metody Ad.isType()
sprawdzić, czy reklama ma odpowiedni typ:
if (ad.isType().expandedTextAd()) {
let expandedTextAd = ad.asType().expandedTextAd();
let headlinePart1 = expandedTextAd.getHeadlinePart1();
let headlinePart2 = expandedTextAd.getHeadlinePart2();
}
Raportowanie
Widok ad_group_ad
możesz też używać do wyszukiwania pól reklamy związanych z danym typem reklamy oprócz zwykłych statystyk, takich jak ad_group_ad.expanded_text_ad.headline_part1
.
Z tego fragmentu kodu dowiesz się, jak pobrać statystyki dotyczące wszystkich rozszerzonych reklam tekstowych, które w nagłówku 1 zawierają ciąg znaków „Wyprzedaż”.
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.