برخی از انواع تبلیغات، مانند ImageAd و ResponsiveDisplayAd ، حاوی تصاویر و سایر عناصر رسانه هستند. این راهنما نحوه آپلود و پرس و جو رسانه با استفاده از اسکریپت های Google Ads را شرح می دهد.
در حال آپلود تصاویر
تصاویر را می توان با استفاده از کلاس ImageBuilder
آپلود کرد که نام و داده های تصویر را می گیرد. داده ها به عنوان یک شی تبادل داده Blob
ارائه می شوند که می تواند توسط سرویس هایی مانند Drive یا URL fetch ایجاد شود.
قطعه زیر نحوه آپلود یک تصویر از یک 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 Ads با استفاده از MediaSelector
جستجو کرد. از گزاره withCondition()
برای فیلتر کردن رسانه بر اساس نام، نوع یا سایر فیلدها استفاده کنید. به عنوان مثال، قطعه زیر تمام تصاویر یک حساب کاربری را پیدا می کند:
let mediaIterator = AdsApp.adMedia().media()
.withCondition("Type = IMAGE")
.get();
while (mediaIterator.hasNext()) {
let image = mediaIterator.next();
}
ایجاد تبلیغات با رسانه
برای چند نمونه کد از ایجاد تبلیغات پشتیبانی شده با رسانه پیوست شده، مقاله تبلیغات ما را ببینید.