- المورد: InventorySource
- BuyerStatus
- SellerStatus
- InventorySourceVolumeForecast
- DailyVolume
- DayOfWeek
- CreativeApprovalConfig
- PublisherConfig
- الطُرق
المرجع: InventorySource
نموذج التنفيذ لمصدر مستودع "مساحة العرض والفيديو 360".
تمثيل JSON |
---|
{ "name": string, "buyerStatus": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم المورد النسبي للطلب تم إنشاؤها من قِبل الخادم. مثال: "exchanges/1234/inventorySources/5678". |
buyerStatus |
النتائج فقط. حالة المشتري |
sellerStatus |
حالة البائع |
transactionType |
النتائج فقط. نوع معاملة المنتج |
pricingType |
النتائج فقط. نوع السعر للمنتج. |
rateDetails |
النتائج فقط. تفاصيل السعر |
startTime |
النتائج فقط. الوقت الذي يصبح فيه هذا المنتج نشطًا. يجب أن يكون قبل endTime. لا يمكن أن يكون وقت البدء بعد أكثر من عام واحد في المستقبل. يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: |
endTime |
النتائج فقط. الوقت الذي يصبح فيه هذا المنتج غير نشط يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: |
exchangeVolumeForecast |
يوفّر الصرف توقّعات يومية للحجم. تُستخدَم لتحديد وتيرة عرض الإعلانات وتفعيل خيار المشتري. تم إيقاف هذا الحقل نهائيًا. |
audienceMatchRate |
النتائج فقط. معدّل المطابقة المتوقّع للجمهور في الصفقات المضمونة الآلية التي تستهدِف شرائح الجمهور، ويستخدمه التبادل لتحديد عدد الطلبات الإضافية التي يجب إرسالها. هذه قيمة عشرية تتراوح بين 0 و1، ويجب استخدام مقلوبها كمُضاعِف لمرّات الظهور. يشير الرقم 0 إلى أنّ الحقل غير محدّد، وبالتالي لا يتضمّن استهدافًا للجمهور. مثال: "0.125". يشير ذلك إلى أنّ% 12.5 من الطلبات تتطابق مع استهداف الجمهور، ويجب أن يكون عدد الطلبات المُرسَلة 8 مرّات عدد مرّات الظهور المُتّفَق عليها. |
makegoodRequested |
النتائج فقط. يشير إلى ما إذا تم طلب تعويض من المشتري. |
makegoodRequestedReason |
النتائج فقط. سبب طلب التعويض المقدَّم من المشتري |
percentFrequencyCapExcludedTraffic |
النسبة المئوية للزيارات المستبعَدة من الحدّ الأقصى لعدد مرّات الظهور لصفقة مضمونة آليًا. يجب أن يكون هذا العنصر عددًا صحيحًا بين 0 و100. تشير القيمة 0 (وهي القيمة التلقائية أيضًا) إلى عدم وجود استثناء، وبالتالي تكون جميع الزيارات مؤهّلة للحدّ الأقصى لعدد مرّات الظهور. تشير القيمة 100 إلى استثناء كامل، وبالتالي لن يتم تطبيق حدّ أقصى لعدد مرّات الظهور. ستؤدي القيم بين 0 و100 إلى استبعاد جزئي. على سبيل المثال، ستؤدي القيمة 20 إلى استبعاد% 20 من عدد الزيارات من الحدّ الأقصى لعدد مرّات الظهور. |
dv360WseatId[] |
النتائج فقط. ملفات تعريف الارتباط التي تم منحها حاليًا الإذن بالوصول إلى مصدر المستودع |
lastModifiedTime |
النتائج فقط. آخر مرة تم فيها تعديل مصدر المستودع يُرجى العِلم أنّ بعض التعديلات الداخلية في DV3 ستؤدي إلى تغيير وقت التعديل الأخير. يستخدم معيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه دائمًا مُعدَّلاً وفقًا لقاعدة Z ويستخدم 0 أو 3 أو 6 أو 9 أرقام عشرية. يتم أيضًا قبول العناصر غير "Z". أمثلة: |
creativeApprovalConfig |
اختياريّ. الإعدادات الخاصة بالموافقة على تصميم الإعلان. يمكن أن تكون الموافقة مطلوبة على مستوى التبادل أو على مستوى الناشر. |
BuyerStatus
حالة المشتري
عمليات التعداد | |
---|---|
BUYER_STATUS_UNSPECIFIED |
لم يتم تحديد حالة المشتري. قيمة الإدخال غير صالحة. |
BUYER_STATUS_ACTIVE |
حالة المشتري نشطة. تمّ إسناد العنصر، وتمّ إسناد تصميم إعلان صالح. |
BUYER_STATUS_PENDING |
حالة المشتري معلّقة. تعني هذه الحالة أنّ الصفقة غير نشطة وأنّ هناك إجراءات معيّنة مطلوبة من المشتري. |
BUYER_STATUS_PAUSED |
حالة المشتري "تم إيقافه مؤقتًا من قِبل المشتري" |
SellerStatus
حالة البائع
عمليات التعداد | |
---|---|
SELLER_STATUS_UNSPECIFIED |
لم يتم تحديد حالة البائع. غير متوقّعة، وتشير إلى أنّ حالة التفاوض غير معروفة. قيمة الإدخال غير صالحة. |
SELLER_STATUS_ACTIVE |
حالة البائع نشطة. مصدر المستودع نشط على جانب التبادل. |
SELLER_STATUS_PAUSED |
تم إيقاف حالة البائع مؤقتًا. |
InventorySourceVolumeForecast
توقّعات حجم الطلبات اليومية لمصدر مستودع تنطبق قواعد التحقّق التالية: - يجب تقديم إدخال لكل يوم من أيام الأسبوع - يجب أن يكون حجم المحتوى غير سالب - يجب إدخال مَعلمة timeZoneId ويجب أن تكون صالحة.
تمثيل JSON |
---|
{
"dailyVolumes": [
{
object ( |
الحقول | |
---|---|
dailyVolumes[] |
توقّعات الكميات اليومية |
timeZoneId |
المنطقة الزمنية لقاعدة بيانات المناطق الزمنية في IANA، مثل "أمريكا/نيويورك"، والتي تُستخدَم للكميات اليومية. |
DailyVolume
طلب حجم مصدر مستودع في يوم معيّن
تمثيل JSON |
---|
{
"day": enum ( |
الحقول | |
---|---|
day |
يوم الأسبوع الذي ينطبق عليه حجم الطلبات. |
volume |
حجم الطلبات المتوقّع ليوم محدّد من الأسبوع. |
DayOfWeek
يمثّل يومًا من أيام الأسبوع.
عمليات التعداد | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
يوم الأسبوع غير محدّد. |
MONDAY |
الاثنين |
TUESDAY |
الثلاثاء |
WEDNESDAY |
الأربعاء |
THURSDAY |
الخميس |
FRIDAY |
الجمعة |
SATURDAY |
السبت |
SUNDAY |
الأحد |
CreativeApprovalConfig
الإعدادات الخاصة بالموافقة على تصميم الإعلان.
تمثيل JSON |
---|
{
"requiresExchangeApproval": boolean,
"publisherConfigs": [
{
object ( |
الحقول | |
---|---|
requiresExchangeApproval |
مطلوب. يشير إلى ما إذا كان تصميم الإعلان يتطلّب موافقة قبل نقله على مستوى التبادل. |
publisherConfigs[] |
اختياريّ. الإعدادات الخاصة بالناشر |
PublisherConfig
إعدادات الناشر (publisher_config). في حال ضبط publisher_config، يتطلّب تصميم الإعلان الحصول على موافقة قبل نقله على مستوى الناشر.
تمثيل JSON |
---|
{ "publisherId": string, "publisherDisplayName": string } |
الحقول | |
---|---|
publisherId |
مطلوب. الرقم التعريفي للناشر |
publisherDisplayName |
مطلوب. اسم الناشر |
الطُرق |
|
---|---|
|
الحصول على مصدر مستودع |
|
يسرد مصادر المستودع. |
|
تعديل مصدر مستودع |