مشخصات 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 تنظیم می‌شود.

کاربر

ویژگی نوع توضیحات
id رشته شناسه کاربری گوگل.
buyeruid رشته داده‌های تطبیق میزبانی‌شده با سرویس تطبیق کوکی آپلود شده‌اند. به‌طور پیش‌فرض، این مورد با کدگذاری web-safe base64 و بدون padding مشخص شده است. می‌توانید به‌صورت اختیاری با تماس با مدیر حساب خود، این فیلد را طوری پیکربندی کنید که بدون کدگذاری پر شود.
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 رشته فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. سازنده دستگاه (مثلاً "اپل").
ifa رشته شناسه تبلیغاتی دستگاه رمزگذاری نشده (هش نشده). در پروتکل گزینش بلادرنگ گوگل، این معمولاً یک UUID 36 کاراکتری است که در آن شناسه‌های اندروید با حروف کوچک و شناسه‌های IDFA با حروف بزرگ نوشته می‌شوند. برای دستگاه‌های سامسونگ، این مقادیر 32 کاراکتری الفبایی-عددی هستند.

ژئو

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

پاسخ سگمنت

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

بخش

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

گوگل بر اساس درخواست‌های تبلیغاتی که با موجودی هدف‌گذاری شده شما و ادغام 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 تنظیم می‌شود.

کاربر

ویژگی نوع توضیحات
id رشته شناسه کاربری گوگل.
buyeruid رشته داده‌های تطبیق میزبانی‌شده با سرویس تطبیق کوکی آپلود شده‌اند. به‌طور پیش‌فرض، این مورد با کدگذاری web-safe base64 و بدون padding مشخص شده است. می‌توانید به‌صورت اختیاری با تماس با مدیر حساب خود، این فیلد را طوری پیکربندی کنید که بدون کدگذاری پر شود.
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 رشته فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. سازنده دستگاه (مثلاً "اپل").
ifa رشته شناسه تبلیغاتی دستگاه رمزگذاری نشده (هش نشده). در پروتکل گزینش بلادرنگ گوگل، این معمولاً یک UUID 36 کاراکتری است که در آن شناسه‌های اندروید با حروف کوچک و شناسه‌های IDFA با حروف بزرگ نوشته می‌شوند. برای دستگاه‌های سامسونگ، این مقادیر 32 کاراکتری الفبایی-عددی هستند.

ژئو

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

پاسخ سگمنت

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

بخش

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

گوگل بر اساس درخواست‌های تبلیغاتی که با موجودی هدف‌گذاری شده شما و ادغام 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 تنظیم می‌شود.

کاربر

ویژگی نوع توضیحات
id رشته شناسه کاربری گوگل.
buyeruid رشته داده‌های تطبیق میزبانی‌شده با سرویس تطبیق کوکی آپلود شده‌اند. به‌طور پیش‌فرض، این مورد با کدگذاری web-safe base64 و بدون padding مشخص شده است. می‌توانید به‌صورت اختیاری با تماس با مدیر حساب خود، این فیلد را طوری پیکربندی کنید که بدون کدگذاری پر شود.
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 رشته فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. سازنده دستگاه (مثلاً "اپل").
ifa رشته شناسه تبلیغاتی دستگاه رمزگذاری نشده (هش نشده). در پروتکل گزینش بلادرنگ گوگل، این معمولاً یک UUID 36 کاراکتری است که در آن شناسه‌های اندروید با حروف کوچک و شناسه‌های IDFA با حروف بزرگ نوشته می‌شوند. برای دستگاه‌های سامسونگ، این مقادیر 32 کاراکتری الفبایی-عددی هستند.

ژئو

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

پاسخ سگمنت

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

بخش

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

گوگل بر اساس درخواست‌های تبلیغاتی که با موجودی هدف‌گذاری شده شما و ادغام 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 تنظیم می‌شود.

کاربر

ویژگی نوع توضیحات
id رشته شناسه کاربری گوگل.
buyeruid رشته داده‌های تطبیق میزبانی‌شده با سرویس تطبیق کوکی آپلود شده‌اند. به‌طور پیش‌فرض، این مورد با کدگذاری web-safe base64 و بدون padding مشخص شده است. می‌توانید به‌صورت اختیاری با تماس با مدیر حساب خود، این فیلد را طوری پیکربندی کنید که بدون کدگذاری پر شود.
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 رشته فقط برای شرکای گزینش زمینه‌ای پشتیبانی می‌شود. سازنده دستگاه (مثلاً "اپل").
ifa رشته شناسه تبلیغاتی دستگاه رمزگذاری نشده (هش نشده). در پروتکل گزینش بلادرنگ گوگل، این معمولاً یک UUID 36 کاراکتری است که در آن شناسه‌های اندروید با حروف کوچک و شناسه‌های IDFA با حروف بزرگ نوشته می‌شوند. برای دستگاه‌های سامسونگ، این مقادیر 32 کاراکتری الفبایی-عددی هستند.

ژئو

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

پاسخ سگمنت

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

بخش

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