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

בחירת פלטפורמה: HTML5 Android iOS tvOS

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

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

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

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

  • IAB_AUDIENCE_1_1 ל-Audience Taxonomy 1.1
  • ‫IAB_CONTENT_2_2 ל-Content Taxonomy 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;