تطبیق کوکی

تطبیق کوکی ویژگی‌ای است که به شما امکان می‌دهد کوکی خود را - به عنوان مثال، شناسه کاربری که وب‌سایت شما را مرور کرده است - با شناسه کاربر Google خاص پیشنهاد دهنده مطابقت دهید و فهرست‌های کاربری بسازید که می‌تواند به شما کمک کند انتخاب‌های پیشنهادی مؤثرتری داشته باشید. این راهنما مفاهیم مورد استفاده در Cookie Matching و همچنین گردش‌های کاری مختلف Cookie Matching و هر گونه تغییراتی که ممکن است برای موارد استفاده خاص داشته باشند را شرح می‌دهد.

مفاهیم

صاحبان دامنه معمولاً محتویات کوکی ها را برای کاربرانی که سایت آنها را مرور می کنند تنظیم می کنند که برای شناسایی کاربران در آن دامنه استفاده می شود. حتی اگر دو صاحب دامنه در غیر این صورت با مبادله این داده ها موافقت کنند، مدل امنیتی مرورگرهای اینترنتی فرد را از خواندن کوکی تنظیم شده توسط دامنه دیگر محدود می کند.

در زمینه تبلیغات دیجیتال، Google کاربران را با کوکی‌هایی که به دامنه doubleclick.net تعلق دارند شناسایی می‌کند و پیشنهاد دهندگانی که در مناقصه بلادرنگ شرکت می‌کنند ممکن است دامنه خود را داشته باشند که در آن تعدادی از کاربرانی را که می‌خواهند تبلیغات نشان دهند شناسایی می‌کنند. تطبیق کوکی به پیشنهاددهنده امکان می‌دهد کوکی‌های خود را با کوکی‌های Google تطبیق دهد، به طوری که آنها می‌توانند تعیین کنند که آیا نمایش ارسال شده در یک درخواست پیشنهاد با یکی از کاربران مورد هدف مرتبط است یا خیر، آنها داده‌های کوکی خود را دریافت خواهند کرد یا یک شناسه کاربر Google خاص پیشنهاد دهنده را دریافت خواهند کرد. که یک فرم رمزگذاری شده از کوکی doubleclick.net در درخواست پیشنهاد است.

سرویس تطبیق کوکی که در این راهنما توضیح داده شده است، ایجاد و حفظ ارتباط بین کوکی پیشنهاددهنده و شناسه کاربری Google را تسهیل می‌کند، و همچنین به فرد اجازه می‌دهد لیست‌های کاربران را پر کند.

جداول مطابقت

یک جدول تطبیق می تواند برای نگاشت یک شناسه یا داده های دیگر از یک دامنه به دامنه دیگر استفاده شود. مناقصه‌دهندگان می‌توانند از سرویس تطبیق کوکی‌ها برای پر کردن جدول‌های تطبیق خود با نگاشت کوکی خود برای یک کاربر معین در شناسه کاربر Google کاربر، یا برای پر کردن جدول تطبیق میزبانی شده توسط Google استفاده کنند. جداول تطبیق برای برنامه مناقصه‌دهنده برای دسترسی به داده‌های کوکی برای کاربر که برداشت نشان داده می‌شود، ضروری است.

جداول مسابقه میزبانی شده توسط گوگل

برای نگهداری آسان‌تر، بهبود تأخیر، و دسترسی به داده‌های مطابقت برای کاربران در مناطق خاص، توصیه می‌شود به Google اجازه دهید جدول مسابقه شما را میزبانی کند. این به شما امکان می‌دهد یک رشته رمزگذاری شده مبتنی بر وب ایمن (که از این به بعد به عنوان داده‌های بازی میزبانی‌شده نامیده می‌شود) را مشخص کنید که به شناسه کاربری Google برای یک کاربر معین نگاشت می‌شود. هنگامی که یک مسابقه ایجاد شد، می توان از آن به روش های زیر استفاده کرد:

  • مناقصه بلادرنگ : در درخواست‌های پیشنهادی بعدی برای نمایش‌های مرتبط با کاربر، Google داده‌های بازی میزبانی‌شده را که با شناسه کاربری Google آنها مطابقت داده‌اید برای شما ارسال می‌کند. اگر نقطه پایان مناقصه شما برای استفاده از پروتکل RTB Google پیکربندی شده باشد، آن را به صورت بایت های رمزگشایی شده از طریق فیلد BidRequest.hosted_match_data دریافت خواهید کرد. در پیاده‌سازی OpenRTB Google، BidRequest.user.buyeruid این داده‌ها را به‌عنوان یک رشته کدگذاری شده مبتنی بر وب امن برمی‌گرداند.

  • فهرست‌های کاربر : فهرست‌های کاربران را می‌توان با شناسه‌های کاربری Google یا داده‌های بازی میزبانی شده پر کرد.

  • پیش هدف گذاری : می توانید پیش هدف گذاری خود را به گونه ای پیکربندی کنید که فقط درخواست های پیشنهادی حاوی داده های مسابقه میزبانی شده را دریافت کنید. این می تواند برای حذف برداشت های کمتر مرتبط برای کاربران خارج از فضای کوکی شما استفاده شود.

