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

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

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

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

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

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

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

المصطلحات

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

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

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

رسم بياني يعرض دليل طرح ميزات "الجمهور المحمي"
دليل الطرح لميزات "الجمهور المحمي"

التعرّف على Protected Audience

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

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

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

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

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

تفاعل شريك التكامل

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

إعداد الإصدار التجريبي (متاح في الربع الرابع)

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

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

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

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

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

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

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

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

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

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

إنشاء الحلّ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

قائمة AdData

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

يحدّد المشترون مقدار المعلومات المطلوب تضمينها في كل إعلان. إليك بعض النقاط التي يجب أخذها في الاعتبار:

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

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

  • يحتوي عنوان URL لعرض الإعلان على حدّ أدنى من مستوى إخفاء الهوية، لذا تجنَّب تضمين معلَمات محدودة. سيتم نشر المزيد من المعلومات حول حدّ إخفاء الهوية بالاستناد إلى عدد k في وقت لاحق.
  • يجب أن يحتوي عنوان 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().
  • اطّلِع على دليل المطوّر لمعرفة تفاصيل التنفيذ واستخدام واجهة برمجة التطبيقات.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

إشارات عروض الأسعار في الوقت الفعلي باستخدام خدمات "مفتاح/قيمة"

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

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

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

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

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

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

البائعون: احتساب النقاط واختيار الإعلان الفائز

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

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

منطق احتساب النقاط في التصميم

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

تقديم بيانات التقييم

إشارات التقييم في الوقت الفعلي باستخدام خدمات "مفتاح/قيمة"

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

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

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

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

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

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

الإبلاغ عن نتائج مرّات الظهور

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

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

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

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

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