סוגי מודעות

מערכת 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() method:

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. קטע הקוד הבא מראה איך לאחזר את הנתונים הסטטיסטיים של כל מודעות הטקסט המורחבות מכילים את הערך 'Discount Sales'. בכותרת 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;
  ...
}

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