סקריפטים של 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 In-stream
- TrueView Video Discovery
- מודעות באמפר
אפשר לבחור את הקמפיינים האלה באמצעות withCondition:
const campaignIterator = AdsApp.videoCampaigns()
.withCondition("AdvertisingChannelSubType = null")
.get();
מודעות וידאו In-stream יכולות להופיע לפני, במהלך או אחרי סרטונים אחרים, והמשתמשים יכולים לדלג עליהן אחרי פרק זמן מסוים. מודעות Discovery של וידאו מופיעות ברשת המדיה ובדפים שונים ב-YouTube, והן מופעלות רק אם המשתמש לוחץ באופן פעיל על התמונה הממוזערת של המודעה. מודעות באמפר הן מודעות באורך של 6 שניות או פחות, והן יכולות להופיע בסרטונים ב-YouTube או בסרטונים באפליקציות ובאתרים של שותפים ברשת המדיה. פרטים מלאים על כל אחד מסוגי המודעות האלה זמינים במאמר מידע על פורמטים של מודעות וידאו.
יצירת קבוצת המודעות
כדי ליצור קבוצת מודעות וידאו, משתמשים ב-method newVideoAdGroupBuilder() של קמפיין וידאו. כשיוצרים קבוצת מודעות, צריך לציין את הסוג והשם שלה. סוג קבוצת המודעות חייב להיות אחד מהסוגים הבאים, ואי אפשר לשנות אותו אחרי שיוצרים את קבוצת המודעות:
VIDEO_BUMPERVIDEO_EFFICIENT_REACHVIDEO_NON_SKIPPABLE_IN_STREAM(רק לקמפיינים מסוגVIDEO_NON_SKIPPABLE)VIDEO_RESPONSIVE(רק לקמפיינים מסוגVIDEO_ACTION)VIDEO_TRUE_VIEW_IN_DISPLAYVIDEO_TRUE_VIEW_IN_STREAMYOUTUBE_AUDIO
דוגמה:
const videoAdGroup =
videoCampaign.newVideoAdGroupBuilder()
.withAdGroupType("VIDEO_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()):
inStreamAdBuilder()videoDiscoveryAdBuilder()bumperAdBuilder()responsiveVideoAdBuilder()(בקמפיינים מסוגVIDEO_ACTIONבלבד)nonSkippableAdBuilder()(בקמפיינים מסוגVIDEO_NON_SKIPPABLEבלבד)
לדוגמה:
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();
}