تحسين الحملات الإعلانية باستخدام نموذج "التكلفة لكل تثبيت"
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك إرسال بيانات الجمهور والسياق على أنّها
إشارات مقدَّمة من الناشر
(PPS) في طلبات الإعلانات. باستخدام "الإشارات المقدَّمة من الناشر"، يمكنك استخدام بيانات المستخدمين لتحسين تحقيق الربح الآلي من خلال إعلام مقدِّمي عروض الأسعار بسمات جمهورك في جميع أنواع المعاملات، باستخدام التصنيفات العادية، بدون الحاجة إلى مشاركة معرّفات المستخدمين. يمكن أن تتضمن خصائص جمهورك بيانات السلوكية استنادًا إلى الاهتمامات (الإصدار 1.1 من تصنيف الجمهور الصادر عن مكتب IAB)، والبيانات السياقية (تصنيف المحتوى من IAB 2.2).
ويمكنك أيضًا إرسال الإشارات المنظَّمة المقدَّمة من الناشر، والتي تحدّدها Google، والسماح بإرسال إشارات إضافية.
إنشاء ملف JSON لإشارات المستخدم
في المستوى الأعلى، أنشئ عنصر JSON يتضمّن زوجًا واحدًا من المفتاح والقيمة. يجب أن يكون المفتاح
PublisherProvidedTaxonomySignals، ويجب أن تكون قيمته صفيفًا
من العناصر. يجب أن يتضمّن كل عنصر في المصفوفة زوجَي مفتاح/قيمة:
إنشاء صفيف الإشارات المنظَّمة
بالنسبة إلى الإشارات المنظَّمة، أضِف المفتاح 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": أمبير
|
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) باستخدام StreamRequest:
- أنشئ عنصرًا بتنسيق JSON يتضمّن اهتمامات المستخدم أو سلوكه أو بياناته السياقية.
- أنشِئ سلسلة ASCII بترميز Base64 من كائن JSON أعلاه.
- أضِف السلسلة المشفَّرة باستخدام
StreamRequest.adTagParameters.
const userSignals = {
"PublisherProvidedTaxonomySignals": [{
"taxonomy": "IAB_AUDIENCE_1_1",
"values": ["1", "284"]
}]
};
const encodedSignals = encodeURIComponent(window.btoa(JSON.stringify(userSignals)));
streamRequest.adTagParameters = { "ppsj" : encodedSignals };
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003ePublisher provided signals (PPS) let you share audience and contextual data with bidders to enhance programmatic ad monetization, using standard taxonomies like IAB Audience Taxonomy 1.1 and IAB Content Taxonomy 2.2, without revealing user identifiers.\u003c/p\u003e\n"],["\u003cp\u003eYou construct the user signals JSON with a "PublisherProvidedTaxonomySignals" key containing an array of objects, each specifying the taxonomy (e.g., "IAB_AUDIENCE_1_1") and corresponding taxonomy values.\u003c/p\u003e\n"],["\u003cp\u003eStructured signals, defined by Google, can be included using the "PublisherProvidedStructuredSignals" key with an array of objects representing signal types and their values.\u003c/p\u003e\n"],["\u003cp\u003eTo send PPS in stream requests, create a JSON object with user data, Base64-encode it, and add it to the \u003ccode\u003eStreamRequest.adTagParameters\u003c/code\u003e with the key "ppsj".\u003c/p\u003e\n"]]],["Publishers can enhance programmatic monetization by sending audience and contextual data (Publisher Provided Signals or PPS) in ad requests. This data, categorized using IAB taxonomies (Audience 1.1, Content 2.2) or publisher-defined structured signals, is sent to bidders without user identifiers. Data is structured in JSON, with keys for taxonomy (`IAB_AUDIENCE_1_1`, `IAB_CONTENT_2_2`) and values or specific types of data, and then Base64-encoded. This encoded string is added to the `StreamRequest.adTagParameters`.\n"],null,["# Improve ad campaigns with PPS\n\nYou can send audience and contextual data as\n[publisher provided signals](//support.google.com/admanager/answer/12451124)\n(PPS) in ad requests. With PPS, you can use your user data to improve\nprogrammatic monetization by communicating your audience characteristics to\nbidders in all\n[transaction types](//support.google.com/admanager/answer/2805834), using\nstandard taxonomies, without the need to share user identifiers. Your audience\ncharacteristics can include behavioral and interest-based data (\n[IAB Audience Taxonomy 1.1](//iabtechlab.com/standards/audience-taxonomy/)), and\ncontextual data (\n[IAB Content Taxonomy 2.2](https://iabtechlab.com/standards/content-taxonomy/)).\nYou can also send publisher provided structured signals, which are defined by\nGoogle, and allow for additional signals to be sent.\n\nConstruct the user signals JSON\n-------------------------------\n\nAt the top level, create a JSON object with a single key-value pair. The key\nshould be `PublisherProvidedTaxonomySignals`, and its value should be an array\nof objects. Each object in the array should have 2 key-value pairs:\n\n- The `taxonomy` key, which accepts the following values that are mapped to\n following IAB public specifications:\n\n - `IAB_AUDIENCE_1_1` for Audience Taxonomy 1.1\n - `IAB_CONTENT_2_2` for Content Taxonomy 2.2\n- The `values` key with a corresponding array of string taxonomy values.\n\n### Construct the structured signals array\n\nFor structured signals, add the `PublisherProvidedStructuredSignals` key with a\nvalue of an array of objects. Construct the object based on the following list\nof signal key-values: \n\n#### Toggle view of structured signals table\n\n| Signal | \"type\" Value | Possible `\"single_value\"` Values | Possible `\"values\"` Values |\n|--------------------|--------------------|-------------------------------------------------------------------------------------------|--------------------------------------------------------------------|\n| Audio Feed Type | `\"audio_feed\"` | - `\"af_1\"`: Music - `\"af_2\"`: Broadcast - `\"af_3\"`: Podcast | n/a |\n| Content Rating | `\"content_rating\"` | - `\"cr_1\"`: G - `\"cr_2\"`: PG - `\"cr_3\"`: T - `\"cr_4\"`: MA | n/a |\n| Content Delivery | `\"delivery\"` | n/a | - `\"cd_1\"`: Streaming - `\"cd_2\"`: Progressive - `\"cd_3\"`: Download |\n| Production Quality | `\"prodq\"` | - `\"pq_1\"`: Professionally Produced - `\"pq_2\"`: Prosumer - `\"pq_3\"`: User Generated (UGC) | n/a |\n\nSee the following example that uses the `IAB_AUDIENCE_1_1` and `IAB_CONTENT_2_2`\nfor taxonomy signals and includes structured signals. \n\n const userSignals = {\n \"PublisherProvidedTaxonomySignals\": [{\n \"taxonomy\": \"IAB_AUDIENCE_1_1\",\n \"values\": [\"6\", \"284\"]\n // '6' = 'Demographic | Age Range | 30-34'\n // '284' = 'Interest | Business and Finance | Mergers and Acquisitions'\n },\n {\n \"taxonomy\": \"IAB_CONTENT_2_2\",\n \"values\": [\"49\", \"138\"]\n // '49' = 'Books and Literature | Poetry'\n // '138' = 'Education | College Education | College Planning'\n }],\n \"PublisherProvidedStructuredSignals\": [{\n \"type\": \"audio_feed\",\n \"single_value\": \"af_1\",\n },\n {\n \"type\": \"delivery\",\n \"values\": [\"cd_1\", \"cd_3\"],\n },\n ],\n };\n\nConfigure your stream request\n-----------------------------\n\nFollow these steps to send PPS with your\n[`StreamRequest`](/interactive-media-ads/docs/sdks/caf-dai/reference/js/StreamRequest):\n\n- Create a JSON object with the user's interest, behavior, or contextual data.\n- Create a Base64-encoded ASCII string from the JSON object above.\n- Add your encoded string using [`StreamRequest.adTagParameters`](/interactive-media-ads/docs/sdks/caf-dai/reference/js/StreamRequest#adTagParameters).\n\n const userSignals = {\n \"PublisherProvidedTaxonomySignals\": [{\n \"taxonomy\": \"IAB_AUDIENCE_1_1\",\n \"values\": [\"1\", \"284\"]\n }]\n };\n\n const encodedSignals = encodeURIComponent(window.btoa(JSON.stringify(userSignals)));\n\n streamRequest.adTagParameters = { \"ppsj\" : encodedSignals };"]]
