סוגי מודעות

מערכת Google Ads תומכת במגוון סוגי מודעות, כמו מודעות טקסט, מודעות תמונה ומודעות לנייד. במדריך הזה נסביר איך ליצור מודעות, לאחזר אותן ולדווח עליהן באמצעות סקריפטים של Google Ads. במדריך ל-API תוכלו למצוא סקירה כללית על כל סוגי המודעות שנתמכים ב-Google Ads.

יצירה

סקריפטים יכולים ליצור מודעות באמצעות השיטה newAd() במכונות AdGroup. הפעולה הזו מחזירה את הערך AdBuilderSpace שיוצר builders לסוגי מודעות נתמכים.

קטע הקוד הבא מדגים איך יוצרים מודעת טקסט מורחבת:

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

בדיקה

חלק מהמידע שמשויך לכל סוגי המודעות זמין מיד מ-Ad, כמו מזהה המודעה וסטטוס האישור של המודעה. בנוסף, ניתן להשהות, להפעיל או להסיר כל מודעה.

על מנת לגשת לשדות ספציפיים לסוג המודעה, כמו תיאור של מודעת טקסט מורחבת, משתמשים ב-method asType() כדי ליצור AdViewSpace. כך מקבלים גישה לגרסה מורחבת של Ad שחושפת שיטות ספציפיות לסוג.

קטע הקוד הבא מקבל את התיאור של כל מודעת טקסט מורחבת:

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

שימו לב שהתנאי Type = EXPANDED_TEXT_AD מבטיח שכל מודעה מהאיטרטור תהיה מודעת טקסט מורחבת. ניסיון להציג מודעה מסוג שגוי יגרום לשגיאה שתעצור את הפעלת הסקריפט, לכן חשוב להציג שדות ספציפיים לסוג רק אם סוג המודעה ידוע.

קטע הקוד הבא מראה איך לקבוע אם מודעה היא מהסוג הנכון באמצעות השיטה Ad.isType():

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

דיווח

אפשר להשתמש בתצוגה המפורטת ad_group_ad גם כדי להריץ שאילתות על שדות מודעה ספציפיים לסוג מסוים, בנוסף לנתונים סטטיסטיים רגילים, כמו ad_group_ad.expanded_text_ad.headline_part1. קטע הקוד הבא מראה כיצד לאחזר את הנתונים הסטטיסטיים של כל מודעות הטקסט המורחבות שמכילות את הטקסט "הנחות בהנחה" בכותרת 1:

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

למידע נוסף על דיווח בסקריפטים, קראו את המדריך בנושא דוחות.