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

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

المفاهيم

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

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

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

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

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

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

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

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

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

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

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

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

البدء

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

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

في أيٍّ من مهام سير عمل "مطابقة ملفات تعريف الارتباط" المتاحة، عادةً ما يكون عنوان URL لمطابقة ملفات تعريف الارتباط التابع لمقدِّم عرض أسعار مُلحقًا في طلب غير مضمون. مقدمو عروض الأسعار الذين لديهم عمليات دمج تتطلب اتساقًا يمكن أن يؤدي ترتيب المعلمات إلى وضع وحدات الماكرو في عنوان URL لمطابقة ملفات تعريف الارتباط ضمان موضعها.

وحدات الماكرو المتوافقة

يمكن لمقدّمي عروض الأسعار اختياريًا ضبط عنوان URL لمطابقة ملفات تعريف الارتباط لتضمين عنوان URL واحد أو المزيد من وحدات ماكرو في شكل %%GOOGLE_<PARAM_NAME>%% أو %%GOOGLE_<PARAM_NAME>_PAIR%% تتضمن وحدات الماكرو المتوافقة القيم الموسّعة هي:

وحدة الماكرو قيمة موسّعة
GOOGLE_GID GOOGLE_USER_ID
GOOGLE_GID_PAIR &amp;google_gid=GOOGLE_USER_ID
GOOGLE_CVER COOKIE_VERSION_NUMBER
GOOGLE_CVER_PAIR &amp;cver=COOKIE_VERSION_NUMBER
GOOGLE_ERROR ERROR_ID
GOOGLE_ERROR_PAIR &amp;google_error=ERROR_ID
GOOGLE_PUSH PIXEL_MATCH_DATA
GOOGLE_PUSH_PAIR &amp;google_push=PIXEL_MATCH_DATA
GOOGLE_ALL_PARAMS google_gid=GOOGLE_USER_ID&amp;cver=COOKIE_VERSION_NUMBER&amp;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 حاليًا ثلاثة مهام سير عمل حالات الاستخدام المختلفة الموضحة أدناه.

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

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

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

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

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

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

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

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

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

المعلمة الوصف
google_nid رقم تعريف الشبكة (NID) لحساب مقدِّم عروض الأسعار. يمكن استرداد هذا المعرّف. من خلال أنظمة عروض الأسعار المصدر.
google_cm الإشارة إلى خدمة مطابقة ملفات تعريف الارتباط من Google التي يجب أن تعمل مطابقة ملفات تعريف الارتباط. ويتم تجاهل قيمة المَعلمة وقد يتم تم حذفها.
google_sc تم إيقاف هذه المعلمة نهائيًا. لضبط ملف تعريف ارتباط Google والمستخدم إذا لم يكن موجودًا. ويتم تجاهل قيمة المعلَمة وقد . يؤدي حذف المَعلمة إلى حدوث خطأ في حال عدم توفُّر ملف تعريف ارتباط. الموجودة.
google_no_sc تم إيقاف هذه المعلمة نهائيًا. ويشير هذا إلى خدمة مطابقة ملفات تعريف الارتباط بأنه يجب ألا تضبط ملف تعريف ارتباط للمستخدم إذا واحد غير موجود. ويتم تجاهل قيمة المَعلمة وقد يتم تم حذفها.
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 يشير إلى أنّ الطلب يخضع لقيود اللائحة العامة لحماية البيانات على البيانات الاستخدام. لمزيد من التفاصيل، راجع متطلبات موافقة المستخدم في الاتحاد الأوروبي أدناه، أو التأثير في مطابقة ملفات تعريف الارتباط الأهلية في مستندات الإصدار 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 كجزء من عملية ثنائية الاتجاه طلب مطابقة Pixel يجب أن تضبط إعادة التوجيه google_push على القيمة نفسها التي تم تمريرها إليك في طلب وحدة البكسل الأولي.
  • 6: تم تقديم معرّف NID غير صالح في علامة المطابقة.
  • 7: تم رصد ملف تعريف ارتباط غير صالح.
  • 8: متوقّف نهائيًا لم يتم العثور على ملف تعريف ارتباط.
  • 9: لم يتم العثور على ملف تعريف ارتباط. لقد أجريت محاولة لضبط ملفّ تعريف ارتباط تجريبي.
  • 10: تم استخدام المعلمة google_redir بدون تحديد google_hm، أو تم استخدامها بالإضافة إلى إلى google_cm.
  • 15: الطلب صادر من منطقة تتوفّر فيها Google تتطلب استضافة جدول المطابقة بواسطة 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. يعرض ExampleNews.com الإعلانات من Google (مدير الإعلانات) ويطلبها.
  2. بما أنّ الوحدة الإعلانية مؤهَّلة للتخصيص الديناميكي، سترسل Google عرض السعر الطلبات إلى FinestDSP ومقدمي عروض الأسعار الآخرين من خلال خدمة "عرض الأسعار في الوقت الفعلي".
  3. يتلقى تطبيق مقدِّم عرض السعر التابع لـ FinestDSP طلب عرض السعر ويعالجه، وترسل الاستجابة لعرض السعر
  4. تتلقّى Google ردودًا من مقدِّمي عروض الأسعار، بما في ذلك ردّ FinestDSP. تحدّد إعلانًا بعلامة مطابقة (بكسل).
  5. FinestDSP يفوز بالمزاد. تعرض Google إعلان FinestDSP وعلامة المطابقة جيهان.
  6. وتستدعي علامة المطابقة "خدمة مطابقة ملفات تعريف الارتباط" من Google، وتحدد المَعلمتَان google_nid وgoogle_cm
  7. تقرأ خدمة Cookie Match ملف تعريف ارتباط Google الخاص بـ "سارة"، وترسل ملف تعريف ارتباط في المتصفح إعادة توجيه إلى عنوان URL لمطابقة ملفات تعريف الارتباط في FinestDSP باستخدام تم ضبط المعلمتَين google_user_id وgoogle_cver.
  8. يُحمِّل متصفّح مها إعادة التوجيه إلى عنوان URL لمطابقة ملفات تعريف الارتباط في FinestDSP.
  9. تعالج نقطة نهاية مطابقة ملفات تعريف الارتباط في FinestDSP طلب إعادة التوجيه، والذي يتضمن معلمات عناوين URL التي حددتها Google، وملف تعريف الارتباط الخاص بها لسارة في عناوين HTTP: يستطيع FinestDSP الآن تخزين تعيين ملف تعريف الارتباط الخاص به "google_user_id" في جدول المطابقة.
  10. يستجيب FinestDSP لعملية إعادة التوجيه بدقة 1x1 بكسل غير مرئية.
