تحليل SegmentRequest

في ميزة "التنسيق في الوقت الفعلي"، ترسل Google ملف JSON SegmentRequest إلى نقطة نهاية التنسيق لتوفير إشارات تصف انطباعًا واحدًا أو أكثر، ما يتيح لك تحديد شرائح البيانات السارية لكل انطباع. يتناول هذا الدليل تطوير منطق تنظيم المحتوى الذي يتعامل مع SegmentRequest.

استخدام ترميز gzip

تستخدم Google ترميز gzip عند إرسال SegmentRequest إلى نقطة النهاية. يجب أن يكون نقطة النهاية قادرة على تلقّي الردود باستخدام ترميز gzip.

الخدمات المختارة التي تستخدم نقاط نهاية الإشارات السياقية أو الإشارات الآمنة

عند إنشاء نقطة نهاية لخدمة "اختيار المحتوى في الوقت الفعلي"، عليك اختيار ما إذا كنت تريد تلقّي إشارات سياقية أو إشارات آمنة. تؤثّر الإشارات التي تختارها في طريقة ملء طلبات الشرائح المُرسَلة إلى نقطة النهاية، ومقدار المستودع الإعلاني الذي ينتج طلبات الشرائح المُرسَلة إلى نقطة النهاية، ومنطق التنسيق المستخدَم في عملية الدمج.

استخدام الإشارات السياقية

تتضمّن الإشارات السياقية معلومات حول الناشر والجهاز والمستخدم التي تصف مصدر مرّة الظهور. توضّح القائمة التالية الإشارات المتاحة:

  • استبدِل SegmentRequest.site بما يلي: تصف هذه السمة الموقع الإلكتروني الذي يعرض مرّة الظهور، مثل عنوان URL الخاص بالموقع الإلكتروني. يمكن تعبئة عمود واحد فقط من بين SegmentRequest.site وSegmentRequest.app في SegmentRequest.
  • استبدِل SegmentRequest.app بما يلي: تصف هذه السمة التطبيق الذي يعرض مرّة الظهور، مثل معرّف التطبيق الخاص بالنظام الأساسي. يمكن تعبئة عمود واحد فقط من بين SegmentRequest.site وSegmentRequest.app في SegmentRequest.
  • استبدِل SegmentRequest.pub بما يلي: تصف هذه السمة الناشر الذي يعرض الوسائط التي تؤدي إلى ظهور مرّة الظهور، مثل معرّف الناشر.
  • SegmentRequest.user: تصف هذه السمة خيارات المستخدمين بشأن كيفية معالجة بياناتهم الشخصية، مثل سلسلة الموافقة في إطار الشفافية والموافقة.
  • SegmentRequest.device: تصف هذه السمة معلومات عن الجهاز، مثل الموقع الجغرافي للجهاز بدقة على مستوى المدينة.

يمكنك استخدام الإشارات السياقية لتنفيذ منطق التنسيق الذي يمكنه تحديد شرائح البيانات المناسبة لعرضها في SegmentResponse.

استخدام الإشارات الآمنة

الإشارات الآمنة هي بيانات ينشئها الناشر ويختار مشاركتها مع شريك واحد أو أكثر. يتم تشويشها قبل مشاركتها مع Google في طلب الإعلان، وتظهر بشكلها المشوّش في SegmentRequest.user.eids.uids.id ضمن ميزة "اختيار المحتوى في الوقت الفعلي".

إذا تم ضبط نقطة النهاية لاستخدام الإشارات الآمنة، لن تتلقّى نقطة النهاية سوى طلبات شرائح من مستودع الناشرين الذين اختاروا مشاركة الإشارات الآمنة مع حسابك الخاص بالتنظيم. نتيجةً لذلك، يكون إجمالي مرّات الظهور المؤهَّلة للإرسال إلى نقاط نهاية الإشارات الآمنة أقل من تلك المؤهَّلة للإرسال إلى نقاط نهاية الإشارات السياقية.

يجب أن يفسّر منطق تنظيم المحتوى لنقطة النهاية الإشارة الآمنة، وأن يستخدمها لتحديد شرائح البيانات السارية التي سيتم عرضها في SegmentResponse.

"مدير إعلانات Google".

أمثلة على 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" }
      ]
    }]
  }
}

الخطوات التالية