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

تتيح لك النصوص البرمجية في "إعلانات 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` الخاصة باستهدافات الحملة.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.