الجمهور المحمي: دليل الدمج

تتضمّن ميزة "الجمهور المحمي" (المعروفة سابقًا باسم FLEDGE) في عمليات تنفيذ Android عادةً الدمج بين تطبيقات المعلِنين وتطبيقات الناشرين والبائعين والمشترين. هذا الدليل موجّه للشركاء الذين يخطّطون لإدارة شرائح الجمهور المخصّصة وإجراء المزادات، بما في ذلك شبكات تكنولوجيا الإعلان التي تعمل كمشترين وبائعين على حدٍ سواء. يمكن أن يكون للحملات الإعلانية المختلفة أهدافًا مختلفة، وقد لا يتمّ استخدام جميع ميزات Protected Audience في جميع حالات الاستخدام. يحاول هذا الدليل الإشارة إلى الخطوات اللازمة لدعم الحالات الأكثر تخصصًا كلما أمكن ذلك.

للاستعداد لنشر الإنتاج على نطاق واسع في Protected Audience، يمكن للشركاء البدء في الاختبار من خلال محاكاة نقاط الدمج مع أطراف أخرى. لمساعدتك في التخطيط للدمج، يوفّر هذا الدليل عرضًا شاملاً لكيفية دمج Protected Audience مع تطبيقات Android. وقد يشمل ذلك ميزات لم يتم تنفيذها بعد في المرحلة الحالية من "مبادرة حماية الخصوصية" على إصدار "معاينة المطوِّر" من Android. في هذه الحالات، يتم تقديم إرشادات الجدول الزمني.

يتألّف سير عمل عملية دمج "الجمهور المحمي" من 4 خطوات رئيسية تستند إلى أنواع مختلفة من شركاء تقنية الإعلان:

1. ينشئ المشتري شرائح جمهور مخصّصة.
2. تؤدي عملية اختيار الإعلانات إلى اختيار إعلان فائز.
   1. يبدأ تطبيق البائع في اختيار الإعلانات.
   2. تنفِّذ الخدمات الإعلانية فلترة من جهة الشراء ورمز عروض الأسعار.
   3. تنفّذ الخدمات الإعلانية رمز قرار جهة البيع.
3. يتم عرض الإعلان الفائز في تطبيق البائع.
4. تتوفر تقارير حول مرات ظهور الإعلان لكل من المشتري والبائع.

يوضِّح الرسم البياني التالي الخطوات التالية:

سير عمل اختيار الإعلانات وإدارة شرائح الجمهور المخصّصة في Protected Audience

المصطلحات

• المعلِن: شركة تجذب المستخدمين من خلال وسائل شراء المستودع الإعلاني.
• الناشر: شركة تبيع المساحة المتوفّرة للإعلانات مع المحتوى الخاص بها.
• المشتري: شركة تكنولوجيا إعلان تسهِّل شراء المستودع الإعلاني.
• البائع: شركة لتكنولوجيا الإعلان تسهِّل على الناشرين بيع المستودع الإعلاني.
• الشبكة: شركة لتكنولوجيا الإعلانات تعمل كمشتري وبائع في آنٍ واحد.
• مملوكة ومُدارة: شركة تعمل كناشر وبائع ومشتري.
• شركاء في عملية الدمج: أي شركات تحتاج إلى العمل معها لدمجها بنجاح مع Protected Audience API

المتطلّبات الأساسية وتفاعل الشركاء في عملية الدمج والإعداد

يوضّح هذا القسم مجموعة من الأنشطة الأولية لمساعدتك على فهم آلية عمل Protected Audience API، وكيفية بدء عملية دمج Protected Audience (الجمهور المحمي)، وكيفية التعامل مع الشركاء في عملية الدمج هذه في إطار تنفيذ آلية عمل "Protected Audience API". يمكن أن تحدث هذه الأنشطة بالتوازي.

دليل طرح ميزات "الجمهور المحمي"

التعرّف على الجمهور المحمي

الخطوة الأولى هي التعرّف على واجهات برمجة التطبيقات وواجهات برمجة التطبيقات Protected Audience API.

1. ابدأ بقراءة مقترح التصميم للتعرّف على Protected Audience API وإمكانياتها.
2. اقرأ دليل المطوّر لمعرفة كيفية دمج الرموز البرمجية وطلبات البيانات من واجهة برمجة التطبيقات التي تحتاجها لحالات استخدامك والخدمات اللازمة لدمجها مع Protected Audience.
3. أرسِل ملاحظات بشأن تصميم وتنفيذ واجهات برمجة التطبيقات Protected Audience API والخدمات والوثائق.
4. يمكنك الاشتراك لتلقّي آخر الأخبار للاطّلاع على أحدث ميزات "مبادرة حماية الخصوصية".

