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

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

• יצירת מחרוזת JSON עם נתונים לגבי תחומי העניין, ההתנהגות או ההקשר של המשתמש.
• יוצרים מחרוזת ASCII בקידוד Base64 ממחרוזת ה-JSON שלמעלה.
• מוסיפים את המחרוזת המקודדת לכתובת ה-URL של תג המודעה באמצעות הפרמטר &ppsj=.

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();
}

String userSignals = userSignalsObject.toString();

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);
}

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