تحليل SegmentRequest

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

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

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

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

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

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

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

  • 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"
      }
  }
}

نقطة نهاية "التنظيم في الوقت الفعلي" لإشارات الجمهور

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

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