مزيد من المعلومات حول الحِزم المنسّقة

يتيح لك مورد curators.curatedPackages إنشاء وإدارة حِزم من مستودع الناشر برمجيًا، والتي يمكنك تنظيمها نيابةً عن مخطّطي وسائل الإعلام.

تتيح لك الحِزم المنسَّقة تجميع مستودع إعلاني محدّد يستوفي معايير استهداف معيّنة، مثل أنواع الأجهزة والموقع الجغرافي وشرائح البيانات، وتحديد رسوم منسِّق يتم تحصيلها عندما يفوز المشترون بمرّات الظهور المستهدَفة من خلال الحزمة المنسَّقة.

فهم المفاهيم الأساسية

قبل بدء عملية الدمج، راجِع الحقول والإعدادات التي تحدّد طريقة عمل الحِزم المنسَّقة:

تحديد المستخدمين الذين يمكنهم الوصول إلى حِزمك المنسّقة

لا يمكن الوصول إلى حِزمك المنظَّمة إلا من خلال مخطّطي الوسائط الذين منحتهم إذن الوصول بشكل صريح باستخدام الحقل CuratedPackage.accessSettings. يجب ملء حقل accessSettings عند إنشاء الحزمة المنسّقة.

يمكنك استخدام طريقة mediaPlanners.list لعرض قائمة بمسؤولي التخطيط الإعلامي المؤهّلين ليتم تحديدهم في الحقل CuratedPackage.accessSettings.allowlistedMediaPlanners.

تنبيه: لا يمكنك إنشاء حِزم منسَّقة تمنح إذن الوصول إلى أكثر من مخطِّط وسائط.

ضبط المستودع الإعلاني الذي تستهدفه الحزمة المنسّقة

يمكنك استخدام الحقل CuratedPackage.targeting لتحديد المستودع الإعلاني الذي تستهدفه حزمة المحتوى المنسّق. يتم تعبئة الحقل targeting بالكائن PackageTargeting، الذي يتيح معايير الاستهداف، مثل نوع الجهاز وتنسيق التصميم والموقع الجغرافي.

يمكنك أيضًا تحديد الاستهداف المخصّص باستخدام الحقل CuratedPackage.targeting.includedDataSegments. يتيح لك الحقل includedDataSegments استهداف شرائح البيانات التي تديرها أنت أو شركاء آخرون في تنظيم المحتوى.

فهم منطق الاستهداف

تتم معالجة القيم في الحقول المتكرّرة باستخدام منطق OR، ما يعني أنّ مرّة الظهور التي تنطبق على أي من القيم المحدّدة هي مطابقة. تتم معالجة كل حقل باستخدام AND منطقي، ما يعني أنّه يجب أن تتطابق جميع الحقول المحدّدة مع مرّة ظهور معيّنة لكي تظهر الحزمة المنسّقة في طلب عروض الأسعار ذي الصلة.

ينشئ المثال التالي حزمة منسّقة مع ملء الحقل CuratedPackage.targeting لاستهداف مجموعة من أنواع الأجهزة وشرائح البيانات:

{
  "includedDeviceTypes": [
    "DEVICE_TYPE_PHONE",
    "DEVICE_TYPE_PERSONAL_COMPUTER"
  ],
  "includedDataSegments": [
    "curators/123456/dataSegments/8765",
    "curators/123456/dataSegments/8172"
  ]
}

يوضّح الجدول التالي ما إذا كانت الحزمة المنسّقة من المثال تستهدف ظهورًا، حيث يمثّل كل صف ظهورًا مختلفًا:

نوع الجهاز	معرّفات شرائح البيانات	هل تستهدف الحِزم المنسّقة؟
DEVICE_TYPE_PERSONAL_COMPUTER	‫8765، 8172	نعم
DEVICE_TYPE_PHONE	‫8172، 4321	نعم
DEVICE_TYPE_PHONE	9182	لا
DEVICE_TYPE_CONNECTED_TV	‫4321، 9182	لا

الإشارة إلى قيمة الحزمة المنسّقة

يجب تحديد رسوم تنظيم باستخدام الحقل CuratedPackage.fee union عند إنشاء حزمة منظَّمة، ولا يمكن ملء سوى أحد أنواع الرسوم المتوافقة مع العنصر CuratedPackage، مثل الحقل feeCpm. إجمالي رسوم التنظيم لمرّة ظهور معيّنة هو مجموع رسوم الحزمة المنظَّمة ورسوم أي شرائح بيانات مستهدَفة تنطبق على مرّة الظهور.

يمكنك أيضًا الإشارة إلى قيمة مرّات الظهور التي تستهدفها الحزمة المنسّقة من خلال ضبط الحقل CuratedPackage.floorPriceCpm، ما قد يؤثّر في الحدّ الأدنى للسعر المحدّد لمقدّمي عروض الأسعار في عرض الأسعار في الوقت الفعلي. السعر الأدنى الذي يتم إرساله إلى مقدّمي العروض هو القيمة الأعلى عند مقارنة السعر الأدنى الذي تحدّده في الحقل floorPriceCpm بمجموع السعر الأدنى الذي يحدّده الناشر وإجمالي رسوم التنظيم.

ملاحظة: يشمل الحد الأدنى لسعر الحزمة المنسّقة إجمالي رسوم التنسيق.

يعرض الجدول التالي أمثلة على كيفية احتساب الحد الأدنى الفعّال للسعر الذي يتم إرساله في طلب عرض السعر للحزمة المنسّقة:

السعر الأدنى للناشر (التكلفة لكل ألف ظهور)	إجمالي رسوم التنظيم (التكلفة لكل ألف ظهور)	الحدّ الأدنى لسعر الحزمة المنسّقة (التكلفة لكل ألف ظهور)	الحدّ الأدنى الفعّال (التكلفة لكلّ ألف ظهور)
7 دولارات	2 دولار أميركي (أو ما يعادلهما بالعملة المحلية)	$10	$10
4 دولارات	1 دولار أمريكي (أو ما يعادله بالعملة المحلية)	4 دولارات	دولار هونغ كونغ

التحكّم في عرض حزمة المحتوى المنسّق

يمكن أن تكون الحزمة المنسّقة في إحدى الحالات التالية:

• ACTIVE: الباقة المنسّقة نشطة. يمكن لمخطّطي الوسائط المشتركين تلقّي طلبات عروض أسعار في "عروض الأسعار في الوقت الفعلي" تتضمّن معرّف الحزمة المنسّقة للمستودع الإعلاني المستهدَف.
• INACTIVE: الحزمة المنسَّقة غير نشطة. لا يظهر معرّف الحزمة المنسّقة في طلبات عروض الأسعار في الوقت الفعلي، حتى بالنسبة إلى مخطّطي الوسائط المشتركين.

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

لمزيد من المعلومات حول سير العمل الذي يمكنك تنفيذه باستخدام المرجع curatedPackages، راجِع المحتوى التالي:

• كيفية الاطّلاع على شرائح الجمهور المستندة إلى بياناتك
• كيفية إنشاء حِزم منسَّقة وإدارتها
• كيفية تفعيل حِزم المحتوى المنسّق وإيقافها
• كيفية عرض حِزمك المنسَّقة