"مطابقة ملفات تعريف الارتباط" هي ميزة تمكّنك من مطابقة ملف تعريف الارتباط التابع لك، مثل رقم تعريف لمستخدم تصفّح موقعك الإلكتروني، مع رقم تعريف مستخدم 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
بايت أو أقل. مثلاً: |
google_redir |
سلسلة بترميز عنوان URL يمكن أن يحدّدها نظام عروض الأسعار إذا كان يريد توجيه
Google لإرسال إعادة التوجيه HTTP 302 إلى عنوان URL المشفّر
لعلامة المطابقة هذه. ويتيح ذلك أن يتم عرض Google في مقدّمة الفعالية من خلال إجراء سلسلة من المكالمات الموجّهة إلى الشركاء. وسيؤدي ذلك إلى حدوث خطأ إذا تم تحديدها بدون السمة google_hm أو السمة google_cm . |
google_ula |
سلسلة تُستخدَم لإضافة المستخدِم إلى قائمة مستخدمين حالية. التنسيق المتوقَّع للقيمة هو userlistid[,timestamp] :
يمكن تكرار مَعلمة عنوان URL هذه لإضافة المستخدم إلى قوائم متعدّدة. |
gdpr |
يشير إلى أنّ الطلب يخضع لقيود اللائحة العامة لحماية البيانات (GDPR) في ما يتعلّق باستخدام البيانات. لمزيد من التفاصيل، يمكنك الاطّلاع على
متطلبات موافقة المستخدم في الاتحاد الأوروبي أدناه أو التأثير على أهلية
مطابقة ملفات تعريف الارتباط في
مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن "الشراة المعتمَدون".
مثال: |
gdpr_consent |
سلسلة الشفافية والموافقة (TC) التي تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، يمكنك الاطّلاع على متطلبات موافقة المستخدم في الاتحاد الأوروبي أدناه أو كيف سيتم تمرير سلسلة الموافقة والشفافية في مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن "الشراة المعتمَدون". |
process_consent |
تشير هذه السمة إلى أنّ مقدِّم عرض السعر قد حصل على موافقة المستخدم النهائي على استخدامات البيانات المحدّدة في
سياسة موافقة المستخدم في الاتحاد الأوروبي المتّبعة في Google.
إذا لم يكن الطلب خاضعًا لسياسة موافقة المستخدِم في الاتحاد الأوروبي أو إذا كانت هناك
مَعلمات موافقة أخرى متاحة للطلب
( مثال: |
بالإضافة إلى المَعلمات الواردة أعلاه، يمكن لأنظمة عروض الأسعار تحديد المَعلمات الخاصة بها،
والتي سيتم إلحاقها كمَعلمات إلى عنوان 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_hm |
لا يظهر هذا الخيار إلا إذا تعذّرت محاولة الكتابة إلى جدول المطابقة الذي تستضيفه Google. عند حدوث ذلك، تكون قيمتها إحدى رموز الحالة التالية:
|
google_ula |
حالة عملية إضافة قائمة المستخدمين، تتكرّر في حال تحديد عدة مثال: يمكن أن تعرض عملية
|
أمثلة على سيناريوهات سير عمل مطابقة ملفات تعريف الارتباط
تصف السيناريوهات التالية الشكل الذي قد تبدو عليه مطابقة ملفات تعريف الارتباط لمستخدم عادي يتصفح صفحة ويب.
السيناريو 1: يمحو المستخدم ملفات تعريف الارتباط ويتصفح موقعًا إلكترونيًا
تمحو هبة ذاكرة التخزين المؤقت لجميع ملفات تعريف الارتباط. بعد ذلك ينتقلون إلى صفحة ExampleNews.com الرئيسية.
إليك ما سيحدث:
- يعرض ExampleNews.com الإعلانات من Google (مدير الإعلانات) ويطلبها من خلاله.
- ولأن الوحدة الإعلانية مؤهَّلة للتخصيص الديناميكي، تُرسِل Google طلبات عروض الأسعار إلى FinestDSP وأنظمة عروض الأسعار الأخرى من خلال خدمة "عروض الأسعار في الوقت الفعلي".
- يتلقّى تطبيق نظام عروض الأسعار في FinestDSP طلب عرض السعر ويعالجه، ويرسل الاستجابة لعرض السعر الخاص به.
- تتلقّى Google ردودًا على عروض الأسعار من أنظمة عروض الأسعار، بما في ذلك ردّ FinestDSP الذي يحدِّد إعلانًا بعلامة مطابقة (بكسل).
- يفوز FinestDSP بالمزاد. تعرض Google إعلان FinestDSP وعلامة المطابقة لـ "جاين".
- تستدعي علامة المطابقة "خدمة مطابقة ملفات تعريف الارتباط" من Google، وتحدّد
المَعلمتَين
google_nid
وgoogle_cm
. - تقرأ خدمة مطابقة ملفات تعريف الارتباط ملف تعريف ارتباط Google الخاص بجيهان، وترسل إلى متصفّح ياسمين عملية إعادة توجيه إلى عنوان URL المطابق لملفات تعريف الارتباط الخاص بـ FinestDSP مع ضبط المعلَمتَين
google_user_id
وgoogle_cver
. - يحمّل متصفّح "وليد" عملية إعادة التوجيه إلى عنوان URL لمطابقة ملفات تعريف الارتباط الخاصة بـ FinestDSP.
- تعالج نقطة نهاية مطابقة ملفات تعريف الارتباط في FinestDSP طلب إعادة التوجيه، الذي يتضمّن معلَمات عناوين URL التي ضبطها Google، وملف تعريف الارتباط الخاص بـ "جين" في عناوين HTTP. بإمكان FinestDSP الآن تخزين تعيين ملف تعريف الارتباط الخاص به إلى
google_user_id
في جدول المطابقة. - يستجيب FinestDSP لعملية إعادة التوجيه باستخدام بكسل 1×1 غير مرئي.
السيناريو 2: مستخدم لديه تعيين حالي
بعد أسبوع من السيناريو 1، زارت جاين موقع ExampleNews.com مرة أخرى. والآن بعد أن تم إعداد ملفات تعريف الارتباط لنظام عروض الأسعار و"مدير الإعلانات" لدى "جاين" على جهازها، إليك آلية عمل المطابقة.
- يتم عرض صفحة الويب، ما يدفع Google (مدير الإعلانات) إلى طلب إعلانات سيتم عرضها على الصفحة.
- خلال مزاد الإعلانات، تُرسِل Google طلب عرض السعر إلى أنظمة عروض الأسعار المناسبة، بما في ذلك FinestDSP.
- يتلقّى FinestDSP طلب عرض السعر، بما في ذلك إشارات مثل
google_user_id
. - يبحث FinestDSP عن
google_user_id
في جدول المطابقة الخاص به، ويعثر على ملف تعريف الارتباط المرتبط بـ "جين" الذي تم إنشاؤه قبل أسبوع (في السيناريو 1). - استنادًا إلى المعلومات المرتبطة بملف تعريف الارتباط، يضع منطق عروض الأسعار في FinestDSP عرض سعر على مرة الظهور، ويفوز بالمزاد.
- قد تشاهد سارة إعلانًا مخصّصًا وفقًا لاهتماماتها، استنادًا إلى المعلومات التي يملكها 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] :
يمكن تكرار مَعلمة عنوان URL هذه لإضافة المستخدم إلى قوائم متعدّدة. |
gdpr |
يشير إلى أنّ الطلب يخضع لقيود اللائحة العامة لحماية البيانات (GDPR) في ما يتعلّق باستخدام البيانات. لمزيد من التفاصيل، يمكنك الاطّلاع على
متطلبات موافقة المستخدم في الاتحاد الأوروبي أدناه أو التأثير على أهلية
مطابقة ملفات تعريف الارتباط في
مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن "الشراة المعتمَدون".
مثال: |
gdpr_consent |
سلسلة الشفافية والموافقة (TC) التي تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، يمكنك الاطّلاع على متطلبات موافقة المستخدم في الاتحاد الأوروبي أدناه أو كيف سيتم تمرير سلسلة الموافقة والشفافية في مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن "الشراة المعتمَدون". |
process_consent |
تشير هذه السمة إلى أنّ مقدِّم عرض السعر قد حصل على موافقة المستخدم النهائي على استخدامات البيانات المحدّدة في
سياسة موافقة المستخدم في الاتحاد الأوروبي المتّبعة في Google.
إذا لم يكن الطلب خاضعًا لسياسة موافقة المستخدِم في الاتحاد الأوروبي أو إذا كانت هناك
مَعلمات موافقة أخرى متاحة للطلب
( مثال: |
معلَمات عناوين URL لإعادة التوجيه من Google إلى عنوان URL لتقرير مطابقة ملفات تعريف الارتباط الخاص بمقدِّم عروض الأسعار
المَعلمة | الوصف |
---|---|
google_error |
قيمة عددية تشير إلى إجمالي الخطأ في الطلب. عند
استلام الرسالة، تشير إلى أنّه لم يتم إجراء أي عمليات، وأنّه لن يتم ضبط
معلَمات استجابة
|
بدأته 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] :
يمكن تكرار مَعلمة عنوان 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) ميزة إضافية للتبادلات تمكّنها من إنشاء جداول مطابقة من خلال أنظمة عروض الأسعار الخاصة بها.
آلية عمل أداة مساعدة مطابقة ملفات تعريف الارتباط
عند عرض إعلان، تختار Google خوارزميًا عملية تبادل مشارِكة وتضع علامة مساعدة بشأن مطابقة ملفات تعريف الارتباط لها البنية التالية:
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
تؤدي علامة مطابقة CMA من Google إلى تلقّي عنوان URL لمطابقة ملفات تعريف الارتباط في التبادل لطلب بكسل.
- تتلقّى نقطة نهاية "مطابقة ملفات تعريف الارتباط" في التبادل الطلب، حيث تكون خدمة مطابقة ملفات تعريف الارتباط مسؤولة عن مطابقة رقم تعريف المستخدم مع أحد أنظمة عروض الأسعار التابعة لها. في الرسم البياني أدناه، تستجيب خدمة مطابقة ملفات تعريف الارتباط في تبادل الإعلانات لمتصفّح المستخدم من خلال إعادة توجيه إلى إحدى نقاط النهاية الخاصة بنظام عرض السعر.
- يتلقّى مقدِّم عرض السعر الطلب، بالإضافة إلى أي مَعلمات تحدِّدها عملية التبادل لمطابقة رقم تعريف المستخدم مع ملف تعريف الارتباط.
القيود
تحديد عدد مرات الطلبات لمطابقات جديدة
يتحمّل مقدّمو عروض الأسعار مسؤولية الحد من عدد الطلبات التي تتم من خلال خدمة "مطابقة ملفات تعريف الارتباط" للمستخدمين الذين لديهم إدخال جديد في جدول المطابقة الذي تستضيفه 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.