Google یک SegmentRequest بر اساس درخواست‌های تبلیغاتی ارسال می‌کند که با موجودی هدفمند شما مطابقت دارد با ادغام زمان واقعی شما. شی SegmentRequest یا سیگنال های متنی یا سیگنال های ایمن را ارائه می دهد که می توانید برای شناسایی کدام یک از بخش های خود در موجودی داده شده در SegmentResponse استفاده کنید. Real-time Curation از اشیاء SegmentRequest و SegmentResponse ارسال شده در قالب JSON پشتیبانی می کند.
این راهنما مرجعی برای پروتکل Real-time Curation است که می تواند به شما در ایجاد یکپارچگی کمک کند.
بخش درخواست
| صفت | تایپ کنید | توضیحات |
|---|---|---|
site | سایت | فقط برای شرکای مدیریت متنی پشتیبانی می شود. توصیف کننده وب سایت فیلد |
app | برنامه | فقط برای شرکای مدیریت متنی پشتیبانی می شود. توصیف کننده برنامه اگر محتوای پشتیبانی شده از آگهی یک برنامه غیر مرورگر باشد نه یک وب سایت، فیلد |
pub | ناشر | فقط برای شرکای مدیریت متنی پشتیبانی می شود. توصیف کننده ناشر. |
user | کاربر | توصیفگر کاربر در حال مرور محتوای ناشر که درخواست بخش را آغاز کرده است. |
device | دستگاه | فقط برای شرکای مدیریت متنی پشتیبانی می شود. توصیفگر دستگاه کاربر. |
segment_ request_ id | رشته | یک شناسه منحصر به فرد برای شناسایی درخواست بخش به طور مستقل از سایر درخواست های بخش استفاده می شود. |
سایت
| صفت | تایپ کنید | توضیحات |
|---|---|---|
page | رشته | فقط برای شرکای مدیریت متنی پشتیبانی می شود. نشانی وب صفحه نشان دهنده برداشت. |
برنامه
| صفت | تایپ کنید | توضیحات |
|---|---|---|
bundle | رشته | فقط برای شرکای مدیریت متنی پشتیبانی می شود. یک شناسه برنامه خاص پلتفرم که در نظر گرفته شده برای برنامه منحصر به فرد باشد. در Android، فیلد |
ناشر
| صفت | تایپ کنید | توضیحات |
|---|---|---|
id | رشته | فقط برای شرکای مدیریت متنی پشتیبانی می شود. شناسه ناشر که با پسوند کد ناشر کد دارایی وب تعریف شده است. به عنوان مثال، ناشر دارای کد دارایی وب |
کاربر
| صفت | تایپ کنید | توضیحات |
|---|---|---|
consent | رشته | یک رشته رضایت IAB شفافیت و چارچوب رضایت (TCF) v2 مبتنی بر ۶۴ رمزگذاری شده تحت وب که از پلتفرم مدیریت رضایت IAB ناشر (CMP) واکشی شده است. اگر ناشر با یک CMP برای TCF v2 ادغام شده باشد و CMP نشان دهد که GDPR برای درخواست آگهی اعمال می‌شود و یک رشته رضایت معتبر ارائه می‌کند، فیلد فهرست فروشندگان جهانی IAB را در vendor-list.consensu.org/v2/vendor-list.json برای جزئیات بیشتر درباره فروشندگان فهرست شده در رشته رضایت ببینید. |
eids | آرایه EID | فقط برای شرکای مدیریت سیگنال های ایمن پشتیبانی می شود. نمونه های ID توسعه یافته در Curation، قسمت |
EID
| صفت | تایپ کنید | توضیحات |
|---|---|---|
source | رشته | فقط برای شرکای مدیریت سیگنال های ایمن پشتیبانی می شود. منبع یا ارائه دهنده فناوری مسئول مجموعه داده های گنجانده شده است. به عنوان یک دامنه سطح بالا بیان می شود. |
uids | آرایه UID | فقط برای شرکای مدیریت سیگنال های ایمن پشتیبانی می شود. آرایه ای از اشیاء UID از منبع داده شده. |
UID
| صفت | تایپ کنید | توضیحات |
|---|---|---|
id | رشته | فقط برای شرکای مدیریت سیگنال های ایمن پشتیبانی می شود. شناسه. در curation، فیلد |
دستگاه
| صفت | تایپ کنید | توضیحات |
|---|---|---|
geo | جغرافیایی | فقط برای شرکای مدیریت متنی پشتیبانی می شود. موقعیت مکانی دستگاه کاربر. |
جغرافیایی
| صفت | تایپ کنید | توضیحات |
|---|---|---|
country | رشته | فقط برای شرکای مدیریت متنی پشتیبانی می شود. کشوری که از استاندارد ISO-3166-1 Alpha-3 استفاده می کند. |
region | رشته | فقط برای شرکای مدیریت متنی پشتیبانی می شود. کد منطقه با استفاده از استاندارد ISO-3166-2؛ کد ایالتی 2 حرفی اگر ایالات متحده آمریکا باشد. |
metro | رشته | فقط برای شرکای مدیریت متنی پشتیبانی می شود. کد متروی گوگل در فایل geo-table.csv یافت شد. |
SegmentResponse
| صفت | تایپ کنید | توضیحات |
|---|---|---|
segment | آرایه قطعه | توصیفگر برای یک بخش |
بخش
| صفت | تایپ کنید | توضیحات |
|---|---|---|
segment_id | رشته | شناسه بخش شناسه باید با curatorDataSegmentId موجود در نام بخش موجود در منبع curators.dataSegments API Marketplace مطابقت داشته باشد. |