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

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

المفاهيم

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

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

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

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

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

جداول المطابقة المستضافة على Google

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

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

    .

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

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

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

يمكن إنشاء قوائم المستخدمين وإدارتها باستخدام Real-Time Bidding API. بعد إنشائها، يمكنك تعبئة هذه القوائم باستخدام سير عمل مطابقة ملفات تعريف الارتباط описанة أدناه، أو من خلال خدمة أداة التحميل المجمّع.

البدء

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

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

يشير الإصدار المحدّد في google_cver إلى الرقم المبرمَج لرقم إصدار معرّف مستخدم Google. لن يتغيّر رقم تعريف مستخدم Google لمستخدِم معيّن إلا بشكلٍ غير متكرّر، وبعد ذلك سيتمّ زيادته.

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

الخطوة 3: يعالج مقدّم عروض الأسعار عملية إعادة التوجيه ويردّ باستخدام وحدة البكسل.

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

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

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

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

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

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

البيانات التي يريد مقدّم عروض الأسعار تخزينها في جدول مطابقة يستضيفه Google

القيمة هي سلسلة تم ترميزها باستخدام base64 وآمنة على الويب (التمديد اختياري). يجب أن تكون البيانات الأولية 40 بايت أو أقل. مثلاً: Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مثلاً: process_consent=T
المَعلمة الوصف
google_error

قيمة عددية تشير إلى خطأ الطلب الإجمالي. وعند تلقّيه، يوضِّح أنّه لم يتم إجراء أي عمليات ولن يتم ضبط معلَمات استجابة google_ أخرى. تشمل قيم الخطأ المسموح بها ما يلي:

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

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

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

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

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

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

الرسم التوضيحي لسير عمل "مطابقة الصور" في Pixel

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

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

المَعلمة الوصف
google_gid رقم تعريف مستخدم Google بالنسبة إلى المستخدِمين الذين لا ينتمون إلى إحدى الولايات الأمريكية التي تفرض قيودًا على الخصوصية، سيتم تحديد ذلك دائمًا في علامة المطابقة من Google.
google_cver إصدار ملفّ تعريف الارتباط وسيتم تحديد ذلك دائمًا في علامة مطابقة Google.
google_push يشير هذا الرمز إلى أنّ هذا الطلب يؤدي إلى بدء سير عمل مطابقة Pixel. يجب عرض القيمة من خلال المَعلمة المقابلة في ردّ إعادة التوجيه لمقدّم عروض الأسعار.
gdpr_consent سلسلة TC تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، يُرجى الاطّلاع على [متطلبات موافقة المستخدِم في الاتّحاد الأوروبي](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) أدناه، أو على **كيف سيتمّ تمرير سلسلة الموافقة والشفافية؟** في [مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب IAB والمخصّصة للمشترين المعتمَدين](//support.google.com/authorizedbuyers/answer/9789378).

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

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

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

يمكن تكرار مَعلمة عنوان URL هذه لإضافة المستخدِم إلى قوائم متعدّدة.
gdpr_consent سلسلة TC تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، يُرجى الاطّلاع على [متطلبات موافقة المستخدِم في الاتّحاد الأوروبي](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) أدناه، أو على **كيف سيتمّ تمرير سلسلة الموافقة والشفافية؟** في [مستندات الإصدار 2.0 من إطار الشفافية والموافقة الصادر عن مكتب IAB والمخصّصة للمشترين المعتمَدين](//support.google.com/authorizedbuyers/answer/9789378).

مبادرة من 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.

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

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

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

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

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

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

    <img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>

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

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

القيود

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

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

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

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

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

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

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

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

أمثلة

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

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

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

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

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

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

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

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

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

الإضافة إلى قائمة مستخدم واحد

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