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

اسکریپت‌های 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
• سپر

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

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

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

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

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

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

هدف گذاری ویدیو

دو نوع مختلف هدف گذاری مرتبط برای کمپین های ویدیویی وجود دارد. 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();
}