مشخصات Curation در زمان واقعی را بیاموزید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
گوگل بر اساس درخواستهای تبلیغاتی که با موجودی هدفگذاری شده شما و ادغام Real-time Curation شما مطابقت دارند، یک SegmentRequest ارسال میکند. شیء SegmentRequest سیگنالهای زمینهای یا سیگنالهای مخاطب را ارائه میدهد که میتوانید از آنها برای شناسایی اینکه کدام یک از بخشهای شما برای موجودی داده شده در SegmentResponse اعمال میشود، استفاده کنید. Real-time Curation از اشیاء SegmentRequest و SegmentResponse ارسال شده در قالب JSON پشتیبانی میکند.
این راهنما مرجعی برای پروتکل گزینش بلادرنگ است که میتواند به شما در ایجاد یکپارچهسازی کمک کند.
فقط برای شرکای گزینش متنی پشتیبانی میشود. توصیفکننده وبسایت. فیلد site در صورتی پر میشود که محتوای پشتیبانیشده توسط تبلیغات، یک وبسایت باشد نه یک برنامه غیرمرورگری.
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. توصیفکننده برنامه. فیلد app در صورتی پر میشود که محتوای پشتیبانیشده توسط تبلیغات، یک برنامه غیر مرورگری باشد نه یک وبسایت.
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. توصیفکنندهای از دستگاه کاربر.
segment_request_id
رشته
یک شناسه منحصر به فرد که برای شناسایی درخواست بخش، مستقل از سایر درخواستهای بخش، استفاده میشود.
ایمپریال
ویژگی
نوع
توضیحات
id
رشته
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. یک شناسه منحصر به فرد برای این نمایش در چارچوب درخواست بخش. مقدار از ۱ شروع میشود و برای n نمایش تا n افزایش مییابد.
فقط برای شرکای گزینش متنی پشتیبانی میشود. عرض بر حسب پیکسلهای مستقل از دستگاه (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 دادههایی است که ناشر در دسترس قرار میدهد، مانند سیگنالهای امن.
عید
ویژگی
نوع
توضیحات
source
رشته
فقط برای شرکای گردآوری مخاطب پشتیبانی میشود. منبع یا ارائهدهنده فناوری که مسئول مجموعه دادههای گنجانده شده است. به صورت یک دامنه سطح بالا بیان میشود.
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. موقعیت مکانی دستگاه کاربر.
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
رشته
فقط برای شرکای گزینشیِ مبتنی بر زمینه پشتیبانی میشود. شهری که از کد سازمان ملل برای مکانهای تجارت و حمل و نقل استفاده میکند.
شناسهی مربوط به بخش. این شناسه باید با curatorDataSegmentId موجود در نام بخش در منبع curators.dataSegments از API بازار مطابقت داشته باشد.
،
گوگل بر اساس درخواستهای تبلیغاتی که با موجودی هدفگذاری شده شما و ادغام Real-time Curation شما مطابقت دارند، یک SegmentRequest ارسال میکند. شیء SegmentRequest سیگنالهای زمینهای یا سیگنالهای مخاطب را ارائه میدهد که میتوانید از آنها برای شناسایی اینکه کدام یک از بخشهای شما برای موجودی داده شده در SegmentResponse اعمال میشود، استفاده کنید. Real-time Curation از اشیاء SegmentRequest و SegmentResponse ارسال شده در قالب JSON پشتیبانی میکند.
این راهنما مرجعی برای پروتکل گزینش بلادرنگ است که میتواند به شما در ایجاد یکپارچهسازی کمک کند.
فقط برای شرکای گزینش متنی پشتیبانی میشود. توصیفکننده وبسایت. فیلد site در صورتی پر میشود که محتوای پشتیبانیشده توسط تبلیغات، یک وبسایت باشد نه یک برنامه غیرمرورگری.
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. توصیفکننده برنامه. فیلد app در صورتی پر میشود که محتوای پشتیبانیشده توسط تبلیغات، یک برنامه غیر مرورگری باشد نه یک وبسایت.
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. توصیفکنندهای از دستگاه کاربر.
segment_request_id
رشته
یک شناسه منحصر به فرد که برای شناسایی درخواست بخش، مستقل از سایر درخواستهای بخش، استفاده میشود.
ایمپریال
ویژگی
نوع
توضیحات
id
رشته
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. یک شناسه منحصر به فرد برای این نمایش در چارچوب درخواست بخش. مقدار از ۱ شروع میشود و برای n نمایش تا n افزایش مییابد.
فقط برای شرکای گزینش متنی پشتیبانی میشود. عرض بر حسب پیکسلهای مستقل از دستگاه (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 دادههایی است که ناشر در دسترس قرار میدهد، مانند سیگنالهای امن.
عید
ویژگی
نوع
توضیحات
source
رشته
فقط برای شرکای گردآوری مخاطب پشتیبانی میشود. منبع یا ارائهدهنده فناوری که مسئول مجموعه دادههای گنجانده شده است. به صورت یک دامنه سطح بالا بیان میشود.
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. موقعیت مکانی دستگاه کاربر.
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
رشته
فقط برای شرکای گزینشیِ مبتنی بر زمینه پشتیبانی میشود. شهری که از کد سازمان ملل برای مکانهای تجارت و حمل و نقل استفاده میکند.
شناسهی مربوط به بخش. این شناسه باید با curatorDataSegmentId موجود در نام بخش در منبع curators.dataSegments از API بازار مطابقت داشته باشد.
،
گوگل بر اساس درخواستهای تبلیغاتی که با موجودی هدفگذاری شده شما و ادغام Real-time Curation شما مطابقت دارند، یک SegmentRequest ارسال میکند. شیء SegmentRequest سیگنالهای زمینهای یا سیگنالهای مخاطب را ارائه میدهد که میتوانید از آنها برای شناسایی اینکه کدام یک از بخشهای شما برای موجودی داده شده در SegmentResponse اعمال میشود، استفاده کنید. Real-time Curation از اشیاء SegmentRequest و SegmentResponse ارسال شده در قالب JSON پشتیبانی میکند.
این راهنما مرجعی برای پروتکل گزینش بلادرنگ است که میتواند به شما در ایجاد یکپارچهسازی کمک کند.
فقط برای شرکای گزینش متنی پشتیبانی میشود. توصیفکننده وبسایت. فیلد site در صورتی پر میشود که محتوای پشتیبانیشده توسط تبلیغات، یک وبسایت باشد نه یک برنامه غیرمرورگری.
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. توصیفکننده برنامه. فیلد app در صورتی پر میشود که محتوای پشتیبانیشده توسط تبلیغات، یک برنامه غیر مرورگری باشد نه یک وبسایت.
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. توصیفکنندهای از دستگاه کاربر.
segment_request_id
رشته
یک شناسه منحصر به فرد که برای شناسایی درخواست بخش، مستقل از سایر درخواستهای بخش، استفاده میشود.
ایمپریال
ویژگی
نوع
توضیحات
id
رشته
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. یک شناسه منحصر به فرد برای این نمایش در چارچوب درخواست بخش. مقدار از ۱ شروع میشود و برای n نمایش تا n افزایش مییابد.
فقط برای شرکای گزینش متنی پشتیبانی میشود. عرض بر حسب پیکسلهای مستقل از دستگاه (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 دادههایی است که ناشر در دسترس قرار میدهد، مانند سیگنالهای امن.
عید
ویژگی
نوع
توضیحات
source
رشته
فقط برای شرکای گردآوری مخاطب پشتیبانی میشود. منبع یا ارائهدهنده فناوری که مسئول مجموعه دادههای گنجانده شده است. به صورت یک دامنه سطح بالا بیان میشود.
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. موقعیت مکانی دستگاه کاربر.
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
رشته
فقط برای شرکای گزینشیِ مبتنی بر زمینه پشتیبانی میشود. شهری که از کد سازمان ملل برای مکانهای تجارت و حمل و نقل استفاده میکند.
شناسهی مربوط به بخش. این شناسه باید با curatorDataSegmentId موجود در نام بخش در منبع curators.dataSegments از API بازار مطابقت داشته باشد.
،
گوگل بر اساس درخواستهای تبلیغاتی که با موجودی هدفگذاری شده شما و ادغام Real-time Curation شما مطابقت دارند، یک SegmentRequest ارسال میکند. شیء SegmentRequest سیگنالهای زمینهای یا سیگنالهای مخاطب را ارائه میدهد که میتوانید از آنها برای شناسایی اینکه کدام یک از بخشهای شما برای موجودی داده شده در SegmentResponse اعمال میشود، استفاده کنید. Real-time Curation از اشیاء SegmentRequest و SegmentResponse ارسال شده در قالب JSON پشتیبانی میکند.
این راهنما مرجعی برای پروتکل گزینش بلادرنگ است که میتواند به شما در ایجاد یکپارچهسازی کمک کند.
فقط برای شرکای گزینش متنی پشتیبانی میشود. توصیفکننده وبسایت. فیلد site در صورتی پر میشود که محتوای پشتیبانیشده توسط تبلیغات، یک وبسایت باشد نه یک برنامه غیرمرورگری.
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. توصیفکننده برنامه. فیلد app در صورتی پر میشود که محتوای پشتیبانیشده توسط تبلیغات، یک برنامه غیر مرورگری باشد نه یک وبسایت.
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. توصیفکنندهای از دستگاه کاربر.
segment_request_id
رشته
یک شناسه منحصر به فرد که برای شناسایی درخواست بخش، مستقل از سایر درخواستهای بخش، استفاده میشود.
ایمپریال
ویژگی
نوع
توضیحات
id
رشته
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. یک شناسه منحصر به فرد برای این نمایش در چارچوب درخواست بخش. مقدار از ۱ شروع میشود و برای n نمایش تا n افزایش مییابد.
فقط برای شرکای گزینش متنی پشتیبانی میشود. عرض بر حسب پیکسلهای مستقل از دستگاه (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 دادههایی است که ناشر در دسترس قرار میدهد، مانند سیگنالهای امن.
عید
ویژگی
نوع
توضیحات
source
رشته
فقط برای شرکای گردآوری مخاطب پشتیبانی میشود. منبع یا ارائهدهنده فناوری که مسئول مجموعه دادههای گنجانده شده است. به صورت یک دامنه سطح بالا بیان میشود.
فقط برای شرکای گزینش زمینهای پشتیبانی میشود. موقعیت مکانی دستگاه کاربر.
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
رشته
فقط برای شرکای گزینشیِ مبتنی بر زمینه پشتیبانی میشود. شهری که از کد سازمان ملل برای مکانهای تجارت و حمل و نقل استفاده میکند.
تاریخ آخرین بهروزرسانی 2026-09-23 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-09-23 بهوقت ساعت هماهنگ جهانی."],[],[]]