אותות שמספקים בעלי תוכן דיגיטלי

אפשר לשלוח נתונים של קהלים ונתונים לפי הקשר בתור אותות שמספקים בעלי תוכן דיגיטלי (PPS) בבקשות להצגת מודעות. באמצעות PPS, תוכלו להשתמש בנתוני המשתמשים שלכם כדי לשפר את המונטיזציה הפרוגרמטית. לשם כך, תוכלו להעביר את מאפייני הקהל שלכם למגישי הצעות המחיר בכל סוגי הטרנזקציות באמצעות טקסונומיות סטנדרטיות, בלי שתצטרכו לשתף את מזהי המשתמשים. מאפייני הקהל יכולים לכלול נתונים התנהגותיים ונתונים שמבוססים על תחומי עניין (טקסונומיית קהל 1.1 של IAB) ונתונים לפי הקשר (טקסונומיה של תוכן IAB 2.2). אפשר גם לשלוח אותות מובְנים שמספקים בעלי תוכן דיגיטלי, שמוגדרים על ידי Google ומאפשרים לשלוח אותות נוספים.

יצירה של קובץ JSON של אותות המשתמשים

ברמה העליונה, יוצרים אובייקט JSON עם צמד מפתח/ערך יחיד. המפתח צריך להיות PublisherProvidedTaxonomySignals והערך שלו צריך להיות מערך של אובייקטים. לכל אובייקט במערך צריכים להיות 2 זוגות מפתח/ערך:

  • המפתח taxonomy, שמקבל את הערכים הבאים שממופים לפי המפרטים הציבוריים של IAB:

    • IAB_AUDIENCE_1_1 לטקסונומיית קהל 1.1
    • IAB_CONTENT_2_2 לטקסונומיה של תוכן 2.2

  • המפתח values עם מערך תואם של ערכי טקסונומיית מחרוזות.

יצירת מערך האותות המובְנים

לאותות מובנים, מוסיפים את המפתח PublisherProvidedStructuredSignals עם ערך של מערך אובייקטים. בונים את האובייקט על סמך הרשימה הבאה של צמדי מפתח/ערך של אותות:

החלפת מצב התצוגה של טבלת האותות המובְנים

אות <code" dir="ltr" translate="no">"type" Value</code"> ערכים אפשריים של "single_value" ערכים אפשריים של "values"
סוג של פיד אודיו "audio_feed"
  • "af_1": מוזיקה
  • "af_2": שידור
  • "af_3": פודקאסט
 לא רלוונטי
סיווג תוכן "content_rating"
  • "cr_1": G
  • "cr_2": PG
  • "cr_3": ט
  • "cr_4": מסצ'וסטס
 לא רלוונטי
העברת תוכן "delivery" לא רלוונטי
  • "cd_1": סטרימינג
  • "cd_2": הדרגתית
  • "cd_3": הורדה
איכות ההפקה "prodq"
  • "pq_1": הפקה מקצועית
  • "pq_2": צרכן
  • "pq_3": תוכן שנוצר על ידי משתמשים (UGC)
 לא רלוונטי

בדוגמה הבאה נעשה שימוש באותות IAB_AUDIENCE_1_1 ו-IAB_CONTENT_2_2 לאותות טקסונומיה, וכוללת אותות מובְנים.

const userSignals = {
  "PublisherProvidedTaxonomySignals": [{
     "taxonomy": "IAB_AUDIENCE_1_1",
     "values": ["6", "284"]
     // '6' = 'Demographic | Age Range | 30-34'
     // '284' = 'Interest | Business and Finance |  Mergers and Acquisitions'
  },
  {
     "taxonomy": "IAB_CONTENT_2_2",
     "values": ["49", "138"]
     // '49' = 'Books and Literature | Poetry'
     // '138' = 'Education | College Education | College Planning'
  }],
  "PublisherProvidedStructuredSignals": [{
      "type": "audio_feed",
      "single_value": "af_1",
    },
    {
      "type": "delivery",
      "values": ["cd_1", "cd_3"],
    },
  ],
};

הגדרה של בקשות להצגת מודעות

כדי לשלוח PPS באמצעות AdsRequest:

  • יוצרים אובייקט JSON עם תחומי העניין, ההתנהגות או נתוני ההקשר של המשתמש.
  • יוצרים מחרוזת ASCII בקידוד Base64 מהאובייקט JSON שלמעלה.
  • מוסיפים את המחרוזת המוצפנת לכתובת ה-URL של תג המודעה באמצעות הפרמטר &ppsj=.
const userSignals = {
  "PublisherProvidedTaxonomySignals": [{
     "taxonomy": "IAB_AUDIENCE_1_1",
     "values": ["1", "284"]
  }]
};

const sampleAdTag = "https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s"

const encodedSignals = encodeURIComponent(window.btoa(JSON.stringify(userSignals)));

const finalAdTag = sampleAdTag + "&ppsj=" + encodedSignals;