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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

المفاهيم

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

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

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

جداول المطابقة

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

جداول المطابقة المستضافة من Google

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

  • عروض الأسعار في الوقت الفعلي: في طلبات عروض الأسعار اللاحقة لمرات الظهور المرتبطة بالمستخدم، سترسل إليك Google بيانات المطابقة المستضافة التي تطابقتها مع رقم تعريف المستخدم للمستخدم على Google. إذا تم ضبط نقطة نهاية عروض أسعارك لاستخدام بروتوكول RTB من Google، ستتلقّى هذه القيمة كوحدات بايت تم فك ترميزها من خلال الحقل BidRequest.hosted_match_data. في عملية تنفيذ Google OpenRTB، تعرض خدمة BidRequest.user.buyeruid هذه البيانات كسلسلة مشفّرة على الويب بتشفير base64.

  • قوائم المستخدمين: يمكن تعبئة قوائم المستخدمين إما بمعرّفات مستخدمي Google أو بيانات المطابقة المستضافة.

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

قوائم المستخدمين

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

البدء

لبدء استخدام ميزة "مطابقة ملفات تعريف الارتباط"، يجب التواصل مع "المدير الفني للحساب" الذي يمكنه تفعيل مهام سير عمل معيّنة ومساعدتك في ضبط ما يلي:

  • رقم تعريف شبكة مطابقة ملفات تعريف الارتباط (NID): معرّف سلسلة يحدّد بشكلٍ فريد حساب نظام عروض الأسعار لمطابقة ملفات تعريف الارتباط والعمليات الأخرى ذات الصلة.
  • عنوان URL لمطابقة ملفات تعريف الارتباط: عنوان URL الأساسي لنقطة نهاية تقبل الطلبات الواردة وتعالجها كجزء من سير عمل مطابقة ملفات تعريف الارتباط. يمكن لمقدمي عروض الأسعار تضمين وحدات ماكرو في عنوان URL هذا للتحكم في ترتيب المعلمات التي يتم تمريرها إليها في سير عمل مطابقة ملفات تعريف الارتباط.
  • علامة المطابقة: العلامة التي يجب وضعها في متصفّح المستخدم لإجراء سير عمل مطابقة ملفات تعريف الارتباط الذي بدأه مقدم عرض السعر. ويمكن عرض هذا الخيار مع الإعلانات، أو وضعه على مواقع إلكترونية خارج الإعلانات.
  • عنوان URL لتقرير مطابقة ملفات تعريف الارتباط (اختياري): في "سير عمل مطابقة ملفات تعريف الارتباط الأحادي الاتجاه"، يكون هذا عنوان URL اختياريًا يمكن توفيره لتحديد نقطة نهاية ستتلقّى تفاصيل الخطأ في حال تعذّر مطابقة ملف تعريف الارتباط من خلال إعادة التوجيه HTTP 302. وحسب الإعدادات التلقائية، سيتم إرسال الردود إلى عنوان URL هذا فقط في حال حدوث خطأ في عملية مطابقة ملفات تعريف الارتباط، ولكن قد يطلب مقدّم عروض الأسعار أن يتم إرسال إعادة التوجيه دائمًا.
  • عنوان URL لمساعد مطابقة ملفات تعريف الارتباط: بالنسبة إلى تبادلات تنفيذ سير عمل مساعد مطابقة ملفات تعريف الارتباط، هذا هو عنوان 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_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. ويتطلّب تنفيذها تنفيذ معلّمات من تحديد عرض الأسعار مسبقًا، بالإضافة إلى معلّمات مطابقة Pixel بالترتيب التالي: 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’s حاليًا ثلاثة مهام سير عمل لحالات الاستخدام المختلفة الموضّحة أدناه.

تشير مطابقة ملفات تعريف الارتباط ثنائية الاتجاه إلى سير العمل الذي بدأه مقدم عرض السعر، حيث يضع علامة مطابقة في متصفح المستخدم الذي يوجّهه إلى 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-br. بالنسبة إلى مقدّمي عروض الأسعار الذين يختارون استضافة جدول مطابق، يُنصح بأن يخزّنوا السلسلة الدقيقة التي تعرضها خدمة مطابقة ملفات تعريف الارتباط. وفي طلبات عروض الأسعار اللاحقة، سيتوافق ذلك مع القيم المحدّدة من خلال BidRequest.google_user_id في بروتوكول عرض الأسعار في الوقت الفعلي (RTB) في Google#، أو BidRequest.user.id في تنفيذ OpenRTB على Google.

