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

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

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