مشخصات Curation در زمان واقعی را بیاموزید

گوگل بر اساس درخواست‌های تبلیغاتی که با موجودی هدف‌گذاری‌شده شما و ادغام Real-time Curation شما مطابقت دارند، یک SegmentRequest ارسال می‌کند. شیء SegmentRequest یا سیگنال‌های زمینه‌ای یا سیگنال‌های امنی را ارائه می‌دهد که می‌توانید از آنها برای شناسایی اینکه کدام یک از بخش‌های شما برای موجودی داده‌شده در SegmentResponse اعمال می‌شود، استفاده کنید. Real-time Curation از اشیاء SegmentRequest و SegmentResponse ارسال‌شده در قالب JSON پشتیبانی می‌کند.

این راهنما مرجعی برای پروتکل گزینش بلادرنگ است که می‌تواند به شما در ایجاد یکپارچه‌سازی کمک کند.

درخواست قطعه

ویژگی	نوع	توضیحات
imp	آرایه Imp	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. نشان‌دهنده فرصت‌های تأثیرگذاری ارائه شده است.
site	سایت	فقط برای شرکای گزینش متنی پشتیبانی می‌شود. توصیف‌کننده وب‌سایت. فیلد site در صورتی پر می‌شود که محتوای پشتیبانی‌شده توسط تبلیغات، یک وب‌سایت باشد نه یک برنامه غیرمرورگری.
app	برنامه	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. توصیف‌کننده برنامه. فیلد app در صورتی پر می‌شود که محتوای پشتیبانی‌شده توسط تبلیغات، یک برنامه غیر مرورگری باشد نه یک وب‌سایت.
pub	ناشر	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. توصیف ناشر.
user	کاربر	توصیف‌گری از محتوای ناشری که درخواست بخش‌بندی را آغاز کرده و توسط کاربر در حال مرور آن است.
device	دستگاه	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. توصیف‌کننده‌ای از دستگاه کاربر.
segment_request_id	رشته	یک شناسه منحصر به فرد که برای شناسایی درخواست بخش، مستقل از سایر درخواست‌های بخش، استفاده می‌شود.

ایمپریال

ویژگی	نوع	توضیحات
id	رشته	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. یک شناسه منحصر به فرد برای این نمایش در چارچوب درخواست بخش. مقدار از ۱ شروع می‌شود و برای n نمایش تا n افزایش می‌یابد.
banner	بنر	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. این فیلد در صورتی پر می‌شود که نمایش به عنوان یک فرصت تبلیغ بنری ارائه شود.
video	ویدئو	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. این فیلد در صورتی پر می‌شود که نمایش به عنوان یک فرصت تبلیغ ویدیویی ارائه شود.
ext	ایمپت اکسچنج	این با افزونه‌هایی برای شیء Imp پر شده است.

بنر

ویژگی	نوع	توضیحات
w	عدد صحیح	فقط برای شرکای گزینش متنی پشتیبانی می‌شود. عرض بر حسب پیکسل‌های مستقل از دستگاه (DIPS).
h	عدد صحیح	فقط برای شرکای گزینش متنی پشتیبانی می‌شود. ارتفاع بر حسب پیکسل‌های مستقل از دستگاه (DIPS).
pos	عدد صحیح	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. موقعیت تبلیغ روی صفحه. برای کسب اطلاعات بیشتر در مورد موقعیت‌های ممکن برای قرارگیری، به فهرست: موقعیت‌های قرارگیری در AdCOM 1.0 مراجعه کنید.

ویدئو

ویژگی	نوع	توضیحات
w	عدد صحیح	فقط برای شرکای گزینش متنی پشتیبانی می‌شود. عرض پخش‌کننده ویدیو بر حسب پیکسل‌های مستقل از دستگاه (DIPS).
h	عدد صحیح	فقط برای شرکای گزینش متنی پشتیبانی می‌شود. ارتفاع پخش‌کننده ویدیو بر حسب پیکسل‌های مستقل از دستگاه (DIPS).
pos	عدد صحیح	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. موقعیت تبلیغ روی صفحه. برای کسب اطلاعات بیشتر در مورد موقعیت‌های ممکن برای قرارگیری، به فهرست: موقعیت‌های قرارگیری در AdCOM 1.0 مراجعه کنید.

ایمپت اکسچنج

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

سایت

