แคมเปญวิดีโอ

สคริปต์ 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()):

ตัวอย่าง

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();
}