يشير الإصدار المحدد في google_cver إلى رقم الإصدار الرقمي للرقم التعريفي لمستخدم Google. نادرًا ما يتغير معرّف مستخدم Google لمستخدم معيّن، وبعد ذلك ستتم زيادة هذا الرقم.

إذا واجه محرّك بحث Google خطأً أثناء معالجة طلب المطابقة، سيتم تحديد معلَمة google_error بدلاً من ذلك.

الخطوة 3: معالجة نظام عروض الأسعار لعملية إعادة التوجيه والاستجابة باستخدام بكسل

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

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

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

يوضح الرسم البياني أدناه سير العمل هذا، حيث يتم تمثيل الطلبات والردود من خلال سهم، ويتم سرد عناصر البيانات التي تُرفق مع هذه العناصر بين قوسين.

معلمات عنوان URL لعلامة المطابقة

المعلمة الوصف
google_nid رقم تعريف الشبكة (NID) لحساب نظام عروض الأسعار. يمكن استرداد رقم التعريف هذا من خلال الحقل Buyer REST API Accounts's cookieMatchingNid.
google_cm تشير إلى "خدمة مطابقة ملفات تعريف الارتباط من 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 هذه لإضافة المستخدم إلى قوائم متعددة.

بالإضافة إلى المعلّمات المذكورة أعلاه، يمكن لمقدمي عروض الأسعار تحديد معلماتهم الخاصة التي سيتم إلحاقها كمعلمات بعنوان URL لإعادة التوجيه. يُرجى العلم بأنّه سيتم تجاهل المعلَمات التي يحدّدها مقدّم عرض الأسعار والتي تحمل اسم البادئة google_ لأن هذه المعلّمات محجوزة من قِبل Google للتطوير في المستقبل، والحفاظ على المعلَمات&#39، ولا يمكن ضمان الترتيب. علامة المطابقة التي تتضمن معلَمات عروض الأسعار قد تبدو كما يلي:

<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 كجزء من طلب مطابقة Pixel ثنائي الاتجاه. يجب أن توجِّه عملية إعادة التوجيه google_push إلى القيمة نفسها التي يتم تمريرها إليك في طلب وحدة البكسل الأولي.
  • 6: تم تقديم رقم NID غير صالح في علامة المطابقة.
  • 7: تم اكتشاف ملف تعريف ارتباط غير صالح.
  • 8: متوقف. لم يتم العثور على أي ملفات تعريف ارتباط.
  • 9: لم يتم العثور على أي ملفات تعريف ارتباط، فقد تمت محاولة ضبط ملف تعريف ارتباط تجريبي.
  • 10: تم استخدام المعلَمة google_redir بدون تحديد google_hm، أو تم استخدامها بالإضافة إلى google_cm.
  • 15: يأتي الطلب من منطقة يتطلّب فيها محرّك البحث Google استضافة جدول المطابقة. ونتيجةً لذلك، لا تحتوي هذه الاستجابة على رقم تعريف مستخدم Google. ويتم تفعيل هذا الخيار حاليًا لنسبة صغيرة فقط من الزيارات، ولكن نخطّط لتفعيله بالكامل في حزيران (يونيو) 2020.
google_hm

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

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

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

مثال: google_ula=1234567890,0

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

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

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

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

