وسائط الإعلان

تحتوي بعض أنواع الإعلانات، مثل ImageAd وResponsiveDisplayAd، على صور وعناصر وسائط أخرى. يوضّح هذا الدليل كيفية تحميل الوسائط و البحث عنها باستخدام نصوص "إعلانات Google" البرمجية.

جارٍ تحميل الصور

يمكن تحميل الصور باستخدام فئة ImageBuilder التي تأخذ اسمًا وبيانات الصورة. يتم تقديم البيانات كعنصر تبادل بيانات Blob يمكن أن تنشئه خدمات مثل Drive أو fetch URL.

يوضّح المقتطف التالي كيفية تحميل صورة من عنوان URL خارجي:

let imageUrl = "http://www.example.com/example.png";
let imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

بدلاً من ذلك، يمكن تحميل ملفّ الصورة من Google Drive:

let imageFileId = "IMAGE_FILE_ID";
let imageBlob = DriveApp.getFileById(imageFileId).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

جارٍ تحميل حِزم الوسائط

حِزم الوسائط هي أرشيفات ZIP تحتوي على مواد عرض HTML5، ويمكن استخدامها ل إنشاء إعلانات HTML5. حمِّل حِزم الوسائط باستخدام فئة MediaBundleBuilder التي تأخذ اسمًا وبيانات الملف. كما هو الحال مع الصور، يتم تقديم البيانات على أنّها عنصر تبادل بيانات Blob.

يوضّح المقتطف التالي كيفية تحميل حِزمة وسائط من عنوان URL خارجي:

let mediaBundleUrl = "http://www.example.com/example.zip";
let mediaBundleBlob = UrlFetchApp.fetch(mediaBundleUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newMediaBundleBuilder()
    .withName("bundle name")
    .withData(mediaBundleBlob)
    .build();

طلب الوسائط

يمكن البحث عن جميع أنواع الوسائط في نصوص "إعلانات Google" البرمجية باستخدام علامة MediaSelector. استخدِم العبارة withCondition() لفلترة الوسائط حسب الاسم أو النوع أو حقول أخرى. على سبيل المثال، يبحث المقتطف التالي عن جميع الصور في حساب:

let mediaIterator = AdsApp.adMedia().media()
    .withCondition("Type = IMAGE")
    .get();
while (mediaIterator.hasNext()) {
  let image = mediaIterator.next();
}

إنشاء إعلانات باستخدام الوسائط

اطّلِع على مقالة الإعلانات لمعرفة بعض الأمثلة على الرموز التي تُستخدم لإنشاء إعلانات متوافقة مع الوسائط المرفقة.