إعداد نماذج التطبيقات واختبارها

بعد أن تتعرّف على أساسيات "الجمهور المحمي" كما هو موضّح سابقًا، عليك إعداد نماذج التطبيقات واختبارها.

1. عندما تكون مستعدًا لبدء عملية الدمج، يمكنك إعداد بيئة التطوير باستخدام أحدث إصدار من معاينة المطوِّرين ضمن "مبادرة حماية الخصوصية".
2. عليك إعداد نقاط نهاية الخادم المطلوبة. استخدم نماذج تجريبية مع حل اختبار واجهة برمجة التطبيقات المفضل لديك لبدء هذه العملية.
3. شوكة الرمز وشغِّله في نموذج التطبيق للتعرف على إدارة الجمهور المخصص وسير عمل اختيار الإعلانات وإعداد تقارير مرات الظهور.

تفاعل الشركاء في عملية الدمج

حدِّد موعدًا لإجراء المناقشات مع شركاء الدمج لمناقشة اختبار ميزة "الجمهور المحمي" واستخدامها على Android، بما في ذلك تحديد شكل الإشارات التي يتم تبادلها بين الأطراف. بالنسبة إلى المشترين، يجب أن تتضمّن المناقشات استراتيجيات لإنشاء شرائح جمهور مخصّصة والانضمام إليها، والتي قد تشمل مناقشات حول كيفية تحديد شرائح الجمهور. تعاوَن مع شركائك في عملية الدمج لتحديد الجداول الزمنية للدمج، من الاختبار الأولي إلى الاعتماد، والمجالات التي يكون كل طرف مسئولاً عنها في التصميم.

إعداد الإصدار التجريبي (ستتوفّر خلال الربع الرابع من العام)

تسجيل مؤسستك في "مبادرة حماية الخصوصية" على Android التسجيل مطلوب لضمان أن يعمل مطوّرو تكنولوجيا الإعلان وفقًا لسياسات "مبادرة حماية الخصوصية"، ويسمح لمطوّري تكنولوجيا الإعلان بتحديد هويتهم على مستوى حِزم تطوير البرامج (SDK) والنطاقات المتعددة.

الاعتبارات المعمارية

بالنسبة إلى المشترين والبائعين على حدّ سواء، توفِّر ميزة "الجمهور المحمي" إمكانية عرض مزادات الإعلانات على الجهاز. يجب أن تضع أنت وشركاء التكامل في الاعتبار العديد من الاعتبارات المهمة في تصميماتك:

تخزين شرائح الجمهور وإعلانات تجديد النشاط التسويقي على الجهاز

وعلى النقيض من تخزين الإعلانات بالكامل على الخوادم في الوقت الحالي، يتم تخزين معلومات الجمهور وإعلانات تجديد النشاط التسويقي على الجهاز. أما بالنسبة إلى الإعلانات السياقية التي لا تعتمد على البيانات داخل الجهاز للاستهداف، فستظل متاحة على الخوادم. تحتاج منصات تكنولوجيا الإعلان إلى التوسّع لمراعاة طلب الإعلانات المنتشر بين الخوادم والأجهزة.

تتم عمليات عروض الأسعار والمزادات على الجهاز

بالإضافة إلى إجراء المزادات على الخوادم، تُتاح الآن لمنصات تكنولوجيا الإعلان تسعير وترتيب طلبات الإعلان المخزّنة على الجهاز.

هناك نهج شائع يتمثل في أن تُجري تقنيات الإعلان مزادات للإعلانات السياقية كما هي الحال في الوقت الحالي. وبعد الانتهاء من المزاد، يمكن للبائع اختيار إجراء مزاد على الجهاز لتقييم طلب تجديد النشاط التسويقي المُخزَّن على الجهاز. بما أنّ هذه العمليات تعمل الآن على الجهاز، من المهم تذكّر الحدود الحالية لضمان إجراء المزاد من البداية إلى النهاية كما صمّمه شركاء الدمج المختلفون، وذلك في مجموعة متنوّعة من حالات استخدام تجديد النشاط التسويقي.

إستراتيجية البيانات

