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

تحتوي بعض أنواع الإعلانات، مثل 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();
}

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

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