دارایی‌ها

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

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

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