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

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

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

المفاهيم

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

البدء

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

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

ملاحظة: يمكن لـ "الشراة المعتمَدون" الاطّلاع على معرّف NID المتوافق مع ملفات تعريف الارتباط وعنوان URL الذي تم ضبطه لحساباتهم باستخدام المرجع أنظمة عروض الأسعار.

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

في أيٍّ من سير عمل مطابقة ملفات تعريف الارتباط المتوافق، يكون لعنوان 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_error في علامة المطابقة من Google لسير عمل مطابقة وحدات البكسل، وبالتالي يتم استبعادها.

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

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

بدءه من خلال نظام عروض الأسعار: مطابقة ملفات تعريف الارتباط الثنائية الاتجاه

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

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

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

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

ملاحظة: يجب استبدال BIDDER_ACCOUNT_NID برقم NID لحساب نظام عروض الأسعار. يوفّر المدراء الفنيون للحسابات هذا القسم أثناء ضبط مطابقة ملفات تعريف الارتباط في حساب نظام عروض الأسعار، ويمكن الاطّلاع عليه أيضًا باستخدام مرجع أنظمة عروض الأسعار في واجهة برمجة التطبيقات الخاصة بعروض الأسعار في الوقت الفعلي.

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

يشير الإصدار المحدّد في google_cver إلى رقم الإصدار الرقمي لـ 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 يجب ألا تضبط ملف تعريف ارتباط للمستخدم في حال عدم توفّره. يتم تجاهل قيمة المَعلمة وقد يتم حذفها.
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) التي تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، اطّلِع على متطلبات موافقة المستخدم في الاتحاد الأوروبي أدناه، أو كيف سيتم تمرير سلسلة الموافقة والشفافية (TC)؟ في مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب الإعلانات التفاعلية (IAB) للشراة المعتمَدين.
process_consent	يشير ذلك إلى أنّ نظام عروض الأسعار قد حصل على موافقة المستخدم النهائي بشأن استخدامات البيانات المحدّدة في سياسة موافقة المستخدم في الاتحاد الأوروبي المتّبعة في Google. إذا لم يكن الطلب خاضعًا لسياسة موافقة المستخدم في الاتحاد الأوروبي أو إذا كانت هناك معلَمات أخرى للموافقة في الطلب (gdpr_consent)، يتم تجاهل هذه المَعلمة. مثال: process_consent=T

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

<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />

معلَمات عنوان URL لإعادة التوجيه

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

المَعلمة	الوصف
google_gid	رقم تعريف مستخدم Google يمكنك ضبط هذه السمة إذا تم تحديد google_cm في الطلب ونجح الطلب.
google_cver	إصدار ملف تعريف الارتباط. يمكنك ضبط هذه السمة إذا تم تحديد google_cm في الطلب ونجح الطلب.
google_error	قيمة عدد صحيح تشير إلى إجمالي الخطأ في الطلب. عند تلقّي الرسالة، تشير إلى أنّه لم يتم تنفيذ أي عمليات، ولن يتم ضبط معلَمات استجابة google_ أخرى. وتشمل قيم الخطأ المسموح بها ما يلي: 1: يمتلك المستخدم ملف تعريف ارتباط Google، ولكنه أوقف أي تتبُّع باستخدام ملف تعريف الارتباط هذا. 2: لم يتم تحديد أي عمليات صالحة، على سبيل المثال، تم تلقّي طلب عدم تشغيل. 3: لا يملك المستخدم ملف تعريف ارتباط Google. ولن تضبط Google ملف تعريف الارتباط من خلال "خدمة مطابقة ملفات تعريف الارتباط". 4: تم تحديد عمليات متعارضة. ولا يُسمح لك بتحديد كلتا العلامتَين google_push وgoogle_cm في الطلب نفسه لأنّ لكل منهما أغراض متضاربة. 5: تم تمرير مَعلمة google_push غير صالحة في عملية إعادة توجيه إلى خادم Google كجزء من طلب مطابقة وحدات البكسل الثنائي الاتجاه. يجب أن تضبط عملية إعادة التوجيه google_push على القيمة نفسها التي تم تمريرها إليك في طلب وحدة البكسل الأول. 6: تم تقديم رقم NID غير صالح في علامة المطابقة. 7: تم رصد ملف تعريف ارتباط غير صالح. 8: متوقّف نهائيًا. لم يتم العثور على ملف تعريف ارتباط. 9: لم يتم العثور على أي ملف تعريف ارتباط، وتمت محاولة ضبط ملف تعريف ارتباط تجريبي. 10: تم استخدام المَعلمة google_redir بدون تحديد google_hm، أو تم استخدامها بالإضافة إلى google_cm. 15: وصل الطلب من منطقة يطلب فيها محرّك بحث Google أن يكون جدول المطابقة أن تستضيفه Google. نتيجةً لذلك، لا يحتوي هذا الردّ على User ID من 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: مستخدم لديه تعيين حالي

بعد أسبوع من السيناريو الأول، زارت هدى موقع 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" />

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

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

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

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

