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

تتيح "إعلانات 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;
  ...
}

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