السيناريو 2: المستخدم لديه التعيين الحالي

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

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

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

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

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

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

يجب أن تتم إعادة توجيه نقطة نهاية مطابقة ملفات تعريف الارتباط التي يتعامل معها مقدِّم عرض السعر إلى ملف تعريف الارتباط في Google. خدمة مطابقة، بما في ذلك المَعلمة 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 أو BidRequest.user.buyeruid لبروتوكول OpenRTB من Google التنفيذ. يمكن لمقدّمي عروض الأسعار أيضًا تعبئة قوائم المستخدمين باستخدام بيانات المطابقة المستضافة. حددوها.

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

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

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

الخطوة 6: يعرض تطبيق Bidder وحدة بكسل شفافة 1x1

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

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

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

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

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

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

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

مثلاً: gdpr=1

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

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

مثلاً: process_consent=T

المعلمة الوصف
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. نتيجة لذلك، لا تحتوي الاستجابة على معرف مستخدم Google. هذه الميزة مفعّلة حاليًا في نسبة ضئيلة من الزيارات، لكن من المقرر تفعيلها بالكامل حزيران (يونيو) 2020

التشغيل الذي بدأته Google: مطابقة 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 لعملية إعادة التوجيه والاستجابة باستخدام بكسل

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

مخطّط سير عمل مطابقة وحدات البكسل

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

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

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

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

المعلمة الوصف
google_nid رقم تعريف الشبكة (NID) لحساب مقدِّم عروض الأسعار. يمكن استرداد هذا المعرّف. من خلال أنظمة عروض الأسعار المصدر.
google_push يشير هذا إلى أنّ إعادة التوجيه هذه تكمل عملية مطابقة Pixel. سير العمل. يجب أن تكون القيمة من علامة مطابقة Google المقابلة المحددة هنا.
google_hm

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

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

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

التشغيل الذي بدأته Google: مطابقة وحدات البكسل أحادية الاتجاه

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

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

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

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

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

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

يجب أن تتم إعادة توجيه نقطة نهاية مطابقة ملفات تعريف الارتباط التي يتعامل معها مقدِّم عرض السعر إلى ملف تعريف الارتباط في 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

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

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

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

  1. عند عرض إعلان، تختار Google المشاركة باستخدام خوارزميات تبادل ووضع علامة مساعدة مطابقة ملفات تعريف الارتباط التي تحتوي على ما يلي البنية:

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

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

القيود

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

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

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

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

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

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

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

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

أمثلة

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

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

يمكن لمقدّم عروض الأسعار استخدام سير عمل "مطابقة ملفات تعريف الارتباط" لتعبئة المطابقة الخاصة به. من خلال تقديم 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_nid وgoogle_ula لإضافة المستخدم إلى القائمة المحددة دون بدء عملية سير عمل مطابقة ملفات تعريف الارتباط الاطّلاع على القيود حول استدعاء "خدمة مطابقة ملفات تعريف الارتباط" (Cookie Matching Service) لمزيد من التفاصيل. المقابل قد تبدو علامة المطابقة على النحو التالي:

<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.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 لتطبيق OpenRTB من Google.