PartnerCost

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

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeAmount": string,
  "feePercentageMillis": string
  // End of mutually exclusive fields.
}
الحقول
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.
  • النتائج فقط للأنواع الأخرى.
تكون هذه السمة قابلة للتطبيق عندما لا تكون قيمة cost_type هي PARTNER_COST_TYPE_DV360_FEE. بالنسبة إلى PARTNER_COST_TYPE_DV360_FEE، سيكون الحقل 0 عند القراءة وسيتم تطبيق رسوم تلقائية. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
feeAmount

string (int64 format)

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

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

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

string (int64 format)

النسبة المئوية لرسوم الوسائط بالمللي ثانية (جزء من ألف من النسبة المئوية)

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

على سبيل المثال، يمثّل الرقم 100 نسبة %0.1.
نهاية الحقول التي يستبعد كلّ منها الآخر

PartnerCostType

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

عمليات التعداد
PARTNER_COST_TYPE_UNSPECIFIED لم يتم تحديد قيمة النوع أو أنّها غير معروفة في هذا الإصدار.
PARTNER_COST_TYPE_ADLOOX يتم تحصيل التكلفة مقابل استخدام Scope3 (المعروفة سابقًا باسم Adloox). يتم إصدار الفاتورة من قِبل الشريك.
PARTNER_COST_TYPE_ADLOOX_PREBID يتم تحصيل التكلفة مقابل استخدام ميزة "العرض المسبق" من Scope3 (المعروفة سابقًا باسم 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 Pre-Bid. يتم تحصيل الفواتير من خلال "مساحة العرض والفيديو 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_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 يتم تحصيل تكلفة الشريك من خلال الشريك.