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

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

المفاهيم

ما المقصود بمطابقة ملفات تعريف الارتباط؟

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

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

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

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

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

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

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

يشير الإصدار المحدّد في google_cver إلى رقم الإصدار الرقمي لمعرّف المستخدم من Google. نادرًا ما يتغير رقم تعريف المستخدم في 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 أنّه يجب عدم إعداد ملف تعريف ارتباط للمستخدم في حال عدم توفّره. يتم تجاهل قيمة المعلَمة وقد يتم حذفها.
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 من إطار الشفافية والموافقة الصادر عن "الشراة المعتمَدون". مثال: gdpr=1
gdpr_consent	سلسلة الشفافية والموافقة (TC) التي تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، يمكنك الاطّلاع على متطلبات موافقة المستخدم في الاتحاد الأوروبي أدناه أو كيف سيتم تمرير سلسلة الموافقة والشفافية في مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن "الشراة المعتمَدون".
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: تم إدخال 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. تقرأ خدمة مطابقة ملفات تعريف الارتباط ملف تعريف ارتباط Google الخاص بجيهان، وترسل إلى متصفّح ياسمين عملية إعادة توجيه إلى عنوان URL المطابق لملفات تعريف الارتباط الخاص بـ FinestDSP مع ضبط المعلَمتَين google_user_id وgoogle_cver.
8. يحمّل متصفّح "وليد" عملية إعادة التوجيه إلى عنوان URL لمطابقة ملفات تعريف الارتباط الخاصة بـ FinestDSP.
9. تعالج نقطة نهاية مطابقة ملفات تعريف الارتباط في FinestDSP طلب إعادة التوجيه، الذي يتضمّن معلَمات عناوين URL التي ضبطها Google، وملف تعريف الارتباط الخاص بـ "جين" في عناوين HTTP. بإمكان FinestDSP الآن تخزين تعيين ملف تعريف الارتباط الخاص به إلى google_user_id في جدول المطابقة.
10. يستجيب FinestDSP لعملية إعادة التوجيه باستخدام بكسل 1×1 غير مرئي.

السيناريو 2: مستخدم لديه تعيين حالي

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

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

بدء مقدّم عروض الأسعار: مطابقة ملفات تعريف الارتباط أحادية الاتجاه

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

الخطوة 1: وضع علامة المطابقة الموجّهة إلى عنوان URL لمطابقة ملفات تعريف الارتباط لمقدّم عرض الأسعار

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

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

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

الخطوة 2: إعادة التوجيه إلى خدمة مطابقة ملفات تعريف الارتباط من Google

يجب أن تعيد نقطة نهاية مطابقة ملفات تعريف الارتباط لدى مقدّم عرض الأسعار التوجيه إلى خدمة "مطابقة ملفات تعريف الارتباط" من Google، بما في ذلك المَعلمة google_hm التي تمت تعبئتها ببيانات ملفات تعريف الارتباط التي تستخدم web-safebase64. قد يظهر عنوان URL لإعادة التوجيه على النحو التالي:

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

الخطوة 3: تتم إعادة توجيه متصفح المستخدم إلى خدمة مطابقة ملفات تعريف الارتباط من Google

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

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

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

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

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

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

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

الخطوة 6: يعرض مقدِّم عروض الأسعار وحدة بكسل شفافة 1×1

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

رسم بياني لسير عمل مطابقة ملفات تعريف الارتباط للمستخدمين من الولايات الأمريكية مع القيود المفروضة على الخصوصية

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

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

