هدف گذاری کلید-مقدار

از کلید-مقدارها می توان برای هدف قرار دادن تبلیغات به صورت جزئی تر از واحدهای تبلیغاتی استفاده کرد. درباره کلید-مقدارها بیشتر بیاموزید.

برای هر درخواست تبلیغ، می‌توانید یک یا چند کلید را ارسال کنید که هر کدام یک یا چند مقدار مرتبط دارند. این کلید-مقدارها در مقابل گزینه‌های هدف‌یابی پیکربندی‌شده در سطح مورد خط در Ad Manager ارزیابی می‌شوند. به عنوان مثال، اگر یک کلید-مقدار سفارشی age=18-34 را پاس کنید، اقلام خطی که برای محدوده سنی 18-34 سال هدف گذاری شده اند، با فرض مطابقت همه معیارهای دیگر، واجد شرایط ارائه خدمات خواهند بود.

هدف گذاری را تنظیم کنید

می‌توانید مقادیر کلیدی را برای پیکربندی هدف‌گیری در سطح شکاف و صفحه بر اساس نیازهای شبکه خود تعیین کنید.

در سطح اسلات

به شما امکان می دهد مقادیر کلیدی را برای جایگاه های تبلیغاتی جداگانه در صفحه خود تنظیم کنید.

هدف گذاری در سطح اسلات به شما امکان می دهد هدف گذاری را بر اساس هر اسلات پیکربندی کنید. این در مواردی مفید است که اسلات‌های جداگانه در یک صفحه به هدف‌گیری متفاوتی نیاز دارند، اما در موقعیت‌هایی که کلید-مقدارهای یکسان برای همه اسلات‌ها اعمال می‌شود، می‌تواند ناکارآمد باشد. از 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