لیست های کاربران

لیست‌های کاربر را می‌توان با API پیشنهادی بلادرنگ ایجاد و مدیریت کرد. پس از ایجاد، می‌توانید این فهرست‌ها را با گردش‌های کاری تطبیق کوکی که در زیر توضیح داده شده است، یا از طریق سرویس آپلود انبوه پر کنید.

شروع شدن

برای شروع با Cookie Matching، باید با مدیر حساب فنی خود تماس بگیرید، که می‌تواند گردش‌های کاری خاص را فعال کند و به شما در پیکربندی موارد زیر کمک کند:

  • شناسه شبکه تطبیق کوکی (NID) : شناسه رشته ای که منحصراً یک حساب پیشنهاد دهنده برای تطبیق کوکی و سایر عملیات مرتبط را شناسایی می کند.
  • نشانی اینترنتی تطبیق کوکی : نشانی وب پایه برای نقطه پایانی که درخواست‌های دریافتی را به عنوان بخشی از گردش‌های کاری تطبیق کوکی می‌پذیرد و رسیدگی می‌کند. پیشنهاد دهندگان می توانند ماکروها را در این URL جاسازی کنند تا ترتیب پارامترهای ارسال شده به آن را در گردش کار Cookie Matching کنترل کنند.
  • Match Tag : برچسبی که باید در مرورگر کاربر برای گردش کار Cookie Matching آغاز شده توسط پیشنهاد دهنده قرار دهید. این را می توان در کنار تبلیغات ارائه کرد یا در ویژگی های وب خارج از تبلیغات قرار داد.
  • URL گزارش تطبیق کوکی (اختیاری): در گردش کار تطبیق کوکی یک جهته، این یک URL اختیاری است که می تواند برای تعیین نقطه پایانی ارائه شود که در صورت عدم موفقیت تطبیق کوکی از طریق تغییر مسیر HTTP 302، جزئیات خطا را دریافت می کند. به‌طور پیش‌فرض، پاسخ‌ها تنها در صورتی به این URL ارسال می‌شوند که در عملیات تطبیق کوکی خطایی وجود داشته باشد، اما پیشنهاددهنده ممکن است درخواست کند که تغییر مسیر همیشه ارسال شود.
  • نشانی اینترنتی کمک تطبیق کوکی : برای صرافی‌هایی که گردش کار کمک تطبیق کوکی را اجرا می‌کنند، این نشانی وب پایه نقطه پایانی است که برای پاسخ به درخواست‌های دریافتی در نظر گرفته شده است.
  • سهمیه کمک تطبیق کوکی : برای صرافی هایی که گردش کار کمک تطبیق کوکی را اجرا می کنند، این حداکثر تعداد درخواست هایی است که URL تطبیق کوکی آنها می تواند در هر ثانیه دریافت کند. این به منظور جلوگیری از بارگیری بیش از حد درخواست‌های CMA با درخواست‌ها، سرورهای صرافی است.

در هر یک از جریان‌های کاری Cookie Matching پشتیبانی شده، 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 Matching به ترتیب زیر نیاز دارد: 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" />

پارامترهای اضافی وجود دارد که می توانید در تگ مطابقت بگنجانید تا موارد استفاده مختلف را برآورده کنید. برای کسب اطلاعات بیشتر در مورد این پارامترها، به Match Tag URL Parameters مراجعه کنید.

مرحله 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 ارسال می‌شود، یک رشته رمزگذاری‌شده مبتنی بر وب بی‌خطر است. برای مناقصه‌دهندگانی که برای میزبانی میز مسابقه انتخاب می‌کنند، توصیه می‌شود که رشته‌ای را که توسط سرویس تطبیق کوکی بازگردانده شده است، ذخیره کنند. در درخواست‌های پیشنهادی بعدی، این با مقادیر مشخص‌شده از طریق BidRequest.google_user_id در پروتکل RTB Google یا BidRequest.user.id در اجرای OpenRTB Google مطابقت دارد.

نسخه مشخص شده در google_cver شماره نسخه عددی شناسه کاربری Google را نشان می دهد. شناسه کاربری Google برای یک کاربر خاص به ندرت تغییر می‌کند و پس از آن این مقدار افزایش می‌یابد.

