تحليل 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.

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

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