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_PEER39
    • 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)

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

تنطبق هذه السمة عندما تكون قيمة السمة 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_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 Video. يتم تحصيل الرسوم من خلال الشريك.
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 Digital Ad Ratings. يتم تحصيل الفواتير من خلال "مساحة العرض والفيديو 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".

لا يتوفّر هذا النوع حاليًا إلا لعملاء معيّنين. وسيتلقّى العملاء الآخرون الذين يحاولون استخدام هذا النوع رسالة خطأ.
PARTNER_COST_TYPE_PEER39 يتم تحصيل التكلفة مقابل استخدام Peer39. يتم تحصيل الرسوم من خلال الشريك.
PARTNER_COST_TYPE_PEER39_PREBID يتم تحصيل التكلفة مقابل استخدام Peer39 Pre-Bid. يتم تحصيل الفواتير من خلال "مساحة العرض والفيديو 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 يتم تحصيل تكلفة الشريك من قِبل الشريك.