بهبود پویش‌های آگهی با «پرداخت به‌ازای فروش»

پلاتفرم را انتخاب کنید: HTML5 Android iOS tvOS

می‌توانید داده‌های زمینه‌ای و مخاطب را به‌عنوان نشان‌های ناشرداده (PPS) در درخواست‌های آگهی ارسال کنید. با «سیگنال‌های ارائه‌شده توسط ناشر»، می‌توانید از داده‌های کاربرتان برای بهبود درآمدزایی برنامه‌ای استفاده کنید. این کار با انتقال ویژگی‌های مخاطبانتان به پیشنهاددهندگان در همه انواع تراکنش، بااستفاده از طبقه‌بندی‌های استاندارد، و بدون نیاز به هم‌رسانی شناسه‌های کاربر انجام می‌شود. ویژگی‌های مخاطب شما می‌تواند شامل داده‌های رفتاری و مبتنی بر علاقه ( طبقه‌بندی مخاطب IAB نسخه ۱.۱) و داده‌های زمینه‌ای ( طبقه‌بندی محتوای IAB نسخه ۲.۲) باشد. همچنین می‌توانید نشان‌های ساختاریافته ناشرداده را که توسط Google تعریف شده‌اند ارسال کنید و اجازه دهید نشان‌های بیشتری ارسال شود.

ساخت JSON سیگنال‌های کاربر

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

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

    • IAB_AUDIENCE_1_1 برای «طبقه‌بندی مخاطب ۱.۱»
    • IAB_CONTENT_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
 موجود نیست
Content Delivery "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"],
    },
  ],
};

پیکربندی درخواست آگهی

برای ارسال «سرویس‌های پلاتفرم پیکسلی» با AdsRequest، این مراحل را دنبال کنید:

  • رشته JSON با داده‌های بافتی، رفتاری، یا علایق کاربر ایجاد کنید.
  • رشته ASCII کدبندی‌شده با Base64 را از رشته JSON بالا ایجاد کنید.
  • رشته کدبندی‌شده را با پارامتر &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;