تُمْحِي هُدَى الْمُحْتَوَى الْمُمْكِنْ مِنْ كُلِّ الْبَسْكُوتْ. وبعد ذلك، يزورون الصفحة الرئيسية في ExampleNews.com.

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

  1. يعرض موقع NewsNews.com الإعلانات من Google ويتصل بها (مدير الإعلانات).
  2. وبما أن الوحدة الإعلانية مؤهَّلة للتخصيص الديناميكي، تُرسل Google طلبات عروض الأسعار إلى FinestDSP وأنظمة عروض أسعار أخرى من خلال خدمة "عرض الأسعار في الوقت الفعلي".
  3. يتلقّى تطبيق نظام عروض الأسعار من FinestDSP' طلب عرض السعر ويعالجه، ويرسل ردّ عرض السعر الخاص به.
  4. تتلقّى Google ردود عروض الأسعار من مقدّمي عروض الأسعار، بما في ذلك استجابة FinestDSP' التي تحدّد إعلانًا بعلامة مطابقة (بكسل).
  5. فاز فريق FinestDSP بالمزاد. تعرض Google إعلان FinestDSP's ومطابقة بياناته مع "سميرة".
  6. تستدعي علامة المطابقة خدمة مطابقة ملفات تعريف الارتباط من Google، مع تحديد المعلمات google_nid وgoogle_cm.
  7. تقرأ "خدمة التحقّق من ملفات تعريف الارتباط" ملف تعريف الارتباط من "وليد" على Google، وترسل "متصفِّح" إلى متصفّح إعادة التوجيه إلى عنوان URL المطابق لملفات تعريف الارتباط مع المَعلمتَين google_user_id وgoogle_cver.
  8. يحمّل متصفّح Jane&#39 إعادة التوجيه إلى عنوان URL لمطابقة ملفات تعريف الارتباط من FinestDSP's.
  9. تعالج نقطة نهاية مطابقة ملفات تعريف الارتباط FinestDSP&#39 طلب إعادة التوجيه، الذي يتضمّن معلَمات عناوين URL التي تضبطها Google، وملف تعريف الارتباط الخاص بسميرة في عناوين HTTP. يمكن الآن لخدمة FinestDSP تخزين تعيين ملفات تعريف الارتباط في السمة google_user_id في جدول التطابق.
  10. يستجيب FinestDSP لعملية إعادة التوجيه باستخدام وحدة بكسل 1×1 غير مرئية.
السيناريو 2: المستخدم الذي لديه ربط حالي

بعد أسبوع من السيناريو 1، زارت هبة مرة أخرى موقع ExampleNews.com. والآن، بعد أن عملت هدى على ملفات تعريف الارتباط و"مدير إعلانات Google" على جهازها، إليك آلية عمل المطابقة.

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

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

لبدء هذه العملية، يجب أن يضع مقدّم عرض الأسعار علامة مطابقة بحيث يتم عرضها في متصفّح المستخدم. وعلى عكس سير العمل للمستخدمين خارج كاليفورنيا، يجب أن توجِّه علامة المطابقة متصفِّح user@ إلى عنوان URL لمطابقة ملفات تعريف الارتباط. على سبيل المثال، عند ضبط عنوان URL لمطابقة ملفات تعريف الارتباط على أنّه https://ad.network.com/pixel، سيبدو على النحو التالي:

<img src="https://ad.network.com/pixel" />

وعند التحميل في متصفّح المستخدم، سيُطلب منك وحدة بكسل من عنوان URL لمطابقة ملفات تعريف الارتباط. سيحتوي هذا الطلب على ملف تعريف ارتباط في عنوان HTTP، ويجب استخراجه للخطوة التالية.

يجب أن تعيد نقطة النهاية المتطابقة مع ملف تعريف الارتباط الخاص بنظام عروض الأسعار إعادة توجيه العملاء إلى خدمة مطابقة ملفات تعريف الارتباط من Google's، بما في ذلك المعلّمة google_hm التي تم تعبئتها ببيانات ملفات تعريف الارتباط المشفّرة base64 الآمنة على الويب. قد يبدو عنوان URL لإعادة التوجيه على النحو التالي:

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA

ستتلقى Google إعادة توجيه تحتوي على المعلمات التي حددتها، بالإضافة إلى ملف تعريف ارتباط Google في عناوين HTTP.

الخطوة 4: تعرض Google وحدة البكسل على نجاح أو إعادة توجيه الخطأ إذا تم تحديد عنوان URL للتقرير

إذا تمت عملية مطابقة ملفات تعريف الارتباط بنجاح أو إذا لم يتم تحديد عنوان URL لتقرير مطابقة ملفات تعريف الارتباط في حساب وعروض الأسعار، ستعرض Google تلقائيًا وحدة بكسل شفافة 1 × 1، وسينتهي سير العمل هنا. ستشمل مرات الظهور لهذا المستخدم في طلبات عروض الأسعار اللاحقة بيانات عروض الأسعار المستضافة في BidRequest.hosted_match_data لـ Google Protocol أو BidRequest.user.buyeruid للتنفيذ في OpenRTB من Google. يمكن لمقدمي عروض الأسعار أيضًا تعبئة قوائم المستخدمين باستخدام بيانات المطابقة المستضافة التي حددوها.

