SegmentRequest را تجزیه کنید

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

از رمزگذاری gzip استفاده کنید

Google هنگام ارسال SegmentRequest به نقطه پایانی شما از رمزگذاری gzip استفاده می کند. نقطه پایانی شما باید قابلیت دریافت و پاسخگویی با رمزگذاری gzip را داشته باشد.

مدیریت با سیگنال متنی یا نقاط پایانی سیگنال ایمن

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

از سیگنال های متنی استفاده کنید

سیگنال‌های متنی شامل اطلاعاتی درباره ناشر، دستگاه و کاربر است که منشأ برداشت را توصیف می‌کند. لیست زیر سیگنال های موجود را شرح می دهد:

  • SegmentRequest.site : وب سایتی را توصیف می کند که نمایش را ارائه می دهد، مانند URL سایت. فقط یکی از SegmentRequest.site و SegmentRequest.app را می توان در SegmentRequest پر کرد.
  • SegmentRequest.app : برنامه ای را توصیف می کند که نمایش را ارائه می دهد، مانند شناسه برنامه خاص پلت فرم برنامه. فقط یکی از SegmentRequest.site و SegmentRequest.app را می توان در SegmentRequest پر کرد.
  • SegmentRequest.pub : ناشر رسانه ای را توصیف می کند که برداشت را ارائه می کند. به عنوان مثال، شناسه ناشر.
  • SegmentRequest.user : انتخاب های کاربر در مورد نحوه پردازش داده های شخصی آنها را شرح می دهد. برای مثال، با رشته رضایت TCF.
  • SegmentRequest.device : اطلاعات مربوط به دستگاه، مانند موقعیت جغرافیایی دستگاه را با دقت در سطح مترو توصیف می کند.

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

از سیگنال های امن استفاده کنید

سیگنال‌های ایمن داده‌هایی هستند که توسط ناشر ایجاد می‌شوند و آنها انتخاب کرده‌اند تا با یک یا چند شریک به اشتراک بگذارند. آنها قبل از به اشتراک گذاشتن با Google در درخواست آگهی مبهم می شوند و در Curation بلادرنگ به شکل مبهم خود در SegmentRequest.user.eids.uids.id ظاهر می شوند.

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

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

نمونه های SegmentRequest

سیگنال متنی نقطه پایانی تنظیم زمان واقعی 

{
  "site":{
    "page":"https://dfpgpt.appspot.com/smd/"
  },
  "pub":{
    "id":"pub-1234567890987654"
  },
  "device":{
    "geo":{
      "country":"US",
        "metro":"501"
      }
    }
  }
}

سیگنال ایمن نقطه پایانی تنظیم در زمان واقعی 

{
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }]
  }
}

مراحل بعدی