ویژگی	نوع	توضیحات
page	رشته	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. نشانی اینترنتی صفحه‌ای که نمایش را نشان می‌دهد.
mobile	عدد صحیح	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. نشان می‌دهد که آیا سایت برای بهینه‌سازی طرح‌بندی هنگام مشاهده در دستگاه‌های تلفن همراه برنامه‌ریزی شده است یا خیر، که در آن ۰ = خیر، ۱ = بله.

برنامه

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

ناشر

ویژگی	نوع	توضیحات
id	رشته	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. شناسه ناشر که توسط پسوند کد ناشر کد ویژگی وب تعریف می‌شود. برای مثال، ناشری که کد ویژگی وب ca-pub-123 دارد، شناسه‌اش روی pub-123 تنظیم می‌شود.

کاربر

ویژگی	نوع	توضیحات
consent	رشته	یک رشته رضایت‌نامه IAB Transparency and Consent Framework (TCF) نسخه ۲ که مبتنی بر وب و با رمزگذاری ۶۴ بیتی است و از پلتفرم مدیریت رضایت‌نامه IAB (CMP) ناشر دریافت شده است. فیلد consent در صورتی پر می‌شود که ناشر با CMP برای TCF نسخه ۲ ادغام شده باشد و CMP نشان دهد که GDPR برای درخواست تبلیغ اعمال می‌شود و یک رشته رضایت‌نامه معتبر ارائه می‌دهد. برای جزئیات بیشتر در مورد فروشندگان ذکر شده در رشته رضایت‌نامه، به فهرست جهانی فروشندگان IAB در vendor-list.consensu.org/v2/vendor-list.json مراجعه کنید.
eids	آرایه EID	فقط برای شرکای گزینش سیگنال‌های امن پشتیبانی می‌شود. نمونه‌های شناسه توسعه‌یافته. در گزینش، فیلد eids داده‌هایی است که توسط ناشر در دسترس قرار می‌گیرد، مانند سیگنال‌های امن.

عید

ویژگی	نوع	توضیحات
source	رشته	فقط برای شرکای جمع‌آوری سیگنال‌های امن پشتیبانی می‌شود. منبع یا ارائه‌دهنده فناوری مسئول مجموعه داده‌های موجود. به صورت یک دامنه سطح بالا بیان می‌شود.
uids	آرایه UID	فقط برای شرکای جمع‌آوری سیگنال‌های امن پشتیبانی می‌شود. آرایه‌ای از اشیاء UID از منبع داده شده.

شناسه کاربری

ویژگی	نوع	توضیحات
id	رشته	فقط برای شرکای گزینش سیگنال‌های امن پشتیبانی می‌شود. شناسه. در گزینش، فیلد id یک سیگنال امن است. برای کسب اطلاعات بیشتر در مورد سیگنال‌های امن، به بخش «اشتراک‌گذاری سیگنال‌های امن با پیشنهاددهندگان و شرکای گزینش» در Ad Manager مراجعه کنید.

دستگاه

ویژگی	نوع	توضیحات
geo	ژئو	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. موقعیت مکانی دستگاه کاربر.
devicetype	عدد صحیح	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. نوع کلی دستگاه. برای کسب اطلاعات بیشتر در مورد انواع دستگاه‌های ممکن، به فهرست: انواع دستگاه در AdCOM 1.0 مراجعه کنید.
os	رشته	فقط برای شرکای گزینش متنی پشتیبانی می‌شود. سیستم عامل دستگاه (مثلاً "iOS").
make	رشته	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. سازنده دستگاه (مثلاً "اپل").

ژئو

ویژگی	نوع	توضیحات
country	رشته	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. کشوری که از استاندارد ISO-3166-1 Alpha-3 استفاده می‌کند.
region	رشته	فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. کد منطقه با استفاده از استاندارد ISO-3166-2؛ کد ایالت دو حرفی اگر ایالات متحده آمریکا باشد.
metro	رشته	فقط برای شرکای گزینش متنی پشتیبانی می‌شود. کد متروی گوگل در فایل geo-table.csv یافت شد.
city	رشته	فقط برای شرکای گزینش مبتنی بر زمینه پشتیبانی می‌شود. شهری که از کد سازمان ملل برای مکان‌های تجارت و حمل و نقل استفاده می‌کند.

پاسخ سگمنت

ویژگی	نوع	توضیحات
segment	آرایه قطعه‌ای	توصیف‌گری برای یک بخش.

بخش

ویژگی	نوع	توضیحات
segment_id	رشته	شناسه‌ی مربوط به بخش. این شناسه باید با curatorDataSegmentId موجود در نام بخش در منبع curators.dataSegments از API بازار مطابقت داشته باشد.