پویش‌های ویدیویی

جاوااسکریپت 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، آگهی‌های ویدیویی جدید ایجاد کنید.

قالب‌های آگهی ویدیویی

قالب‌های آگهی ویدیویی پشتیبانی‌شده براساس نوع پویش ویدیویی متفاوت است. برای اطمینان از اینکه نوع مناسب پویش ویدیویی را انتخاب می‌کنید، تماسی در AdvertisingChannelSubType با withCondition اضافه کنید.

برخی پویش‌های ویدیویی دارای زیرنوع‌هایی هستند که انواع آگهی‌های پشتیبانی‌شده در آن پویش را محدود می‌کنند. به‌طور خاص، پویش‌های 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 نمایش داده می‌شوند و فقط درصورتی پخش می‌شوند که کاربر ابتدا به‌طور فعال روی ریزعکس آگهی کلیک کند. آگهی‌های بامپر ۶ ثانیه یا کوتاه‌تر هستند و می‌توانند در ویدیوهای YouTube یا در ویدیوهای سایت‌ها و برنامه‌های شریک در «شبکه تبلیغات» نمایش داده شوند. برای جزئیات کامل درباره هریک از این انواع آگهی، درباره قالب‌های آگهی ویدیویی را ببینید.

ساختن گروه آگهی

گروه آگهی ویدیویی را ازطریق روش newVideoAdGroupBuilder() پویش ویدیویی ایجاد می‌کنید. هنگام ایجاد گروه آگهی، باید نوع گروه آگهی و نام گروه آگهی را مشخص کنید. نوع گروه آگهی باید یکی از موارد زیر باشد و پس‌از ایجاد گروه آگهی نمی‌توان آن را تغییر داد:

  • VIDEO_BUMPER
  • VIDEO_EFFICIENT_REACH
  • ‫VIDEO_NON_SKIPPABLE_IN_STREAM (فقط برای پویش‌های VIDEO_NON_SKIPPABLE)
  • ‫VIDEO_RESPONSIVE (فقط برای پویش‌های VIDEO_ACTION)
  • VIDEO_TRUE_VIEW_IN_DISPLAY
  • VIDEO_TRUE_VIEW_IN_STREAM
  • YOUTUBE_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();

ساختن آگهی

برای ایجاد آگهی جدید، از روش سازنده مطابق با نوع گروه آگهی استفاده کنید (زنجیره‌ای بعداز 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();

معیارهای جمعیت‌شناسی (سن، جنسیت) کمی متفاوت از انواع دیگر معیارها عمل می‌کنند. وقتی گروه آگهی جدیدی ایجاد می‌شود، معیارهای هریک از مقادیر احتمالی سن و جنسیت به‌طور خودکار ایجاد می‌شود و آن گروه آگهی همه آن‌ها را هدف قرار می‌دهد. می‌توانید با واکشی هدف‌یابی موجود و فراخوانی روش exclude() روی آن، یک جمعیت‌شناسی را مستثنی کنید، و می‌توانید با پیدا کردن هدف‌یابی مستثنی‌شده موجود و فراخوانی include()، یک جمعیت‌شناسی مستثنی‌شده را دوباره اضافه کنید.

در اینجا مثالی برای مستثنی کردن یک جنسیت خاص از گروه آگهی آورده شده است:

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