סוגי מודעות

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

יצירה

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

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

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

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