کمپین های ویدیویی

اسکریپت‌های گوگل ادز به شما امکان مدیریت و گزارش کمپین‌های ویدیویی مبتنی بر یوتیوب خود را می‌دهند. می‌توانید از اسکریپت‌ها برای مدیریت کمپین‌های ویدیویی موجود، ایجاد و مدیریت گروه‌های تبلیغاتی و تبلیغات، تنظیم هدف‌گذاری برای کمپین‌ها و اجرای گزارش‌ها استفاده کنید. با این حال، نمی‌توانید از اسکریپت‌ها برای ایجاد کمپین‌های ویدیویی استفاده کنید.

بازیابی کمپین‌های ویدیویی و گروه‌های تبلیغاتی

کمپین‌های ویدیویی از طریق مجموعه 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) {
  ...
}

ایجاد تبلیغات ویدیویی

اسکریپت‌های گوگل ادز به شما امکان می‌دهند تبلیغات ویدیویی خود را با استفاده از متد 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
• سپر

شما می‌توانید این کمپین‌ها را با استفاده از withCondition انتخاب کنید:

const campaignIterator = AdsApp.videoCampaigns()
  .withCondition("AdvertisingChannelSubType = null")
  .get();

تبلیغات ویدیویی درون استریم می‌توانند قبل، حین یا بعد از ویدیوهای دیگر پخش شوند و به کاربران این امکان را می‌دهند که پس از مدت زمان مشخصی، از پخش آن صرف نظر کنند. تبلیغات ویدیویی در شبکه نمایش و صفحات مختلف یوتیوب ظاهر می‌شوند و فقط در صورتی پخش می‌شوند که کاربر ابتدا به طور فعال روی تصویر کوچک تبلیغ کلیک کند. تبلیغات Bumper 6 ثانیه یا کمتر هستند و می‌توانند در ویدیوهای یوتیوب یا در ویدیوهای سایت‌ها و برنامه‌های همکار در شبکه نمایش ظاهر شوند. برای جزئیات کامل در مورد هر یک از این انواع تبلیغات، به «درباره قالب‌های تبلیغات ویدیویی» مراجعه کنید.

توجه: برای یک کمپین مشخص، می‌توانید یا تبلیغات "TrueView" یا تبلیغات Bumper داشته باشید، اما نمی‌توانید هر دو را با هم داشته باشید.

گروه تبلیغاتی بسازید

شما یک گروه تبلیغاتی ویدیویی را از طریق متد 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();

دارایی ویدیویی ایجاد کنید

تبلیغات ویدیویی معمولاً نیاز به ارجاع به یک فایل ویدیویی دارند. این مشخص می‌کند که کدام ویدیو برای تبلیغ پخش خواهد شد. شما نمی‌توانید با استفاده از اسکریپت‌ها ویدیویی را آپلود کنید، اما می‌توانید یک ویدیوی یوتیوب موجود را که قبلاً آپلود کرده‌اید برای استفاده در تبلیغات خود لینک کنید. این کار را با ایجاد یک 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();

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

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

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