اگر Google هنگام پردازش درخواست مطابقت شما با خطا مواجه شود، در عوض یک پارامتر google_error مشخص می‌شود.

مرحله 3: مناقصه‌گر تغییر مسیر را پردازش می‌کند و با پیکسل پاسخ می‌دهد

پیشنهاد دهنده یک تغییر مسیر به URL مطابق کوکی خود شامل پارامترهایی که در مرحله اول مشخص کرده است و پارامترهایی که Google در مرحله دوم ارائه کرده است دریافت می کند. علاوه بر این، آنها کوکی خود را در هدرهای HTTP نیز دریافت خواهند کرد. اگر عملیات موفقیت‌آمیز بود، پیشنهاد دهنده‌ای که میز تطابق خود را میزبانی می‌کند، می‌تواند کوکی خود را با شناسه کاربر Google موجود در پاسخ مطابقت دهد. توصیه می شود که پیشنهاد دهندگان رشته دقیقی را که توسط سرویس تطبیق کوکی برگردانده شده است ذخیره کنند.

اگر عملیات ناموفق بود، پیشنهاد دهنده یک پارامتر google_error در تغییر مسیر دریافت می کند. این یک مقدار عددی مربوط به حالت های خطای مختلف است که خطای خاصی را که رخ داده است مشخص می کند. در اینجا می‌توانید درباره مقادیر خطای احتمالی اطلاعات بیشتری کسب کنید. اگر خطایی دریافت کردید، می‌توانید با قرار دادن یک تگ مطابقت جدید، دوباره برای آن کاربر مطابقت کنید.

پیشنهاد دهنده باید همیشه با ارائه یک تصویر پیکسل نامرئی 1×1 پاسخ دهد، یا در عوض یک پاسخ HTTP 204 بدون محتوا را برگرداند.

این گردش کار با نمودار زیر نشان داده شده است، جایی که درخواست‌ها و پاسخ‌ها با یک فلش نشان داده می‌شوند و اقلام داده‌ای که آنها را همراهی می‌کنند در داخل پرانتز فهرست شده‌اند.

مطابقت با پارامترهای URL برچسب

پارامتر شرح
google_nid شناسه شبکه (NID) برای حساب پیشنهاد دهنده. این شناسه از طریق منبع Bidders قابل بازیابی است.
google_cm به سرویس تطبیق کوکی های Google نشان می دهد که باید تطبیق کوکی ها را انجام دهد. مقدار پارامتر نادیده گرفته می شود و ممکن است حذف شود.
google_sc این پارامتر منسوخ شده است. در صورت عدم حضور کاربر، کوکی Google را برای کاربر تنظیم می کند. مقدار پارامتر نادیده گرفته می شود و ممکن است حذف شود. در صورت عدم وجود کوکی، حذف پارامتر منجر به خطا می شود.
google_no_sc این پارامتر منسوخ شده است. این به سرویس تطبیق کوکی‌های Google نشان می‌دهد که در صورت عدم حضور کاربر، نباید کوکی را برای کاربر تنظیم کند. مقدار پارامتر نادیده گرفته می شود و ممکن است حذف شود.
google_hm

داده‌هایی که پیشنهاد دهنده می‌خواهد در جدول مسابقه میزبانی شده توسط Google ذخیره کند.

این مقدار یک رشته رمزگذاری شده مبتنی بر وب ایمن (base64) است (پدینگ اختیاری است). داده های خام باید 40 بایت یا کمتر باشد. به عنوان مثال، Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u .

google_redir یک رشته رمزگذاری شده با URL که پیشنهاد دهنده می تواند آن را مشخص کند اگر بخواهد Google را هدایت کند تا تغییر مسیر HTTP 302 را به URL رمزگذاری شده برای این تگ مطابقت ارسال کند. این به Google اجازه می دهد تا در یک تماس زنجیره ای با شرکا در جلو قرار گیرد. اگر بدون google_hm یا با google_cm مشخص شود، این خطا منجر به خطا می شود.
google_ula رشته ای که برای افزودن کاربر به لیست کاربران موجود استفاده می شود. قالب مورد انتظار مقدار userlistid[,timestamp] است:
  • userlistid : شناسه لیست کاربر عددی واحد.
  • timestamp : یک مهر زمانی اختیاری در قالب POSIX، نشان می دهد که کاربر چه زمانی به لیست کاربران اضافه شده است.

این پارامتر URL ممکن است برای افزودن کاربر به چند لیست تکرار شود.

