مطابقة ملفات تعريف الارتباط

"مطابقة ملفات تعريف الارتباط" هي ميزة تتيح لك مطابقة ملف تعريف الارتباط الخاص بك، مثل معرّف مستخدم تصفّح موقعك الإلكتروني، مع معرّف مستخدم 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 المضمّن في الردّ. يُنصح بأن يخزّن مقدّمو عروض الأسعار السلسلة المطابقة التي تعرضها خدمة &quot;مطابقة ملفات تعريف الارتباط&quot;.

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

على مقدّم العروض الاستجابة دائمًا من خلال عرض صورة غير مرئية بحجم 1x1 بكسل، أو بدلاً من ذلك، عرض استجابة HTTP 204 No Content.

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

مَعلمات عناوين URL الخاصة بعلامة المطابقة

المَعلمة الوصف
google_nid رقم تعريف الشبكة (NID) لحساب مقدّم عروض الأسعار يمكن استرداد هذا المعرّف من خلال مورد جهات عروض الأسعار.
google_cm تشير هذه المَعلمة إلى &quot;خدمة مطابقة ملفات تعريف الارتباط&quot; من Google بأنّه عليها إجراء مطابقة ملفات تعريف الارتباط. يتم تجاهل قيمة المَعلمة ويمكن حذفها.
google_sc تم إيقاف هذه المَعلمة نهائيًا. تضبط هذه السمة ملف تعريف ارتباط Google للمستخدم إذا لم يكن متوفّرًا. يتم تجاهل قيمة المَعلمة ويمكن حذفها. سيؤدي حذف المَعلمة إلى حدوث خطأ في حال عدم توفّر أي ملف تعريف ارتباط.
google_no_sc تم إيقاف هذه المَعلمة نهائيًا. يشير ذلك إلى خدمة مطابقة ملفات تعريف الارتباط من Google بأنّه يجب عدم ضبط ملف تعريف ارتباط للمستخدم إذا لم يكن متوفّرًا. يتم تجاهل قيمة المَعلمة ويمكن حذفها.
google_hm

البيانات التي يريد مقدّم العروض تخزينها في جدول مطابقة مستضاف من Google

القيمة هي سلسلة مرمّزة باستخدام base64 متوافقة مع الويب (الحشو اختياري). يجب ألا يتجاوز حجم البيانات الأولية 40 بايت. على سبيل المثال، Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u.
google_redir سلسلة مرمَّزة بنظام عناوين URL يمكن مقدّم العروض تحديدها إذا أراد توجيه Google لإرسال عملية إعادة التوجيه HTTP 302 إلى عنوان URL المرمَّز لعلامة المطابقة هذه. ويسمح ذلك بوضع Google في المقدّمة في طلب متسلسل للشركاء. سيؤدي ذلك إلى حدوث خطأ إذا تم تحديده بدون google_hm أو مع google_cm.
google_ula سلسلة تُستخدَم لإضافة المستخدِم إلى قائمة مستخدمين حالية. التنسيق المتوقّع للقيمة هو userlistid[,timestamp]:
  • userlistid: رقم تعريف واحد لقائمة المستخدمين.
  • ‫timestamp: طابع زمني اختياري بتنسيق POSIX، يشير إلى وقت إضافة المستخدم إلى قائمة المستخدمين.

يمكن تكرار مَعلمة عنوان URL هذه لإضافة المستخدم إلى قوائم متعدّدة.
gdpr تشير إلى أنّ الطلب يخضع لقيود اللائحة العامة لحماية البيانات (GDPR) بشأن استخدام البيانات. لمزيد من التفاصيل، يُرجى الاطّلاع على متطلبات موافقة المستخدمين في الاتحاد الأوروبي أو التأثير في أهلية مطابقة ملفات تعريف الارتباط في مستندات الإصدار 2.0 من إطار الشفافية والموافقة لمكتب IAB في "المشترون المعتمَدون".

مثلاً: gdpr=1
gdpr_consent سلسلة الموافقة والشفافية التي تمثّل موافقة المستخدم النهائي للحصول على مزيد من التفاصيل، اطّلِع على متطلبات موافقة المستخدمين في الاتحاد الأوروبي أو كيف سيتم تمرير سلسلة الموافقة والشفافية؟ في مستندات الإصدار 2.0 من "إطار الشفافية والموافقة" الصادر عن مكتب IAB في "المشترين المعتمَدين".
process_consent تشير إلى أنّ مقدّم عروض الأسعار قد حصل على موافقة المستخدم النهائي على استخدامات البيانات المحدّدة في سياسة موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google.

إذا لم يخضع الطلب لـ "سياسة موافقة المستخدم في الاتحاد الأوروبي"، أو إذا كانت هناك معلَمات موافقة أخرى متاحة في الطلب (gdpr_consent)، سيتم تجاهل هذه المَعلمة.

مثلاً: process_consent=T

