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

يمكنك إرسال بيانات الجمهور والسياق على أنّها إشارات مقدَّمة من الناشر (PPS) في طلبات الإعلانات. باستخدام ميزة 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 باستخدام 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;