وبخلاف ذلك، في حال حدوث خطأ، سترسل Google عملية إعادة توجيه إلى عنوان URL لتقرير مطابقة ملفات تعريف الارتباط مع عرض السعر مع سبب الخطأ المحدَّد في المعلَمة google_error. إذا كان عنوان URL لتقرير مطابقة ملفات تعريف الارتباط الخاص بـ Bider's https://ad.network.com/report، سيظهر عنوان URL لإعادة التوجيه على النحو التالي:

<img src="https://ad.network.com/report?google_error=ERROR_ID" />

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

الخطوة 6: استخدام نظام عروض الأسعار 1x1 بكسل شفاف

يجب أن يستجيب مقدّم عرض الأسعار عن طريق عرض وحدة بكسل 1x1 شفافة في متصفّح المستخدم.

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

المعلمة الوصف
google_nid رقم تعريف الشبكة (NID) لحساب نظام عروض الأسعار. يمكن استرداد رقم التعريف هذا من خلال الحقل Buyer REST API Accounts's cookieMatchingNid.
google_sc تم إيقاف هذه المعلّمة. تضبط ملف تعريف الارتباط من Google للمستخدم في حال عدم توفّر ملف تعريف ارتباط. ويتم تجاهل قيمة المعلّمة وقد يتم حذفها. ويؤدي حذف المعلّمة إلى حدوث خطأ في حال عدم توفّر ملف تعريف ارتباط.
google_no_sc تم إيقاف هذه المعلّمة. ويشير ذلك إلى "خدمة مطابقة ملفات تعريف الارتباط من Google" بأنّه يجب عدم ضبط ملف تعريف ارتباط للمستخدم في حال عدم توفّره. ويتم تجاهل قيمة المعلّمة وقد يتم حذفها.
google_hm

تحتوي على بيانات يريد نظام عروض الأسعار تخزينها في جدول مطابقة تستضيفها Google.

google_redir عنوان URL مرمّز تريد أن يرسل إليه محرّك البحث Google عملية إعادة توجيه 302 HTTP سيتلقّى عنوان URL المحدَّد عمليات إعادة توجيه باستخدام المعلَمة google_error لكلٍّ من الأخطاء والعمليات الناجحة.
google_ula سلسلة مستخدَمة لإضافة المستخدم إلى قائمة مستخدمين حالية. التنسيق المتوقَّع للقيمة هو userlistid[,timestamp]:
  • userlistid: معرّف قائمة مستخدمين رقمي واحد.
  • timestamp: طابع زمني اختياري بتنسيق POSIX، يشير إلى وقت إضافة المستخدم إلى قائمة المستخدمين.

قد تكرر معلمة عنوان URL هذه لإضافة المستخدم إلى قوائم متعددة.

المعلمة الوصف
google_error

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

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

بدء تشغيل Google: مطابقة Pixel ثنائية الاتجاه

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

الخطوة 1: تضع Google علامة مطابقة

عندما يتم تحميل صفحة أحد الناشرين المشاركين في متصفّح المستخدم ويتم تحميل خانة إعلانية على هذه الصفحة بواسطة Google، قد يتم وضع علامة مطابقة تطلب وحدة بكسل من نظام عروض الأسعار الذي يختاره الخوارزمية. تجمع علامة Pixel المحدّدة من قبل 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" />

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

https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA

لاحظ أن عنوان URL لإعادة التوجيه أعلاه مشابه لعنوان URL المستخدم في علامة التطابق لـ سير عمل مطابقة ملفات تعريف الارتباط التي بدأها مقدم عرض السعر. في ميزة "مطابقة Pixel"، يتم استبدال مَعلمة google_cm بالمَعلمة google_push، ويجب أن تكون قيمتها مساوية للقيمة التي قدّمتها Google في الطلب. يمكن أيضًا تحديد معلّمات إضافية، مثلها مثل سير العمل الذي بدأه مقدم عروض الأسعار، لتلبية حالات استخدام إضافية.

