دارایی‌ها

پیش‌از ایجاد پویش «تولید تقاضا»، مهم است که همه دارایی‌هایی را که قصد دارید در پویش استفاده کنید وارد کنید. همیشه می‌توانید بعداً برگردید و دارایی اضافه کنید، اما برای شروع به مجموعه‌ای از دارایی‌ها نیاز دارید.

هنگام برنامه‌ریزی پویش، راهنمای روال‌های مطلوب و مشخصات دارایی «تولید تقاضا» را بررسی کنید.

دارایی‌های تصویری و ویدیویی انواع اصلی دارایی هستند و این راهنما نحوه بارگذاری هرکدام از آن‌ها را نشان می‌دهد. این اصول را می‌توان به انواع دیگر دارایی نیز تعمیم داد. مهم نیست چه نوع دارایی‌ای می‌سازید، از AssetOperation برای ساختن آن استفاده کنید.

دارایی‌ها را می‌توان بااستفاده از AdsApp بدون استفاده از mutate ایجاد کرد، اما برای حفظ ثبات، این راهنما آن را به همان روشی که بقیه عملیات‌ها انجام می‌دهند، انجام می‌دهد. توجه داشته باشید که اگر ازقبل دارایی‌های موجودی دارید، می‌توانید و باید از آن‌ها مجدداً استفاده کنید. بنابراین، اگرچه برای ایجاد پویش «تولید تقاضا» باید دارایی داشته باشید، ممکن است لزوماً لازم نباشد که آن‌ها را به‌عنوان بخشی از فرایند ایجاد پویش ایجاد کنید.

دارایی‌های تصویری

دارایی‌های تصویری در قالب کدبندی‌شده با پایه ۶۴ بارگذاری می‌شوند. ازآنجایی‌که نمی‌توانید تصاویر را مستقیماً در جاوااسکریپت Google Ads بارگذاری کنید، دو رویکرد متفاوت برای دریافت داده‌های تصویر و کدگذاری آن برای بارگذاری دارید.

برای واکشی تصویر از Google Drive، ابتدا به شناسه آن نیاز دارید که بهترین راه برای شناسایی منحصربه‌فرد تصویر است. یکی از راه‌های دریافت شناسه، کپی کردن پیوند هم‌رسانی‌شدنی از واسط کاربر Google Drive و استخراج شناسه است. همچنین می‌توانید مجموعه‌ای از فایل‌ها را به‌صورت برنامه‌نویسی‌شده واکشی کنید و فایل‌هایی را که می‌خواهید بارگذاری کنید انتخاب کنید. این کد نشان می‌دهد که چگونه یک تصویر را با شناسه مشخص بارگذاری کنید:

const file = DriveApp.getFileById(fileId);
const imageAsset =  {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing Logo",
      "type": "IMAGE",
      "imageAsset": {
        "data": Utilities.base64Encode(file.getBlob().getBytes())
      }
    }
  }
}

یا می‌توانید بااستفاده از UrlFetchApp، تصویری را که در سرور وب میزبانی می‌شود ازطریق نشانی وب آن واکشی کنید:

const file = UrlFetchApp.fetch(imageUrl);

سپس می‌توانید getBlob را در این فایل فراخوانی کنید، درست مانند کاری که با فایل Drive انجام می‌دهید، بنابراین ساختار عملیات با مراحل مربوط به فایل Google Drive یکسان است.

دارایی‌های ویدیو

دارایی‌های ویدیویی ازطریق ویدیوهای YouTube مدیریت می‌شوند. اگر دارایی‌ها را به‌عنوان بخشی از فرایند ایجاد پویش بارگذاری می‌کنید، از شناسه موقت استفاده کنید. درغیراین‌صورت، نام منبع برگردانده‌شده را یادداشت کنید تا در عملیات آتی، زمانی که لازم است به دارایی ارجاع دهید تا آن را به گروه دارایی اضافه کنید، از آن استفاده کنید.

const videoAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing video",
      "type": "YOUTUBE_VIDEO",
      "youtube_video_asset": {
        "youtube_video_title": "Demand Gen video",
        "youtube_video_id": "123456789"
      }
    }
  }
}
operations.push(videoAsset);