gdpr نشان می دهد که درخواست مشمول محدودیت های GDPR در استفاده از داده است. برای جزئیات بیشتر، الزامات رضایت کاربر اتحادیه اروپا را در زیر ببینید، یا تأثیر بر واجد شرایط بودن مطابقت کوکی را در اسناد مجاز خریداران IAB TCF نسخه 2.0 ببینید.

مثال: gdpr=1

gdpr_consent یک رشته TC که نشان دهنده رضایت کاربر نهایی است. برای جزئیات بیشتر، الزامات رضایت کاربر اتحادیه اروپا را در زیر ببینید، یا رشته TC چگونه منتقل می شود؟ در اسناد مجاز خریداران IAB TCF v2.0 .
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_cm در درخواست مشخص شده باشد و درخواست موفقیت آمیز باشد، تنظیم کنید.
google_cver نسخه کوکی. اگر google_cm در درخواست مشخص شده باشد و درخواست موفقیت آمیز باشد، تنظیم کنید.
google_error

یک عدد صحیح که خطای کلی درخواست را نشان می دهد. هنگامی که دریافت شد، نشان می دهد که هیچ عملیاتی انجام نشده است، و هیچ پارامتر پاسخ google_ دیگری تنظیم نخواهد شد. مقادیر خطای پشتیبانی شده شامل موارد زیر است:

  • 1 : کاربر یک کوکی Google دارد، اما از هرگونه ردیابی با استفاده از این کوکی انصراف داده است.
  • 2 : هیچ عملیات معتبری مشخص نشده است. به عنوان مثال، یک درخواست بدون عملیات دریافت شد.
  • 3 : کاربر کوکی گوگل ندارد. 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 - Payload بیش از حد طولانی: مقدار پارامتر به بیش از 24 بایت داده رمزگشایی می شود.
  • 4 - خطای داخلی: یک خطای داخلی در ذخیره سازی داده ها وجود داشت.
  • 5 - Throttled: این نوشته به دلیل دریچه گاز پردازش نشد.
google_ula

وضعیت عملیات افزودن لیست کاربر، اگر چندین google_ula در درخواست مشخص شده باشد، تکرار می شود. قالب این است:
userlistid,status code

مثال: google_ula=1234567890,0

عملیات google_ula می تواند هر یک از کدهای وضعیت زیر را برگرداند:

  • 0 - بدون خطا کاربر به لیست کاربران اضافه شده است.
  • 2 - اجازه داده نشد. شما مجوز اضافه کردن کاربران به لیست کاربران داده شده را ندارید.
  • 5 - شناسه لیست کاربری بد. شناسه لیست کاربر ارائه شده نامعتبر است.
  • 6 - شناسه مشخصه بسته. شناسه لیست کاربر ارائه شده بسته است.
  • 10 - خطای داخلی. سرویس Cookie Matching با یک خطای داخلی مواجه شده است. می توانید دوباره با کاربر مطابقت دهید.

سناریوهای زیر توضیح می‌دهند که تطبیق کوکی‌ها برای یک کاربر معمولی که در حال مرور یک صفحه وب است چگونه به نظر می‌رسد.

سناریو 1: کاربر کوکی های خود را پاک می کند و یک سایت را مرور می کند

جین کش آنها را از همه کوکی ها پاک می کند. سپس از صفحه اصلی ExampleNews.com بازدید می کنند.

این چیزی است که اتفاق می افتد:

  1. ExampleNews.com تبلیغات را از Google (Ad Manager) رندر می کند و فراخوانی می کند.
  2. از آنجایی که واحد تبلیغات برای تخصیص پویا واجد شرایط است، Google درخواست‌های پیشنهاد قیمت را از طریق سرویس بیدرنگ مناقصه به FinestDSP و سایر پیشنهاد دهندگان ارسال می‌کند.
  3. برنامه پیشنهادی FinestDSP درخواست پیشنهاد را دریافت و پردازش می کند و پاسخ پیشنهاد خود را ارسال می کند.
  4. Google پاسخ‌های پیشنهادی را از مناقصه‌دهندگان دریافت می‌کند، از جمله پاسخ FinestDSP که تبلیغی را با برچسب مطابقت (پیکسل) مشخص می‌کند.
  5. FinestDSP برنده حراج است. Google آگهی FinestDSP و تگ مطابقت را به جین ارائه می کند.
  6. تگ مطابقت با مشخص کردن پارامترهای google_nid و google_cm ، سرویس Google's Cookie Match را فراخوانی می‌کند.
  7. سرویس Cookie Match کوکی گوگل جین را می خواند و مرورگر جین را با تنظیم پارامترهای google_user_id و google_cver به URL تطبیق کوکی FinestDSP تغییر مسیر می دهد.
  8. مرورگر جین تغییر مسیر را به URL مطابقت کوکی FinestDSP بارگیری می کند.
  9. نقطه پایانی تطبیق کوکی FinestDSP درخواست تغییر مسیر را پردازش می کند که شامل پارامترهای URL تنظیم شده توسط Google و کوکی آنها برای Jane در هدرهای HTTP است. FinestDSP اکنون می‌تواند نگاشت کوکی خود را به google_user_id در جدول تطبیق خود ذخیره کند.
  10. FinestDSP با یک پیکسل نامرئی 1x1 به تغییر مسیر پاسخ می دهد.
