קמפיינים בווידאו

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

אחזור של קמפיינים וקבוצות של מודעות וידאו

קמפיינים של מודעות וידאו זמינים דרך האוסף videoCampaigns של אובייקט AdsApp. אפשר לאחזר אותם כמו שמאחזרים קמפיינים בדרך כלל בסקריפטים:

const campaignName = "My first video campaign";

const campaignIterator = AdsApp.videoCampaigns()
    .withCondition(`campaign.name = "${campaignName}"`)
    .get();

for (const campaign of campaignIterator) {
  ...
}

אחרי שאתם מאחזרים קמפיין, אתם יכולים לקבל את קבוצות המודעות שלו באופן דומה:

const adGroupIterator = campaign.videoAdGroups()
    .withCondition(`ad_group.name = "${adGroupName}"`)
    .get();

for (const adGroup of adGroupIterator) {
  ...
}

לחלופין, אפשר להשתמש בשיטה AdsApp.videoAdGroups():

const adGroupIterator = AdsApp.videoAdGroups()
    .withCondition(`campaign.name = "${campaignName}" AND ad_group.name = "${adGroupName}")
    .get();

for (const adGroup of adGroupIterator) {
  ...
}

יצירת מודעות וידאו

סקריפטים של Google Ads מאפשרים לאחזר את מודעות הווידאו באמצעות השיטה videoAds() של VideoAdGroup. אפשר ליצור מודעות וידאו חדשות באמצעות השיטה newVideoAd() של VideoAdGroup.

פורמטים של מודעות וידאו

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

בקמפיינים מסוימים של מודעות וידאו יש תת-סוגים שמגבילים את סוגי המודעות שנתמכים בקמפיין. באופן ספציפי, קמפיינים מסוג VIDEO_ACTION תומכים רק בסוג המודעה VIDEO_RESPONSIVE, וקמפיינים מסוג VIDEO_NON_SKIPPABLE תומכים רק בסוג המודעה NON_SKIPPABLE_INSTREAM_VIDEO_AD.

הדרך הטובה ביותר לבצע פעולות בסוגים ספציפיים של קמפיינים היא להשתמש בפסקה withCondition בבורר. אפשר לעדכן את הערך של AdvertisingChannelSubType עבור סוג הקמפיין הרצוי:

const campaignIterator = AdsApp.videoCampaigns()
  .withCondition("AdvertisingChannelSubType = VIDEO_ACTION")
  .get();

קמפיינים של מודעות וידאו ללא סוג משנה תומכים בפורמטים הבאים של מודעות וידאו:

  • TrueView בתוך ההפעלה
  • TrueView Video Discovery
  • מודעות באמפר

אפשר לבחור את הקמפיינים האלה באמצעות withCondition:

const campaignIterator = AdsApp.videoCampaigns()
  .withCondition("AdvertisingChannelSubType = null")
  .get();

מודעות וידאו In-Stream יכולות להופיע לפני סרטונים אחרים, במהלכם או אחריהם, ולמשתמשים יש אפשרות לדלג עליהן אחרי פרק זמן מסוים. מודעות Video Discovery מופיעות ברשת המדיה ובדפים שונים ב-YouTube, והן יופעלו רק אם המשתמש ילחץ באופן פעיל על התמונה הממוזערת של המודעה. מודעות באמפר הן באורך 6 שניות או פחות, והן יכולות להופיע בסרטונים ב-YouTube או בסרטונים שמוצגים באתרים ובאפליקציות של שותפים ברשת המדיה. פרטים מלאים על כל אחד מסוגי המודעות האלה זמינים במאמר מידע על פורמטים של מודעות וידאו.

יצירה של קבוצת המודעות

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

  • TRUE_VIEW_IN_STREAM
  • TRUE_VIEW_IN_DISPLAY
  • BUMPER
  • VIDEO_RESPONSIVE (רק בקמפיינים מסוג VIDEO_ACTION)
  • NON_SKIPPABLE_INSTREAM_VIDEO_AD (רק בקמפיינים מסוג VIDEO_NON_SKIPPABLE)

דוגמה:

const videoAdGroup =
    videoCampaign.newVideoAdGroupBuilder()
    .withAdGroupType("TRUE_VIEW_IN_STREAM")
    .withName("Video Ad Group")
    .build()
    .getResult();

יצירת נכס הווידאו

בדרך כלל, מודעות וידאו צריכות להפנות לנכס וידאו. הפעולה הזו קובעת איזה סרטון יוצג במודעה. אי אפשר להעלות סרטון באמצעות סקריפטים, אבל אפשר לקשר סרטון קיים ב-YouTube שהעליתם בעבר כדי להשתמש בו במודעות. כדי לעשות זאת, יוצרים Asset עם YouTubeVideoAssetBuilder.

const assetOperation = AdsApp.adAsset().newYouTubeVideoAssetBuilder()
   .withName("name")
   // This is the ID in the URL for the YouTube video.
   .withYouTubeVideoId(youTubeVideoId)
   .build();
const videoAsset = assetOperation.getResult();

יצירת המודעה

כדי ליצור מודעה חדשה, משתמשים בשיטת ה-builder שתואמת לסוג קבוצת המודעות (מחוברת אחרי newVideoAd()):

דוגמה:

const videoAd = videoAdGroup.newVideoAd()
    .inStreamAdBuilder()
    .withAdName("Video Ad")
    .withFinalUrl(
        "http://www.example.com/video-ad")
    // Specify the video asset created in the last step.
    .withVideo(video)
    .build()
    .getResult();

מיקוד וידאו

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

הסוג השני של טירגוט מאפשר לכם לציין קריטריונים לקמפיינים של מודעות וידאו ולקבוצות של מודעות וידאו בנפרד. אפשר לגשת אליו באמצעות השיטה videoTargeting() בקמפיין או בקבוצת המודעות, והוא מספק גישה לבוררים ולכלי היצירה של קריטריונים חיוביים ושליליים לכל הסוגים שרלוונטיים לרמת הטירגוט הזו. השיטה AdsApp.videoTargeting() קיימת גם כדי להציג קריטריונים ברמת החשבון, והיא כוללת קבוצה שונה של קריטריונים מ-AdsApp.videoCampaignTargeting(). בדומה ל-VideoCampaignTargeting, אי אפשר לנהל את הקריטריונים האלה באמצעות סקריפטים.

דוגמה להחרגת מיקום מודעה ספציפי בקמפיין:

videoCampaign.videoTargeting().newPlacementBuilder()
    .withUrl("http://www.example.com")
    .exclude();

הקריטריונים הדמוגרפיים (גיל, מגדר) פועלים בצורה שונה מעט מהקריטריונים האחרים. כשיוצרים קבוצת מודעות חדשה, המערכת יוצרת באופן אוטומטי קריטריונים לכל ערך אפשרי של גיל ומגדר, וקבוצת המודעות הזו מטרגטת את כולם. כדי להחריג קבוצה דמוגרפית, אפשר לאחזר את הטירגוט הקיים ולקרוא ל-method‏ exclude(). כדי לכלול מחדש קבוצה דמוגרפית שהוחרגה, אפשר למצוא את הטירגוט הקיים של ההחרגה ולקרוא ל-method‏ include().

דוגמה להחרגת מגדר ספציפי מקבוצת מודעות:

const videoGenderIterator = videoAdGroup.videoTargeting()
    .genders()
    .withCondition('GenderType = "GENDER_MALE"')
    .get();
if (videoGenderIterator.hasNext()) {
  const videoGender = videoGenderIterator.next();
  videoGender.exclude();
}