שיפור הקמפיינים בעזרת PPS

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

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;