مواد العرض

قبل إنشاء "حملة أداء أفضل"، من المهم استيراد جميع مواد العرض التي تخطّط لاستخدامها في الحملة. يمكنك دائمًا العودة وإضافة مواد عرض لاحقًا، ولكنك تحتاج إلى مجموعة من مواد العرض حتى تتمكّن من البدء.

يمكنك الاطّلاع على مواد العرض ومتطلبات مواد العرض في "حملات الأداء الأفضل" أثناء التخطيط لحملتك.

بما أنّ مواد العرض النصية ومواد عرض الصور هي أنواع مواد العرض الأساسية المطلوبة، سيوضّح هذا الدليل كيفية تحميل كلّ منها. ويمكن تطبيق هذه المبادئ على أنواع مواد العرض الأخرى أيضًا. بغض النظر عن نوع مادة العرض التي تريد إنشاؤها، استخدِم AssetOperation لإنشائها.

يمكن إنشاء مواد العرض باستخدام AdsApp بدون استخدام mutate، ولكن من أجل الاتساق، يتّبع هذا الدليل الطريقة نفسها المستخدمة في بقية العمليات. يُرجى العِلم أنّه يمكنك ويجب إعادة استخدام مواد العرض الحالية إذا كانت لديك بعض مواد العرض المتاحة. لذا، على الرغم من أنّه يجب توفّر مواد عرض لإنشاء "حملة أداء أفضل"، قد لا يكون من الضروري إنشاء هذه المواد كجزء من عملية إنشاء الحملة.

مواد العرض النصية

تعمل مواد العرض النصية مثل أي عملية أخرى. إذا كنت بصدد تحميل مواد عرض كجزء من عملية إنشاء الحملة، استخدِم معرّفًا مؤقتًا. بخلاف ذلك، سجِّل اسم مصدر العرض الذي تم إرجاعه لاستخدامه في عملية مستقبلية عندما تحتاج إلى الإشارة إلى مادة العرض لإضافتها إلى مجموعة مواد عرض.

const textAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "textAsset": {
        "text": "Travel the World"
      }
    }
  }
}
operations.push(textAsset);

مواد عرض الصور

يتم تحميل مواد عرض الصور بتنسيق base-64 مشفّر. بما أنّه لا يمكنك تحميل الصور مباشرةً إلى نصوص "إعلانات Google" البرمجية، يمكنك اتّباع أحد الأسلوبَين المختلفَين للحصول على بيانات الصورة وترميزها من أجل التحميل.

لاسترداد صورة من 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())
      }
    }
  }
}
operations.push(imageAsset);

بدلاً من ذلك، يمكنك استرجاع صورة مستضافة على خادم ويب من خلال عنوان URL الخاص بها باستخدام UrlFetchApp:

const file = UrlFetchApp.fetch(imageUrl);

يمكنك بعد ذلك استدعاء getBlob على هذا الملف تمامًا كما تفعل مع ملف Drive، وبالتالي تكون عملية الإنشاء مماثلة لخطوات ملف Google Drive.