يجب أن تراعي منصات تكنولوجيا الإعلان أنواع البيانات المستخدَمة في المزادات. وفي الوقت الحالي، يتم جمع هذه المعلومات من مصادر مختلفة ثم تجميعها في مكان واحد على الخادم. توفّر مزادات الجمهور المحمي عدّة مسارات مختلفة لتمرير تلك البيانات على سبيل المثال: تأتي الإشارات في الوقت الفعلي مثل الميزانية المتبقية من خدمة ذات قيمة أساسية كإشارات موثوقة، في حين يتم إرسال الإشارات السياقية مثل الوقت من اليوم من البائعين عند إجراء مزاد. يتم شرح هذه الإشارات بمزيد من التفصيل في الأقسام ذات الصلة من هذا الدليل.

بناء الحل

هناك عدّة مراحل رئيسية لإجراء مزاد باستخدام ميزة "الجمهور المحمي". على المشترين بناء الجمهور وتقديم بيانات عروض الأسعار وتوجيه الإعلانات لاستهداف شرائح الجمهور وإعداد عروض الأسعار. يجب على البائع إعداد المزاد وبدءه، وتقييم الإعلانات المرشحة، واختيار الفائز. تتطلب بعض هذه المراحل التعاون بين كلا الطرفين لضمان إمكانية تنفيذ المزاد بشكل صحيح. تصف الأقسام التالية كل مرحلة بالتفصيل وتوضح صراحةً الطرف المسئول عن التنفيذ.

المشترون: تكوين قاعدة جماهيرية

يدير المشترون عادةً شرائح الجمهور المخصّصة. نظرًا لإدارة الجماهير المخصّصة على الجهاز، تم تصميم واجهة برمجة التطبيقات لإدارة الجماهير المخصّصة ليتم استدعاؤها على الجهاز.

إذا كانت لديك حزمة تطوير برامج (SDK) خاصة بك في تطبيق المعلنين، يمكنك تنفيذ هذا الرمز مباشرةً من خلال joinCustomAudience().

إذا لم يكن لديك رمز حزمة SDK خاص بك على الأجهزة، يمكنك التعاون مع شريك دمج حالي موفّر حِزم SDK أيضًا. حدِّد هذا الشريك واعمَل معه لتحديد عقد وتدفق لتحديد شرائح الجمهور المخصّصة وإدارتها. يستخدم هذا الدليل مصطلح "المشتري" بغض النظر عن الأسلوب المستخدَم. تتضمن بعض أمثلة المناهج ما يلي:

• بصفته مشترٍ، اطلب من المعلِن تحديد شريحة جمهورك. يمكن لحزمة تطوير البرامج (SDK) الخاصة بشريك في عملية الدمج المثبَّتة على الجهاز إرسال أحداث التطبيقات إلى المشتري. عند استيفاء المعايير المحدَّدة مسبقًا، يرسل المشتري رسالة إلى حزمة تطوير البرامج (SDK) للانضمام إلى الجمهور المخصّص على العميل نيابةً عن المشتري.
• يمكن لحزمة تطوير البرامج (SDK) امتلاك الجمهور بشكل مباشر. يعمل المعلنون مع موفِّر حزمة تطوير البرامج (SDK) لتحديد الجمهور تراقب حزمة SDK أحداث التطبيق وانضم

حملة تجديد النشاط التسويقي للنموذج الأولي: تصميم جمهور مخصص

الجمهور المخصّص هو مجموعة من المستخدِمين الذين لديهم اهتمامات مشابهة ويمكن عرض إعلانات مخصّصة لها. يمكن للمشترين مساعدة المعلنين في إنشاء شرائح جمهور مخصّصة في تطبيقاتهم استنادًا إلى نشاط المستخدم.

ينشئ Protected Audience حاوية للجمهور المخصّص الذي يرتبط بتفاعل مخصّص معيّن للمستخدم على النحو الذي حدّده المعلِن. ويشمل ذلك مجموعة من الإعلانات المرشحة التي يمكن عرضها لهذا الجمهور، ومجموعة من منطق عروض الأسعار المخصّصة والبيانات التي يمكن استخدامها خلال المزاد لفلترة الإعلانات وتسعيرها.

الإعداد والنموذج الأولي

• استخدِم واجهة برمجة تطبيقات الجمهور المخصّص لإنشاء وتخزين شريحة جمهور على الجهاز يمكن استخدامها لاحقًا في مزاد.
• راجِع دليل المطوِّر لمعرفة تفاصيل حول التنفيذ واستخدام واجهة برمجة التطبيقات.

اعتبارات التصميم

يمكن للمشترين التعامل مع مجموعة متنوعة من حالات الاستخدام من خلال إعداد الجماهير المخصّصة. ويشمل ذلك تحديد منطق عروض الأسعار لنوع الإعلان أو الحملة التي يستهدفها هذا الجمهور، وتحديد قائمة الإعلانات المرشحة، والاعتبارات المماثلة. يتضمن هذا القسم اعتبارات التصميم لتعبئة بعض الحقول الرئيسية واستخدامها في الجمهور المخصص.