الخطوة 6: يعرض نظام عروض الأسعار وحدة بكسل شفافة بنسبة 1×1.

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

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

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

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

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

المَعلمة	الوصف
google_nid	رقم تعريف الشبكة (NID) لحساب نظام عروض الأسعار ويمكن استرداد رقم التعريف هذا من خلال مورد أنظمة عروض الأسعار.
google_sc	تم إيقاف هذه المَعلمة نهائيًا. يضبط ملف تعريف ارتباط Google للمستخدم في حال عدم توفّره. يتم تجاهل قيمة المَعلمة وقد يتم حذفها. ويؤدي حذف المَعلمة إلى حدوث خطأ في حال عدم توفّر ملف تعريف ارتباط.
google_no_sc	تم إيقاف هذه المَعلمة نهائيًا. وتشير هذه الرسالة إلى أنّ خدمة مطابقة ملفات تعريف الارتباط من Google يجب ألا تضبط ملف تعريف ارتباط للمستخدم في حال عدم توفّره. يتم تجاهل قيمة المَعلمة وقد يتم حذفها.
google_hm	يحتوي على البيانات التي يريد نظام عروض الأسعار تخزينها في جدول المطابقة الذي تستضيفه Google. ملاحظة: القيمة هي سلسلة آمنة على الويب بترميز Base64 (مساحة متروكة اختيارية) ويجب أن يكون حجمها أقل من 23 بايت. على سبيل المثال، قد يظهر هذا الخيار على النحو التالي: Q29va2llIG51bWJlciAxIQ==.
google_redir	عنوان URL مرمّز تريد أن يرسله محرّك بحث Google لإعادة التوجيه 302 HTTP. سيتلقّى عنوان URL المحدَّد عمليات إعادة توجيه مع المَعلمة google_error لكل من الأخطاء والعمليات الناجحة.
google_ula	سلسلة تُستخدم لإضافة المستخدم إلى قائمة مستخدمين حالية. التنسيق المتوقَّع للقيمة هو userlistid[,timestamp]: userlistid: رقم تعريف قائمة مستخدمين رقمية واحدة. timestamp: طابع زمني اختياري بتنسيق POSIX، ويشير إلى وقت إضافة المستخدم إلى قائمة المستخدمين. يمكن تكرار معلَمة عنوان URL هذه لإضافة المستخدم إلى قوائم متعددة.
gdpr	يشير إلى أنّ الطلب يخضع لقيود اللائحة العامة لحماية البيانات (GDPR) في ما يتعلق باستخدام البيانات. للحصول على مزيد من التفاصيل، يمكنك الاطّلاع على متطلبات موافقة المستخدم في الاتحاد الأوروبي أدناه، أو التأثير في أهلية مطابقة ملفات تعريف الارتباط في مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب الإعلانات التفاعلية للشراة المعتمَدين. مثال: gdpr=1
gdpr_consent	سلسلة الموافقة والشفافية (TC) التي تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، اطّلِع على متطلبات موافقة المستخدم في الاتحاد الأوروبي أدناه، أو كيف سيتم تمرير سلسلة الموافقة والشفافية (TC)؟ في مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب الإعلانات التفاعلية (IAB) للشراة المعتمَدين.
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. نتيجةً لذلك، لا يحتوي هذا الردّ على User ID من 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 في الطلب. وعلى غرار سير العمل الذي يبدأه نظام عروض الأسعار، يمكن تحديد مَعلمات إضافية لتلبية حالات استخدام إضافية.

تحذير: يجب ألا تظهر المعلمتان 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	تشير هذه السمة إلى أنّ عملية إعادة التوجيه هذه تكمل سير عمل "مطابقة البكسل". يجب تحديد القيمة من علامة مطابقة Google المقابلة هنا.
google_hm	يحتوي على البيانات التي يريد نظام عروض الأسعار تخزينها في جدول المطابقة الذي تستضيفه Google. ملاحظة: القيمة هي سلسلة آمنة على الويب بترميز Base64 (مساحة متروكة اختيارية) ويجب أن يكون حجمها أقل من 23 بايت. على سبيل المثال، قد يظهر هذا الخيار على النحو التالي: Q29va2llIG51bWJlciAxIQ==.
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"/>

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

2. تؤدي علامة مطابقة CMA من Google إلى تلقّي عنوان URL لمطابقة ملفات تعريف الارتباط لطلب بكسل.

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

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

القيود

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

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

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

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

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

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

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

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

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

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

• الإصدار 2 من إطار الشفافية والموافقة: يشمل المَعلمتَين gdpr وgdpr_consent. لمعرفة التفاصيل، يُرجى الرجوع إلى مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب الإعلانات التفاعلية للشراة المعتمَدين.
• 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 لإعادة التوجيه.

ملاحظة: المعلمة التي يحددها نظام عروض الأسعار id يتم تمريرها في علامة المطابقة كما هي عندما تعيد Google توجيه Google إلى عنوان 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_ula هي 12345,0، ما يشير إلى أنّه يجب إضافة المستخدم إلى قائمة المستخدمين برقم التعريف 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.