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

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

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

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

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

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

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