טירגוט לפי ערך מפתח

אפשר להשתמש בערכי מפתח כדי לטרגט מודעות באופן מפורט יותר מאשר יחידות מודעות. מידע נוסף על צמדי מפתח/ערך

לכל בקשת מודעה, אפשר להעביר מפתח אחד או יותר, עם ערך אחד או יותר משויך לכל מפתח. ערכי המפתח האלה ייבדקו מול אפשרויות הטירגוט שהוגדרו ברמת הפריט ב-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