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

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

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

إزالة

يمكنك إزالة جدول عرض إعلانات باستخدام الطريقة 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.