סוגי מודעות

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

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

יצירה

סקריפטים יכולים ליצור מודעות באמצעות השיטה 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, למשל מזהה המודעה וסטטוס האישור שלה. בנוסף, אפשר להשהות, להפעיל או להסיר כל מודעה.

כדי לגשת לשדות שספציפיים לסוג המודעה, כמו תיאור של מודעת טקסט מורחבת, משתמשים בשיטה 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;
  ...
}

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