الإشارات المقدَّمة من الناشر

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

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

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

  • يتيح المفتاح 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": بودكاست
 timing fixed in amara
تقييم المحتوى "content_rating"
  • "cr_1": أخضر
  • "cr_2": PG
  • ‫"cr_3": T
  • "cr_4": أمبير
 timing fixed in amara
عرض المحتوى "delivery" timing fixed in amara
  • "cd_1": البث
  • "cd_2": متدرّجة
  • "cd_3": تنزيل
جودة الإنتاج "prodq"
  • "pq_1": إنتاج احترافي
  • "pq_2": مستهلك
  • "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 باستخدام IMAAdsRequest:

  • أنشئ سلسلة JSON تتضمّن اهتمامات المستخدم أو سلوكه أو بياناته السياقية.
  • أنشِئ سلسلة ASCII بترميز Base64 من سلسلة JSON أعلاه.
  • أضِف السلسلة المشفّرة إلى عنوان URL لعلامة الإعلان باستخدام المَعلمة &ppsj=.
let userSignals = """
{
   "PublisherProvidedTaxonomySignals": [
    {
      "taxonomy": "IAB_AUDIENCE_1_1",
      "values": [
        "1",
        "284"
      ]
    }
  ],
}
"""
let base64Signals = Data(userSignals.utf8).base64EncodedString()
var encodedSignals = base64Signals.replacingOccurrences(of: "+", with: "%2B")
encodedSignals = encodedSignals.replacingOccurrences(of: "/", with: "%2F")
encodedSignals = encodedSignals.replacingOccurrences(of: "=", with: "%3D")


let finalAdTag = sampleAdTag + "&ppsj=" + encodedSignals