عنوان URL لمنطق عروض الأسعار

ونظرًا لتنفيذ المزادات على الجهاز، يحتاج المشترون إلى نشر نقطة نهاية يمكنها عرض منطق عروض الأسعار مثل JavaScript. يصف دليل المطوّر توقيعات الطرق المطلوبة. يمكن لمنطق عروض الأسعار الوصول إلى إشارات معيّنة حول المستخدم أثناء المزاد كما هو موضّح في الأقسام القليلة التالية. شرح منطق عروض الأسعار وإعداد إشارات المستخدِم لاحقًا في هذه المقالة

إشارات عروض أسعار المستخدِمين

ويمكن للمشترين استخدام UserBiddingSignals لنقل المعرفة التي تتوفّر لدى المعلِن أو المشتري نفسه بشأن المستخدم، وذلك في المزادات المستقبلية على الجهاز. يمكن أن يشمل ذلك معلومات مثل:

• شرائح الجمهور الأخرى التي تمت إضافة المستخدم إليها
• إحصاءات الطرف الأول التي تتوفّر لدى المعلِن حول المستخدم

وبما أنّ هذه الإشارات متوفّرة خلال المزاد، يمكن للمشترين تنفيذ عمليات عروض أسعار مخصّصة خلال المزاد، بما في ذلك:

• رفع عروض الأسعار أو خفضها استنادًا إلى إشارات عروض الأسعار
• تصفية إعلانات محددة من المزاد.

بيانات عروض الأسعار الموثوق بها

كجزء من تنفيذ ميزة "الجمهور المحمي"، يمكن للمشترين الوصول إلى المعلومات في الوقت الفعلي أثناء المزاد من خدمة ذات قيمة أساسية. وكآلية مؤقتة، يمكن للمشتري والبائع استرجاع إشارات عروض الأسعار هذه من أي خدمة، بما في ذلك الخدمة التي يديرونها بأنفسهم. المثال الأكثر شيوعًا هو البحث عن الميزانية المتبقية للإعلانات أثناء التطوير، من الممكن عمل نموذج تجريبي لهذه الخدمة، ويمكنك التطوير مقابل نقطة النهاية الوهمية هذه. يمكنك الاطّلاع على دليل FledgeServerSpec في نموذج مستودع التطبيق على GitHub للحصول على تعليمات الإعداد.

يتكون الحقل TrustedBiddingData من عنوان URL ومجموعة من المفاتيح. فيما يلي بعض الاعتبارات عند تصميم نوع الهيكل الأساسي المطلوب استخدامه:

• النهج البسيط هو تضمين مفتاح يحدد نسبة 1:1 للجمهور الذي يتم إنشاؤه. يمكن أن تحتوي خدمة القيمة الرئيسية بعد ذلك على جميع المعلومات المرتبطة بالجمهور.
• من الأهمية بمكان أن تكون الميزانية وحالة الإعلان من الأمور المهمة التي يجب وضعها في الاعتبار في الوقت الفعلي.
• الحد الأقصى لمبلغ عرض السعر أو الإشارات الأخرى التي يمكن استخدامها لتسعير إعلان في المزاد. من الممكن تضمين هذه المعلومات مع الإعلان في قائمة AdData، ولكنّ تخزين هذه المعلومات في خدمة ذات قيمة أساسية يسمح بتعديلها بسهولة أكبر حسب الحاجة.

قائمة بيانات الإعلانات

عند إنشاء حملة تجديد نشاط تسويقي، يراعي المعلِنون عادةً العديد من أنواع الإعلانات المختلفة التي تُعرض على المستخدِم ضمن شريحة جمهور معيّنة، مثل الإعلان عن خصومات مختلفة استنادًا إلى التفاعل السابق للمستخدم مع التطبيق. ويتضمّن الجمهور المخصّص قائمة AdData تحتوي على الإعلانات المرشَّحة للمستخدمين.

ويرجع قرار الشراء إلى المبلغ الذي يجب تضمينه في كل إعلان. بعض الأشياء التي يجب مراعاتها:

• يمكن تعديل قائمة AdData بطريقتَين:
  • عندما يتضمّن التطبيق نشاطًا مرئيًا في المقدّمة، يمكنه بدء القائمة عند ضم مستخدم إلى جمهور مخصّص.
  • أثناء التحديث اليومي، يتم بدء عملية الجلب في الخلفية. يرسل الجهاز طلبًا إلى daily_update_url ضمن مكالمة joinCustomAudience ويتوقّع ردًا يتضمن قائمة AdData معدّلة.
