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

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

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

يمكن تحميل الصور باستخدام الفئة ImageBuilder التي تأخذ اسمًا وبيانات صورة. يتم توفير البيانات على شكل كائن تبادل بيانات Blob يمكن إنشاؤه من خلال خدمات مثل Drive أو جلب عنوان 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();
}

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

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