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

يمكن استخدام القيم الأساسية لاستهداف الإعلانات بدقة أكبر من الوحدات الإعلانية. مزيد من المعلومات عن القيم الأساسية.

بالنسبة إلى كل طلب إعلان، يمكنك تمرير مفتاح واحد أو أكثر، ويشتمل كل مفتاح على قيمة مرتبطة واحدة أو أكثر. سيتم تقييم قيم المفاتيح هذه وفقًا لخيارات الاستهداف التي تم ضبطها على مستوى العنصر في "مدير الإعلانات". على سبيل المثال، إذا مرّرت قيمة مفتاح مخصّصة بقيمة age=18-34، ستكون البنود المُستهدَفة للفئة العمرية 18-34 مؤهَّلة لعرض الإعلانات، بافتراض أن جميع المعايير الأخرى تتطابق.

تعيين الاستهداف

يمكنك تحديد قيم أساسية لإعداد الاستهداف على مستوى كلٍّ من الشريحة والصفحة استنادًا إلى احتياجات الشبكة.

على مستوى الفتحة

يسمح لك بتعيين قيم أساسية للشرائح الإعلانية الفردية على صفحتك.

يتيح لك الاستهداف على مستوى الشريحة تهيئة الاستهداف على أساس كل شريحة. ويفيد ذلك في الحالات التي تتطلب فيها الشرائح الفردية على الصفحة نفسها استهدافًا مختلفًا، ولكنها قد تكون غير فعّالة في الحالات التي يتم فيها تطبيق القيم الرئيسية نفسها على جميع الشرائح. استخدم Slot.setTargeting() للاستفادة من الاستهداف على مستوى الشريحة الإعلانية، كما في المثال التالي.

على مستوى الصفحة

يسمح لك بتعيين قيم المفاتيح في جميع الشرائح الإعلانية على صفحتك.

ويضمن الاستهداف على مستوى الصفحة احتواء جميع الشرائح الإعلانية على مجموعة القيم الأساسية نفسها. وفي بعض الحالات، قد يقلل ذلك من العدد الكلي للشفرة اللازمة لتهيئة الاستهداف. استخدم googletag.pubads().setTargeting() للاستفادة من الاستهداف على مستوى الصفحة، كما في المثال التالي.

<head>
  <script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
  <script>
    window.googletag = window.googletag || {cmd: []};

    // GPT slots
    var adSlots = [];

    googletag.cmd.push(function() {
      // Configure slot-level targeting.
      adSlots[0] = googletag
          .defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-1')
          .addService(googletag.pubads())
          .setTargeting('color', 'red')
          .setTargeting('position', 'atf');
      adSlots[1] = googletag
          .defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-2')
          .addService(googletag.pubads())
          .setTargeting('position', 'btf');

      // Configure page-level targeting.
      googletag.pubads().setTargeting('interests', 'basketball');

      // Enable SRA and services.
      googletag.pubads().enableSingleRequest();
      googletag.enableServices();
    });
  </script>
</head>

في هذا المثال، تم تحديد شريحتين إعلانيتين تحدّدان الوحدة الإعلانية /6355419/Travel/Asia وحجم الإعلان 728x90. وبعد ذلك، يتم تطبيق استهداف قيمة المفتاح لتقييد الإعلانات التي قد تُعرض في كل شريحة وتمييزها.

عند استخدام كلٍّ من الاستهداف على مستوى الشريحة الإعلانية والصفحة المقصودة، يتم ضم قيم المفتاحين ولن تكون الإعلانات التي تلبي جميع المعايير مؤهلة للعرض في شريحة إعلانية معينة. في هذا المثال، وضع العلامات الفعال لكل شريحة هو:

الشريحة الإعلانية الاستهداف الفعّال
1 color=red AND position=atf AND interests=basketball
2 position=btf AND interests=basketball

استهداف مفاتيح أو قيم متعددة

في المثال السابق، تم استخدام مجموعة من الاستهداف على مستوى الشريحة والصفحة لتحديد مفاتيح استهداف متعددة لشريحة إعلانية واحدة. في ما يلي بعض الطرق البديلة لتحقيق الاستهداف الفعّال نفسه:

الاستهداف على مستوى الشريحة فقط

في هذا المثال، تتكرر قيم المفاتيح المشتركة لكل شريحة إعلانية.

// Slot-level targeting with multiple keys.
adSlots[0] = googletag
    .defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-1')
    .addService(googletag.pubads())
    .setTargeting('color', 'red')
    .setTargeting('position', 'atf')
    .setTargeting('interests', 'basketball');
adSlots[1] = googletag
    .defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-2')
    .addService(googletag.pubads())
    .setTargeting('position', 'btf')
    .setTargeting('interests', 'basketball');

الاستهداف التلقائي على مستوى الصفحة

في هذا المثال، يتم تعيين الاستهداف التلقائي على مستوى الصفحة وإلغاؤها على مستوى الشريحة عند الضرورة.

// Page-level default targeting.
googletag.pubads().setTargeting('interests', 'basketball')
                  .setTargeting('position', 'btf');

// Slot-level targeting overrides.
adSlots[0] = googletag
    .defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-1')
    .addService(googletag.pubads())
    .setTargeting('color', 'red')
    .setTargeting('position', 'atf');
adSlots[1] = googletag
    .defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-2')
    .addService(googletag.pubads());

من الممكن أيضًا استهداف قيم متعددة لمفتاح واحد من خلال تقديم مصفوفة من القيم عند طلب setTargeting():

// Page-level targeting with multiple values for a single key.
googletag.pubads().setTargeting('interests', ['baseball', 'basketball']);

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

بعد تعيين الاستهداف، سيتم إرسال قيم المفتاح الذي تمت تهيئته مع كل طلب إعلان طوال فترة الشريحة الإعلانية. ولكن في بعض الظروف، قد يكون من المفضل أن يتغير الاستهداف بمرور الوقت. يمكن استخدام setTargeting() لإضافة قيم مفاتيح واستبدالها، ولكن لا يمكن إزالتها بهذه الطريقة. ولتحقيق ذلك، يجب استخدام Slot.clearTargeting() أو googletag.pubads().clearTargeting() بدلاً من ذلك.

// Step 0, define slot- and page-level targeting.
adSlots[0] = googletag
    .defineSlot('/6355419/Travel/Asia', [728, 90], 'banner-ad-1')
    .addService(googletag.pubads())
    .setTargeting('color', 'red')
    .setTargeting('position', 'atf');

googletag.pubads().setTargeting('interests', 'basketball');

// Step 1, clear slot-level color targeting.
adSlots[0].clearTargeting('color');

// Step 2, clear all page-level targeting.
googletag.pubads().clearTargeting();

عند استدعاء clearTargeting() باستخدام مفتاح خاص (إما على مستوى الشريحة أو على مستوى الصفحة)، تتم إزالة هذا المفتاح فقط. عند عدم تحديد أي مفتاح، تتم إزالة كل الاستهدافات على هذا المستوى.

في المثال السابق، الاستهداف الفعال للشريحة الإعلانية بعد كل خطوة هو:

الخطوة الاستهداف الفعّال
0 color=red AND position=atf AND interests=basketball
1 position=atf AND interests=basketball
2 position=atf