PartnerCost

الإعدادات التي تتحكّم في تكلفة الشريك.

تكلفة الشريك هي أي نوع من النفقات المرتبطة بعرض حملة إعلانية، غير تكاليف شراء مرات الظهور (التي تُعرف باسم تكلفة جميع الوسائل) واستخدام بيانات شريحة الجمهور التابعة لجهة خارجية (رسوم البيانات). تشمل بعض الأمثلة على تكاليف الشركاء رسوم استخدام "مساحة العرض والفيديو 360" أو خادم إعلانات تابع لجهة خارجية أو خدمة التحقّق من عرض الإعلانات التابعة لجهات خارجية.

تمثيل JSON
{
  "costType": enum (PartnerCostType),
  "feeType": enum (PartnerCostFeeType),
  "invoiceType": enum (PartnerCostInvoiceType),

  // Union field fee_value can be only one of the following:
  "feeAmount": string,
  "feePercentageMillis": string
  // End of list of possible types for union field fee_value.
}
الحقول
costType

enum (PartnerCostType)

مطلوب. تمثّل هذه السمة نوع تكلفة الشريك.

feeType

enum (PartnerCostFeeType)

مطلوب. نوع الرسوم لتكلفة هذا الشريك

invoiceType

enum (PartnerCostInvoiceType)

نوع الفاتورة لتكلفة هذا الشريك

  • تكون هذه السمة مطلوبة عندما تكون السمة costType واحدة مما يلي:
    • PARTNER_COST_TYPE_ADLOOX
    • PARTNER_COST_TYPE_DOUBLE_VERIFY
    • PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE.
  • إخراج فقط للأنواع الأخرى.
حقل الاتحاد fee_value. سارٍ عندما لا تكون قيمة cost_type هي PARTNER_COST_TYPE_DV360_FEE. في PARTNER_COST_TYPE_DV360_FEE، سيكون الحقل 0 عند القراءة وسيتم تطبيق رسوم تلقائية. يمكن أن يكون fee_value واحدًا فقط مما يلي:
feeAmount

string (int64 format)

مبلغ رسوم التكلفة لكل ألف ظهور بالميكرومتر بعملة المعلِن.

سارٍ عندما تكون قيمة feeType هي PARTNER_FEE_TYPE_CPM_FEE. يجب أن تكون القيمة أكبر من 0 أو مساوية له.

على سبيل المثال، إذا كانت القيمة هي 1.5 وحدة عادية من عملة المعلِن، اضبط هذا الحقل على 1500000.

feePercentageMillis

string (int64 format)

النسبة المئوية لرسوم وسائل الإعلام بالمللي ثانية (1/1000 من النسبة المئوية)

سارٍ عندما تكون قيمة feeType هي PARTNER_FEE_TYPE_MEDIA_FEE. يجب أن تكون القيمة أكبر من 0 أو مساوية له.

على سبيل المثال: 100 تمثّل 0.1%.

PartnerCostType

الأنواع المحتملة لتكلفة الشريك.

