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

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

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

الإنشاء

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

يوضّح المقتطف التالي كيفية إنشاء إعلان نصي موسَّع:

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;
  ...
}

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