"مطابقة ملفات تعريف الارتباط" هي ميزة تمكّنك من مطابقة ملفات تعريف الارتباط مثل، رقم تعريفي لمستخدم تصفّح موقعك الإلكتروني مع معرف مستخدم Google الخاص بمقدِّم عرض السعر، وإنشاء قوائم مستخدمين يمكن أن تساعدك في اختيارات عروض أسعار أكثر فعالية. يصف هذا الدليل المفاهيم المستخدَمة في ملفات تعريف الارتباط المطابقة، وكذلك سير عمل مطابقة ملفات تعريف الارتباط المختلفة وأي صيغ مختلفة حالات استخدام معينة.
المفاهيم
ما المقصود بمطابقة ملفات تعريف الارتباط؟
يحدّد مالكو النطاقات عادةً محتوى ملفات تعريف الارتباط للمستخدمين الذين يتصفّحون مواقعهم، والتي يتم استخدامها لتحديد هوية المستخدمين داخل هذا النطاق. حتى لو اثنتين فإن مالكي النطاقات قد يوافقون على تبادل هذه البيانات، ونموذج الأمان من متصفحات الإنترنت تمنع المستخدم من قراءة ملف تعريف ارتباط تم ضبطه من قِبل آخر مجالك.
في سياق الإعلانات الرقمية، تحدد Google المستخدمين باستخدام ملفات تعريف الارتباط
التي تنتمي إلى النطاق doubleclick.net
ومقدِّمي عروض الأسعار
المشاركة في عرض الأسعار في الوقت الفعلي قد يكون لها نطاق خاص،
تحديد مجموعة من المستخدمين الذين يرغبون في عرض الإعلانات لهم. مطابقة ملفات تعريف الارتباط
تمكين مقدّم عرض الأسعار من مطابقة ملفات تعريف الارتباط
مع ملفات تعريف الارتباط في Google، ليتمكّن من
تحديد ما إذا كانت مرة الظهور المُرسَلة في طلب عرض سعر مرتبطة بواحد
المستخدمين المستهدفين، سيتلقون إما بيانات ملفات تعريف الارتباط الخاصة بهم أو
معرّف مستخدم Google الخاص بمقدِّم عرض السعر والذي يُعد شكلاً مشفّرًا
ملف تعريف ارتباط واحد (doubleclick.net
) في طلب عرض السعر.
تُسهِّل خدمة مطابقة ملفات تعريف الارتباط الموضّحة في هذا الدليل عملية الإنشاء. والحفاظ على الارتباط بين ملف تعريف ارتباط مقدّم عرض سعر ونظام User ID، ويسمح أيضًا لواحد بتعبئة قوائم المستخدمين.
جداول المطابقة
يمكن استخدام جدول المطابقة لربط رقم تعريف أو بيانات أخرى من نطاق البعض يمكن لمقدّمي عروض الأسعار استخدام "خدمة مطابقة ملفات تعريف الارتباط" لتعبئة لمطابقة الجداول من خلال ربط ملف تعريف الارتباط الخاص بمستخدم محدد بحساب Google رقم تعريف المستخدم، أو لتعبئة جدول مطابقة تستضيفه Google. جداول المطابقة هي ضروريًا لكي يتمكّن تطبيق مقدّم عروض الأسعار من الوصول إلى بيانات ملفات تعريف الارتباط للمستخدِم إظهار الانطباع.
جداول المطابقة التي تستضيفها Google
لتسهيل الصيانة وتحسين وقت الاستجابة والوصول إلى بيانات المطابقة مستخدمين في مناطق معينة، ننصحك بالسماح لـ Google باستضافة جدول المطابقة. يتيح لك ذلك تحديد سلسلة بترميز base64 آمنة على الويب: يُشار إليها في ما بعد باسم بيانات المطابقة المستضافة، والتي سيتم ربطها رقم تعريف المستخدم في Google لمستخدم معين. بمجرد تحديد المطابقة، يمكن المستخدمة بالطرق التالية:
عروض الأسعار في الوقت الفعلي: في طلبات عروض الأسعار اللاحقة لمرات الظهور المرتبطة بالمستخدم، سترسل إليك Google بيانات المطابقة المستضافة التي مطابق مع رقم تعريف المستخدم في Google. في حال ضبط نقطة نهاية عروض الأسعار لاستخدام بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google، ستتلقى هذه البيانات على شكل وحدات بايت تم فك ترميزها من خلال الحقل
BidRequest.hosted_match_data
. في بروتوكول OpenRTB من Google التنفيذ، ستعرضBidRequest.user.buyeruid
هذا كسلسلة بترميز base64 متوافقة مع الويب.قوائم المستخدمين: يمكن تعبئة قوائم المستخدمين إما مع أرقام تعريف مستخدمي Google أو بيانات المطابقة المستضافة.
- الاستهداف المُسبَق: يمكنك ضبط الاستهداف المُسبَق بحيث تتلقّى طلبات عروض الأسعار فقط. الذي يحتوي على بيانات المطابقة المستضافة. ويمكن استخدام ذلك لإزالة المحتوى الأقل أهمية مرات الظهور للمستخدمين خارج مساحة ملفات تعريف الارتباط
قوائم المستخدمين
يمكن إنشاء قوائم المستخدمين وإدارتها باستخدام واجهة برمجة تطبيقات عروض الأسعار في الوقت الفعلي. بعد إنشائها، يمكنك تعبئة هذه القوائم باستخدام مهام سير عمل مطابقة ملفات تعريف الارتباط. كما هو موضّح أدناه، أو من خلال خدمة أداة التحميل المجمَّع.
البدء
لبدء استخدام "مطابقة ملفات تعريف الارتباط"، عليك التواصل مع المدير التقني للحسابات الذي يمكنه تفعيل مهام سير عمل معيّنة ومساعدتك. اضبط ما يلي:
- رقم تعريف شبكة مطابقة ملفات تعريف الارتباط (NID): رقم تعريف سلسلة يحدِّد بشكلٍ فريد حساب مقدّم عروض أسعار لميزة "مطابقة ملفات تعريف الارتباط" وغيرها من العمليات ذات الصلة
- عنوان URL لمطابقة ملفات تعريف الارتباط: عنوان URL الأساسي لنقطة نهاية ستقبل والتعامل مع الطلبات الواردة في إطار مهام سير عمل مطابقة ملفات تعريف الارتباط. يمكن لمقدّمي عروض الأسعار تضمين وحدات ماكرو في عنوان URL هذا التحكم في ترتيب المعلمات التي يتم تمريرها إليها في سير عمل مطابقة ملفات تعريف الارتباط.
- علامة المطابقة: العلامة التي يجب وضعها في متصفح المستخدم لعرض سير عمل مطابقة ملفات تعريف الارتباط الذي بدأه مقدِّم عرض السعر. يمكن عرضه إلى جانب الإعلانات أو موضوعة على مواقع إلكترونية خارج الإعلانات
- عنوان URL لتقرير مطابقة ملفات تعريف الارتباط (اختياري): في الاتجاه الأحادي سير عمل مطابقة ملفات تعريف الارتباط، فهذا عنوان URL اختياري يمكن تقديمه تحديد نقطة نهاية ستتلقى تفاصيل الخطأ في حالة حدوث ملف تعريف الارتباط هذا فشل المطابقة عبر إعادة توجيه HTTP 302. وبشكلٍ افتراضي، ستكون الردود إلى عنوان URL هذا إذا كان هناك خطأ في عملية مطابقة ملف تعريف الارتباط، ولكن قد يطلب مقدم عرض السعر إرسال إعادة التوجيه دائمًا.
- عنوان URL للمساعدة في مطابقة ملفات تعريف الارتباط: بالنسبة إلى عمليات التبادل التي تنفّذ آلية عمل المساعدة في مطابقة ملفات تعريف الارتباط، عنوان URL الأساسي لنقطة النهاية التي تهدف إلى الاستجابة للطلبات الواردة.
- نسبة المساعدة في مطابقة ملفات تعريف الارتباط: بالنسبة إلى عمليات التبادل التي تنفّذ آلية عمل المساعدة في مطابقة ملفات تعريف الارتباط، الحد الأقصى لعدد الطلبات التي يمكن أن يتلقّاها عنوان URL لمطابقة ملفات تعريف الارتباط كل ثانيًا. والهدف من ذلك هو منع طلبات CMA من تحميل عبء زائد على لخوادم التبادل بالطلبات.
وحدات ماكرو لمطابقة ملفات تعريف الارتباط
في أيٍّ من مهام سير عمل "مطابقة ملفات تعريف الارتباط" المتاحة، عادةً ما يكون عنوان URL لمطابقة ملفات تعريف الارتباط التابع لمقدِّم عرض أسعار مُلحقًا في طلب غير مضمون. مقدمو عروض الأسعار الذين لديهم عمليات دمج تتطلب اتساقًا يمكن أن يؤدي ترتيب المعلمات إلى وضع وحدات الماكرو في عنوان URL لمطابقة ملفات تعريف الارتباط ضمان موضعها.
وحدات الماكرو المتوافقة
يمكن لمقدّمي عروض الأسعار اختياريًا ضبط عنوان URL لمطابقة ملفات تعريف الارتباط لتضمين عنوان URL واحد أو
المزيد من وحدات ماكرو في شكل %%GOOGLE_<PARAM_NAME>%%
أو
%%GOOGLE_<PARAM_NAME>_PAIR%%
تتضمن وحدات الماكرو المتوافقة
القيم الموسّعة هي:
وحدة الماكرو | قيمة موسّعة |
---|---|
GOOGLE_GID | GOOGLE_USER_ID |
GOOGLE_GID_PAIR | &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
، ويتطلّب تنفيذها
المَعلمات التي حدّدها مقدِّم عروض الأسعار مسبقًا، بالإضافة إلى ميزة مطابقة Pixel
بالترتيب التالي: google_push
،
google_gid
وgoogle_cver
و
google_error
ويمكن لمقدِّم عرض السعر تحقيق ذلك من خلال ضبط
عنوان URL لمطابقة ملف تعريف الارتباط في:
https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%
عندما ترسل Google طلب مطابقة لاحقًا إلى مقدِّم عرض السعر هذا، سيتم توسيعه. إلى شيء مثل ما يلي:
https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3
سير عمل خدمة مطابقة ملفات تعريف الارتباط
تتيح خدمة مطابقة ملفات تعريف الارتباط من Google حاليًا ثلاثة مهام سير عمل حالات الاستخدام المختلفة الموضحة أدناه.
بدأه نظام عروض الأسعار: مطابقة ملفات تعريف الارتباط الثنائية الاتجاه
وتشير مطابقة ملفات تعريف الارتباط الثنائية الاتجاه إلى سير عمل يبدأه مقدّم عروض الأسعار، حيث يشير يضع علامة مطابقة في متصفح المستخدم يوجّهها إلى Google. هذا النمط لـ Google ومقدّم عرض السعر بتعبئة جداول المطابقة. في ما يلي مثال بسيط على سير العمل هذا.
الخطوة 1: وضع علامة المطابقة
لبدء هذه العملية، على مقدّم عرض السعر وضع علامة المطابقة على النحو التالي: التي يتم عرضها في متصفح المستخدم علامة مطابقة بسيطة لا يتم عرضها إلا يمكن تنظيم ميزة "رقم تعريف مستخدم Google" إلى مقدِّم عرض السعر على النحو التالي:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />
هناك مَعلمات إضافية يمكنك تضمينها في علامة المطابقة لتنفيذها حالات الاستخدام المختلفة. لمزيد من المعلومات عن هذه المعلمات، راجع مَعلمة عناوين URL الخاصة بالعلامات المطابقة.
الخطوة 2: ردّ Google باستخدام إعادة توجيه بما في ذلك بيانات المطابقة
وستتسبب علامة المطابقة في تلقي خدمة مطابقة ملفات تعريف الارتباط من Google
طلب من متصفح المستخدم، ما سيؤدي إلى إصدار HTTP 302
إعادة التوجيه إلى عنوان URL لمطابقة ملفات تعريف الارتباط التابع لمقدّم عرض السعر. ستتضمن عملية إعادة التوجيه استعلام
المَعلمات التي تحدد رقم تعريف المستخدم في Google ورقم الإصدار في عنوان URL
وسيتلقى مقدّم عرض السعر أيضًا ملف تعريف الارتباط المضمّن في عناوين الطلبات. ضِمن
تدريبًا، بالنسبة إلى عنوان URL لمطابقة ملفات تعريف الارتباط والمحددة على النحو https://ad.network.com/pixel
،
عنوان URL لإعادة التوجيه لعلامة المطابقة البسيطة كما هو موضح أعلاه يمكن أن يبدو مثل
التالي:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
رقم تعريف مستخدم Google الذي يتم تمريره من خلال معلَمة google_gid
هو
بترميز base64 غير مُضاف وآمن على الويب
السلسلة. بالنسبة إلى مقدِّمي عروض الأسعار الذين يختارون استضافة جدول مطابقة، يُنصح بأن
تخزن السلسلة الدقيقة التي تعرضها خدمة مطابقة ملفات تعريف الارتباط. في مرحلة لاحقة
من طلبات عروض الأسعار، فإن هذا يتوافق مع القيم المحددة من خلال BidRequest.google_user_id
في بروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google، أو BidRequest.user.id
في سياسة Google
تنفيذ OpenRTB.
يشير الإصدار المحدد في google_cver
إلى القيمة الرقمية
رقم إصدار معرِّف مستخدم Google. سيقوم User-ID في Google لمستخدم معين
نادرًا ما يتغير، وبعد ذلك سيزيد ذلك.
إذا واجهت Google خطأً أثناء معالجة طلب المطابقة، فإن
سيتم تحديد مَعلمة google_error
بدلاً من ذلك.
الخطوة 3: معالجة نظام عروض الأسعار لإعادة التوجيه والاستجابة باستخدام بكسل
يتلقى مقدّم عرض السعر إعادة توجيه إلى عنوان URL لمطابقة ملفات تعريف الارتباط بما في ذلك والمعلمات التي حددها في الخطوة الأولى، وتلك التي قدمتها Google في الخطوة الثانية. بالإضافة إلى ذلك، سوف يتلقى هؤلاء المستلمون ملف تعريف الارتباط الخاص بهم في بروتوكول HTTP العناوين. إذا تمت العملية بنجاح، يستضيف مقدّم عرض السعر جدول المطابقة الخاص به مطابقة ملف تعريف الارتباط مع رقم تعريف المستخدم في Google المضمّن في الرد. من المهم ننصح بأن يخزّن مقدّمو عروض الأسعار السلسلة الدقيقة التي تعرضها مطابقة ملفات تعريف الارتباط الخدمة.
إذا لم تنجح العملية، سيتلقى مقدّم عرض السعر google_error
في إعادة التوجيه. هذه قيمة رقمية تتجاوب مع مختلف
التي تحدد الخطأ المعين الذي حدث. يمكنك معرفة
مزيد من المعلومات حول قيم الأخطاء المحتملة هنا.
إذا تلقيت رسالة خطأ، يمكنك محاولة المطابقة مع هذا المستخدم مرة أخرى عن طريق
وضع علامة مطابقة جديدة.
يجب أن يتجاوب مقدّم عرض السعر دائمًا من خلال عرض صورة بكسل غير مرئية بحجم 1×1، أو
أو عرض الرد HTTP 204
ليس هناك محتوى
مخطّط سير عمل مطابقة ملفات تعريف الارتباط
يتم توضيح سير العمل هذا من خلال الرسم التخطيطي أدناه، حيث تظهر الطلبات يتم تمثيل الردود بسهم، وعناصر البيانات المصاحبة لها مدرجة بين قوسين.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching.png?authuser=4&hl=ar)
مَعلمات عناوين URL لعلامة المطابقة
المعلمة | الوصف |
---|---|
google_nid |
رقم تعريف الشبكة (NID) لحساب مقدِّم عروض الأسعار. يمكن استرداد هذا المعرّف. من خلال أنظمة عروض الأسعار المصدر. |
google_cm |
الإشارة إلى خدمة مطابقة ملفات تعريف الارتباط من Google التي يجب أن تعمل مطابقة ملفات تعريف الارتباط. ويتم تجاهل قيمة المَعلمة وقد يتم تم حذفها. |
google_sc |
تم إيقاف هذه المعلمة نهائيًا. لضبط ملف تعريف ارتباط Google والمستخدم إذا لم يكن موجودًا. ويتم تجاهل قيمة المعلَمة وقد . يؤدي حذف المَعلمة إلى حدوث خطأ في حال عدم توفُّر ملف تعريف ارتباط. الموجودة. |
google_no_sc |
تم إيقاف هذه المعلمة نهائيًا. ويشير هذا إلى خدمة مطابقة ملفات تعريف الارتباط بأنه يجب ألا تضبط ملف تعريف ارتباط للمستخدم إذا واحد غير موجود. ويتم تجاهل قيمة المَعلمة وقد يتم تم حذفها. |
google_hm |
البيانات التي يريد نظام عروض الأسعار تخزينها في جدول المطابقات التي تستضيفها Google
القيمة هي سلسلة بترميز base64 متوافقة مع الويب آمنة (المساحة المتروكة اختيارية). يجب أن تكون البيانات الأولية 40
بايت أو أقل. مثلاً: |
google_redir |
سلسلة مرمّزة بعنوان URL يمكن لنظام عروض الأسعار تحديدها إذا كان يريد توجيهها
سترسل Google عملية إعادة التوجيه HTTP 302 إلى عنوان URL المرمّز للنطاق
علامة المطابقة هذه. وهذا يسمح بوضع Google في المقدمة في سلسلة
أو نداء إلى الشركاء. سيؤدي ذلك إلى حدوث خطأ إذا تم تحديدها بدون
google_hm ، أو مع google_cm . |
google_ula |
سلسلة تُستخدَم لإضافة المستخدم إلى قائمة مستخدمين حالية. القيمة
التنسيق المتوقع هو userlistid[,timestamp] :
يمكن تكرار مَعلمة عنوان URL هذه لإضافة المستخدِم إلى حسابات متعدّدة القوائم. |
gdpr |
يشير إلى أنّ الطلب يخضع لقيود اللائحة العامة لحماية البيانات على البيانات
الاستخدام. لمزيد من التفاصيل، راجع
متطلبات موافقة المستخدم في الاتحاد الأوروبي أدناه، أو التأثير في مطابقة ملفات تعريف الارتباط
الأهلية في
مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب IAB في "الشراة المعتمَدون"
مثلاً: |
gdpr_consent |
سلسلة الموافقة والشفافية التي تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، راجع متطلبات موافقة المستخدم في الاتحاد الأوروبي أدناه أو كيف سيتم تمرير سلسلة الموافقة والشفافية؟ في مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب IAB في "الشراة المعتمَدون" |
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
- تقرأ خدمة Cookie Match ملف تعريف ارتباط Google الخاص بـ "سارة"، وترسل ملف تعريف ارتباط
في المتصفح إعادة توجيه إلى عنوان URL لمطابقة ملفات تعريف الارتباط في FinestDSP باستخدام
تم ضبط المعلمتَين
google_user_id
وgoogle_cver
. - يُحمِّل متصفّح مها إعادة التوجيه إلى عنوان URL لمطابقة ملفات تعريف الارتباط في FinestDSP.
- تعالج نقطة نهاية مطابقة ملفات تعريف الارتباط في FinestDSP طلب إعادة التوجيه،
والذي يتضمن معلمات عناوين URL التي حددتها Google، وملف تعريف الارتباط الخاص بها لسارة في
عناوين HTTP: يستطيع FinestDSP الآن تخزين تعيين ملف تعريف الارتباط الخاص به
"
google_user_id
" في جدول المطابقة. - يستجيب FinestDSP لعملية إعادة التوجيه بدقة 1x1 بكسل غير مرئية.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie-matching-schematic.png?authuser=4&hl=ar)
السيناريو 2: المستخدم لديه التعيين الحالي
بعد أسبوع من السيناريو 1، تزور فاطمة موقع ExampleNews.com مرة أخرى. الآن بعد أن أصبحت جين على كل من ملفات تعريف الارتباط لكل من نظام عروض الأسعار و"مدير الإعلانات" على الجهاز، إليك كيفية مطابقة أعماله.
- يتم عرض صفحة الويب، ما يؤدي إلى طلب Google (مدير إعلانات Google) الإعلانات التي سيتم عرضه على الصفحة.
- خلال مزاد الإعلانات، ترسل Google طلب عرض سعر إلى مقدِّمي عروض الأسعار المناسبين بما في ذلك FinestDSP.
- يتلقى FinestDSP طلب عرض السعر، بما في ذلك إشارات مثل
google_user_id
- يبحث FinestDSP عن
google_user_id
في جدول المطابقة. ويجد ملف تعريف الارتباط المرتبط بجين الذي تم إنشاؤه قبل أسبوع (في السيناريو 1). - استنادًا إلى المعلومات المرتبطة بملف تعريف الارتباط، فإن عروض أسعار FinestDSP تقديم عرض سعر على مرة الظهور، ويفوز بالمزاد.
- قد تظهر لسارة إعلانًا مخصَّصًا لاهتماماتها، ويستند إلى المعلومات التي يمتلكها FinestDSP.
بدأه مقدِّم عروض الأسعار: مطابقة ملفات تعريف الارتباط الأحادية الاتجاه
تشبه مطابقة ملفات تعريف الارتباط الأحادية الاتجاه سير العمل الثنائي الاتجاه،
باستثناء أنه تم تعديله بحيث لا يستضيف Google سوى 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
التي تمت تعبئتها بـ
بيانات ملفات تعريف الارتباط بترميز base64 الآمن على الويب. قد يظهر عنوان 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 الخاص بمقدِّم عرض السعر
عنوان 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: يعرض تطبيق Bidder وحدة بكسل شفافة 1x1
يجب أن يستجيب مقدّم عرض السعر من خلال عرض بكسل 1x1 شفاف على المتصفح.
مخطّط بياني لسير عمل "مطابقة ملفات تعريف الارتباط" للمستخدمين من الولايات الأمريكية التي تفرض قيودًا متعلّقة بالخصوصية
يوضّح الرسم البياني سير العمل التلقائي للمستخدمين المقيمين في الولايات الأمريكية التي تفرض قيودًا متعلّقة بالخصوصية. أدناه، حيث يتم تمثيل الطلبات والردود بسهم، ويتم يتم سرد العناصر المصاحبة لهم بين قوسين.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching_ca.png?authuser=4&hl=ar)
معلمات عناوين URL لإعادة توجيه مقدِّم عرض السعر إلى خدمة مطابقة ملفات تعريف الارتباط من Google
المعلمة | الوصف |
---|---|
google_nid |
رقم تعريف الشبكة (NID) لحساب مقدِّم عروض الأسعار. يمكن استرداد هذا المعرّف. من خلال أنظمة عروض الأسعار المصدر. |
google_sc |
تم إيقاف هذه المعلمة نهائيًا. لضبط ملف تعريف ارتباط Google والمستخدم إذا لم يكن موجودًا. ويتم تجاهل قيمة المعلَمة وقد . يؤدي حذف المَعلمة إلى حدوث خطأ في حال عدم توفُّر ملف تعريف ارتباط. الموجودة. |
google_no_sc |
تم إيقاف هذه المعلمة نهائيًا. ويشير هذا إلى خدمة مطابقة ملفات تعريف الارتباط بأنه يجب ألا تضبط ملف تعريف ارتباط للمستخدم إذا واحد غير موجود. ويتم تجاهل قيمة المَعلمة وقد يتم تم حذفها. |
google_hm |
يحتوي على بيانات يريد نظام عروض الأسعار تخزينها في مطابقة تستضيفها Google المؤقت. |
google_redir |
تمثّل هذه السمة عنوان URL مشفّرًا تريد أن يرسل إليه محرّك بحث Google عملية إعادة التوجيه HTTP 302. تشير رسالة الأشكال البيانية
سيتلقّى عنوان URL المحدّد عمليات إعادة توجيه مع google_error .
لكل من الأخطاء والعمليات الناجحة. |
google_ula |
سلسلة تُستخدَم لإضافة المستخدم إلى قائمة مستخدمين حالية. القيمة
التنسيق المتوقع هو userlistid[,timestamp] :
يمكن تكرار مَعلمة عنوان URL هذه لإضافة المستخدِم إلى حسابات متعدّدة القوائم. |
gdpr |
يشير إلى أنّ الطلب يخضع لقيود اللائحة العامة لحماية البيانات على البيانات
الاستخدام. لمزيد من التفاصيل، راجع
متطلبات موافقة المستخدم في الاتحاد الأوروبي أدناه، أو التأثير في مطابقة ملفات تعريف الارتباط
الأهلية في
مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب IAB في "الشراة المعتمَدون"
مثلاً: |
gdpr_consent |
سلسلة الموافقة والشفافية التي تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، راجع متطلبات موافقة المستخدم في الاتحاد الأوروبي أدناه أو كيف سيتم تمرير سلسلة الموافقة والشفافية؟ في مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب IAB في "الشراة المعتمَدون" |
process_consent |
تشير إلى أنّ مقدِّم عرض السعر حصل على موافقة المستخدم النهائي على استخدامات البيانات المحدّدة في
سياسة موافقة المستخدم في الاتحاد الأوروبي المتّبعة في Google
إذا لم يكن الطلب خاضعًا لسياسة موافقة المستخدم في الاتحاد الأوروبي، أو إذا كانت هناك
هل مَعلمات الموافقة الأخرى المتوفّرة في الطلب
( مثلاً: |
مَعلمات عناوين URL لإعادة توجيه Google إلى عنوان URL لتقرير مطابقة ملفات تعريف الارتباط الخاص بمقدِّم عرض السعر
المعلمة | الوصف |
---|---|
google_error |
قيمة عددية تشير إلى خطأ الطلب الإجمالي. فعندما
فإنها تشير إلى أنه لم يتم إجراء أي عمليات، ولم يتم إجراء أي
سيتم ضبط
|
التشغيل الذي بدأته Google: مطابقة Pixel ثنائية الاتجاه
"مطابقة وحدات البكسل ثنائية الاتجاه" هي سير عمل لمطابقة ملفات تعريف الارتباط من Google خدمة تحاول فيها Google مطابقة رقم تعريف مستخدم من Google مع حساب خوارزمي المستخدم الذي اختار عرض أسعار آخر بخلاف الفائز في مزاد "عرض الأسعار في الوقت الفعلي". عندما يكون الإعلان موضعها، سيضع Google علامة مطابقة توجه متصفح المستخدم لتحميل بكسل شفاف من عنوان URL لمطابقة ملفات تعريف الارتباط الخاص بمقدِّم عرض السعر الذي تم اختياره. سيمكن هذا كلّ من Google ومقدِّم عرض السعر لتعبئة جدول مطابقة مع مستخدِم معيّن. في ما يلي مثالاً بسيطًا على سير العمل هذا.
الخطوة 1: تضع Google علامة مطابقة
عند تحميل صفحة ناشر مشارك في متصفّح المستخدم
تملأ Google الشريحة الإعلانية الموجودة على هذه الصفحة، يمكن أن يتم وضع علامة مطابقة
يطلب وحدة بكسل من نظام عروض أسعار محدد خوارزميًا. مطابقة Pixel
تجمع هذه العلامة التي وضعتها Google عنوان URL لمطابقة ملفات تعريف الارتباط لدى مقدِّم عرض السعر مع
المعلمات الإضافية
التي يمكن لمقدم عروض الأسعار استخدامها لتعبئة جدول المطابقة. بالنسبة إلى عنوان URL لمطابقة ملفات تعريف الارتباط
محددة على أنها https://ad.network.com/pixel
، فإنها مهيكلة على النحو التالي
التالي:
<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />
الخطوة 2: يجب أن يستجيب نظام عروض الأسعار من خلال إعادة التوجيه إلى عنوان URL لخدمة مطابقة ملفات تعريف الارتباط من Google
وعلى مقدِّمي عروض الأسعار الذين يتلقّون طلبات مطابقة وحدات البكسل أن يجيبوا عن طريق تقديم إعادة التوجيه إلى خدمة مطابقة ملفات تعريف الارتباط من Google والمهيكلة على النحو التالي:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
لاحظ أن عنوان URL لإعادة التوجيه أعلاه مشابه لعنوان URL المستخدم في
علامة مطابقة لسير عمل مطابقة ملفات تعريف الارتباط التي بدأها مقدِّم عرض السعر.
في مطابقة Pixel، يتم استبدال مَعلمة google_cm
بمَعلمة "مطابقة وحدات البكسل".
المعلمة google_push
، ويجب أن تكون قيمتها مساوية للقيمة
المقدمة من Google في الطلب. تشبه أيضًا استراتيجية عروض الأسعار التي بدأها مقدِّم عرض الأسعار
سير العمل، المعلَمات الإضافية
يمكن تحديدها لتنفيذ حالات استخدام إضافية.
الخطوة 3: معالجة Google لعملية إعادة التوجيه والاستجابة باستخدام بكسل
تُسجّل Google أنه تم إنشاء مطابقة للمستخدم وتعالج أي العمليات الإضافية المطلوبة من خلال معلَمات طلب البحث وأخيرًا، تستجيب Google باستخدام بكسل شفاف 1×1.
مخطّط سير عمل مطابقة وحدات البكسل
يتم توضيح سير العمل هذا من خلال الرسم التخطيطي أدناه، حيث تظهر الطلبات يتم تمثيل الردود بسهم، وعناصر البيانات المصاحبة لها مدرجة بين قوسين.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/pixel_matching.png?authuser=4&hl=ar)
مَعلمات طلب علامة مطابقة 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 لا تتضمن معلمة تحدد ID، ولكنها ستستمر في تعبئة جدول المطابقات التي تستضيفها 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
التي تمت تعبئتها بـ
بيانات ملفات تعريف الارتباط بترميز base64 الآمن على الويب. قد يظهر عنوان 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
لبروتوكول Google
تنفيذ OpenRTB. يمكن لمقدّمي عروض الأسعار أيضًا تعبئة قوائم المستخدمين باستخدام
يطابق البيانات التي حددها.
وأخيرًا، تعرض Google بكسل شفاف 1×1 إلى متصفح المستخدم.
مساعد مطابقة ملفات تعريف الارتباط
تسمح "عرض الأسعار المفتوح" للتبادلات باستخدام عروض الأسعار التي بدأها مقدِّم عرض السعر. وتبدأه Google عمليات مطابقة ملفات تعريف الارتباط، لمطابقة معرّف المستخدم في Google مع ملف تعريف الارتباط التابع له. بسكويت Match Assist (CMA) هو ميزة إضافية لعمليات التبادل التي تتيح لهم إنشاء جداول مطابقة باستخدام أنظمة عروض أسعار خاصة بهم.
آلية عمل Cookie Match Assist
عند عرض إعلان، تختار Google المشاركة باستخدام خوارزميات تبادل ووضع علامة مساعدة مطابقة ملفات تعريف الارتباط التي تحتوي على ما يلي البنية:
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
تؤدّي علامة مطابقة CMA من Google إلى ظهور عنوان URL لمطابقة ملفات تعريف الارتباط في التبادل استلام طلب وحدة بكسل.
- وتتلقّى نقطة نهاية مطابقة ملفات تعريف الارتباط الخاصة بالتبادل الطلب، حيث يكون فإن خدمة مطابقة ملفات تعريف الارتباط التابعة لها مسؤولة عن مطابقة معرّف المستخدم لأحد مقدمي عروض الأسعار له. في الرسم التخطيطي أدناه، تشير مطابقة ملفات تعريف الارتباط في التبادل تستجيب الخدمة لمتصفّح المستخدم عبر إعادة توجيه إلى عرض السعر والنقاط النهائية.
- يتلقى نظام عرض السعر الطلب، إلى جانب أي معلمات تحدّدها التبادل لمطابقة رقم تعريف المستخدم مع ملف تعريف الارتباط.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_match_assist_diagram.png?authuser=4&hl=ar)
القيود
تحديد عدد مرات ظهور طلبات المطابقة الجديدة
يتحمّل مقدّمو عروض الأسعار مسؤولية الحدّ من عدد الطلبات المتعلّقة بملف تعريف الارتباط. خدمة مطابقة للمستخدمين الذين لديهم إدخال جديد في المطابقة التي تستضيفها Google المؤقت. قد يتم اعتبار أحد الإدخالات في جدول المطابقات المستضافة منتهي الصلاحية خلال 14 يومًا، ويمكن تحديثه بعد ذلك.
الاستجابة لجميع طلبات مطابقة وحدات البكسل
من المتوقّع أن يتجاوب مقدّمو عروض الأسعار الذين يستخدمون سير عمل مطابقة Pixel مع جميع
طلبات مطابقة Pixel Match الواردة مع ردّ، بما في ذلك google_push
. يتيح هذا الإجراء لشركة Google فرض السياسات من خلال مراقبة الاستخدام. إذا
انخفاض معدل استجابة مقدم عرض السعر إلى أقل من 90%، فستقلل Google عدد
طلبات مطابقة Pixel Match التي تم إرسالها إلى حساباتهم
استخدام نقاط نهاية HTTPS
يجب أن تستخدِم نقاط النهاية المستخدَمة في جميع مهام سير عمل "مطابقة ملفات تعريف الارتباط" HTTPS.
عند الرد على طلب "مطابقة Pixel" تم إرساله إليك عبر 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_nid
وgoogle_ula
لإضافة المستخدم إلى القائمة المحددة دون بدء عملية
سير عمل مطابقة ملفات تعريف الارتباط الاطّلاع على القيود
حول استدعاء "خدمة مطابقة ملفات تعريف الارتباط" (Cookie Matching Service) لمزيد من التفاصيل. المقابل
قد تبدو علامة المطابقة على النحو التالي:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
للحصول على استجابة ناجحة، حيث يتم تحديد عنوان URL لمطابقة ملفات تعريف الارتباط لدى مقدّم عرض السعر
https://ad.network.com/pixel
، سيكون عنوان URL لإعادة التوجيه من Google على النحو التالي:
https://ad.network.com/pixel?google_ula=12345,0
إذا كان هناك خطأ عام، على سبيل المثال، لا يتوفّر ملف تعريف ارتباط من Google.
للمستخدم، سيتضمن عنوان URL لإعادة التوجيه
مَعلمة google_error
:
https://ad.network.com/pixel?google_error=3
إذا كان هناك خطأ يتعلق تحديدًا بإضافة المستخدم إلى القائمة،
ستتلقى google_ula
في إعادة التوجيه. وعلى عكس
معلمة علامة المطابقة المقابلة، يؤدي ذلك إلى استبدال الطابع الزمني بحالة
للإشارة إلى نجاح العملية. على سبيل المثال، إذا فشل الطلب
لأنّ حساب مقدِّم عرض السعر لم يكن لديه إذن الوصول إلى قائمة المستخدمين المحدّدة،
سيكون عنوان URL لإعادة التوجيه على النحو التالي:
https://ad.network.com/pixel?google_ula=12345,2
الإضافة إلى قوائم مستخدمين متعدّدة
يمكن لمقدّمي عروض الأسعار تحديد وجوب إضافة مستخدم إلى قوائم مستخدمين متعددة عن طريق
تضمين معلَمات google_ula
متعدّدة في علامة المطابقة. ضِمن
التدريب، فقد يبدو ذلك كما يلي:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />
يتم أيضًا الإبلاغ عن حالة العملية لكل قائمة مستخدمين من خلال
معلَمات google_ula
مختلفة في عملية إعادة التوجيه:
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
في عملية إعادة التوجيه أعلاه، يمكننا ملاحظة أن العملية نجحت للمستخدم
قائمة برقم التعريف 45678
، لكن تعذّر إتمامها لرقم تعريف قائمة المستخدم 12345
وذلك لأنّ مقدِّم عرض السعر لم يكن لديه إذن للوصول إليها.
تنقَّل في سير عمل "مطابقة ملفات تعريف الارتباط" وأضِف المستخدمين إلى قائمة المستخدمين.
لإجراء مطابقة ملفات تعريف الارتباط وإضافة المستخدم إلى قائمة مستخدمين في
الطلب، يجب أن تتضمّن علامة المطابقة الخاصة بمقدِّم عرض السعر google_cm
google_ula
:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />
أن يتضمن عنوان URL لإعادة التوجيه الذي حددته Google google_gid
،
google_cver
وgoogle_ula
قد يبدو هذا مثل
التالي:
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
تخزين مطابقة في جدول المطابقة الذي تستضيفه Google
إذا أراد أحد مقدمي عروض الأسعار تخزين بيانات ملفات تعريف الارتباط في جدول مطابقة تستضيفه Google،
ولا ينوي تخزين المطابقة مع رقم تعريف المستخدم في Google في المطابقة الخاصة به
جدول، يجب أن تتضمن علامة المطابقة المعلمة google_hm
حيث
يجب أن تكون قيمتها سلسلة بترميز base64 متوافقة مع الويب. بالنسبة للمستخدم الذي يكون فيه
بيانات ملفات تعريف الارتباط غير المشفرة الخاصة بمقدِّم عرض السعر هي Cookie number 1!
، بترميز
هي Q29va2llIG51bWJlciAxIQ==
، والتي سيتم استخدامها في
تمامًا كما يلي:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
للحصول على استجابة ناجحة، حيث يتم تحديد عنوان URL لمطابقة ملفات تعريف الارتباط لدى مقدّم عرض السعر
https://cookie-monster.com/pixel
، سيكون عنوان URL لإعادة التوجيه من Google
أن يكون:
https://cookie-monster.com/pixel
ولا تتوفر المَعلمة google_gid
في عملية إعادة التوجيه لأنّ
لم تتضمّن علامة المطابقة google_cm
، وgoogle_hm
هو
ولا يتم تضمينها في الردود الناجحة. في طلبات عروض الأسعار المستقبلية لمرات الظهور
لهذا المستخدم، سيتلقّى مقدّم عرض السعر بيانات المطابقة المستضافة الخاصة به
BidRequest.hosted_match_data
لبروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google
BidRequest.user.buyeruid
لتطبيق OpenRTB من Google.
إذا استخدم نظام عرض السعر علامة مطابقة بدلاً من ذلك، حيث كانت قيمة
لم يكن google_hm
بترميز base64، مثل
chocolate_chunk!
—قد يظهر عنوان URL لإعادة التوجيه بالشكل
التالي:
https://cookie-monster.com/pixel?google_hm=2
يتضمن عنوان URL لإعادة التوجيه أعلاه القيمة google_hm
2
، مما يشير إلى تعذُّر العملية لأن القيمة يمكن أن
أن يتم فك ترميزها.
جداول عروض الأسعار وتلك التي تستضيفها Google مع قوائم المستخدمين
في حال استضاف مقدِّم عرض أسعار قائمة استخدام خاصة به بالإضافة إلى مستخدم تستضيفه Google
ويريد علامة مطابقة واحدة لمطابقة كلا الجدولين وإضافة المستخدم إلى
في قائمة مستخدمين محددة، يجب أن تتضمن علامة المطابقة الخاصة بهم google_cm
،
المعلمتان google_hm
وgoogle_ula
. إذا لم يحدد
Cookie number 1!
، فستكون القيمة المشفرة
Q29va2llIG51bWJlciAxIQ==
، التي ستُنتج علامة مطابقة مثل
التالي:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
للحصول على استجابة ناجحة، حيث يتم تحديد عنوان URL لمطابقة ملفات تعريف الارتباط لدى مقدّم عرض السعر
https://cookie-monster.com/pixel
، سيكون عنوان URL لإعادة التوجيه من Google
على النحو التالي:
https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0
عند تلقّي إعادة التوجيه، يمكن أن يتطابق مقدّم عرض السعر مع رقم تعريف مستخدم Google المحدّد.
في google_gid
باستخدام بيانات ملفات تعريف الارتباط في جدول المطابقة. ضِمن
بالإضافة إلى ذلك، يمكنه تحديد أن جدول المطابقة وقائمة المستخدمين التي تستضيفها Google
العمليات ناجحة. ونتيجةً لذلك، فإنّ أي استهداف مسبق لمقدّم عرض الأسعار
عند الضبط على استهداف رقم تعريف قائمة المستخدمين المحدّد، سيجعل مقدّم عرض السعر الآن
تلقّي طلبات عروض الأسعار مقابل مرات الظهور من المستخدم وبالمثل، في عرض السعر هذا
المستخدم، سيتلقى مقدّم عرض السعر بيانات المطابقة المستضافة الخاصة به
BidRequest.hosted_match_data
لبروتوكول عرض الأسعار في الوقت الفعلي (RTB) من Google
BidRequest.user.buyeruid
لتطبيق OpenRTB من Google.