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

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

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

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

گردآوری با سیگنال متنی یا نقاط انتهایی سیگنال امن

وقتی یک نقطه پایانیِ گزینشِ بلادرنگ (Real-time Curation endpoint) ایجاد می‌کنید ، باید انتخاب کنید که آیا سیگنال‌های متنی (contextual signal) یا سیگنال‌های امن (secure signal) دریافت کنید. سیگنال‌هایی که انتخاب می‌کنید بر نحوه‌ی جمع‌آوری درخواست‌های بخش‌بندی ارسال‌شده به نقطه‌ی پایانی شما، میزان موجودی درخواست‌های بخش‌بندی ارسال‌شده به نقطه‌ی پایانی شما و منطق گزینشِ مورد استفاده در ادغام شما تأثیر می‌گذارند.

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

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

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

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

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

سیگنال‌های امن، داده‌هایی هستند که توسط ناشر ایجاد شده‌اند و او تصمیم گرفته است آنها را با یک یا چند شریک به اشتراک بگذارد. آنها قبل از اینکه در درخواست تبلیغ با گوگل به اشتراک گذاشته شوند، مبهم‌سازی می‌شوند و در فرآیند گزینش بلادرنگ (Real-time Curation) به شکل مبهم خود در SegmentRequest.user.eids.uids.id ظاهر می‌شوند.

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

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

مثال‌های درخواست قطعه

سیگنال متنی، نقطه پایانی گزینش بلادرنگ 

{
  "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" }
      ]
    }]
  }
}

مراحل بعدی