الإشارات التي يقدّمها الناشر

يمكنك إرسال الجمهور والبيانات السياقية على شكل إشارات مقدَّمة من الناشر (PPS) في طلبات الإعلان. مع PPS، يمكنك استخدام بيانات المستخدمين لتحسين تحقيق الربح الآلي من خلال إعلام مقدمي عروض الأسعار بخصائص جمهورك في جميع أنواع المعاملات، وذلك باستخدام التصنيفات العادية بدون الحاجة إلى مشاركة معرّفات المستخدمين. يمكن أن تشمل خصائص جمهورك البيانات السلوكية واستنادًا إلى الاهتمامات ( تصنيف الجمهور IAB 1.1) والبيانات السياقية ( تصنيف المحتوى 2.2 الصادر عن مكتب IAB). يمكنك أيضًا إرسال الإشارات المنظَّمة المقدّمة من الناشر التي تحدّدها 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": طن
  • "cr_4": MA
 timing fixed in amara
عرض المحتوى "delivery" timing fixed in amara
  • "cd_1": البث
  • "cd_2": متدرّجة
  • "cd_3": تنزيل
جودة الإنتاج "prodq"
  • "pq_1": تم إنتاجه باحتراف
  • "pq_2": مستهلكي المنتجات
  • "pq_3": محتوى من إنشاء المستخدمين (UGC)
 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"],
    },
  ],
};

ضبط طلب الإعلان

اتّبِع الخطوات التالية لإرسال إشارات مقدَّمة من الناشر باستخدام AdsRequest:

  • أنشِئ كائن JSON يتضمّن اهتمامات المستخدم أو سلوكه أو بياناته السياقية.
  • أنشئ سلسلة ASCII بترميز Base64 من كائن JSON أعلاه.
  • ألحِق السلسلة المشفرة بعنوان URL لعلامة إعلانك باستخدام المعلمة &ppsj=.
const userSignals = {
  "PublisherProvidedTaxonomySignals": [{
     "taxonomy": "IAB_AUDIENCE_1_1",
     "values": ["1", "284"]
  }]
};

const sampleAdTag = "https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s"

const encodedSignals = encodeURIComponent(window.btoa(JSON.stringify(userSignals)));

const finalAdTag = sampleAdTag + "&ppsj=" + encodedSignals;