الخطوة 3: تعالج Google عمليات إعادة التوجيه وتستجيب باستخدام pixel.

وتسجّل Google أنّه قد تم إنشاء مطابقة للمستخدم، وتعالج أي عمليات إضافية يتم طلبها من خلال معلَمات طلب البحث. وأخيرًا، يستجيب محرّك البحث Google بوحدات البكسل الشفافة 1×1.

الرسم التوضيحي لآلية عمل مطابقة Pixel

يوضح الرسم البياني أدناه سير العمل هذا، حيث يتم تمثيل الطلبات والردود من خلال سهم، ويتم سرد عناصر البيانات التي تُرفق مع هذه العناصر بين قوسين.

معلّمات طلب علامة مطابقة Google

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

مَعلمات إعادة توجيه مطابقة وحدات البكسل في تقديم عروض الأسعار

المعلمة الوصف
google_nid رقم تعريف الشبكة (NID) لحساب نظام عروض الأسعار. يمكن استرداد رقم التعريف هذا من خلال الحقل Buyer REST API Accounts's cookieMatchingNid.
google_push تشير هذه الحالة إلى أن عملية إعادة التوجيه هذه تُكمل سير عمل "مطابقة Pixel". يجب تحديد القيمة من علامة مطابقة Google المطابقة هنا.
google_hm

تحتوي على بيانات يريد نظام عروض الأسعار تخزينها في جدول مطابقة تستضيفها Google.

google_ula سلسلة مستخدَمة لإضافة المستخدم إلى قائمة مستخدمين حالية. التنسيق المتوقَّع للقيمة هو userlistid[,timestamp]:
  • userlistid: معرّف قائمة مستخدمين رقمي واحد.
  • timestamp: طابع زمني اختياري بتنسيق POSIX، يشير إلى وقت إضافة المستخدم إلى قائمة المستخدمين.

قد تكرر معلمة عنوان URL هذه لإضافة المستخدم إلى قوائم متعددة.

مشغّل من Google: مطابقة أحادي الاتجاه لهاتف Pixel

تختلف مطابقة Pixel أحادي الاتجاه عن سير العمل الثنائي الاتجاه في أن علامة مطابقة Google\u3s’s لا تتضمن معلمة تحدد رقم تعريف المستخدم في Google، ولكنها ستستمر في تعبئة جدول المطابقة الذي تستضيفه Google. يمكن استخدام ذلك في الحالات التي لا يُسمح فيها بعرض الأسعار بأرقام تعريف مستخدمي Google في جدول المطابقة الخاص بهم. في ما يلي ملخص بسيط لسير العمل المعدَّل.

الخطوة 1: تضع Google علامة مطابقة

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

<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />

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

يطلب متصفِّح المستخدم بكسل من عنوان URL لمطابقة ملفات تعريف الارتباط الخاص بنظام عروض الأسعار، بما في ذلك ملف تعريف الارتباطتحدِّد عروض الأسعار في عناوين HTTP.

يجب أن تعيد نقطة النهاية المتطابقة مع ملف تعريف الارتباط الخاص بنظام عروض الأسعار إعادة توجيه العملاء إلى خدمة مطابقة ملفات تعريف الارتباط من Google's، بما في ذلك المعلّمة google_hm التي تم تعبئتها ببيانات ملفات تعريف الارتباط المشفّرة base64 الآمنة على الويب. قد يبدو عنوان URL لإعادة التوجيه على النحو التالي:

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA

ستتلقى Google إعادة توجيه تحتوي على المعلمات التي حددتها، بالإضافة إلى ملف تعريف ارتباط Google في عناوين HTTP. إذا نجحت العملية، ستشمل مرات الظهور لهذا المستخدم في طلبات عروض الأسعار اللاحقة بيانات عروض الأسعار المستضافة على BidRequest.hosted_match_data في بروتوكول Google، أو BidRequest.user.buyeruid لتنفيذ OpenRTB. يمكن لمقدمي عروض الأسعار أيضًا تعبئة قوائم المستخدمين باستخدام بيانات المطابقة المستضافة التي حددوها.

وأخيرًا، تعرض Google وحدة بكسل شفافة 1 × 1 على متصفح المستخدم.