عمليات التعداد
PARTNER_COST_TYPE_UNSPECIFIED قيمة النوع غير محدّدة أو غير معروفة في هذا الإصدار.
PARTNER_COST_TYPE_ADLOOX يتم تحصيل التكلفة مقابل استخدام Adloox. يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_ADLOOX_PREBID يتم تحصيل التكلفة مقابل استخدام عرض السعر المسبق من Adloox. فوترة "مساحة العرض والفيديو 360":
PARTNER_COST_TYPE_ADSAFE يتم تحصيل تكلفة استخدام AdSafe. يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_ADXPOSE يتم تحصيل التكلفة مقابل استخدام AdExpose. يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_AGGREGATE_KNOWLEDGE ويتم تحصيل التكلفة مقابل استخدام "المعرفة المجمّعة". يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_AGENCY_TRADING_DESK يتم تحصيل التكلفة مقابل استخدام مكتب التداول في الوكالة. يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_DV360_FEE يتم تحصيل التكلفة مقابل استخدام "مساحة العرض والفيديو 360". فوترة "مساحة العرض والفيديو 360":
PARTNER_COST_TYPE_COMSCORE_VCE يتم تحصيل التكلفة مقابل استخدام comScore vCE. فوترة "مساحة العرض والفيديو 360":
PARTNER_COST_TYPE_DATA_MANAGEMENT_PLATFORM يتم تحصيل التكلفة مقابل استخدام "منصّة إدارة بيانات". يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_DEFAULT نوع التكلفة التلقائي. يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_DOUBLE_VERIFY يتم تحصيل التكلفة مقابل استخدام DoubleVerify. يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_DOUBLE_VERIFY_PREBID يتم حساب التكلفة باستخدام عرض السعر المسبق من DoubleVerify. فوترة "مساحة العرض والفيديو 360":
PARTNER_COST_TYPE_EVIDON يتم تحصيل تكلفة استخدام Evidon. يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_VIDEO يتم تحصيل التكلفة مقابل استخدام فيديو Integral Ad Science. يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_PREBID يتم تحصيل التكلفة مقابل استخدام عرض السعر المسبق من Integral Ad Science. فوترة "مساحة العرض والفيديو 360":
PARTNER_COST_TYPE_MEDIA_COST_DATA يتم تحصيل التكلفة مقابل استخدام بيانات تكلفة جميع الوسائل. يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_MOAT_VIDEO يتم تحصيل التكلفة مقابل استخدام MOAT Video. يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_NIELSEN_DAR يتم تحصيل تكلفة استخدام "تقييمات الإعلانات الرقمية من Nielsen". فوترة "مساحة العرض والفيديو 360":
PARTNER_COST_TYPE_SHOP_LOCAL يتم تحصيل تكلفة استخدام ShopLocal. يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_TERACENT يتم تحصيل التكلفة مقابل استخدام Teracent. يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_THIRD_PARTY_AD_SERVER يتم تحصيل التكلفة مقابل استخدام خادم إعلانات تابع لجهة خارجية. يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_TRUST_METRICS يتم تحصيل التكلفة باستخدام TrustMetrics. يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_VIZU يتم تحصيل التكلفة مقابل استخدام Vizu. يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_ADLINGO_FEE يتم تحصيل التكلفة مقابل استخدام AdLingo. فوترة "مساحة العرض والفيديو 360":
PARTNER_COST_TYPE_CUSTOM_FEE_1 يتمّ تحصيل هذه التكلفة بأنّها رسوم مخصّصة 1- يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_CUSTOM_FEE_2 يتم تحصيل هذه التكلفة بصفتها رسوم مخصّصة 2- يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_CUSTOM_FEE_3 يتم تحصيل هذه التكلفة باعتبارها رسوم مخصّصة 3- يتم تحصيل رسوم الاشتراك من قِبل الشريك.
PARTNER_COST_TYPE_CUSTOM_FEE_4 تُحصَّل هذه التكلفة كرسوم مخصّصة 4- يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_CUSTOM_FEE_5 تُحفَظ هذه التكلفة بأنّها رسوم مخصّصة 5- يتم تحصيل الرسوم من قِبل الشريك.
PARTNER_COST_TYPE_SCIBIDS_FEE

ويتم تحصيل التكلفة مقابل استخدام Scibids. فوترة "مساحة العرض والفيديو 360":

هذا النوع متاح حاليًا لعملاء محددين فقط. وستظهر رسالة خطأ للعملاء الآخرين الذين يحاولون استخدام هذا النوع.

PartnerCostFeeType

أنواع الرسوم المحتملة لتكلفة الشريك.

عمليات التعداد
PARTNER_COST_FEE_TYPE_UNSPECIFIED القيمة غير محددة أو غير معروفة في هذا الإصدار.
PARTNER_COST_FEE_TYPE_CPM_FEE

تكلفة الشريك هي رسوم ثابتة لكل ألف ظهور.

لا ينطبق ذلك عندما تكون تكلفة الشريك بقيمة costType واحدة مما يلي:

  • PARTNER_COST_TYPE_MEDIA_COST_DATA
  • PARTNER_COST_TYPE_DV360_FEE.
PARTNER_COST_FEE_TYPE_MEDIA_FEE

وتكلفة الشريك هي نسبة مئوية من الرسوم الإضافية استنادًا إلى تكلفة جميع الوسائل.

لا ينطبق ذلك عندما يكون الشريك costType واحدًا مما يلي:

  • PARTNER_COST_TYPE_SHOP_LOCAL
  • PARTNER_COST_TYPE_TRUST_METRICS
  • PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_VIDEO
  • PARTNER_COST_TYPE_MOAT_VIDEO.

PartnerCostInvoiceType

أنواع الفواتير المحتملة لتكلفة الشريك.

عمليات التعداد
PARTNER_COST_INVOICE_TYPE_UNSPECIFIED قيمة النوع غير محدّدة أو غير معروفة في هذا الإصدار.
PARTNER_COST_INVOICE_TYPE_DV360 تتم فوترة تكلفة الشريك من خلال "مساحة العرض والفيديو 360".
PARTNER_COST_INVOICE_TYPE_PARTNER يحصّل الشريك تكلفة استخدام الشريك.