• يمكنك طلب معلومات إضافية عن الإعلانات في وقت إجراء المزاد. قبل المزاد، يرسل الجهاز طلبًا إلى خدمة مفتاح القيمة للمشترين التي تم توفيرها في حقل trustedBiddingData في joinCustomAudience. الخدمة ذات القيمة الأساسية هي خدمة جديدة تشكّل جزءًا من تنفيذ المشترين لميزة "الجمهور المحمي". ويتم شرح المزيد من التفاصيل حول هذه الخدمة لاحقًا في هذا المستند.
• يمكن أن يساعدك تضمين رقم تعريف تصميم إعلان لإعلانك في اتخاذ إجراءات معيّنة بشأن تصميمات إعلانات معيّنة. على سبيل المثال، قد يتوقف المعلنون مؤقتًا عن تصميمات إعلانات معيّنة، وتريد سحب أرقام تعريف تصاميم الإعلانات هذه من خدمة قيم المفاتيح في الوقت الفعلي، ثم مطابقتها مع الإعلانات الموجودة في قائمة AdData.

يجب أن يتضمّن AdData render_url. ويتمّ استخدام عنوان URL المعروض لإعلان تجديد النشاط التسويقي الفائز من أجل عرض الإعلان. تشمل بعض الاعتبارات ما يلي:

• يتضمن عنوان URL للعرض حدًا أدنى للمجهول المصدر، لذا تجنَّب تضمين المعلَمات الضيقة. وسيتم نشر المزيد من المعلومات حول هذا الحدّ الأدنى للمجهول في التصنيف في وقت لاحق.
• يجب أن يحتوي عنوان URL هذا على جميع المعلومات اللازمة لعرض الإعلان. على سبيل المثال، إذا كنت تريد عرض منتجات معيّنة، عليك تضمين معرّفات المنتجات كمَعلمات في عنوان URL.

أثناء إنشاء النماذج الأولية، الحقل الوحيد المطلوب هو renderUri، الذي يشير إلى مواد عرض عرض الإعلان. يمكن تجاهل حقل البيانات الوصفية في AdData أثناء إنشاء الحلّ. أثناء انتقالك إلى الإنتاج، يجب أن تفكر في البيانات الوصفية ذات الصلة بك حيث يمكن استخدامها أثناء إنشاء عروض الأسعار لتعديل سعر عرض السعر.

وقت التفعيل ووقت انتهاء الصلاحية

يمكنك استخدام حقلَي التفعيل وانتهاء الصلاحية لدعم حالات الاستخدام التي يجب أن يكون فيها الجمهور المخصّص مؤهَّلاً فقط للمزادات خلال فترة زمنية محدّدة مسبقًا. ويجب الانتباه إلى أنّ هناك قيودًا معيّنة تحدّ من المدة التي يمكن أن يتأخّر فيها وقت التفعيل والفرق بين وقت التفعيل ووقت انتهاء الصلاحية. تتضمن أمثلة حالات الاستخدام ما يلي:

• مستخدم غير نشط (مثل مستخدم لم يتفاعل مع تطبيق المعلِن في آخر 7 أيام)
  • وفي كل مرة يفتح فيها المستخدم التطبيق، يمكن للمشتري الاتصال بالرقم joinCustomAudience وضبط activation_time ليكون طابعًا زمنيًا للمدة 7 أيام في المستقبل.
  • يكون الجمهور مؤهَّلاً لاستخدام عروض الأسعار في حال مرور 7 أيام منذ آخر مرة فتح فيها المستخدِم التطبيق.
• جمهور موسمي (وهو جمهور صالح فقط خلال إطار زمني محدد في المستقبل القريب)
  • يمكن للمشتري البدء في تحديد شرائح الجمهور المخصّصة مقدمًا والتي يجب أن تكون مؤهَّلة فقط لتقديم عروض الأسعار خلال فترة محدّدة مسبقًا في المستقبل (القريب).
  • على سبيل المثال، إذا أطلق معلِن حملة نهاية الصيف في الولايات المتحدة في عام 2022، يمكن للمشتري الاتصال بالرقم joinCustomAudience وضبط activation_time ليصبح يوم السبت 20 آب (أغسطس) 2022. إذا تم إطلاق الحملة لمدة أسبوع واحد فقط، يمكن للمشتري تحديد تاريخ انتهاء الصلاحية على 27 آب (أغسطس) 2022، وبعد ذلك تتم فلترة الجمهور المخصّص من خلال المنصة أثناء اختيار الإعلانات وجمع البيانات غير المرغوب فيها في النهاية.

