مواد العرض

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

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

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

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

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

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

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

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

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

لاسترجاع صورة من Google Drive، ستحتاج أولاً إلى رقم تعريفها ID، وهو أفضل طريقة لـ تحديد الصورة بشكلٍ فريد. إحدى طرق الحصول على رقم التعريف هي نسخ الرابط القابل للمشاركة من واجهة مستخدم 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.