بالإضافة إلى المَعلمات السابقة، يمكن مقدّمي عروض الأسعار تحديد مَعلماتهم الخاصة التي ستتم إضافتها كمَعلمات إلى عنوان 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_. تشمل قيم الخطأ المسموح بها ما يلي:

  • ‫1: لدى المستخدم ملف تعريف ارتباط من Google، ولكنّه أوقف أي تتبُّع باستخدام ملف تعريف الارتباط هذا.
  • 2: لم يتم تحديد أي عمليات صالحة، على سبيل المثال، تم تلقّي طلب بدون عملية.
  • 3: لا يملك المستخدم ملف تعريف ارتباط من Google. لن تضبط Google ملف تعريف الارتباط من خلال خدمة مطابقة ملفات تعريف الارتباط.
  • 4: تم تحديد عمليات متضاربة. لا يُسمح لك بتحديد كل من العلامتَين google_push وgoogle_cm في الطلب نفسه لأنّ الغرض منهما يتعارض مع بعضه.
  • ‫5: تم تمرير المَعلمة google_push غير الصالحة في عملية إعادة توجيه إلى خادم Google كجزء من طلب مطابقة وحدات البكسل الثنائية الاتجاه. يجب أن يضبط التوجيه google_push على القيمة نفسها التي تمّ تمريرها إليك في طلب البكسل الأوّلي.
  • ‫6: تم تقديم رقم تعريف غير صالح في علامة المطابقة.
  • ‫7: تم رصد ملف تعريف ارتباط غير صالح.
  • 8: تم إيقافها نهائيًا. لم يتم العثور على أي ملف تعريف ارتباط.
  • ‫9: لم يتم العثور على ملف تعريف ارتباط، ويتم إجراء محاولة لضبط ملف تعريف ارتباط تجريبي.
  • ‫10: تم استخدام المَعلمة google_redir بدون تحديد google_hm، أو تم استخدامها بالإضافة إلى google_cm.
  • ‫15: يأتي الطلب من منطقة تشترط فيها Google أن تستضيف جدول المطابقة. نتيجةً لذلك، لا تتضمّن هذه الاستجابة معرّف مستخدم Google.
google_hm

لا تظهر إلا إذا تعذّرت محاولة الكتابة إلى جدول مطابقة مستضاف على Google. وعند حدوث ذلك، تكون قيمته إحدى رموز الحالة التالية:

  • ‫1 - Forbidden: لا يملك العميل إذن الوصول للكتابة في إدخالات جدول المطابقة المستضاف.
  • 2 - خطأ في فك الترميز: تعذّر فك ترميز قيمة المَعلمة.
  • 3 - الحمولة طويلة جدًا: تم فك ترميز قيمة المَعلمة إلى أكثر من 40 بايت من البيانات.
  • 4 - خطأ داخلي: حدث خطأ داخلي أثناء تخزين البيانات.
  • ‫5 - تم تقييد الخدمة: لم تتم معالجة عملية الكتابة هذه بسبب تقييد الخدمة.
google_ula

حالة عملية إضافة قائمة المستخدمين، ويتم تكرارها إذا تم تحديد عدة google_ula في الطلب. التنسيق هو:
userlistid,status code

مثال: google_ula=1234567890,0

يمكن أن تعرض العملية google_ula أيًّا من رموز الحالة التالية:

  • ‫0 - ما مِن خطأ تمت إضافة المستخدم إلى قائمة المستخدمين.
  • 2 - تم رفض الإذن. ليس لديك إذن بإضافة مستخدمين إلى قائمة المستخدمين المحدّدة.
  • ‫5: رقم تعريف قائمة المستخدمين غير صالح. رقم تعريف قائمة المستخدمين المقدَّم غير صالح.
  • ‫6: رقم تعريف السمة المغلقة رقم تعريف قائمة المستخدمين المقدَّم مغلق.
  • ‫10 - حدث خطأ داخلي. حدث خطأ داخلي في خدمة &quot;مطابقة ملفات تعريف الارتباط&quot;، ويمكنك محاولة إعادة مطابقة المستخدم مرة أخرى.

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

السيناريو 1: يمحو المستخدم ملفات تعريف الارتباط ويتصفّح موقعًا إلكترونيًا

تمحو "جين" ذاكرة التخزين المؤقت لجميع ملفات تعريف الارتباط. بعد ذلك، ينتقلون إلى الصفحة الرئيسية لموقع ExampleNews.com.

إليك ما سيحدث:

  1. تعرض ExampleNews.com الإعلانات وتطلبها من Google (مدير إعلانات Google).
  2. بما أنّ الوحدة الإعلانية مؤهَّلة للتخصيص الديناميكي، ترسل Google طلبات عروض الأسعار إلى FinestDSP وأنظمة عروض الأسعار الأخرى من خلال خدمة "عروض الأسعار في الوقت الفعلي".
  3. يتلقّى تطبيق نظام عروض الأسعار في FinestDSP طلب عرض السعر ويعالجه، ثم يرسل ردّه بشأن عرض السعر.
  4. يتلقّى محرّك بحث Google استجابات عروض الأسعار من مقدّمي عروض الأسعار، بما في ذلك استجابة FinestDSP التي تحدّد إعلانًا يتضمّن علامة مطابقة (بكسل).
  5. تفوز FinestDSP بالمزاد. تعرض Google علامة الإعلان والمطابقة من FinestDSP إلى &quot;سارة&quot;.
  6. تطلب علامة المطابقة خدمة مطابقة ملفات تعريف الارتباط من Google، مع تحديد المَعلمتَين