استهداف الحملة

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

جداول عرض الإعلانات

تتيح لك جداول عرض الإعلانات التحكّم في وقت عرض إعلاناتك.

الاسترداد

يمكنك استرداد جداول عرض الإعلانات لحملة باستخدام الأسلوب adSchedules استهدافات الحملة. يوضِّح المقتطف التالي من الرمز البرمجي كيفية استرداد قائمة بكلّ AdSchedule المعايير لحملة معيّنة:

const campaign = AdsApp.campaigns()
    .withCondition("campaign.name = 'My campaign'")
    .get()
    .next();

const adSchedules = campaign.targeting().adSchedules().get();
for (const adSchedule of adSchedules) {
  // Process your ad schedule.
  ...
}

تعرض الحملة الإعلانات تلقائيًا في جميع الأوقات، لذا لن تتلقّى أي جداول عرض إعلانات إذا لم تكن قد أعددت جدول عرض إعلانات مخصّصًا لحملتك.

تعديل

بعد استرداد جدول عرض إعلانات، يمكنك تعديل خصائصه مباشرةً. على سبيل المثال، يمكنك تعديل مُعدِّل عرض أسعار جدول عرض إعلانات على النحو التالي:

adSchedule.setBidModifier(1.1);

إنشاء

لإنشاء جدول عرض إعلانات جديد، يمكنك استخدام addAdSchedule طريقة Campaign. ينشئ المقتطف التالي من الرمز البرمجي جدول عرض إعلانات مخصّصًا للحملة من الساعة 7 صباحًا إلى الساعة 11 صباحًا في المنطقة الزمنية للحساب، وذلك كلّ سبت، مع مُعدِّل عرض سعر هو 1.1.

campaign.addAdSchedule({
   dayOfWeek: "SATURDAY",
   startHour: 7,
   startMinute: 0,
   endHour: 11,
   endMinute: 0,
   bidModifier: 1.1
});

ملاحظة: يمكن إنشاء ستة جداول عرض إعلانات كحد أقصى لكل يوم من أيام الأسبوع، مثلاً، يمكن تقسيم كل يوم إلى ست فترات مدتها 4 ساعات، ولكن لا يمكن تقسيم كل يوم إلى 24 فترة مدتها ساعة واحدة.

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

إزالة

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

const adSchedules = campaign.adSchedules().get();
for (const adSchedule of adSchedules) {
  adSchedule.remove();
}

المواقع الجغرافية

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

الاسترداد

يمكنك استرداد قائمة المواقع الجغرافية المستهدفة باستخدام القيمة targetedLocations لطريقة استهدافات الحملة. يمكن استرجاع المواقع الجغرافية المُستبعَدة باستخدام الطريقة excludedLocations. يختار مقتطف الرمز التالي جميع المواقع الجغرافية المستهدَفة التي تلقّت أكثر من 100 مرّة ظهور في الشهر الماضي.

const locations = AdsApp.targeting()
  .targetedLocations()
  .withCondition("metrics.impressions > 100")
  .forDateRange("LAST_MONTH")
  .orderBy("metrics.clicks DESC")
  .get();

for (const location of locations) {
 // Process the campaign target here.
 ...
}

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

تعديل

بعد استرداد موقع جغرافي، يمكنك تعديل خصائصه مباشرةً. على سبيل المثال، يمكنك تعديل مُعدِّل عرض سعر موقع جغرافي على النحو التالي:

location.setBidModifier(1.1);

إنشاء

يمكنك إنشاء مواقع جغرافية مستهدَفة في حملة باستخدام addLocation الطريقة. وبالمثل، يمكنك استبعاد موقع جغرافي باستخدام الطريقة excludeLocation. يستهدف مقتطف الرمز التالي حملة في الولايات المتحدة باستخدام مُعدِّل عرض سعر يبلغ 1.15، مع استبعاد مدينة نيويورك.

campaign.addLocation(2840, 1.15);     // United States
campaign.excludeLocation(1023191);    // New York city

يمكنك الرجوع إلى مستندات ميزة الاستهداف الجغرافي في Google Ads API للحصول على قائمة الأرقام التعريفية لاستخدامها عند إضافة ميزة الاستهداف حسب الموقع الجغرافي. لتتبُّع أداء استهدافات المواقع الجغرافية، يمكنك البحث في مرجع location_view التقرير.

إزالة

يمكنك إزالة استهداف موقع جغرافي باستخدام الطريقة remove.

المواقع الجغرافية القريبة

يمكنك استهداف حملة ضمن نطاق جغرافي محدّد (قرب) من موقع جغرافي باستخدام النصوص البرمجية في "إعلانات Google".

الاسترداد

يمكنك استرداد قائمة المواقع الجغرافية القريبة المستهدَفة باستخدام الإجراء targetedProximities في استهدافات الحملة. يختار مقتطف الرمز التالي جميع المواقع الجغرافية القريبة المستهدَفة التي تلقّت أكثر من 100 مرّة ظهور في الشهر الماضي.

const proximities = AdsApp.targeting()
    .targetedProximities()
    .withCondition("metrics.impressions > 100")
    .forDateRange("LAST_MONTH")
    .orderBy("metrics.clicks DESC")
    .get();

for (const proximity of proximities) {
  ...
}

إنشاء

يمكنك إنشاء هدف قريب لحملة باستخدام addProximity الطريقة. يستهدف مقتطف الرمز البرمجي التالي حملة على نطاق 20 كيلومترًا حول الإحداثيات (37.423021، -122.083739).

campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS");

يمكنك أيضًا استخدام هذه الطريقة لإنشاء استهداف الموقع الجغرافي القريب نفسه باستخدام مُعدِّل عرض سعر وعنوان:

campaign.addProximity(37.423021, -122.083739, 20, "KILOMETERS", {
  bidModifier: 1.15,
  address: {
    streetAddress: "1600 Amphitheatre Parkway",
    cityName: "Mountain View",
    provinceName: "California",
    provinceCode: "CA",
    postalCode: "94043",
    countryCode: "US"
  }
});

يُرجى العِلم أنّه لا يتم التحقّق من أنّ العنوان يقع فعلاً عند خط العرض وخط الطول المحدَّدَين. لا يخدم العنوان أي غرض سوى تغيير ما يظهر في واجهة "إدارة الحملات".

إزالة

يمكنك إزالة هدف القرب باستخدام remove الطريقة.

الأنظمة الأساسية

يمكنك استرداد قائمة المنصّات التي تستهدفها الحملة باستخدام platforms طريقة استهدافات الحملة. بما أنّ حملات "إعلانات Google" تستهدف جميع الأنظمة الأساسية (أجهزة الكمبيوتر المكتبي والأجهزة الجوّالة والأجهزة اللوحية)، لا يمكنك إضافة معيار Platform أو إزالته. إنّ الاستخدام الأكثر شيوعًا لمعيار الاستهداف هذا هو ضبط تعديل عروض أسعار الأجهزة في حملتك:

campaign.targeting()
    .platforms()
    .mobile()
    .get()
    .next().
    setBidModifier(1.2);

تتم مشاركة أرقام تعريف المنصات على مستوى الحملات، وهي تتضمّن قيمًا محدّدة مسبقًا كما هو موضح في ملحق منصّات Google Ads API. يمكن أن تكون هذه الأرقام التعريفية مفيدة عند تحليل التقارير. عند اختيار المعايير مباشرةً، يمكنك استخدام طرق المساعدة التي يوفّرها PlatformSelector.