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

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

إزالة

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