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

تتيح لك نصوص "إعلانات 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.