المشترون والبائعون: اختيار الإعلانات

تتطلب اختيار الإعلانات التعاون بين المشترين والبائعين. يمكن النظر إلى ذلك كعملية من أربع خطوات:

1. يحدّد البائعون استراتيجية التوسّط.
2. يحدّد البائعون المزاد ويبدأون اختيار الإعلانات.
3. تتم دعوة المشترين للمشاركة في المزاد من خلال عملية الإعداد التي يحدّدها البائع. يتم تنفيذ منطق عروض أسعار المشتري لاختيار إعلان وعرض سعر مرشح.
4. يتمّ تنفيذ منطق قرارات البائعين لتقييم المرشحين واختيار إعلان فائز.

لتسهيل عملية التطوير، من الممكن محاكاة استجابات الخدمة للمشترين والبائعين، ويشمل ذلك منطق عروض الأسعار ورصد النتائج، ما يسمح لك بالتركيز على تطوير الإجراءات ذات الصلة بحالة الاستخدام. يمكنك الاطّلاع على دليل FledgeServerSpec على GitHub للحصول على تعليمات حول إعداد نقاط نهاية تجريبية أو دليل المطوّر للحصول على تعليمات حول كيفية إلغاء الحاجة إلى استرجاع نقاط النهاية عن بُعد باستخدام JavaScript.

البائعون: تحديد استراتيجية التوسط

تهدف ميزة Protected Audience إلى دعم توسّط العرض الإعلاني بدون انقطاع. هذا المجال قيد التطوير، وسيتم توفير المزيد من المعلومات عند توفرها. في الوقت الحالي، يُرجى الرجوع إلى اقتراح التصميم لتوسّط العرض الإعلاني بدون انقطاع في "الجمهور المحمي".

البائعون: ضبط المزاد

البائعون مسؤولون عن تهيئة المزاد وتقديم المعلومات اللازمة لعملية اختيار الإعلانات. يمكن للبائعين اختيار إتاحة المعلومات لجميع الأطراف أو الأطراف المحددة فقط. يمكن أن يشمل ذلك معلومات تمتلكها أو معلومات تُدرجها نيابةً عن المشترين.

الإعداد والنموذج الأولي

• يمكن للبائع إعداد مزاد وبدئه من خلال إعداد عنصر AdSelectionConfig واستخدام واجهة برمجة التطبيقات AdSelection. ابدأ المزاد من خلال استدعاء selectAds().
• راجِع دليل المطوِّر لمعرفة تفاصيل حول التنفيذ واستخدام واجهة برمجة التطبيقات.

اعتبارات التصميم

يتضمّن هذا القسم اعتبارات التصميم لتعبئة الحقول الرئيسية واستخدامها في إعدادات اختيار الإعلانات.

• لا تتضمّن بيئة التنفيذ الخاص سوى إعلانات الجمهور المخصّص على الجهاز، لذا فإن إصدار طلب إعلان سياقي مسبقًا يتيح لك مراعاة الطلب الإضافي.

• قبل بدء عملية اختيار الإعلانات، ننصحك بتقديم طلب إعلان لجمع المعلومات من المشترين. بعد ذلك، استخدِم هذه المعلومات لضبط اختيار الإعلانات

• نظرًا لأنه كان بإمكان العديد من المشترين إنشاء شرائح جمهور مخصّصة على الجهاز، على البائعين استخدام حقل شراة الجمهور المخصّص للإشارة إلى المشترين المحدّدين الذين سيتم تضمينهم في العملية. هناك العديد من الطرق التي يمكن من خلالها إنشاء هذه القائمة. ومن الأمثلة على ذلك:

  • قائمة ثابتة بالمشترين التي يرغب البائع دائمًا في تضمينها في العملية.
  • قائمة بالمشترين الذين يشيرون إلى رغبتهم في المشاركة في استجابة إعلاناتهم. يُعدّ هذا الخيار مفيدًا إذا كان البائع يستخدِم تبادلات الإعلانات وقد لا يكون لديه معرفة كاملة بجميع المشترين.

