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

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

المفاهيم

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

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

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

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

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

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

لتسهيل الصيانة وتحسين وقت الاستجابة والوصول إلى بيانات المطابقة للمستخدمين في مناطق معيّنة، ننصحك بالسماح لشركة Google باستضافة جدول المطابقة. يتيح لك ذلك تحديد سلسلة بترميز base64 آمنة على الويب، والتي يُشار إليها في ما بعد باسم "بيانات المطابقة المستضافة"، والتي سيتم ربطها بـ رقم تعريف مستخدم 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 سلسلة موافقة وشفافية تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، يُرجى الاطّلاع على متطلبات موافقة المستخدِم في الاتّحاد الأوروبي أدناه، أو كيف سيتمّ تمرير سلسلة الموافقة والشفافية؟ في مستندات الإصدار 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: تم تقديم رقم تعريف مستخدم غير صالح في علامة المطابقة.
  • 7: تم رصد ملف تعريف ارتباط غير صالح.
  • 8: ميزة متوقّفة نهائيًا لم يتم العثور على ملفّ تعريف ارتباط.
  • 9: لم يتم العثور على ملف تعريف ارتباط، وتم إجراء محاولة لضبط ملف تعريف ارتباط تجريبي.
  • 10: تم استخدام المَعلمة google_redir بدون تحديد google_hm، أو تم استخدامها بالإضافة إلى google_cm.
  • 15: يأتي الطلب من منطقة تتطلّب من 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 ("مدير إعلانات 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 لبروتوكول Google RTB الذي تم إيقافه نهائيًا. يمكن لمقدّمي عروض الأسعار أيضًا تعبئة قوائم المستخدمين باستخدام بيانات المطابقة المستضافة التي حدّدوها.

أمّا في حال حدوث خطأ، فسيتم إرسال إعادة توجيه من 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

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

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

المَعلمة الوصف
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 سلسلة موافقة وشفافية تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، يُرجى الاطّلاع على متطلبات موافقة المستخدِم في الاتّحاد الأوروبي أدناه، أو كيف سيتمّ تمرير سلسلة الموافقة والشفافية؟ في مستندات الإصدار 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 كجزء من طلب مطابقة ثنائية الاتجاه لوحدة البكسل. يجب أن تضبط إعادة التوجيه google_push على القيمة نفسها التي تم تمريرها إليك في طلب وحدة البكسل الأولي.
  • 6: تم تقديم رقم تعريف مستخدم غير صالح في علامة المطابقة.
  • 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 يشير إلى أنّ هذا الطلب يبدأ سير عمل "مطابقة البكسل". يجب عرض القيمة من خلال المَعلمة المقابلة في ردّ إعادة التوجيه لمقدّم عروض الأسعار.
gdpr_consent سلسلة موافقة وشفافية تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، يُرجى الاطّلاع على [متطلبات موافقة المستخدِم في الاتّحاد الأوروبي](/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 سلسلة موافقة وشفافية تمثّل موافقة المستخدم النهائي لمزيد من التفاصيل، يُرجى الاطّلاع على [متطلبات موافقة المستخدِم في الاتّحاد الأوروبي](/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 عدد طلبات مطابقة علامات البكسل المُرسَلة إلى حسابه.

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

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

عند الردّ على طلب مطابقة وحدة البكسل الذي يتم إرساله إليك عبر 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==، ما سيؤدي إلى إنشاء علامة مطابقة مثلCookie number 1! التالي:

<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 الذي تمّ إيقافه نهائيًا.