این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

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

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

گوگل هنگام ارسال درخواست 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 : اطلاعاتی در مورد دستگاه، مانند موقعیت جغرافیایی دستگاه با دقت در سطح کلان‌شهر، را شرح می‌دهد.

شما می‌توانید از سیگنال‌های زمینه‌ای برای پیاده‌سازی منطق گزینش استفاده کنید که می‌تواند بخش‌های داده‌ی قابل اجرا را برای بازگشت در 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"
      }
  }
}

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

{
  "device":{
    "ifa":"OMITTED_IFA"
  },
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }],
    "buyeruid": "OMITTED_BUYERUID",
    "id": "OMITTED_ID"
  }
}

مراحل بعدی

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

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

گردآوری با سیگنال‌های زمینه‌ای یا نقاط پایانی سیگنال مخاطب

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

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

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

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

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

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

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

{
  "device":{
    "ifa":"OMITTED_IFA"
  },
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }],
    "buyeruid": "OMITTED_BUYERUID",
    "id": "OMITTED_ID"
  }
}

مراحل بعدی

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

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

گردآوری با سیگنال‌های زمینه‌ای یا نقاط پایانی سیگنال مخاطب

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

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

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

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

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

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

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

{
  "device":{
    "ifa":"OMITTED_IFA"
  },
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }],
    "buyeruid": "OMITTED_BUYERUID",
    "id": "OMITTED_ID"
  }
}

مراحل بعدی

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

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

گردآوری با سیگنال‌های زمینه‌ای یا نقاط پایانی سیگنال مخاطب

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

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

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

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

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

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

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

{
  "device":{
    "ifa":"OMITTED_IFA"
  },
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }],
    "buyeruid": "OMITTED_BUYERUID",
    "id": "OMITTED_ID"
  }
}

مراحل بعدی

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

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

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

گردآوری با سیگنال‌های زمینه‌ای یا نقاط پایانی سیگنال مخاطب

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

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

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

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

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

مراحل بعدی

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

گردآوری با سیگنال‌های زمینه‌ای یا نقاط پایانی سیگنال مخاطب

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

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

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

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

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

مراحل بعدی

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

گردآوری با سیگنال‌های زمینه‌ای یا نقاط پایانی سیگنال مخاطب

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

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

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

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

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

مراحل بعدی

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

گردآوری با سیگنال‌های زمینه‌ای یا نقاط پایانی سیگنال مخاطب

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

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

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

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

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

مراحل بعدی

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