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

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

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

ضبط الاستهداف

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

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

يتيح لك هذا الإجراء ضبط قيم مفاتيح لمواضع إعلان فردية على صفحتك.

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

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

يسمح لك هذا الإجراء بضبط قيم المفاتيح في جميع الخانات الإعلانية على صفحتك.

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

<head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <meta
      name="description"
      content="Use key-value targeting to control the ads eligible to serve to specific ad slots."
    />
    <title>Key-value targeting</title>
    <script
      async
      src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"
      crossorigin="anonymous"
    ></script>
    <script>
      window.googletag = window.googletag || { cmd: [] };

      // GPT slots
      let adSlots = [];

      googletag.cmd.push(() => {
        // 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