ناشر سیگنال هایی را ارائه کرد

می‌توانید مخاطبان و داده‌های متنی را به‌عنوان سیگنال‌های ارائه‌شده ناشر (PPS) در درخواست‌های آگهی ارسال کنید. با PPS، می‌توانید از داده‌های کاربر خود برای بهبود درآمدزایی برنامه‌ای با برقراری ارتباط با ویژگی‌های مخاطبان خود به پیشنهاد دهندگان در همه انواع تراکنش ، با استفاده از طبقه‌بندی استاندارد، بدون نیاز به اشتراک‌گذاری شناسه‌های کاربر، استفاده کنید. ویژگی های مخاطب شما می تواند شامل داده های رفتاری و مبتنی بر علاقه ( IAB Audience Taxonomy 1.1 ) و داده های متنی ( IAB Content Taxonomy 2.2 ) باشد. همچنین می‌توانید سیگنال‌های ساختاریافته ارائه شده توسط ناشر را که توسط Google تعریف شده است، ارسال کنید و امکان ارسال سیگنال‌های اضافی را فراهم کنید.

سیگنال های کاربر را JSON بسازید

در سطح بالا، یک شی JSON با یک جفت کلید-مقدار واحد ایجاد کنید. کلید باید PublisherProvidedTaxonomySignals باشد و مقدار آن باید آرایه ای از اشیا باشد. هر شی در آرایه باید 2 جفت کلید-مقدار داشته باشد:

  • کلید taxonomy ، که مقادیر زیر را می پذیرد که با مشخصات عمومی زیر IAB نگاشت می شوند:

    • IAB_AUDIENCE_1_1 برای طبقه بندی مخاطب 1.1
    • IAB_CONTENT_2_2 برای طبقه بندی محتوا 2.2

  • values با یک آرایه مربوطه از مقادیر طبقه بندی رشته کلید می زنند.

آرایه سیگنال های ساخت یافته را بسازید

برای سیگنال های ساخت یافته، کلید PublisherProvidedStructuredSignals را با مقدار آرایه ای از اشیا اضافه کنید. شی را بر اساس لیستی از مقادیر کلیدهای سیگنال زیر بسازید:

تغییر نمای جدول سیگنال های ساخت یافته

سیگنال مقدار "نوع". مقادیر ممکن "single_value" "values" ممکن ارزش ها
نوع فید صوتی "audio_feed"
  • "af_1" : موسیقی
  • "af_2" : پخش
  • "af_3" : پادکست
 n/a
رتبه بندی محتوا "content_rating"
  • "cr_1" : G
  • "cr_2" : PG
  • "cr_3" : T
  • "cr_4" : MA
 n/a
تحویل محتوا "delivery" n/a
  • "cd_1" : پخش جریانی
  • "cd_2" : پیشرو
  • "cd_3" : دانلود کنید
کیفیت تولید "prodq"
  • "pq_1" : تولید حرفه ای
  • "pq_2" : Prosumer
  • "pq_3" : کاربر ایجاد شده (UGC)
 n/a

مثال زیر را ببینید که از 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 بالا ایجاد کنید.
  • رشته کدگذاری شده را با پارامتر &ppsj= به URL تگ تبلیغاتی خود اضافه کنید. 
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;