สคริปต์ 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();
โฆษณาวิดีโอในสตรีมสามารถเล่นก่อน ระหว่าง หรือหลังจากวิดีโออื่นๆ ทำให้ผู้ใช้มีตัวเลือกที่จะข้ามหลังจากเวลาที่ระบุได้ โฆษณา 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();
สร้างโฆษณา
หากต้องการสร้างโฆษณาใหม่ ให้ใช้วิธีสร้างที่ตรงกับประเภทกลุ่มโฆษณา (เชื่อมโยงหลัง 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();
การกำหนดเป้าหมายวิดีโอ
การกำหนดเป้าหมายที่เกี่ยวข้องสำหรับแคมเปญวิดีโอมีอยู่ 2 ประเภท VideoCampaignTargeting
แสดงถึงการกำหนดเป้าหมายที่ทำในระดับบัญชีสำหรับแคมเปญวิดีโอทั่วไป และเข้าถึงได้โดยใช้ AdsApp.videoCampaignTargeting()
ซึ่งแก้ไขผ่านสคริปต์ไม่ได้ แต่ดูได้
การกำหนดเป้าหมายอีกประเภทหนึ่งช่วยให้คุณระบุเกณฑ์สำหรับแคมเปญวิดีโอและกลุ่มโฆษณาวิดีโอแยกกันได้ ซึ่งเข้าถึงได้ด้วยเมธอด videoTargeting()
ในแคมเปญหรือกลุ่มโฆษณา และให้สิทธิ์การเข้าถึงตัวเลือกและเครื่องมือสร้างสำหรับทั้งเกณฑ์เชิงบวกและเชิงลบสำหรับประเภททั้งหมดที่เกี่ยวข้องกับการกำหนดเป้าหมายระดับนั้น เมธอด AdsApp.videoTargeting()
มีไว้ดูเกณฑ์ที่ระดับบัญชี และรวมชุดเกณฑ์อื่นจาก AdsApp.videoCampaignTargeting()
ด้วย เช่นเดียวกับ VideoCampaignTargeting
คุณจะจัดการเกณฑ์เหล่านี้ด้วยสคริปต์ไม่ได้
ต่อไปนี้เป็นตัวอย่างสำหรับการยกเว้นตำแหน่งที่เฉพาะเจาะจงในแคมเปญ
videoCampaign.videoTargeting().newPlacementBuilder()
.withUrl("http://www.example.com")
.exclude();
เกณฑ์สำหรับข้อมูลประชากร (อายุ เพศ) ทำงานต่างจากเกณฑ์ประเภทอื่นๆ เล็กน้อย เมื่อมีการสร้างกลุ่มโฆษณาใหม่ ระบบจะสร้างเกณฑ์สำหรับค่าอายุและเพศที่เป็นไปได้แต่ละรายการโดยอัตโนมัติ และกลุ่มโฆษณานั้นจะกำหนดเป้าหมายไปยังรายการทั้งหมด คุณยกเว้นข้อมูลประชากรได้โดยการดึงข้อมูลการกำหนดเป้าหมายที่มีอยู่และเรียกใช้เมธอด exclude()
และรวมข้อมูลประชากรที่ยกเว้นอีกครั้งโดยการค้นหาการกำหนดเป้าหมายการยกเว้นและการเรียกใช้ที่มีอยู่
include()
ต่อไปนี้คือตัวอย่างของการยกเว้นเพศที่เฉพาะเจาะจงจากกลุ่มโฆษณา
const videoGenderIterator = videoAdGroup.videoTargeting()
.genders()
.withCondition('GenderType = "GENDER_MALE"')
.get();
if (videoGenderIterator.hasNext()) {
const videoGender = videoGenderIterator.next();
videoGender.exclude();
}