حملات الفيديو

تتيح لك نصوص "إعلانات Google" البرمجية إدارة حملات الفيديو المستندة إلى 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" البرمجية استرداد إعلانات الفيديو باستخدام طريقة 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 video discovery
  • إعلان ملصق صغير

يمكنك اختيار هذه الحملات باستخدام withCondition:

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

يمكن عرض "الإعلانات أثناء عرض الفيديو" قبل الفيديوهات الأخرى أو أثناءها أو بعدها، ما يتيح للمستخدمين خيار تخطّيها بعد وقت محدّد. تظهر إعلانات الفيديو أثناء التصفّح على "الشبكة الإعلانية" وصفحات YouTube المختلفة، ولن يتم تشغيلها إلا إذا نقر المستخدم بشكل نشط على الصورة المصغّرة للإعلان أولاً. تبلغ مدة "إعلانات الملصقات الصغيرة" 6 ثوانٍ أو أقل، ويمكن أن تظهر على فيديوهات 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();
}