دارایی‌ها

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

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

دارایی‌های تصویری و ویدیویی انواع اصلی دارایی هستند و این راهنما نحوه بارگذاری هریک از آن‌ها را نشان می‌دهد. این اصول را می‌توان به انواع دیگر دارایی نیز تعمیم داد. مهم نیست چه نوع دارایی‌ای می‌سازید، از 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);