سناریو 2: کاربر با نقشه های موجود

یک هفته پس از سناریو 1، جین دوباره از ExampleNews.com بازدید می کند. اکنون که جین هم کوکی‌های مناقصه‌دهنده و هم کوکی‌های Ad Manager را روی دستگاه خود دارد، در اینجا نحوه کار تطبیق آمده است.

  1. صفحه وب رندر می شود و باعث می شود Google (Ad Manager) تبلیغاتی را که در صفحه نمایش داده می شود درخواست کند.
  2. در طول حراج آگهی، Google یک درخواست پیشنهاد برای پیشنهاد دهندگان قابل اجرا، از جمله FinestDSP ارسال می کند.
  3. FinestDSP درخواست پیشنهاد، از جمله سیگنال‌هایی مانند google_user_id را دریافت می‌کند.
  4. FinestDSP google_user_id در جدول تطبیق خود جستجو می کند و کوکی مرتبط با Jane را که یک هفته قبل (در سناریو 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's Cookie Matching هدایت شود، از جمله پارامتر google_hm که با داده‌های کوکی کدگذاری شده با پایگاه 64 ایمن وب وی پر شده است. URL تغییر مسیر ممکن است به شکل زیر باشد:

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

Google یک تغییر مسیر حاوی پارامترهایی که شما مشخص کرده‌اید، به اضافه کوکی Google در سرصفحه‌های HTTP دریافت می‌کند.

مرحله 4: اگر نشانی اینترنتی گزارش مشخص شده باشد، Google در صورت موفقیت یا خطا، پیکسل را ارائه می دهد

اگر عملیات تطبیق کوکی موفقیت آمیز باشد - یا اگر هیچ نشانی اینترنتی گزارش تطبیق کوکی برای حساب پیشنهاد دهنده مشخص نشده باشد - Google به طور پیش‌فرض یک پیکسل شفاف 1x1 ارائه می‌کند و گردش کار در اینجا به پایان می‌رسد. نمایش‌های نشان‌داده‌شده برای این کاربر در درخواست‌های پیشنهادی بعدی شامل داده‌های مطابقت میزبانی شده پیشنهاددهنده در BidRequest.hosted_match_data برای پروتکل Google یا BidRequest.user.buyeruid برای اجرای OpenRTB Google می‌شود. پیشنهاد دهندگان همچنین می توانند لیست های کاربران را با استفاده از داده های بازی میزبانی شده ای که مشخص کرده اند پر کنند.

در غیر این صورت، اگر خطایی رخ داده باشد، Google یک تغییر مسیر به نشانی اینترنتی گزارش تطبیق کوکی پیشنهاد دهنده با دلیل خطای مشخص شده در پارامتر google_error ارسال می کند. اگر نشانی وب گزارش تطبیق کوکی پیشنهاد دهنده https://ad.network.com/report باشد، نشانی اینترنتی تغییر مسیر به این صورت خواهد بود:

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

مرورگر کاربر به نشانی اینترنتی گزارش تطبیق کوکی پیشنهاد دهنده، از جمله دلیل خطا (در صورت وجود) که توسط Google در پارامتر google_error مشخص شده است، هدایت می شود. برای کسب اطلاعات بیشتر در مورد تفسیر کد خطا، به توضیحات پارامتر مراجعه کنید.

مرحله 6: پیشنهاد دهنده پیکسل شفاف 1x1 را ارائه می دهد

پیشنهاد دهنده باید با ارائه یک پیکسل شفاف 1x1 به مرورگر کاربر پاسخ دهد.

گردش کار پیش‌فرض برای کاربران در ایالت‌های ایالات متحده با محدودیت‌های حریم خصوصی با نمودار زیر نشان داده شده است، که در آن درخواست‌ها و پاسخ‌ها با یک فلش نشان داده می‌شوند و اقلام داده‌ای که آنها را همراهی می‌کنند در داخل پرانتز فهرست شده‌اند.

پارامتر شرح
google_nid شناسه شبکه (NID) برای حساب پیشنهاد دهنده. این شناسه از طریق منبع Bidders قابل بازیابی است.
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 نشان می دهد که درخواست مشمول محدودیت های GDPR در استفاده از داده است. برای جزئیات بیشتر، الزامات رضایت کاربر اتحادیه اروپا را در زیر ببینید، یا تأثیر بر واجد شرایط بودن مطابقت کوکی را در اسناد مجاز خریداران IAB TCF نسخه 2.0 ببینید.

مثال: gdpr=1

gdpr_consent یک رشته TC که نشان دهنده رضایت کاربر نهایی است. برای جزئیات بیشتر، الزامات رضایت کاربر اتحادیه اروپا را در زیر ببینید، یا رشته TC چگونه منتقل می شود؟ در اسناد مجاز خریداران IAB TCF v2.0 .
process_consent نشان می دهد که پیشنهاد دهنده رضایت کاربر نهایی را برای استفاده از داده های مشخص شده در خط مشی رضایت کاربر اتحادیه اروپا Google دریافت کرده است.

اگر درخواست مشمول خط‌مشی رضایت کاربر اتحادیه اروپا نباشد، یا اگر پارامترهای رضایت دیگری در درخواست موجود باشد ( gdpr_consent )، این پارامتر نادیده گرفته می‌شود.

مثال: process_consent=T

پارامتر شرح
google_error

یک عدد صحیح که خطای کلی درخواست را نشان می دهد. هنگامی که دریافت شد، نشان می دهد که هیچ عملیاتی انجام نشده است، و هیچ پارامتر پاسخ google_ دیگری تنظیم نخواهد شد. مقادیر خطای پشتیبانی شده شامل موارد زیر است:

  • 1 : کاربر یک کوکی Google دارد، اما از هرگونه ردیابی با استفاده از این کوکی انصراف داده است.
  • 2 : هیچ عملیات معتبری مشخص نشده است. به عنوان مثال، یک درخواست بدون عملیات دریافت شد.
  • 3 : کاربر کوکی گوگل ندارد. 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: تطبیق پیکسل دو جهته

تطبیق پیکسل دوطرفه یک گردش کاری برای سرویس تطبیق کوکی Google است که در آن Google تلاش می‌کند شناسه کاربری Google را با پیشنهاددهنده‌ای که به‌طور الگوریتمی انتخاب شده به غیر از برنده مزایده بیدرنگ مناقصه مطابقت دهد. وقتی تبلیغی قرار می‌گیرد، Google یک تگ تطبیقی ​​قرار می‌دهد که مرورگر کاربر را هدایت می‌کند تا یک پیکسل شفاف را از URL تطبیق کوکی پیشنهاد دهنده منتخب بارگیری کند. این کار به Google و پیشنهاد دهنده امکان می دهد تا جدول مطابقت را با یک کاربر مشخص پر کنند. در زیر یک مثال ساده از این گردش کار آورده شده است.

مرحله 1: گوگل یک تگ مسابقه قرار می دهد

وقتی صفحه ناشر شرکت‌کننده در مرورگر کاربر بارگیری می‌شود، و یک جایگاه تبلیغاتی در آن صفحه توسط Google پر می‌شود، ممکن است یک برچسب تطبیقی ​​قرار داده شود که از پیشنهاد دهنده‌ای که به‌صورت الگوریتمی انتخاب شده، یک پیکسل درخواست می‌کند. تگ Pixel Matching که توسط Google قرار داده شده است، نشانی وب تطبیق کوکی پیشنهاد دهنده را با پارامترهای اضافی ترکیب می کند که پیشنهاد دهنده می تواند برای پر کردن جدول تطبیق خود از آنها استفاده کند. برای یک 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 مورد استفاده در تگ تطبیق برای گردش کار تطبیق کوکی های آغاز شده توسط Bidder است. در Pixel Matching، پارامتر google_cm با پارامتر google_push جایگزین می شود و مقدار آن باید برابر با مقدار ارائه شده توسط Google در درخواست باشد. همچنین مشابه گردش کار آغاز شده توسط پیشنهاد دهنده، پارامترهای اضافی را می توان برای انجام موارد استفاده اضافی مشخص کرد.

مرحله 3: گوگل تغییر مسیر را پردازش می کند و با پیکسل پاسخ می دهد

Google گزارش می دهد که یک مطابقت برای کاربر ایجاد شده است، و هرگونه عملیات اضافی درخواستی را از طریق پارامترهای پرس و جو انجام می دهد در نهایت، Google با یک پیکسل شفاف 1x1 پاسخ می دهد.

نمودار گردش کار مطابق با پیکسل

این گردش کار با نمودار زیر نشان داده شده است، جایی که درخواست‌ها و پاسخ‌ها با یک فلش نشان داده می‌شوند و اقلام داده‌ای که آنها را همراهی می‌کنند در داخل پرانتز فهرست شده‌اند.

پارامترهای درخواست تگ مطابقت Google

پارامتر شرح
google_gid شناسه کاربری گوگل برای کاربرانی که از ایالت های ایالات متحده با محدودیت های حریم خصوصی نیستند، این همیشه در تگ مطابقت Google مشخص می شود.
google_cver نسخه کوکی. این همیشه در تگ مسابقه گوگل مشخص می شود.
google_push نشان می دهد که این درخواست گردش کار Pixel Matching را آغاز می کند. مقدار باید از طریق پارامتر مربوطه در پاسخ تغییر مسیر پیشنهاد دهنده بازگردانده شود.

پارامترهای تغییر مسیر مطابق با پیکسل مناقصه

پارامتر شرح
google_nid شناسه شبکه (NID) برای حساب پیشنهاد دهنده. این شناسه از طریق منبع Bidders قابل بازیابی است.
google_push نشان می دهد که این تغییر مسیر در حال تکمیل گردش کار Pixel Matching است. مقدار تگ مطابقت Google مربوطه باید در اینجا مشخص شود.
google_hm

حاوی داده‌هایی است که پیشنهاددهنده می‌خواهد در جدول مسابقه میزبانی شده توسط Google ذخیره کند.

google_ula رشته ای که برای افزودن کاربر به لیست کاربران موجود استفاده می شود. قالب مورد انتظار مقدار userlistid[,timestamp] است:
  • userlistid : شناسه لیست کاربر عددی واحد.
  • timestamp : یک مهر زمانی اختیاری در قالب POSIX، نشان می دهد که کاربر چه زمانی به لیست کاربران اضافه شده است.

این پارامتر URL ممکن است برای افزودن کاربر به چند لیست تکرار شود.

آغاز شده توسط Google: تطبیق پیکسل یک طرفه

تطبیق پیکسل یک طرفه با گردش کار دو طرفه متفاوت است زیرا برچسب Google's Tag شامل پارامتری نیست که شناسه کاربر 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 که با داده های کوکی رمزگذاری شده با وب سایت خود اختصاص داده شده است ، هدایت کند. 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.hosted_match_data برای پروتکل Google یا BidRequest.user.buyeruid برای اجرای OpenRTB Google است. داوطلبان همچنین می توانند لیست های کاربر را با استفاده از داده های مطابقت میزبانی شده که مشخص کرده اند جمع کنند.

سرانجام ، Google یک پیکسل شفاف 1x1 را به مرورگر کاربر باز می گرداند.

مناقصه باز به مبادلات اجازه می دهد تا از محل کار با پیشنهاد دهنده استفاده کنند و Google با شروع گردش کار کوکی را آغاز کنند تا یک شناسه کاربر Google را با کوکی خود مطابقت دهند. کوکی Match Assist (CMA) یک ویژگی اضافی برای صرافی ها است که آنها را قادر می سازد تا میزهای مسابقه را با داوطلبان خود بسازند.

  1. هنگام قرار دادن یک آگهی ، Google به صورت الگوریتمی یک تبادل شرکت کننده را انتخاب می کند و یک برچسب کمک کوکی را که ساختار زیر را دارد قرار می دهد:

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

  2. برچسب CMA Match Google باعث می شود URL تطبیق کوکی Exchange یک درخواست پیکسل دریافت کند.

  3. نقطه پایانی کوکی Exchange این درخواست را دریافت می کند ، جایی که سرویس تطبیق کوکی خود وظیفه تطبیق شناسه کاربر با یکی از داوطلبان خود را بر عهده دارد. در نمودار زیر ، سرویس تطبیق کوکی مبادله با تغییر مسیر به یکی از نقاط پایانی پیشنهاد دهنده خود به مرورگر کاربر پاسخ می دهد.
  4. پیشنهاد دهنده درخواست را به همراه هر پارامتر مشخص شده توسط Exchange دریافت می کند تا شناسه کاربر را با کوکی خود مطابقت دهد.

محدودیت های

فرکانس کلاه درخواست برای مسابقات تازه

داوطلبان وظیفه محدود کردن تعداد تماس های مربوط به سرویس تطبیق کوکی را برای کاربرانی که ورود تازه ای در جدول مسابقه میزبان Google دارند ، محدود می کنند. ورود در جدول مسابقه میزبان ممکن است در 14 روز منقضی شود که پس از آن می توان آن را تازه کرد.

به تمام درخواست های مطابقت پیکسل پاسخ دهید

انتظار می رود داوطلبان با استفاده از گردش کار تطبیق پیکسل با پاسخ از جمله پارامتر google_push به کلیه درخواست های مسابقه پیکسل ورودی پاسخ دهند. این به Google اجازه می دهد تا با نظارت بر استفاده ، سیاست ها را اجرا کند. اگر نرخ پاسخ داوطلب به زیر 90 ٪ کاهش یابد ، Google تعداد درخواست های مطابقت پیکسل را که به حساب آنها ارسال شده است ، باز می کند.

از نقاط پایانی HTTPS استفاده کنید

لازم است که نقاط پایانی مورد استفاده در تمام گردش کار تطبیق کوکی از HTTPS استفاده کنید.

هنگام پاسخ به درخواست مسابقه پیکسل که از طریق HTTPS برای شما ارسال شده است ، شما را ملزم به تغییر مسیر به سرویس تطبیق کوکی از طریق HTTPS می کنید. به همین ترتیب ، یک نقطه پایانی کوکی که به سمت داوطلبان هدایت می شود نیز باید از HTTPS استفاده کند. اگر بیشتر از هر 2 دقیقه درخواست هایی را از طریق HTTP به Google ارسال کنید ، تعداد درخواست های مسابقه ارسال شده به حساب شما مورد بررسی قرار می گیرد.

درخواست های تطبیق کوکی که مشمول سیاست رضایت کاربر اتحادیه اروپا هستند باید رضایت کاربر نهایی را نشان دهند. چنین درخواست هایی لازم است تا نشان دهند که رضایت با استفاده از یکی از روشهای زیر جمع آوری شده است:

  • TCFV2: این شامل پارامترهای gdpr و gdpr_consent است. برای جزئیات بیشتر ، با مستندات خریداران مجاز IAB TCF v2.0 مشورت کنید.
  • process_consent : بیانیه ای مبنی بر اینکه داوطلب رضایت کاربر لازم را به دست آورده است.

مثال ها

مثالهای زیر نحوه استفاده از سرویس تطبیق کوکی را برای دستیابی به اهداف خاص نشان می دهد. توجه داشته باشید که مگر اینکه در غیر این صورت بیان نشده باشد ، فرض بر این است که کاربر تحت عمل قرار می گیرد از یک کشور ایالات متحده با محدودیت های حریم خصوصی نیست.

یک میز مسابقه به میزبان پیشنهاد دهنده را جمع کنید

یک پیشنهاد دهنده می تواند با ارائه فقط پارامترهای google_nid و google_cm در برچسب مسابقه خود ، از گردش کار تطبیق کوکی برای جمع آوری جدول بازی خود استفاده کند. این ممکن است به نظر برسد:

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

اگر URL تطبیق کوکی پیشنهاد دهنده روی https://ad.network.com/pixel?id=1 تنظیم شده باشد ، و عملیات تطبیق کوکی موفقیت آمیز است ، تغییر مسیر Google در پاسخ به برچسب مسابقه پیشنهاد دهنده ممکن است به نظر برسد:

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

اگر عملیات تطبیق کوکی به دلیل عدم موفقیت کاربر کوکی گوگل انجام شود ، پاسخ این است:

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

کد خطا به علت اصلی خطا بستگی دارد. برای کسب اطلاعات بیشتر در مورد کدهای خطای احتمالی برای گردش کار تطبیق کوکی ، به پارامترهای URL تغییر مسیر مراجعه کنید.

به لیست کاربر تک اضافه کنید

پارامتر google_ula را می توان در برچسب مسابقه پیشنهاد دهنده مشخص کرد تا کاربر را با شناسه داده شده به لیست کاربر اضافه کند. اگر جدول مسابقه Google یا Bidder-به میزبانی ورودی تازه ای برای کاربر داشته باشد ، پیشنهاد دهنده می تواند یک برچسب مسابقه از جمله پارامترهای google_nid و google_ula را برای اضافه کردن کاربر به لیست مشخص شده بدون شروع گردش کار کامل کوکی اضافه کند. محدودیت های فراخوانی سرویس تطبیق کوکی را برای DEAIL های بیشتر مشاهده کنید. برچسب مسابقه مربوطه ممکن است به نظر برسد:

<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 در تغییر مسیر دریافت خواهید کرد. بر خلاف پارامتر برچسب تطابق مربوطه ، این جایگزین Timestamp با کد وضعیت می شود تا موفقیت عملیات را نشان دهد. به عنوان مثال ، اگر درخواست به دلیل عدم دسترسی به حساب داوطلب به لیست کاربر مشخص شده ، 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 باشد که در آن مقدار آن باید یک وب باشد -Safe 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 دریافت می کند.