• يمكن للبائع تمرير المعلومات إلى العملية بعدة طرق:

  • يتوفّر حقل إشارات اختيار الإعلان لجميع المشترين والبائعين المشاركين في المزاد في وقت التشغيل الخاص. ويمكنك استخدامها لتقديم معلومات عن فرصة الإعلان مثل حجم الإعلان وشكله.
  • تتم إعادة توجيه الحقل إشارات لكل مشترٍ إلى مشترٍ معيّن لاستخدامه في عملية تقديم عروض الأسعار. يتم تقديم هذه المعلومات من قِبل المشتري، وعليك أنت بصفتك البائع التفكير في كيفية الحصول على هذه المعلومات على الجهاز لاستخدامها أثناء اختيار الإعلان.
  • حقل إشارات البائع هو الطريقة النهائية التي يمكن للبائع من خلالها تمرير المعلومات إلى العملية. بصفتك بائعًا، تستخدم هذه الإشارات عند تسجيل الإعلانات وفلترة الإعلانات، مثل تفعيل ميزة "التحقّق من أمان العلامة التجارية".

المشترون: تقديم عروض الأسعار لشريحة إعلانية

الإعداد والنموذج الأولي

• يمكن للمشتري إضافة منطق عروض الأسعار إلى دالة JavaScript generateBid() التي يتم عرضها من مجموعة المعلَمة biddingLogicUrl عند إنشاء CustomAudience. يمكنك إعداد خدمة وهمية باستخدام المواصفات المقدَّمة أو تطبيق نقطة النهاية هذه على خادم حقيقي.
• راجِع دليل المطوِّر لمعرفة تفاصيل حول التنفيذ واستخدام واجهة برمجة التطبيقات.

اعتبارات التصميم

• يتم تنفيذ منطق عروض الأسعار على الجهاز، ويتم الاستعلام عن بعض الإشارات المستخدَمة في المزاد في الوقت الفعلي. راجِع قائمة القيود للاطّلاع على القيود.
• بالنسبة إلى بعض حالات استخدام الإعلانات، من المهم التعاون مع البائع لضمان توفُّر العديد من المرشحين للإعلانات وعروض أسعارهم التي يمكن أخذها في الاعتبار على الجهاز.

تصميم منطق عروض الأسعار

يجب تنفيذ منطق عروض الأسعار للمشترين عبر JavaScript وتنفيذه على الجهاز. يحتوي دليل المطوِّر على معلومات عن التوقيع المطلوب وتفاصيل حول المَعلمات المختلفة التي تم تمريرها خلال المزاد. ويمكن لمنطق عروض الأسعار على الجهاز الوصول إلى معلومات إضافية، يتم تمريرها كمعلَمات لدالة generateBid().

توفير بيانات عروض الأسعار

إشارات عروض الأسعار في الوقت الفعلي مع خدمات القيمة الرئيسية

وبصفتك مشترٍ، يمكنك استرجاع إشارات في الوقت الفعلي خلال مزاد من خدمة ذات قيمة أساسية تملكها. يمكنك العثور على عملية تنفيذ أولية لهذه الخدمة في مستودع "مبادرة حماية الخصوصية" العام، أو يمكنك إنشاء خدمة خاصة بك. يتم تحديد عنوان URL لهذه الخدمة على أنّه trustedBiddingUrl في شريحة جمهور مخصّصة، ويحاول النظام الأساسي استرجاع البيانات وإتاحتها لدالة generateBid باستخدام trusted_bidding_signals parameter. تحتاج إلى إنشاء هيكل المفتاح الخاص بك.

الإشارات السياقية وإشارات المستخدِمين

يمكن لدالة generateBid الوصول إلى إشارات مستخدم إضافية عند إجراء المزاد على الجهاز. يتم تمرير هذه الإشارات مع الحقلَين contextual_signals وper_buyer_signals. هذه الحقول هي جميع كائنات JSON التي يجب تحديد تنسيقها من قبل المشترين والبائعين.

يتضمّن الحقل contextual_signals معلومات قد تكون ذات صلة بالمستخدم. يتم إنشاء العنصر الذي يتضمّن هذه الإشارات من خلال Protected Audience نفسها ويتم تمريرها إلى منطق عروض أسعارك. يتم تمرير هذا حاليًا ككائن فارغ. إذا كنت تعتقد أنّ هناك إشارة سياقية عن المستخدم قد تكون ذات صلة بحالة الاستخدام، يُرجى تقديم ملاحظات للنظر فيها.

يتوفّر الحقل per_buyer_signals لمنطق عروض الأسعار لديك. يعيّن البائع هذه القيم عند إنشاء تهيئة المزاد. ويجب أن يتعاون المشترين والبائعون لضمان حفظ هذه البيانات على الأجهزة وتمريرها إلى منطق عروض أسعارك. تتضمن بعض الأمثلة على استخدامات هذا الحقل ما يلي:

