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

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