مواد العرض

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

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

بما أنّ مواد العرض النصية ومواد العرض الصورية هما نوعا مواد العرض الأساسيان المطلوبان، سيوضّح هذا الدليل كيفية تحميل كلّ منهما. ويمكن تطبيق هذه المبادئ على أنواع مواد العرض الأخرى أيضًا. بغض النظر عن نوع مادة العرض التي تريد إنشائها، استخدِم 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())
      }
    }
  }
}

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

const file = UrlFetchApp.fetch(imageUrl);

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