أنواع الإعلانات

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

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

الإنشاء

يمكن للبرامج النصية إنشاء إعلانات باستخدام طريقة newAd() في مثيلات AdGroup. تعرض هذه السمة AdBuilderSpace الذي ينشئ أدوات إنشاء لأنواع الإعلانات المتوافقة.

يوضّح المقتطف التالي كيفية إنشاء إعلان نصي موسّع: javascript let adOperation = adGroup.newAd().expandedTextAdBuilder() .withHeadlinePart1("First headline part") .withHeadlinePart2("Second headline part") .withDescription("Ad description") .withFinalUrl("http://www.example.com") .withPath1("path1") // optional .withPath2("path2") // optional .build();

فحص

تتوفّر بعض المعلومات المرتبطة بجميع أنواع الإعلانات على الفور من خلال Ad، مثل معرّف الإعلان وحالة الموافقة عليه. بالإضافة إلى ذلك، يمكن إيقاف أي إعلان مؤقتًا أو تفعيله أو إزالته.

للوصول إلى الحقول الخاصة بنوع إعلان معيّن، مثل وصف إعلان نصي موسّع، استخدِم طريقة asType() لإنشاء AdViewSpace. يوفّر ذلك إمكانية الوصول إلى إصدار موسّع من Ad يعرض طرقًا خاصة بأنواع معيّنة.

تعرض المقتطفة التالية وصف كل إعلان نصي موسّع:

const iterator = AdsApp.ads().withCondition("Type = EXPANDED_TEXT_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let expandedTextAd = ad.asType().expandedTextAd();
  let description = expandedTextAd.getDescription();
}

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

يوضّح المقتطف التالي كيفية تحديد ما إذا كان الإعلان هو النوع الصحيح باستخدام الطريقة Ad.isType():

if (ad.isType().expandedTextAd()) {
  let expandedTextAd = ad.asType().expandedTextAd();
  let headlinePart1 = expandedTextAd.getHeadlinePart1();
  let headlinePart2 = expandedTextAd.getHeadlinePart2();
}

إعداد التقارير

يمكن أيضًا استخدام طريقة العرض ad_group_ad للاستعلام عن حقول الإعلانات الخاصة بنوع معيّن بالإضافة إلى الإحصاءات العادية، مثل ad_group_ad.expanded_text_ad.headline_part1. يعرض المقتطف التالي كيفية استرداد إحصاءات جميع الإعلانات النصية الموسّعة التي تتضمّن "تخفيضات" في العنوان 1:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
          "ad_group_ad.id, " +
          "ad_group_ad.expanded_text_ad.headline_part1, " +
          "ad_group_ad.expanded_text_ad.headline_part2, " +
          "metrics.clicks, " +
          "metrics.impressions, " +
          "metrics.cost" +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.expanded_text_ad.headline_part1 = 'Discount Sales' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let headlinePart1 = row.adGroupAd.expandedTextAd.headlinePart1;
  let headlinePart2 = row.adGroupAd.expandedTextAd.headlinePart2;
  ...
}

راجِع دليل التقارير للحصول على مزيد من المعلومات حول إعداد التقارير في البرامج النصية.