المَعلمة	الوصف
google_nid	رقم تعريف الشبكة (NID) لحساب مقدِّم عروض الأسعار ويمكن استرداد هذا المعرّف من خلال مورد مقدِّمو عروض الأسعار.
google_sc	تم إيقاف هذه المَعلمة نهائيًا. يضبط ملف تعريف ارتباط Google للمستخدم في حال عدم توفّره. يتم تجاهل قيمة المعلمة وقد يتم حذفها. يؤدي حذف المَعلمة إلى حدوث خطأ في حال عدم توفّر ملف تعريف ارتباط.
google_no_sc	تم إيقاف هذه المَعلمة نهائيًا. وتوضح هذه الخدمة لخدمة مطابقة ملفات تعريف الارتباط من Google أنّه يجب عدم إعداد ملف تعريف ارتباط للمستخدم في حال عدم توفّره. يتم تجاهل قيمة المعلَمة وقد يتم حذفها.
google_hm	يحتوي على البيانات التي يريد نظام عروض الأسعار تخزينها في جدول مطابقة تستضيفه Google.
google_redir	هو عنوان URL مرمّز تريد من Google إرسال إعادة التوجيه HTTP 302 إليه. سيتلقّى عنوان URL المحدَّد عمليات إعادة توجيه تتضمّن المعلَمة google_error لكل من الأخطاء والعمليات الناجحة.
google_ula	سلسلة تُستخدَم لإضافة المستخدِم إلى قائمة مستخدمين حالية. التنسيق المتوقَّع للقيمة هو userlistid[,timestamp]: userlistid: رقم تعريف رقم واحد لقائمة المستخدمين timestamp: طابع زمني اختياري بتنسيق POSIX، ويشير إلى وقت إضافة المستخدم إلى قائمة المستخدمين. يمكن تكرار مَعلمة عنوان URL هذه لإضافة المستخدم إلى قوائم متعدّدة.
gdpr	يشير إلى أنّ الطلب يخضع لقيود اللائحة العامة لحماية البيانات (GDPR) في ما يتعلّق باستخدام البيانات. لمزيد من التفاصيل، يمكنك الاطّلاع على متطلبات موافقة المستخدم في الاتحاد الأوروبي أدناه أو التأثير على أهلية مطابقة ملفات تعريف الارتباط في مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن "الشراة المعتمَدون". مثال: gdpr=1
gdpr_consent	سلسلة الشفافية والموافقة (TC) التي تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، يمكنك الاطّلاع على متطلبات موافقة المستخدم في الاتحاد الأوروبي أدناه أو كيف سيتم تمرير سلسلة الموافقة والشفافية في مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن "الشراة المعتمَدون".
process_consent	تشير هذه السمة إلى أنّ مقدِّم عرض السعر قد حصل على موافقة المستخدم النهائي على استخدامات البيانات المحدّدة في سياسة موافقة المستخدم في الاتحاد الأوروبي المتّبعة في Google. إذا لم يكن الطلب خاضعًا لسياسة موافقة المستخدِم في الاتحاد الأوروبي أو إذا كانت هناك مَعلمات موافقة أخرى متاحة للطلب (gdpr_consent)، يتم تجاهل هذه المَعلمة. مثال: process_consent=T

معلَمات عناوين URL لإعادة التوجيه من Google إلى عنوان URL لتقرير مطابقة ملفات تعريف الارتباط الخاص بمقدِّم عروض الأسعار

المَعلمة

الوصف

google_error

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

بدأته Google: مطابقة وحدات البكسل الثنائية الاتجاه

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

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

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

<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />

الخطوة 2: يجب أن يردّ مقدِّم عروض الأسعار بإعادة التوجيه إلى عنوان URL لخدمة مطابقة ملفات تعريف الارتباط من Google.

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

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

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

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

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

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

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

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

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

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

المَعلمة	الوصف
google_nid	رقم تعريف الشبكة (NID) لحساب مقدِّم عروض الأسعار ويمكن استرداد هذا المعرّف من خلال مورد مقدِّمو عروض الأسعار.
google_push	تشير إلى أنّ عملية إعادة التوجيه هذه تستكمل سير عمل مطابقة Pixel. ويجب تحديد القيمة من علامة مطابقة Google المقابلة هنا.
google_hm	يحتوي على البيانات التي يريد نظام عروض الأسعار تخزينها في جدول مطابقة تستضيفه Google.
google_ula	سلسلة تُستخدَم لإضافة المستخدِم إلى قائمة مستخدمين حالية. التنسيق المتوقَّع للقيمة هو userlistid[,timestamp]: userlistid: رقم تعريف رقم واحد لقائمة المستخدمين timestamp: طابع زمني اختياري بتنسيق POSIX، ويشير إلى وقت إضافة المستخدم إلى قائمة المستخدمين. يمكن تكرار مَعلمة عنوان URL هذه لإضافة المستخدم إلى قوائم متعدّدة.

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

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

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

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

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

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

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

الخطوة 3: إعادة التوجيه إلى خدمة مطابقة ملفات تعريف الارتباط من Google

يجب أن تعيد نقطة نهاية مطابقة ملفات تعريف الارتباط لدى مقدّم عرض الأسعار التوجيه إلى خدمة "مطابقة ملفات تعريف الارتباط" من Google، بما في ذلك المَعلمة google_hm التي تمت تعبئتها ببيانات ملفات تعريف الارتباط التي تستخدم web-safebase64. قد يظهر عنوان URL لإعادة التوجيه على النحو التالي:

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

