تحسين الحملات الإعلانية باستخدام نموذج "التكلفة لكل تثبيت"

اختيار النظام الأساسي: HTML5 Android iOS tvOS

يمكنك إرسال بيانات الجمهور والبيانات السياقية على شكل إشارات مقدَّمة من الناشر (PPS) في طلبات عرض الإعلانات. باستخدام الإشارات المقدَّمة من الناشر، يمكنك الاستفادة من بيانات المستخدمين لتحسين تحقيق الربح آليًا من خلال إبلاغ مقدِّمي عروض الأسعار بخصائص جمهورك في جميع أنواع المعاملات، وذلك باستخدام التصنيفات العادية، بدون الحاجة إلى مشاركة معرّفات المستخدمين. يمكن أن تشمل خصائص جمهورك البيانات السلوكية والبيانات المستندة إلى الاهتمامات (الإصدار 1.1 من معايير تصنيف الجمهور لدى IAB) والبيانات السياقية (الإصدار 2.2 من معايير تصنيف المحتوى لدى IAB). يمكنك أيضًا إرسال إشارات منظَّمة يقدّمها الناشر، وتحدّدها Google، وتسمح بإرسال إشارات إضافية.

إنشاء ملف JSON لإشارات المستخدمين

في المستوى الأعلى، أنشئ عنصر JSON يتضمّن زوجًا واحدًا من المفاتيح والقيم. يجب أن يكون المفتاح PublisherProvidedTaxonomySignals، ويجب أن تكون قيمته مصفوفة من العناصر. يجب أن يحتوي كل عنصر في المصفوفة على زوجَين من المفتاح والقيمة:

• مفتاح taxonomy الذي يقبل القيم التالية المرتبطة بالمواصفات العامة التالية لمكتب IAB:

  • ‫IAB_AUDIENCE_1_1 لإصدار Audience Taxonomy 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": بودكاست	timing fixed in amara
تقييم المحتوى	"content_rating"	‫"cr_1": هدف ‫"cr_2": يُنصح بمشاهدته بإشراف عائلي ‫"cr_3": T ‫"cr_4": MA	timing fixed in amara
عرض المحتوى	"delivery"	timing fixed in amara	‫"cd_1": بث المحتوى ‫"cd_2": متدرّجة ‫"cd_3": تنزيل
جودة الإنتاج	"prodq"	‫"pq_1": محتوى من إنتاج محترفين "pq_2": Prosumer "pq_3": محتوى من إنشاء المستخدمين	timing fixed in amara

اطّلِع على المثال التالي الذي يستخدم 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;