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

אפשר לשלוח נתונים של קהלים ונתונים לפי הקשר בתור אותות שמספקים בעלי תוכן דיגיטלי (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": MA
 לא רלוונטי
העברת תוכן "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 באמצעות IMAAdsRequest:

  • יוצרים מחרוזת JSON עם נתוני העניין, ההתנהגות או ההקשר של המשתמש.
  • יוצרים מחרוזת ASCII בקידוד Base64 ממחרוזת ה-JSON שלמעלה.
  • מוסיפים את המחרוזת המוצפנת לכתובת ה-URL של תג המודעה באמצעות הפרמטר &ppsj=.
let userSignals = """
{
   "PublisherProvidedTaxonomySignals": [
    {
      "taxonomy": "IAB_AUDIENCE_1_1",
      "values": [
        "1",
        "284"
      ]
    }
  ],
}
"""
let base64Signals = Data(userSignals.utf8).base64EncodedString()
var encodedSignals = base64Signals.replacingOccurrences(of: "+", with: "%2B")
encodedSignals = encodedSignals.replacingOccurrences(of: "/", with: "%2F")
encodedSignals = encodedSignals.replacingOccurrences(of: "=", with: "%3D")


let finalAdTag = sampleAdTag + "&ppsj=" + encodedSignals