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

אפשר לשלוח נתונים של קהלים ונתונים לפי הקשר בתור אותות שמספקים בעלי תוכן דיגיטלי (PPS) בבקשות להצגת מודעות. באמצעות PPS, תוכלו להשתמש בנתוני המשתמשים שלכם כדי לשפר את המונטיזציה הפרוגרמטית. לשם כך, תוכלו להעביר את מאפייני הקהל שלכם למגישי הצעות המחיר בכל סוגי הטרנזקציות באמצעות טקסונומיות סטנדרטיות, בלי שתצטרכו לשתף את מזהי המשתמשים. מאפייני הקהל יכולים לכלול נתונים התנהגותיים ונתונים שמבוססים על תחומי עניין (טקסונומיית קהלים 1.1 של IAB) ונתונים לפי הקשר (טקסונומיית תוכן 2.2 של IAB). אפשר גם לשלוח אותות מובְנים שמספקים בעלי תוכן דיגיטלי, שמוגדרים על ידי 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": תוכן שנוצר על ידי משתמשים	לא רלוונטי

בדוגמה הבאה נעשה שימוש באותות 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 באמצעות StreamRequest:

• יצירת מחרוזת JSON עם נתונים לגבי תחומי העניין, ההתנהגות או ההקשר של המשתמש.
• יוצרים מחרוזת ASCII בקידוד Base64 ממחרוזת JSON שלמעלה.
• מוסיפים את קובץ ה-JSON המקודד באמצעות StreamRequest.setAdTagParameters.

JSONObject userSignalsObject = new JSONObject();
JSONArray userSignalsArray = new JSONArray();
JSONObject audienceTaxonomyObject = new JSONObject();
JSONArray valuesArray = new JSONArray();
valuesArray.put("1");
valuesArray.put("284");
try {
  audienceTaxonomyObject.put("taxonomy", "IAB_AUDIENCE_1_1");
  audienceTaxonomyObject.put("values", valuesArray);
} catch (JSONException e) {
  e.printStackTrace();
}

userSignalsArray.put(audienceTaxonomyObject);

try {
  userSignalsObject.put("PublisherProvidedTaxonomySignals", userSignalsArray);
} catch (JSONException e) {
  e.printStackTrace();
}

byte[] userSignalsByte=new byte[0];
try {
  userSignalsByte = userSignals.getBytes(StandardCharsets.UTF_8);
  String encodedBas64Signals = android.util.Base64.encodeToString(
    userSignalsByte,
    android.util.Base64.URL_SAFE);
  encodedSignals = URLEncoder.encode(encodedBas64Signals, "UTF-8");
} catch (java.io.UnsupportedEncodingException error) {
  Log.w("Sample app", error);
}

Map<String, String> adTagParamMap = new java.util.HashMap<String, String>();
adTagParamMap.put("ppsj", encodedSignals);

streamRequest.setAdTagParameters(adTagParamMap)