تسمح ميزة "عرض الأسعار المفتوح" للتبادلات باستخدام مهام سير عمل مطابقة ملفات تعريف الارتباط التي بدأها موفّر عروض الأسعار والتي بدأتها Google لمطابقة ملف تعريف مستخدم Google مع ملف تعريف الارتباط الخاص به. "أداة مساعدة مطابقة ملفات تعريف الارتباط" (CMA) هي ميزة إضافية لعمليات تبادل الإعلانات تمكّنها من إنشاء جداول مطابقة مع أنظمة عروض الأسعار الخاصة بها.

  1. عند وضع إعلان، تختار Google خوارزميًا تبادلاً، وتضع علامة Cookie Match Assist التي تحتوي على البنية التالية:

    <img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
  2. تتسبب علامة مطابقة CMA من Google في "عنوان URL لمطابقة ملفات تعريف الارتباط" في تلقي طلب بكسل.

  3. تتلقّى نقطة نهاية مطابقة ملفات تعريف الارتباط في Exchange'الطلب، حيث تكون خدمة مطابقة ملفات تعريف الارتباط الخاصة بها مسؤولة عن مطابقة رقم تعريف المستخدم مع أحد مقدّمي عروض الأسعار. في الرسم البياني أدناه، تستجيب خدمة مطابقة ملفات تعريف الارتباط لتبادل الإعلانات مع متصفح المستخدم من خلال إعادة التوجيه إلى إحدى نقاط نهاية عرض الأسعار الخاصة بها.
  4. يتلقّى نظام عروض الأسعار الطلب، بالإضافة إلى أي معلّمات محدّدة في التبادل لمطابقة رقم تعريف المستخدم مع ملف تعريف الارتباط الخاص به.

القيود

تحديد عدد مرات الظهور لطلبات المطابقة الجديدة

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

الاستجابة لكل طلبات مطابقة وحدات البكسل

من المتوقّع أن تستجيب أنظمة عروض الأسعار التي تستخدم سير عمل"مطابقة Pixel"لجميع طلبات مطابقة Pixel الواردة مع توفير استجابة بما في ذلك معلّمة google_push. ويسمح ذلك لشركة Google بفرض السياسات عن طريق مراقبة الاستخدام. في حال تراجع معدّل الاستجابة لعروض الأسعار إلى أقل من 90%، ستخفّض Google عدد طلبات مطابقة Pixel التي يتم إرسالها إلى حسابه.

استخدام نقاط نهاية HTTPS

ويجب استخدام نقاط النهاية المستخدَمة في جميع سير عمل "مطابقة ملفات تعريف الارتباط" HTTPS.

وعند الردّ على طلب مطابقة أجهزة Pixel المُرسَل إليك عبر بروتوكول HTTPS، عليك إعادة التوجيه إلى خدمة مطابقة ملفات تعريف الارتباط عبر بروتوكول HTTPS. وبالمثل، يجب أيضًا استخدام بروتوكول HTTPS لنقطة نهاية مساعدة مطابقة ملفات تعريف الارتباط التي تعيد التوجيه إلى أنظمة عروض الأسعار. إذا أرسلت طلبات إلى Google عبر HTTP أكثر من مرة واحدة كل دقيقتين، سيتم تقييد عدد طلبات المطابقة المرسلة إلى حسابك.

أمثلة

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

تعبئة جدول مطابقة يستضيفه مقدم عروض أسعار

يمكن أن يستخدم نظام عروض الأسعار "سير عمل مطابقة ملفات تعريف الارتباط" لتعبئة جدول المطابقة الخاص به من خلال تقديم المعلّمتَين 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 ردًا على علامة مطابقة derder's قد تبدو كما يلي:

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\u39s:

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.hosted_match_data لبروتوكول RTB من Google، أو BidRequest.user.buyeruid لتنفيذ OpenRTB من Google.

إذا استخدم نظام عروض الأسعار علامة مطابقة بدلاً من ذلك، حيث لم يتم ترميز قيمة 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.hosted_match_data لبروتوكول "عرض الأسعار في الوقت الفعلي" (RTB) من Google، أوBidRequest.user.buyeruid لتنفيذ عرض الأسعار في الوقت الفعلي (RTRT) من Google.