"مطابقة ملفات تعريف الارتباط" هي ميزة تتيح لك مطابقة ملف تعريف الارتباط الخاص بك، مثل معرّف مستخدم تصفّح موقعك الإلكتروني، مع معرّف مستخدم Google مطابق خاص بمقدّم عروض معيّن، وإنشاء قوائم مستخدمين يمكن أن تساعدك في اتّخاذ خيارات عروض أسعار أكثر فعالية. يوضّح هذا الدليل المفاهيم المستخدَمة في ميزة "مطابقة ملفات تعريف الارتباط"، بالإضافة إلى سير العمل المختلفة لهذه الميزة وأي اختلافات قد تحدث في بعض حالات الاستخدام.
المفاهيم
ما هي عملية مطابقة ملفات تعريف الارتباط؟
يحدّد مالكو النطاقات عادةً محتوى ملفات تعريف الارتباط للمستخدمين الذين يتصفّحون مواقعهم الإلكترونية، ويتم استخدام هذه الملفات لتحديد المستخدمين ضمن هذا النطاق. حتى إذا وافق مالكا نطاقَين على تبادل هذه البيانات، فإنّ نموذج الأمان في متصفحات الإنترنت يمنع أحدهما من قراءة ملف تعريف ارتباط تم ضبطه بواسطة نطاق آخر.
في سياق الإعلانات الرقمية، تحدّد Google المستخدمين من خلال ملفات تعريف الارتباط التي تنتمي إلى النطاق doubleclick.net، وقد يكون لدى مقدّمي عروض الأسعار المشاركين في عروض الأسعار في الوقت الفعلي نطاقهم الخاص الذي يحدّدون فيه مجموعة من المستخدمين الذين يريدون عرض الإعلانات لهم. تتيح ميزة "مطابقة ملفات تعريف الارتباط" مقدّم العرض مطابقة ملفات تعريف الارتباط الخاصة به مع ملفات تعريف الارتباط من Google، ما يتيح له تحديد ما إذا كان ظهور الإعلان الذي تم إرساله في طلب عرض السعر مرتبطًا بأحد المستخدمين المستهدَفين، وسيتلقّى إما بيانات ملفات تعريف الارتباط الخاصة به أو معرّف مستخدم Google خاصًا بمقدّم العرض وهو شكل مشفّر من ملف تعريف الارتباط doubleclick.net في طلب عرض السعر.
تسهّل خدمة مطابقة ملفات تعريف الارتباط الموضّحة في هذا الدليل عملية إنشاء الربط بين ملف تعريف ارتباط مقدّم العروض ورقم تعريف المستخدم على Google والحفاظ على هذا الربط، كما تتيح ملء قوائم المستخدمين.
جداول المطابقة
يمكن استخدام جدول مطابقة لربط رقم تعريف أو بيانات أخرى من نطاق بنطاق آخر. يمكن مقدّمي عروض الأسعار استخدام "خدمة مطابقة ملفات تعريف الارتباط" لملء جداول المطابقة الخاصة بهم من خلال ربط ملف تعريف الارتباط الخاص بمستخدم معيّن بمعرّف المستخدم على Google، أو لملء جدول مطابقة تستضيفه Google. تكون جداول المطابقة ضرورية لتطبيق مقدّم العروض كي يتمكّن من الوصول إلى بيانات ملفات تعريف الارتباط الخاصة بالمستخدم الذي يتم عرض مرّة الظهور له.
جداول المطابقة المستضافة على Google
لتسهيل الصيانة وتحسين وقت الاستجابة وإتاحة الوصول إلى بيانات المطابقة للمستخدمين في مناطق معيّنة، ننصحك بالسماح لشركة Google باستضافة جدول المطابقة. يتيح لك ذلك تحديد سلسلة مرمّزة بتنسيق Base64 الآمن على الويب، والتي يُشار إليها لاحقًا باسم بيانات المطابقة المستضافة، وسيتم ربطها بمعرّف مستخدم Google لمستخدِم معيّن. بعد إثبات التطابق، يمكن استخدام المعلومات بالطرق التالية:
عروض الأسعار في الوقت الفعلي: في طلبات عروض الأسعار اللاحقة الخاصة بمرّات الظهور المرتبطة بالمستخدم، سترسل إليك Google بيانات المطابقة المستضافة التي طابقتها مع معرّف المستخدم على Google. ستحدّد Google
BidRequest.user.buyeruidكسلسلة مشفّرة باستخدام base64 الآمن على الويب.قوائم المستخدمين: يمكن ملء قوائم المستخدمين إما بأرقام تعريف المستخدمين على Google أو ببيانات المطابقة المستضافة.
- الاستهداف المسبق: يمكنك ضبط الاستهداف المسبق بحيث تتلقّى طلبات عروض أسعار تحتوي فقط على بيانات المطابقة المستضافة. ويمكن استخدام ذلك لإزالة مرّات الظهور الأقل صلة بالموضوع للمستخدمين خارج مساحة ملفات تعريف الارتباط.
قوائم المستخدمين
يمكن إنشاء قوائم المستخدمين وإدارتها باستخدام Real-Time Bidding API. بعد إنشاء هذه القوائم، يمكنك ملؤها باستخدام سير عمل "مطابقة ملفات تعريف الارتباط" التالي، أو من خلال خدمة التحميل المجمّع.
البدء
لبدء استخدام ميزة "مطابقة ملفات تعريف الارتباط"، عليك التواصل مع مدير حسابك الفني الذي يمكنه تفعيل سير عمل محدّد ومساعدتك في ضبط ما يلي:
- معرّف شبكة مطابقة ملفات تعريف الارتباط (NID): هو معرّف سلسلة يحدّد بشكل فريد حساب مقدّم عروض أسعار لإجراء عمليات مطابقة ملفات تعريف الارتباط وغيرها من العمليات ذات الصلة.
- عنوان URL لمطابقة ملفات تعريف الارتباط: عنوان URL الأساسي لنقطة نهاية ستقبل الطلبات الواردة وتعالجها كجزء من سير عمل مطابقة ملفات تعريف الارتباط. يمكن مقدّمي عروض الأسعار تضمين وحدات ماكرو في عنوان URL هذا للتحكّم في ترتيب المَعلمات التي يتم تمريرها إليه في سير عمل "مطابقة ملفات تعريف الارتباط".
- علامة المطابقة: هي العلامة التي يجب وضعها في متصفّح المستخدم من أجل سير عمل "مطابقة ملفات تعريف الارتباط" الذي يبدأه مقدّم عروض الأسعار. ويمكن عرض هذا المحتوى بجانب الإعلانات أو وضعه على مواقع إلكترونية خارج الإعلانات.
- عنوان URL لتقرير مطابقة ملفات تعريف الارتباط (اختياري): في سير عمل مطابقة ملفات تعريف الارتباط أحادي الاتجاه، يكون هذا عنوان URL اختياريًا يمكن تقديمه لتحديد نقطة نهاية ستتلقّى تفاصيل الخطأ في حال تعذُّر مطابقة ملفات تعريف الارتباط من خلال عملية إعادة توجيه HTTP 302. بشكلٍ تلقائي، لن يتم إرسال الردود إلى عنوان URL هذا إلا إذا حدث خطأ في عملية مطابقة ملفات تعريف الارتباط، ولكن يمكن أن يطلب مقدّمو عروض الأسعار إرسال عملية إعادة التوجيه دائمًا.
- عنوان URL الخاص بأداة Cookie Match Assist: بالنسبة إلى منصات التبادل التي تنفّذ سير عمل أداة Cookie Match Assist، هذا هو عنوان URL الأساسي لنقطة النهاية المخصّصة للردّ على الطلبات الواردة.
- حصة "ميزة المساعدة في مطابقة ملفات تعريف الارتباط": بالنسبة إلى شبكات التبادل التي تنفّذ سير عمل "ميزة المساعدة في مطابقة ملفات تعريف الارتباط"، هذا هو الحد الأقصى لعدد الطلبات التي يمكن أن يتلقّاها عنوان URL الخاص بمطابقة ملفات تعريف الارتباط كل ثانية. يهدف ذلك إلى منع طلبات الموافقة والإدارة (CMA) من تحميل عبء زائد على خوادم التبادل من خلال الطلبات.
وحدات ماكرو لمطابقة ملفات تعريف الارتباط
في أي من مسارات عمل مطابقة ملفات تعريف الارتباط المتوافقة، يحتوي عادةً عنوان URL لمطابقة ملفات تعريف الارتباط الخاص بأحد مقدّمي عروض الأسعار على مَعلمات مُلحقة بترتيب غير مضمون. يمكن مقدّمي عروض الأسعار الذين لديهم عمليات دمج تتطلّب ترتيبًا متسقًا للمَعلمات وضع وحدات ماكرو في عنوان URL الخاص بمطابقة ملفات تعريف الارتباط للإشارة إلى موضعها.
وحدات الماكرو المتوافقة
يمكن للمزايدين بشكل اختياري ضبط عنوان URL الخاص بميزة "مطابقة ملفات تعريف الارتباط" لتضمين ماكرو واحد أو أكثر بالشكل %%GOOGLE_<PARAM_NAME>%% أو %%GOOGLE_<PARAM_NAME>_PAIR%%. في ما يلي وحدات الماكرو المتوافقة وقيمها الموسّعة:
| وحدة الماكرو | القيمة الموسّعة |
|---|---|
| GOOGLE_GID | GOOGLE_USER_ID |
| GOOGLE_GID_PAIR | &google_gid=GOOGLE_USER_ID |
| GOOGLE_CVER | COOKIE_VERSION_NUMBER |
| GOOGLE_CVER_PAIR | &cver=COOKIE_VERSION_NUMBER |
| GOOGLE_ERROR | ERROR_ID |
| GOOGLE_ERROR_PAIR | &google_error=ERROR_ID |
| GOOGLE_PUSH | PIXEL_MATCH_DATA |
| GOOGLE_PUSH_PAIR | &google_push=PIXEL_MATCH_DATA |
| GOOGLE_ALL_PARAMS | google_gid=GOOGLE_USER_ID&cver=COOKIE_VERSION_NUMBER&google_error=ERROR_ID |
مثال على الماكرو
لدى مقدّم عروض أسعار عملية دمج لمطابقة ملفات تعريف الارتباط مع نقطة نهاية مستضافة على https://user.bidder.com/cookies، ويتطلّب التنفيذ معلَمات محدّدة مسبقًا يحدّدها مقدّم عروض الأسعار بالإضافة إلى مَعلمات مطابقة وحدات البكسل بالترتيب التالي: google_push وgoogle_gid وgoogle_cver وgoogle_error. يمكن مقدّم عروض الأسعار تحقيق ذلك من خلال ضبط عنوان URL الخاص بمطابقة ملفات تعريف الارتباط على ما يلي:
https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%
عندما ترسل Google لاحقًا طلب مطابقة إلى مقدّم العروض هذا، سيتم توسيعه ليصبح على النحو التالي:
https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3
مسارات عمل "خدمة مطابقة ملفات تعريف الارتباط"
تتيح "خدمة مطابقة ملفات تعريف الارتباط" من Google مهام العمل الثلاث التالية.
بدء عملية المطابقة من جانب مقدّم عروض الأسعار: مطابقة ملفات تعريف الارتباط الثنائية الاتجاه
تشير ميزة "مطابقة ملفات تعريف الارتباط الثنائية الاتجاه" إلى سير عمل يبدأه مقدّم عروض الأسعار، حيث يضع علامة مطابقة في متصفّح المستخدِم توجّهه إلى Google. تتيح سير العمل هذا لكلّ من Google والمزايد ملء جداول المطابقة. في ما يلي مثال على سير العمل هذا.
الخطوة 1: وضع علامة المطابقة
لبدء هذا التدفق، يجب أن يضع مقدّم العروض علامة المطابقة الخاصة به بطريقة تتيح عرضها في متصفّح المستخدم. يمكن إنشاء علامة مطابقة تعرض فقط رقم تعريف مستخدم Google لمقدّم العرض على النحو التالي:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />
هناك مَعلمات إضافية يمكنك تضمينها في علامة المطابقة لتلبية حالات استخدام مختلفة. لمزيد من المعلومات عن هذه المَعلمات، يُرجى الاطّلاع على مَعلمات عناوين URL الخاصة بعلامات المطابقة.
الخطوة 2: تردّ Google بعملية إعادة توجيه تتضمّن بيانات المطابقة
سيؤدي "علامة المطابقة" إلى تلقّي "خدمة مطابقة ملفات تعريف الارتباط" من Google طلبًا من متصفّح المستخدِم، ما سيؤدي إلى إصدار عملية إعادة توجيه HTTP 302 إلى عنوان URL الخاص بـ "خدمة مطابقة ملفات تعريف الارتباط" التابع مقدّم عروض الأسعار. سيتضمّن إعادة التوجيه مَعلمات طلب البحث التي تحدّد رقم تعريف مستخدم Google ورقم إصداره في عنوان URL، وسيتلقّى مقدّم العرض أيضًا ملف تعريف الارتباط الخاص به والمضمّن في عناوين الطلبات. في
الممارسة، بالنسبة إلى عنوان URL لمطابقة ملفات تعريف الارتباط المحدّد على أنّه https://ad.network.com/pixel،
يمكن أن يبدو عنوان URL لإعادة التوجيه الخاص بعلامة المطابقة السابقة على النحو التالي:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
معرّف مستخدم Google الذي يتم تمريره من خلال المَعلمة google_gid هو سلسلة base64 مُرمَّزة آمنة على الويب بدون مسافات بادئة. بالنسبة إلى مقدّمي عروض الأسعار الذين يختارون استضافة جدول مطابقة، يُنصح بأن يخزّنوا السلسلة المطابقة التي تعرضها خدمة "مطابقة ملفات تعريف الارتباط". في طلبات عروض الأسعار اللاحقة، سيتوافق ذلك مع القيم المحدّدة من خلال BidRequest.user.id.
يشير الإصدار المحدّد في google_cver إلى رقم الإصدار الرقمي لمعرّف مستخدم Google. سيتغيّر رقم تعريف مستخدم Google لمستخدم معيّن بشكل غير متكرّر، وبعد ذلك سيتم زيادته.
إذا واجهت Google خطأً أثناء معالجة طلب المطابقة، سيتم بدلاً من ذلك تحديد المَعلمة
google_error.
الخطوة 3: تعالج جهة تقديم عروض الأسعار عملية إعادة التوجيه وتستجيب لها باستخدام البكسل
يتلقّى مقدّم العرض عملية إعادة توجيه إلى عنوان URL لمطابقة ملفات تعريف الارتباط يتضمّن المَعلمات التي حدّدها في الخطوة الأولى، وتلك التي قدّمتها Google في الخطوة الثانية. بالإضافة إلى ذلك، سيتلقّون أيضًا ملف تعريف الارتباط في عناوين HTTP. في حال نجاح العملية، يمكن لأحد مقدّمي عروض الأسعار الذي يستضيف جدول المطابقة الخاص به مطابقة ملف تعريف الارتباط مع رقم تعريف مستخدم Google المضمّن في الردّ. يُنصح بأن يخزّن مقدّمو عروض الأسعار السلسلة المطابقة التي تعرضها خدمة "مطابقة ملفات تعريف الارتباط".
إذا لم تنجح العملية، سيتلقّى مقدّم العرض المزايد المَعلمة google_error في عملية إعادة التوجيه. وهي قيمة رقمية
تتوافق مع حالات الخطأ المختلفة التي تحدد الخطأ المعيّن الذي
حدث. يمكنك الاطّلاع على مزيد من المعلومات عن قيم الأخطاء المحتملة في وصف مَعلمة عنوان URL google_error. في حال ظهور رسالة خطأ، يمكنك محاولة مطابقة المستخدم مرة أخرى عن طريق وضع علامة مطابقة جديدة.
على مقدّم العروض الاستجابة دائمًا من خلال عرض صورة غير مرئية بحجم 1x1 بكسل، أو بدلاً من ذلك، عرض استجابة HTTP 204 No Content.
مخطّط سير عمل مطابقة ملفات تعريف الارتباط
يوضّح المخطّط البياني التالي سير العمل هذا، حيث يمثّل السهم الطلبات والردود، ويتم إدراج عناصر البيانات المصاحبة لها بين قوسين.
مَعلمات عناوين URL الخاصة بعلامة المطابقة
| المَعلمة | الوصف |
|---|---|
google_nid |
رقم تعريف الشبكة (NID) لحساب مقدّم عروض الأسعار يمكن استرداد هذا المعرّف من خلال مورد جهات عروض الأسعار. |
google_cm |
تشير هذه المَعلمة إلى "خدمة مطابقة ملفات تعريف الارتباط" من Google بأنّه عليها إجراء مطابقة ملفات تعريف الارتباط. يتم تجاهل قيمة المَعلمة ويمكن حذفها. |
google_sc |
تم إيقاف هذه المَعلمة نهائيًا. تضبط هذه السمة ملف تعريف ارتباط Google للمستخدم إذا لم يكن متوفّرًا. يتم تجاهل قيمة المَعلمة ويمكن حذفها. سيؤدي حذف المَعلمة إلى حدوث خطأ في حال عدم توفّر أي ملف تعريف ارتباط. |
google_no_sc |
تم إيقاف هذه المَعلمة نهائيًا. يشير ذلك إلى خدمة مطابقة ملفات تعريف الارتباط من Google بأنّه يجب عدم ضبط ملف تعريف ارتباط للمستخدم إذا لم يكن متوفّرًا. يتم تجاهل قيمة المَعلمة ويمكن حذفها. |
google_hm |
البيانات التي يريد مقدّم العروض تخزينها في جدول مطابقة مستضاف من Google القيمة هي سلسلة مرمّزة باستخدام base64 متوافقة مع الويب (الحشو اختياري). يجب ألا يتجاوز حجم البيانات الأولية 40 بايت. على سبيل المثال، |
google_redir |
سلسلة مرمَّزة بنظام عناوين URL يمكن مقدّم العروض تحديدها إذا أراد توجيه Google لإرسال عملية إعادة التوجيه HTTP 302 إلى عنوان URL المرمَّز لعلامة المطابقة هذه. ويسمح ذلك بوضع Google في المقدّمة في طلب متسلسل للشركاء. سيؤدي ذلك إلى حدوث خطأ إذا تم تحديده بدون google_hm أو مع google_cm. |
google_ula |
سلسلة تُستخدَم لإضافة المستخدِم إلى قائمة مستخدمين حالية. التنسيق المتوقّع للقيمة هو userlistid[,timestamp]:
يمكن تكرار مَعلمة عنوان URL هذه لإضافة المستخدم إلى قوائم متعدّدة. |
gdpr |
تشير إلى أنّ الطلب يخضع لقيود اللائحة العامة لحماية البيانات (GDPR) بشأن استخدام البيانات. لمزيد من التفاصيل، يُرجى الاطّلاع على
متطلبات موافقة المستخدمين في الاتحاد الأوروبي أو التأثير في أهلية مطابقة ملفات تعريف الارتباط في
مستندات الإصدار 2.0 من إطار الشفافية والموافقة لمكتب IAB في "المشترون المعتمَدون".
مثلاً: |
gdpr_consent |
سلسلة الموافقة والشفافية التي تمثّل موافقة المستخدم النهائي للحصول على مزيد من التفاصيل، اطّلِع على متطلبات موافقة المستخدمين في الاتحاد الأوروبي أو كيف سيتم تمرير سلسلة الموافقة والشفافية؟ في مستندات الإصدار 2.0 من "إطار الشفافية والموافقة" الصادر عن مكتب IAB في "المشترين المعتمَدين". |
process_consent |
تشير إلى أنّ مقدّم عروض الأسعار قد حصل على موافقة المستخدم النهائي على استخدامات البيانات المحدّدة في
سياسة موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google.
إذا لم يخضع الطلب لـ "سياسة موافقة المستخدم في الاتحاد الأوروبي"، أو إذا كانت هناك معلَمات موافقة أخرى متاحة في الطلب ( مثلاً: |
بالإضافة إلى المَعلمات السابقة، يمكن مقدّمي عروض الأسعار تحديد مَعلماتهم الخاصة التي ستتم إضافتها كمَعلمات إلى عنوان URL لإعادة التوجيه. يُرجى العِلم أنّه سيتم تجاهل المَعلمات التي يحدّدها مقدّم العروض والتي تبدأ بالبادئة google_ لأنّ Google تحتفظ بها لاستخدامها في التطوير المستقبلي، ولا يمكن ضمان الحفاظ على ترتيب المَعلمات. قد تبدو علامة المطابقة التي تتضمّن مَعلمات يحدّدها مقدّم العروض كما يلي:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />
مَعلمات عنوان URL لإعادة التوجيه
يتم إنشاء عنوان URL لإعادة التوجيه من عنوان URL الأساسي لمطابقة ملفات تعريف الارتباط الذي تم ضبطه لحساب أحد مقدّمي عروض الأسعار، بما في ذلك google_ والمَعلمات التي يحدّدها مقدّم عروض الأسعار، وذلك استنادًا إلى المَعلمات المحدّدة في علامة المطابقة. يتم تحديد مَعلمات الردّ التالية google_:
| المَعلمة | الوصف |
|---|---|
google_gid |
معرّف مستخدم Google تُستخدَم لتحديد ما إذا تم تحديد google_cm في الطلب وتم تنفيذ الطلب بنجاح. |
google_cver |
إصدار ملف تعريف الارتباط تُستخدَم لتحديد ما إذا تم تحديد google_cm في الطلب وتم تنفيذ الطلب بنجاح. |
google_error |
قيمة عدد صحيح تشير إلى خطأ الطلب الإجمالي. عند تلقّي هذه الحالة، يشير ذلك إلى أنّه لم يتم تنفيذ أي عمليات، ولن يتم ضبط أي مَعلمات أخرى للاستجابة
|
google_hm |
لا تظهر إلا إذا تعذّرت محاولة الكتابة إلى جدول مطابقة مستضاف على Google. وعند حدوث ذلك، تكون قيمته إحدى رموز الحالة التالية:
|
google_ula |
حالة عملية إضافة قائمة المستخدمين، ويتم تكرارها إذا تم تحديد عدة مثال: يمكن أن تعرض العملية
|
أمثلة على سيناريوهات سير عمل مطابقة ملفات تعريف الارتباط
توضّح السيناريوهات التالية الشكل الذي قد يبدو عليه ربط ملفات تعريف الارتباط بالنسبة إلى مستخدم عادي يتصفّح صفحة ويب.
السيناريو 1: يمحو المستخدم ملفات تعريف الارتباط ويتصفّح موقعًا إلكترونيًا
تمحو "جين" ذاكرة التخزين المؤقت لجميع ملفات تعريف الارتباط. بعد ذلك، ينتقلون إلى الصفحة الرئيسية لموقع ExampleNews.com.
إليك ما سيحدث:
- تعرض ExampleNews.com الإعلانات وتطلبها من Google (مدير إعلانات Google).
- بما أنّ الوحدة الإعلانية مؤهَّلة للتخصيص الديناميكي، ترسل Google طلبات عروض الأسعار إلى FinestDSP وأنظمة عروض الأسعار الأخرى من خلال خدمة "عروض الأسعار في الوقت الفعلي".
- يتلقّى تطبيق نظام عروض الأسعار في FinestDSP طلب عرض السعر ويعالجه، ثم يرسل ردّه بشأن عرض السعر.
- يتلقّى محرّك بحث Google استجابات عروض الأسعار من مقدّمي عروض الأسعار، بما في ذلك استجابة FinestDSP التي تحدّد إعلانًا يتضمّن علامة مطابقة (بكسل).
- تفوز FinestDSP بالمزاد. تعرض Google علامة الإعلان والمطابقة من FinestDSP إلى "سارة".
- تطلب علامة المطابقة خدمة مطابقة ملفات تعريف الارتباط من Google، مع تحديد المَعلمتَين
google_nidوgoogle_cm. - تقرأ "خدمة مطابقة ملفات تعريف الارتباط" ملف تعريف الارتباط الخاص بجين على Google، وترسل إلى متصفّح جين عملية إعادة توجيه إلى عنوان URL الخاص بمطابقة ملفات تعريف الارتباط في FinestDSP مع ضبط المَعلمتَين
google_gidوgoogle_cver. - يحمّل متصفّح "جين" عملية إعادة التوجيه إلى عنوان URL لميزة "مطابقة ملفات تعريف الارتباط" في FinestDSP.
- تعالج نقطة نهاية مطابقة ملفات تعريف الارتباط في FinestDSP طلب إعادة التوجيه،
الذي يتضمّن مَعلمات عنوان URL التي ضبطتها Google، وملف تعريف الارتباط الخاص بـ "جين" في
عناوين HTTP. يمكن لـ FinestDSP الآن تخزين عملية الربط بين ملف تعريف الارتباط و
google_gidفي جدول المطابقة. - تستجيب منصة FinestDSP لعملية إعادة التوجيه بصورة غير مرئية بحجم 1×1 بكسل.
السيناريو 2: مستخدم لديه عملية ربط حالية
بعد أسبوع من السيناريو 1، زارت "جيني" الموقع ExampleNews.com مرة أخرى. بعد أن أصبح لدى "سارة" ملفات تعريف ارتباط خاصة بكل من مقدّم عروض الأسعار و"مدير إعلانات Google" على جهازها، إليك طريقة عمل عملية المطابقة.
- يتم عرض صفحة الويب، ما يؤدي إلى أن تطلب Google (من خلال "مدير إعلانات Google") إعلانات سيتم عرضها على الصفحة.
- أثناء مزاد الإعلانات، ترسل Google طلب عرض سعر إلى مقدّمي عروض الأسعار المعنيين، بما في ذلك FinestDSP.
- تتلقّى منصة FinestDSP طلب عرض السعر، بما في ذلك إشارات مثل
google_gid. - تبحث FinestDSP عن
google_gidفي جدول المطابقة، وتعثر على ملف تعريف الارتباط المرتبط بـ "جين" والذي تم إنشاؤه قبل أسبوع (في السيناريو 1). - استنادًا إلى المعلومات المرتبطة بملف تعريف الارتباط، يقدّم منطق عروض الأسعار في FinestDSP عرض سعر على مرّة الظهور، ويفوز بالمزاد.
- قد يظهر لـ "سارة" إعلان مخصّص حسب اهتماماتها استنادًا إلى المعلومات التي تملكها FinestDSP.
مطابقة ملفات تعريف الارتباط أحادية الاتجاه التي يبدأها مقدّم عروض الأسعار
يشبه خيار "مطابقة ملفات تعريف الارتباط أحادية الاتجاه" سير العمل "ثنائي الاتجاه"،
إلا أنّه تم تعديله بحيث تستضيف Google جدول المطابقة وتملأه فقط. يمكن استخدام هذا المعرّف في الحالات التي لا يُسمح فيها لجهة عروض الأسعار باستضافة معرّفات المستخدمين من Google في جدول المطابقة الخاص بها. لاستخدام هذا المسار، على مقدّمي عروض الأسعار السماح لـ Google باستضافة جدول مطابقة، ولن يتمكّنوا بعد ذلك من تحديد google_cm في الطلبات المُرسَلة إلى "خدمة مطابقة ملفات تعريف الارتباط" من Google، وبالتالي لن يتلقّوا google_gid لتعبئة جدول المطابقة الخاص بهم. بعد أن تحدّد Google تطابقًا لأحد المستخدمين، يمكن مقدّمي عروض الأسعار إضافته إلى قوائم المستخدمين باستخدام بيانات ملفات تعريف الارتباط الخاصة بهم. وبالمثل، لن تتضمّن طلبات عروض الأسعار لهؤلاء المستخدمين رقم تعريف المستخدم على Google، ولكنّها ستتضمّن بيانات المطابقة المستضافة. في ما يلي ملخّص لخطوات سير العمل المعدَّل.
الخطوة 1: وضع علامة المطابقة الموجّهة إلى عنوان URL الخاص بمطابقة ملفات تعريف الارتباط لدى مقدّم العروض
لبدء هذا التدفق، يجب أن يضع مقدّم العرض علامة مطابقة بحيث يتم عرضها في متصفّح المستخدم. على عكس سير العمل للمستخدمين الذين لا يقيمون في ولاية أمريكية تفرض قيودًا على الخصوصية، يجب أن توجّه علامة المطابقة متصفّح المستخدم إلى عنوان URL الخاص بميزة "مطابقة ملفات تعريف الارتباط". على سبيل المثال، عند ضبط عنوان URL لميزة "مطابقة ملفات تعريف الارتباط" على https://ad.network.com/pixel، سيظهر على النحو التالي:
<img src="https://ad.network.com/pixel" />
عند تحميلها في متصفّح المستخدم، ستطلب بكسل من عنوان URL الخاص بمطابقة ملفات تعريف الارتباط لدى مقدّم العرض. سيتضمّن هذا الطلب ملف تعريف الارتباط الخاص بالمستخدم في عنوان HTTP، والذي يجب استخراجه لتنفيذ الخطوة التالية.
الخطوة 2: إعادة التوجيه إلى خدمة "مطابقة ملفات تعريف الارتباط" من Google
يجب أن تعيد نقطة نهاية مطابقة ملفات تعريف الارتباط الخاصة مقدّم العروض التوجيه إلى خدمة مطابقة ملفات تعريف الارتباط من Google، بما في ذلك المَعلمة google_hm التي يتم ملؤها ببيانات ملفات تعريف الارتباط المرمّزة باستخدام Base64 الآمن على الويب. قد يبدو عنوان URL لإعادة التوجيه على النحو التالي:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA
الخطوة 3: تتم إعادة توجيه متصفّح المستخدِم إلى خدمة "مطابقة ملفات تعريف الارتباط" من Google
ستتلقّى Google عملية إعادة توجيه تتضمّن المَعلمات التي حدّدتها، بالإضافة إلى ملف تعريف ارتباط Google في عناوين HTTP.
الخطوة 4: تعرض Google بكسل عند إعادة التوجيه إلى صفحة النجاح أو الخطأ في حال تحديد عنوان URL للتقرير
في حال نجاح عملية مطابقة ملفات تعريف الارتباط، أو في حال عدم تحديد عنوان URL لتقرير مطابقة ملفات تعريف الارتباط لحساب مقدّم العروض، ستعرض Google تلقائيًا وحدة بكسل شفافة بحجم 1×1، وسينتهي سير العمل هنا.
ستتضمّن مرّات الظهور لهذا المستخدم في طلبات عروض الأسعار اللاحقة بيانات المطابقة المستضافة الخاصة مقدّم عرض الأسعار في BidRequest.user.buyeruid. يمكن مقدّمي عروض الأسعار أيضًا ملء قوائم المستخدمين باستخدام بيانات المطابقة المستضافة التي حدّدوها.
في حال حدوث خطأ، سترسل Google عملية إعادة توجيه إلى عنوان URL الخاص بتقرير مطابقة ملفات تعريف الارتباط الخاص بالمزايد مع تحديد سبب الخطأ في المَعلمة google_error. إذا كان عنوان URL لتقرير مطابقة ملفات تعريف الارتباط الخاص بمقدّم العروض هو https://ad.network.com/report، سيبدو عنوان URL لإعادة التوجيه على النحو التالي:
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
الخطوة 5: إعادة توجيه متصفّح المستخدِم إلى عنوان URL لتقرير "مطابقة ملفات تعريف الارتباط" الخاصّ مقدّم العروض
ستتم إعادة توجيه متصفّح المستخدِم إلى عنوان URL الخاص بتقرير "مطابقة ملفات تعريف الارتباط" الخاص بالمزايد، بما في ذلك سبب الخطأ (إن وُجد) الذي حدّدته Google في المَعلمة google_error. لمزيد من المعلومات عن تفسير رمز الخطأ، اطّلِع على وصف المَعلمة.
الخطوة 6: يعرض مقدّم عروض الأسعار صورة شفّافة بحجم 1×1 بكسل
على مقدّم العروض الاستجابة من خلال عرض صورة شفافة بحجم 1x1 بكسل على متصفّح المستخدم.
مخطّط سير عمل "مطابقة ملفات تعريف الارتباط" للمستخدمين من الولايات الأمريكية التي تفرض قيودًا على الخصوصية
يوضّح المخطّط التالي سير العمل التلقائي للمستخدمين في الولايات الأمريكية التي تفرض قيودًا على الخصوصية، حيث يتم تمثيل الطلبات والردود بسهم، ويتم إدراج عناصر البيانات المصاحبة لها بين قوسين.
مَعلمات عنوان URL لإعادة توجيه مقدّم العروض إلى خدمة "مطابقة ملفات تعريف الارتباط" من Google
| المَعلمة | الوصف |
|---|---|
google_nid |
رقم تعريف الشبكة (NID) لحساب مقدّم عروض الأسعار يمكن استرداد هذا المعرّف من خلال مورد جهات عروض الأسعار. |
google_sc |
تم إيقاف هذه المَعلمة نهائيًا. تضبط هذه السمة ملف تعريف ارتباط Google للمستخدم إذا لم يكن متوفّرًا. يتم تجاهل قيمة المَعلمة ويمكن حذفها. سيؤدي حذف المَعلمة إلى حدوث خطأ في حال عدم توفّر أي ملف تعريف ارتباط. |
google_no_sc |
تم إيقاف هذه المَعلمة نهائيًا. يشير ذلك إلى خدمة مطابقة ملفات تعريف الارتباط من Google بأنّه يجب عدم ضبط ملف تعريف ارتباط للمستخدم إذا لم يكن متوفّرًا. يتم تجاهل قيمة المَعلمة ويمكن حذفها. |
google_hm |
يحتوي على بيانات يريد مقدّم العروض تخزينها في جدول مطابقات مستضاف من Google. |
google_redir |
عنوان URL مرمّز تريد أن ترسل إليه Google عملية إعادة توجيه HTTP 302. سيتلقّى عنوان URL المحدّد عمليات إعادة توجيه تتضمّن المَعلمة google_error لكلّ من الأخطاء والعمليات الناجحة. |
google_ula |
سلسلة تُستخدَم لإضافة المستخدِم إلى قائمة مستخدمين حالية. التنسيق المتوقّع للقيمة هو userlistid[,timestamp]:
يمكن تكرار مَعلمة عنوان URL هذه لإضافة المستخدم إلى قوائم متعدّدة. |
gdpr |
تشير إلى أنّ الطلب يخضع لقيود اللائحة العامة لحماية البيانات (GDPR) بشأن استخدام البيانات. لمزيد من التفاصيل، يُرجى الاطّلاع على
متطلبات موافقة المستخدمين في الاتحاد الأوروبي أو التأثير في أهلية مطابقة ملفات تعريف الارتباط في
مستندات الإصدار 2.0 من إطار الشفافية والموافقة لمكتب IAB في "المشترون المعتمَدون".
مثلاً: |
gdpr_consent |
سلسلة الموافقة والشفافية التي تمثّل موافقة المستخدم النهائي للحصول على مزيد من التفاصيل، اطّلِع على متطلبات موافقة المستخدمين في الاتحاد الأوروبي أو كيف سيتم تمرير سلسلة الموافقة والشفافية؟ في مستندات الإصدار 2.0 من "إطار الشفافية والموافقة" الصادر عن مكتب IAB في "المشترين المعتمَدين". |
process_consent |
تشير إلى أنّ مقدّم عروض الأسعار قد حصل على موافقة المستخدم النهائي على استخدامات البيانات المحدّدة في
سياسة موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google.
إذا لم يخضع الطلب لـ "سياسة موافقة المستخدم في الاتحاد الأوروبي"، أو إذا كانت هناك معلَمات موافقة أخرى متاحة في الطلب ( مثلاً: |
مَعلمات عناوين URL التي تعيد توجيه المستخدمين من Google إلى عنوان URL لتقرير مطابقة ملفات تعريف الارتباط الخاص بالعارض
| المَعلمة | الوصف |
|---|---|
google_error |
قيمة عدد صحيح تشير إلى خطأ الطلب الإجمالي. عند تلقّي هذه الحالة، يشير ذلك إلى أنّه لم يتم تنفيذ أي عمليات، ولن يتم ضبط أي مَعلمات أخرى للاستجابة
|
ميزة "مطابقة وحدات البكسل" الثنائية الاتجاه التي تبدأها Google
"مطابقة البكسل الثنائية الاتجاه" هي سير عمل في "خدمة مطابقة ملفات تعريف الارتباط" من Google، حيث تحاول Google مطابقة رقم تعريف مستخدم Google مع مقدّم عروض أسعار تم اختياره خوارزميًا وليس الفائز في مزاد "عرض الأسعار في الوقت الفعلي". عند عرض إعلان، ستضع Google علامة مطابقة توجّه متصفّح المستخدِم إلى تحميل بكسل شفاف من عنوان URL الخاص بمطابقة ملفات تعريف الارتباط الخاص بالمزايد المحدّد. سيؤدي ذلك إلى السماح لكلّ من Google والمزايد بملء جدول مطابقة بمستخدم معيّن. في ما يلي مثال على سير العمل هذا.
الخطوة 1: تضع Google علامة مطابقة
عندما يتم تحميل صفحة أحد الناشرين المشاركين في متصفّح المستخدم، وتملأ Google مساحة إعلانية على تلك الصفحة، قد يتم وضع علامة مطابقة تطلب بكسل من أحد مقدّمي عروض الأسعار الذين تم اختيارهم بشكل آلي. يجمع رمز Pixel Matching الذي تضعه Google بين عنوان URL الخاص بميزة "مطابقة ملفات تعريف الارتباط" التابع لجهة عروض الأسعار والمَعلمات الإضافية التي يمكن أن تستخدمها جهة عروض الأسعار لتعبئة جدول المطابقة. بالنسبة إلى عنوان URL لمطابقة ملفات تعريف الارتباط
المحدّد على أنّه https://ad.network.com/pixel، تكون بنيته كما يلي:
<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />
الخطوة 2: يجب أن يستجيب مقدّم عروض الأسعار بإعادة التوجيه إلى عنوان URL الخاص بخدمة مطابقة ملفات تعريف الارتباط من Google
على مقدّمي عروض الأسعار الذين يتلقّون طلبات مطابقة وحدات البكسل الاستجابة من خلال إعادة توجيه إلى خدمة مطابقة ملفات تعريف الارتباط من Google، وذلك على النحو التالي:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
يُرجى العِلم أنّ عنوان URL لإعادة التوجيه السابق يشبه عنوان URL المستخدَم في علامة المطابقة الخاصة بسير عمل مطابقة ملفات تعريف الارتباط التي يبدأها مقدّم العروض.
في ميزة "مطابقة وحدات البكسل"، يتم استبدال المَعلمة google_cm بالمَعلمة google_push، ويجب أن تكون قيمتها مساوية للقيمة التي تقدّمها Google في الطلب. كما هو الحال في سير العمل الذي يبدأه مقدّم العروض، يمكن تحديد مَعلمات إضافية لتلبية حالات استخدام إضافية.
الخطوة 3: تعالج Google عملية إعادة التوجيه وتردّ باستخدام البكسل
تسجّل Google أنّه تم إنشاء مطابقة للمستخدم، وتتعامل مع أي عمليات إضافية مطلوبة من خلال مَعلمات طلب البحث. وأخيرًا، تردّ Google بصورة شفافة بحجم 1×1 بكسل.
الرسم البياني لسير عمل "مطابقة البكسل"
يوضّح المخطّط البياني التالي سير العمل هذا، حيث يمثّل السهم الطلبات والردود، ويتم إدراج عناصر البيانات المصاحبة لها بين قوسين.
مَعلمات طلب علامة المطابقة من Google
| المَعلمة | الوصف |
|---|---|
google_gid |
معرّف مستخدم Google بالنسبة إلى المستخدمين من خارج الولايات الأمريكية التي تفرض قيودًا على الخصوصية، سيتم دائمًا تحديد ذلك في علامة المطابقة من Google. |
google_cver |
إصدار ملف تعريف الارتباط. سيتم تحديد ذلك دائمًا في علامة المطابقة من Google. |
google_push |
تشير هذه السمة إلى أنّ هذا الطلب يبدأ سير عمل "مطابقة وحدات البكسل". يجب عرض القيمة من خلال المَعلمة المقابلة في ردّ إعادة التوجيه الخاص بالمزايد. |
gdpr_consent |
سلسلة الموافقة والشفافية التي تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، يُرجى الاطّلاع على [متطلبات موافقة المستخدمين في الاتحاد الأوروبي](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements)، أو **كيف سيتم تمرير سلسلة الموافقة والشفافية؟** في [مستندات الإصدار 2.0 من "إطار الشفافية والموافقة" الصادر عن مكتب IAB في "المشترون المعتمَدون"](//support.google.com/authorizedbuyers/answer/9789378). |
مَعلمات إعادة التوجيه لمطابقة وحدات البكسل الخاصة بعرض الإعلانات
| المَعلمة | الوصف |
|---|---|
google_nid |
رقم تعريف الشبكة (NID) لحساب مقدّم عروض الأسعار يمكن استرداد هذا المعرّف من خلال مورد جهات عروض الأسعار. |
google_push |
تشير هذه السمة إلى أنّ عملية إعادة التوجيه هذه تكمل سير عمل "مطابقة وحدات البكسل". يجب تحديد القيمة من علامة المطابقة من Google ذات الصلة هنا. |
google_hm |
يحتوي على بيانات يريد مقدّم العروض تخزينها في جدول مطابقات مستضاف من Google. |
google_ula |
سلسلة تُستخدَم لإضافة المستخدِم إلى قائمة مستخدمين حالية. التنسيق المتوقّع للقيمة هو userlistid[,timestamp]:
يمكن تكرار مَعلمة عنوان URL هذه لإضافة المستخدم إلى قوائم متعدّدة. |
gdpr_consent |
سلسلة الموافقة والشفافية التي تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، يُرجى الاطّلاع على [متطلبات موافقة المستخدمين في الاتحاد الأوروبي](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements)، أو على القسم **كيف سيتم تمرير سلسلة الموافقة والشفافية؟** في [مستندات الإصدار 2.0 من "إطار الشفافية والموافقة" الصادر عن مكتب IAB في Authorized Buyers](//support.google.com/authorizedbuyers/answer/9789378). |
مبادرة من Google: ميزة "مطابقة Pixel" أحادية الاتجاه
يختلف "مطابقة وحدات البكسل أحادية الاتجاه" عن سير العمل "ثنائي الاتجاه" في أنّ علامة المطابقة من Google لا تتضمّن مَعلمة تحدّد معرّف مستخدم Google، ولكنّها ستواصل ملء جدول المطابقة المستضاف من Google. ويمكن استخدامها في الحالات التي لا يُسمح فيها لجهة عروض الأسعار باستضافة أرقام تعريف المستخدمين على Google في جدول المطابقة الخاص بها. في ما يلي ملخّص لمثال على سير العمل المعدَّل في الخطوات التالية.
الخطوة 1: تضع Google علامة مطابقة
تضع Google علامة مطابقة لعارض أسعار تم اختياره باستخدام خوارزمية. تتضمّن علامة المطابقة المَعلمة google_push. وفي ما يلي مثال لذلك:
<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />
الخطوة 2: يطلب متصفّح المستخدِم وحدة البكسل من عنوان URL الخاص بمطابقة ملفات تعريف الارتباط لدى مقدّم العروض
يطلب متصفّح المستخدِم بكسل من عنوان URL الخاص بمطابقة ملفات تعريف الارتباط لدى مقدّم العروض، بما في ذلك ملف تعريف الارتباط الخاص بمقدّم العروض في عناوين HTTP.
الخطوة 3: إعادة التوجيه إلى خدمة مطابقة ملفات تعريف الارتباط من Google
يجب أن تعيد نقطة نهاية مطابقة ملفات تعريف الارتباط الخاصة مقدّم العروض التوجيه إلى خدمة مطابقة ملفات تعريف الارتباط من Google، بما في ذلك المَعلمة google_hm التي يتم ملؤها ببيانات ملفات تعريف الارتباط المرمّزة باستخدام Base64 الآمن على الويب. قد يبدو عنوان URL لإعادة التوجيه على النحو التالي:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA
الخطوة 4: تتم إعادة توجيه متصفّح المستخدِم إلى خدمة "مطابقة ملفات تعريف الارتباط" من Google
ستتلقّى Google عملية إعادة توجيه تتضمّن المَعلمات التي حدّدتها، بالإضافة إلى ملف تعريف ارتباط Google في عناوين HTTP. إذا كانت العملية ناجحة، ستتضمّن مرّات الظهور لهذا المستخدِم في طلبات عروض الأسعار اللاحقة بيانات المطابقة المستضافة الخاصة مقدّم عرض الأسعار في BidRequest.user.buyeruid.
يمكن مقدّمي عروض الأسعار أيضًا ملء قوائم المستخدمين باستخدام بيانات المطابقة المستضافة التي حدّدوها.
أخيرًا، تعرض Google صورة شفّافة بحجم 1×1 بكسل في متصفّح المستخدم.
أداة "مساعدة مطابقة ملفات تعريف الارتباط"
تتيح ميزة "عرض الأسعار المفتوح" للتبادلات استخدام سير عمل مطابقة ملفات تعريف الارتباط التي يبدأها مقدّم عروض الأسعار ومطابقة ملفات تعريف الارتباط التي تبدأها Google ، وذلك لمطابقة رقم تعريف مستخدم Google مع ملف تعريف الارتباط الخاص به. Cookie Match Assist (CMA) هي ميزة إضافية للمبادلات تتيح لها إنشاء جداول مطابقة مع مقدّمي عروض الأسعار التابعين لها.
طريقة عمل ميزة "مساعد مطابقة ملفات تعريف الارتباط"
عند عرض إعلان، تختار خوارزمية Google تلقائيًا إحدى البورصات المشارِكة وتضع علامة "مساعدة مطابقة ملفات تعريف الارتباط" التي تتضمّن البنية التالية:
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
يتسبّب علامة مطابقة CMA من Google في تلقّي عنوان URL لمطابقة ملفات تعريف الارتباط في شبكة التبادل طلبًا من البكسل.
- تتلقّى نقطة نهاية "مطابقة ملفات تعريف الارتباط" التابعة لشبكة التبادل الطلب، حيث تكون خدمة مطابقة ملفات تعريف الارتباط الخاصة بها مسؤولة عن مطابقة رقم تعريف المستخدِم مع أحد مقدّمي عروض الأسعار التابعين لها. في الرسم التوضيحي التالي، تستجيب خدمة مطابقة ملفات تعريف الارتباط التابعة لشبكة التبادل لمتصفّح المستخدم من خلال إعادة توجيهه إلى إحدى نقاط النهاية الخاصة بعارض الإعلانات.
- يتلقّى مقدّم عروض الأسعار الطلب، بالإضافة إلى أي مَعلمات يحدّدها التبادل لمطابقة رقم تعريف المستخدِم مع ملف تعريف الارتباط الخاص به.
القيود
تحديد عدد مرّات طلب مطابقة جديدة
يتحمّل مقدّمو عروض الأسعار مسؤولية الحدّ من عدد طلبات البيانات من خدمة "مطابقة ملفات تعريف الارتباط" للمستخدمين الذين لديهم إدخال جديد في جدول المطابقة المستضاف على Google. قد تُعتبر إدخالات جدول المباريات المستضافة منتهية الصلاحية بعد 14 يومًا، وبعد ذلك يمكن إعادة تحميلها.
الردّ على جميع طلبات مطابقة وحدات البكسل
على مقدّمي عروض الأسعار الذين يستخدمون سير عمل "مطابقة وحدات البكسل" الاستجابة لجميع طلبات "مطابقة وحدات البكسل" الواردة من خلال ردّ يتضمّن المَعلمة google_push. يسمح ذلك لشركة Google بفرض السياسات من خلال مراقبة الاستخدام. إذا كان معدّل استجابة أحد مقدّمي عروض الأسعار أقل من %90، ستحدّ Google من عدد طلبات "مطابقة البكسل" المُرسَلة إلى حسابه.
استخدام نقاط نهاية HTTPS
يجب أن تستخدم نقاط النهاية المستخدَمة في جميع إجراءات "مطابقة ملفات تعريف الارتباط" بروتوكول HTTPS.
عند الاستجابة لطلب "مطابقة وحدات البكسل" الذي تم إرساله إليك عبر HTTPS، عليك إعادة التوجيه إلى "خدمة مطابقة ملفات تعريف الارتباط" عبر HTTPS. وبالمثل، يجب أن تستخدم نقطة نهاية Cookie Match Assist التي تعيد التوجيه إلى مقدّمي عروض الأسعار بروتوكول HTTPS أيضًا. إذا أرسلت طلبات إلى Google عبر HTTP أكثر من مرة واحدة كل دقيقتَين، سيتم تقييد عدد طلبات المطابقة المُرسَلة إلى حسابك.
متطلبات موافقة المستخدمين في الاتحاد الأوروبي
يجب أن تشير طلبات مطابقة ملفات تعريف الارتباط الخاضعة لسياسة موافقة المستخدم في الاتحاد الأوروبي المتّبعة في Google إلى موافقة المستخدِم النهائي. يجب أن تشير هذه الطلبات إلى أنّه تم جمع الموافقة بإحدى الطرق التالية:
- إطار الشفافية والموافقة الإصدار 2: يشمل ذلك المَعلمتَين
gdprوgdpr_consent. للحصول على التفاصيل، يُرجى الرجوع إلى مستندات الإصدار 2.0 من "إطار الشفافية والموافقة" الصادر عن مكتب IAB في "المشترون المعتمَدون". -
process_consent: بيان يفيد بأنّ مقدّم عرض السعر قد حصل على موافقة المستخدم اللازمة.
أمثلة
توضّح الأمثلة التالية كيفية استخدام خدمة "مطابقة ملفات تعريف الارتباط" لتحقيق أهداف معيّنة. يُرجى العِلم أنّه ما لم يُذكر خلاف ذلك، يُفترض أنّ المستخدم الذي يتم اتّخاذ إجراء بشأنه ليس من ولاية أمريكية تفرض قيودًا على الخصوصية.
ملء جدول مطابقة مستضاف من مقدّم عروض
يمكن لأحد مقدّمي عروض الأسعار استخدام سير عمل "مطابقة ملفات تعريف الارتباط" لتعبئة جدول المطابقة الخاص به من خلال توفير المَعلمتَين google_nid وgoogle_cm فقط في علامة المطابقة. قد يبدو ذلك على النحو التالي:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />
إذا تم ضبط عنوان URL لمطابقة ملفات تعريف الارتباط الخاص بمقدّم العروض على https://ad.network.com/pixel?id=1،
وتمت عملية مطابقة ملفات تعريف الارتباط بنجاح، قد يبدو إعادة التوجيه التي ترسلها Google
استجابةً لعلامة المطابقة الخاصة بمقدّم العروض على النحو التالي:
https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
إذا تعذّرت عملية مطابقة ملفات تعريف الارتباط لأنّ المستخدم ليس لديه ملف تعريف ارتباط من Google، سيكون الردّ على النحو التالي:
https://ad.network.com/pixel?id=1&google_error=3
يعتمد رمز الخطأ على السبب الأساسي للخطأ. لمزيد من المعلومات عن رموز الخطأ المحتملة في سير عمل "مطابقة ملفات تعريف الارتباط"، راجِع مَعلمات عنوان URL لإعادة التوجيه.
إضافة إلى قائمة مستخدم واحد
يمكن تحديد المَعلمة google_ula في علامة مطابقة خاصة بأحد مقدّمي عروض الأسعار لإضافة المستخدم إلى قائمة مستخدمين تتضمّن رقم التعريف المحدّد. إذا كان جدول المطابقة المستضاف من Google أو مقدّم العروض يتضمّن إدخالاً جديدًا للمستخدم، يمكن لمقدّم العروض وضع علامة مطابقة تتضمّن المَعلمتَين google_nid وgoogle_ula لإضافة المستخدم إلى القائمة المحدّدة بدون بدء سير عمل "مطابقة ملفات تعريف الارتباط" الكامل. اطّلِع على القيود
المفروضة على استخدام "خدمة مطابقة ملفات تعريف الارتباط" للحصول على مزيد من التفاصيل. قد تبدو علامة المطابقة المقابلة على النحو التالي:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
للحصول على استجابة ناجحة، حيث يكون عنوان URL لمطابقة ملفات تعريف الارتباط الخاص بمقدّم عروض الأسعار هو
https://ad.network.com/pixel، سيكون عنوان URL لإعادة التوجيه من Google كما يلي:
https://ad.network.com/pixel?google_ula=12345,0
في حال حدوث خطأ عام، مثلاً، إذا لم تتوفّر ملفات تعريف ارتباط من Google للمستخدم، سيتضمّن عنوان URL لإعادة التوجيه المَعلمة google_error:
https://ad.network.com/pixel?google_error=3
إذا حدث خطأ يتعلق تحديدًا بإضافة المستخدم إلى القائمة، ستتلقّى google_ula في عملية إعادة التوجيه. على عكس مَعلمة علامة المطابقة المقابلة، تستبدل هذه المَعلمة الطابع الزمني برمز حالة للإشارة إلى نجاح العملية. على سبيل المثال، إذا تعذّر تنفيذ الطلب لأنّ حساب مقدّم العروض لم يكن لديه إذن الوصول إلى قائمة المستخدمين المحدّدة، سيكون عنوان URL لإعادة التوجيه على النحو التالي:
https://ad.network.com/pixel?google_ula=12345,2
الإضافة إلى قوائم مستخدمين متعدّدة
يمكن مقدّمي عروض الأسعار تحديد أنّه يجب إضافة مستخدم إلى قوائم مستخدمين متعدّدة من خلال تضمين مَعلمات google_ula متعدّدة في علامة المطابقة. في
التطبيق العملي، قد يبدو ذلك على النحو التالي:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />
يتمّ عرض حالة العملية لكلّ قائمة مستخدمين بشكل مشابه من خلال مَعلمات google_ula مميّزة في عملية إعادة التوجيه:
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
في عملية إعادة التوجيه السابقة، يمكننا أن نرى أنّ العملية نجحت لقائمة المستخدمين التي تحمل المعرّف 45678، ولكنّها تعذّرت لقائمة المستخدمين التي تحمل المعرّف 12345 لأنّ مقدّم العروض لم يكن لديه إذن بالوصول إليها.
اتّبِع خطوات سير عمل "مطابقة ملفات تعريف الارتباط" وأضِفها إلى قائمة المستخدمين
لإجراء مطابقة ملفات تعريف الارتباط وإضافة المستخدم إلى قائمة مستخدمين في طلب واحد، يجب أن يتضمّن رمز المطابقة الخاص بمقدّم العروض google_cm وgoogle_ula:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />
سيتضمّن عنوان URL لإعادة التوجيه الذي تحدّده Google google_gid وgoogle_cver وgoogle_ula. قد يبدو ذلك على النحو التالي:
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
تخزين نتيجة مطابقة في جدول نتائج مطابقة مستضاف على Google
إذا أراد أحد مقدّمي عروض الأسعار تخزين بيانات ملفات تعريف الارتباط في جدول مطابقة مستضاف على Google، ولم يكن ينوي تخزين المطابقة مع معرّف مستخدم Google في جدول المطابقة الخاص به، يجب أن تتضمّن علامة المطابقة المَعلمة google_hm التي يجب أن تكون قيمتها سلسلة بترميز base64 آمن على الويب. بالنسبة إلى مستخدم تكون بيانات ملفات تعريف الارتباط غير المرمّزة الخاصة به Cookie number 1!، ستكون القيمة المرمّزة Q29va2llIG51bWJlciAxIQ==، وسيتم استخدامها في علامة مطابقة على النحو التالي:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
في حال تلقّي استجابة ناجحة، حيث يكون عنوان URL لمطابقة ملفات تعريف الارتباط الخاص بالمزايد هو
https://cookie-monster.com/pixel، سيكون عنوان URL لإعادة التوجيه من Google كما يلي:
https://cookie-monster.com/pixel
المعلَمة google_gid غير مضمّنة في عملية إعادة التوجيه لأنّ علامة المطابقة لم تتضمّن google_cm، كما أنّ google_hm غير مضمّنة في الردود الناجحة. في طلبات عروض الأسعار المستقبلية الخاصة بمرات الظهور لهذا المستخدم، سيتلقّى مقدّم العرض بيانات المطابقة المستضافة في BidRequest.user.buyeruid.
إذا استخدم مقدّم عروض الأسعار بدلاً من ذلك علامة مطابقة لم يتم فيها ترميز قيمة
google_hm باستخدام base64، مثل
chocolate_chunk!، قد يبدو عنوان URL لإعادة التوجيه على النحو التالي:
https://cookie-monster.com/pixel?google_hm=2
يتضمّن عنوان URL لإعادة التوجيه السابق القيمة google_hm التي تساوي 2، ما يشير إلى أنّ العملية تعذّر تنفيذها لأنّه تعذّر فك تشفير القيمة.
جداول المطابقة المستضافة على Google وجداول عروض الأسعار التي تتضمّن قوائم المستخدمين
إذا كان مقدّم العروض يستضيف قائمة الاستخدام الخاصة به بالإضافة إلى قائمة مستخدمين تستضيفها Google، وأراد استخدام علامة مطابقة واحدة لمطابقة الجدولَين وإضافة المستخدم إلى قائمة مستخدمين معيّنة، يجب أن تتضمّن علامة المطابقة المَعلمات google_cm وgoogle_hm وgoogle_ula. إذا كانت بيانات ملف تعريف الارتباط الخاصة مقدّم العروض Cookie number 1!، ستكون القيمة المرمّزة Q29va2llIG51bWJlciAxIQ==، ما يؤدي إلى إنشاء علامة مطابقة على النحو التالي:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
للحصول على استجابة ناجحة، حيث يكون عنوان URL لمطابقة ملفات تعريف الارتباط الخاص بمقدّم عروض الأسعار هو https://cookie-monster.com/pixel، سيبدو عنوان URL لإعادة التوجيه من Google على النحو التالي:
https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0
عند تلقّي عملية إعادة التوجيه، يمكن مقدّم العروض مطابقة معرّف مستخدم Google المحدّد في google_gid مع بيانات ملف تعريف الارتباط في جدول المطابقة. بالإضافة إلى ذلك، يمكنهم تحديد ما إذا كانت عمليات جدول المطابقة وقائمة المستخدمين المستضافَين على Google قد تمت بنجاح. نتيجةً لذلك، سيؤدي أي استهداف مسبق يضبطه مقدّم عروض الأسعار لاستهداف معرّف قائمة المستخدمين المحدّد إلى أن يتلقّى مقدّم عروض الأسعار طلبات عروض أسعار لمرّات الظهور من المستخدم. وبالمثل، سيتلقّى مقدّم عروض الأسعار في طلبات عروض الأسعار هذه بيانات المطابقة المستضافة في BidRequest.user.buyeruid.