الخطوة 4: إعادة توجيه متصفح المستخدم إلى خدمة مطابقة ملفات تعريف الارتباط من Google

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

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

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

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

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

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

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

متطلّبات موافقة المستخدِم في الاتحاد الأوروبي

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

• الإصدار 2 من إطار الشفافية والموافقة: يشمل ذلك المَعلمتَين gdpr وgdpr_consent. لمعرفة التفاصيل، يُرجى الاطّلاع على مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب IAB.
• process_consent: إقرار بأنّ مقدِّم عرض الأسعار قد حصل على موافقة المستخدم اللازمة

أمثلة

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

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

يمكن لنظام عروض الأسعار استخدام سير عمل "مطابقة ملفات تعريف الارتباط" لتعبئة جدول المطابقة الخاص به من خلال توفير مَعلمتَي google_nid وgoogle_cm فقط في علامة المطابقة. قد يبدو هذا على النحو التالي:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />

في حال ضبط "عنوان URL لمطابقة ملفات تعريف الارتباط" الخاص بمقدِّم عرض السعر على https://ad.network.com/pixel?id=1، وتمت عملية مطابقة ملفات تعريف الارتباط بنجاح، قد تبدو عملية إعادة التوجيه التي ترسلها Google استجابةً لعلامة المطابقة الخاصة بمقدِّم عرض السعر على النحو التالي:

https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1

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

https://ad.network.com/pixel?id=1&google_error=3

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

الإضافة إلى قائمة مستخدمين فرديين

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

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />

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

https://ad.network.com/pixel?google_ula=12345,0

إذا كان هناك خطأ عام، مثلاً، عدم توفّر ملف تعريف ارتباط Google للمستخدم، سيتضمّن عنوان URL لإعادة التوجيه المَعلمة google_error:

• https://ad.network.com/pixel?google_error=3

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

https://ad.network.com/pixel?google_ula=12345,2

الإضافة إلى قوائم مستخدمين متعددة

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

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />

ويتم أيضًا الإبلاغ عن حالة العملية لكل قائمة مستخدمين من خلال مَعلمات google_ula مختلفة في عملية إعادة التوجيه:

https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0

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

التعرّف على سير عمل مطابقة ملفات تعريف الارتباط والإضافة إلى قائمة المستخدمين

لإجراء مطابقة ملفات تعريف الارتباط وإضافة المستخدِم إلى قائمة مستخدمين في طلب واحد، يجب أن تتضمّن علامة المطابقة الخاصة بمقدّم عرض السعر google_cm وgoogle_ula:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />

إنّ عنوان URL لإعادة التوجيه الذي تحدّده Google يتضمّن google_gid وgoogle_cver وgoogle_ula. قد يبدو هذا كما يلي:

https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0

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

إذا أراد أحد عروض الأسعار تخزين بيانات ملفات تعريف الارتباط في جدول مطابقة تستضيفه Google ولا ينوي تخزين المطابقة مع رقم تعريف مستخدم Google في جدول المطابقة الخاص به، يجب أن تتضمّن علامة المطابقة الخاصة به المَعلمة google_hm حيث يجب أن تكون قيمته سلسلة بترميز base64 آمنة على الويب. بالنسبة إلى المستخدم الذي تكون فيه بيانات ملفات تعريف الارتباط غير المرمّزة الخاصة بنظام عرض الأسعار هي Cookie number 1!، ستكون القيمة المرمّزة Q29va2llIG51bWJlciAxIQ==، والتي سيتم استخدامها في علامة مطابقة كما يلي:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />

للحصول على استجابة ناجحة، حيث يكون عنوان URL لمطابقة ملفات تعريف الارتباط الخاص بمقدِّم عرض السعر هو https://cookie-monster.com/pixel، سيكون عنوان URL لإعادة التوجيه من Google على النحو التالي:

https://cookie-monster.com/pixel

المعلمة google_gid غير موجودة في عملية إعادة التوجيه لأن علامة المطابقة لم تتضمن google_cm، ولا يتم تضمين google_hm في الردود الناجحة. في طلبات عروض الأسعار المستقبلية لمرات الظهور لهذا المستخدم، سيتلقّى نظام عروض الأسعار بيانات المطابقة المستضافة في BidRequest.hosted_match_data لبروتوكول عرض الأسعار في الوقت الفعلي من 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.