• الفلترة للحفاظ على أمان العلامة التجارية يمكن للبائع السماح للمشترين بمعرفة بعض معلومات التصنيف حول التطبيق الذي يطلب إعلانًا، ويمكن للمشتري استخدام هذه المعلومات لتصفية إعلانات معينة.
• إرسال تضمين لنموذج تعلُّم الآلة مع مراعاة المعلومات السياقية

البائعون: سجِّل الأهداف واختر الإعلان الفائز

الإعداد والنموذج الأولي

• يمكن للبائع إضافة منطق النتائج الخاص به إلى دالة JavaScript scoreAd() التي يتم عرضها من مجموعة معلَمات scoringLogicUrl عند إنشاء AdSelectionConfig. يمكنك إعداد خدمة وهمية باستخدام المواصفات المقدَّمة أو تطبيق نقطة النهاية هذه على خادم حقيقي.
• راجِع دليل المطوِّر لمعرفة تفاصيل حول التنفيذ واستخدام واجهة برمجة التطبيقات.

تصميم منطق تسجيل النقاط

ينفّذ البائعون منطقًا لتسجيل النتائج في JavaScript، ويتم تنفيذه على الجهاز. يحتوي دليل المطوِّر على معلومات عن التوقيع المطلوب وتفاصيل عن المعلَمات المختلفة التي تم تمريرها خلال المزاد. بالإضافة إلى ذلك، يمكن لمنطق النتائج على الجهاز الوصول إلى معلومات إضافية يتم تمريرها كمعلَمات لدالة scoreAd.

توفير بيانات النتائج

إشارات تسجيل النتائج في الوقت الفعلي باستخدام خدمات القيم الأساسية

وبصفتك بائعًا، يمكنك استرجاع الإشارات في الوقت الفعلي خلال مزاد من خدمة ذات قيمة أساسية تملكها. يمكنك العثور على عملية تنفيذ أولية لهذه الخدمة في مستودع "مبادرة حماية الخصوصية" العام. يتم تحديد عنوان URL لهذه الخدمة على أنّه trustedScoringUri في إعدادات المزاد، وتحاول المنصة استرجاع البيانات وإتاحتها لدالة scoreAd من خلال مَعلمة trusted_scoring_signals. يجب عليك إنشاء الهيكل الرئيسي الخاص بك.

الإشارات السياقية وإشارات المستخدِمين

يمكن لوظيفة "scoreAd" الوصول إلى إشارات المستخدم الإضافية عند إجراء المزاد على الجهاز. ويتم تمرير هذه الإشارات إلى دالة التسجيل من خلال الحقل contextual_signal. يحتوي هذا الحقل على كائنات JSON التي يحدد المشترين والبائعون تنسيقها.

يتضمّن الحقل contextual_signal معلومات سياقية قد تكون ذات صلة بالمستخدم. يتم إنشاء العنصر الذي يتضمّن هذه الإشارات من قِبل Protected Audience نفسها، ويتم تحديد هذه البيانات وفقًا لمنطق النتائج الخاص بك. يتم تمرير هذا ككائن فارغ. إذا كنت تعتقد أنّ هناك إشارة بشأن المستخدم قد تكون ذات صلة بحالة استخدامك، يُرجى تقديم ملاحظاتك للنظر فيها.

البائعون: عرض إعلان

يجب أن يعرض البائعون الإعلان الفائز. ارجع إلى اقتراح التصميم للحصول على تفاصيل إضافية عن كيفية عرض الإعلانات الفائزة. هذه المنطقة لا تزال قيد التصميم.

تسجيل نتائج مرات الظهور

الإعداد والنموذج الأولي

• يمكن للمشترين والبائعين إضافة منطق إعداد التقارير إلى دالة JavaScript reportWin() التي يتم عرضها من خلال المعلَمة biddingLogicUrl أو scoringLogicUrl على التوالي. يمكنك إعداد خدمة وهمية باستخدام المواصفات المقدَّمة أو تطبيق نقطة النهاية هذه على خادم حقيقي.
• راجِع دليل المطوِّر لمعرفة تفاصيل حول التنفيذ واستخدام واجهة برمجة التطبيقات.

اعتبارات التصميم

على المشترين والبائعين تنفيذ الدالة reportWin في رمز JavaScript الذي يعرضه نقاط النهاية التي تم ضبطها. تتيح لك هذه الطريقة إعادة إرسال البيانات إلى خوادمك.

توفّر "مبادرة حماية الخصوصية" أيضًا Attribution Reporting API لإدارة التقارير المجمَّعة وعلى مستوى الحدث. يمكنك قراءة دليل الدمج للاطّلاع على مزيد من التفاصيل.