PartnerCost

تنظیماتی که هزینه شریک را کنترل می‌کنند.

هزینه مشارکت، هر نوع هزینه‌ای است که در اجرای یک کمپین، به غیر از هزینه‌های خرید نمایش (که هزینه رسانه نامیده می‌شود) و استفاده از داده‌های بخش مخاطبان شخص ثالث (هزینه داده) وجود دارد. برخی از نمونه‌های هزینه‌های مشارکت شامل هزینه‌های استفاده از DV360، یک سرور تبلیغاتی شخص ثالث یا یک سرویس تأیید نمایش تبلیغات شخص ثالث است.

نمایش 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)

مبلغ هزینه CPM به واحد پول تبلیغ‌کننده (میکرو)

زمانی که feeType برابر با PARTNER_FEE_TYPE_CPM_FEE باشد، قابل اجرا است. باید بزرگتر یا مساوی 0 باشد.

برای مثال، برای ۱.۵ واحد استاندارد از واحد پول تبلیغ‌کننده، این فیلد را روی ۱۵۰۰۰۰۰ تنظیم کنید.

feePercentageMillis

string ( int64 format)

درصد هزینه رسانه به میلی (۱/۱۰۰۰ درصد).

زمانی که feeType برابر با PARTNER_FEE_TYPE_MEDIA_FEE باشد، قابل اجرا است. باید بزرگتر یا مساوی 0 باشد.

برای مثال: عدد ۱۰۰ نشان‌دهنده ۰.۱٪ است.

پایان میدان‌های ناسازگار.

نوع هزینه شریک

انواع احتمالی هزینه شریک.

انوم‌ها
PARTNER_COST_TYPE_UNSPECIFIED مقدار نوع در این نسخه مشخص نشده یا ناشناخته است.
PARTNER_COST_TYPE_ADLOOX هزینه برای استفاده از Scope3 (که قبلاً با نام Adloox شناخته می‌شد) دریافت می‌شود. صورتحساب توسط شریک صادر می‌شود.
PARTNER_COST_TYPE_ADLOOX_PREBID هزینه برای استفاده از پیش‌خرید Scope3 (که قبلاً با نام Adloox شناخته می‌شد) دریافت می‌شود. صورتحساب از طریق DV360 صادر می‌شود.
PARTNER_COST_TYPE_ADSAFE هزینه استفاده از AdSafe دریافت می‌شود. صورتحساب توسط شریک صادر می‌شود.
PARTNER_COST_TYPE_ADXPOSE هزینه برای استفاده از AdExpose دریافت می‌شود. صورتحساب توسط شریک صادر می‌شود.
PARTNER_COST_TYPE_AGGREGATE_KNOWLEDGE هزینه استفاده از Aggregate Knowledge دریافت می‌شود. صورتحساب توسط شریک صادر می‌شود.
PARTNER_COST_TYPE_AGENCY_TRADING_DESK هزینه استفاده از میز معاملاتی آژانس دریافت می‌شود. صورتحساب توسط شریک صادر می‌شود.
PARTNER_COST_TYPE_DV360_FEE هزینه برای استفاده از DV360 دریافت می‌شود. صورتحساب از طریق DV360 صادر می‌شود.
PARTNER_COST_TYPE_COMSCORE_VCE هزینه برای استفاده از comScore vCE دریافت می‌شود. صورتحساب از طریق DV360 صادر می‌شود.
PARTNER_COST_TYPE_DATA_MANAGEMENT_PLATFORM هزینه استفاده از پلتفرم مدیریت داده دریافت می‌شود و توسط شریک محاسبه می‌شود.
PARTNER_COST_TYPE_DEFAULT نوع هزینه پیش‌فرض. توسط شریک محاسبه می‌شود.
PARTNER_COST_TYPE_DOUBLE_VERIFY هزینه استفاده از DoubleVerify دریافت می‌شود و توسط شریک پرداخت می‌شود.
PARTNER_COST_TYPE_DOUBLE_VERIFY_PREBID هزینه برای استفاده از پیش‌پرداخت DoubleVerify دریافت می‌شود. صورتحساب از طریق DV360 صادر می‌شود.
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 دریافت می‌شود. صورتحساب از طریق DV360 صادر می‌شود.
PARTNER_COST_TYPE_MEDIA_COST_DATA هزینه استفاده از داده‌های رسانه‌ای دریافت می‌شود. صورتحساب توسط شریک صادر می‌شود.
PARTNER_COST_TYPE_MOAT_VIDEO هزینه استفاده از MOAT Video دریافت می‌شود و توسط شریک محاسبه می‌شود.
PARTNER_COST_TYPE_NIELSEN_DAR هزینه برای استفاده از رتبه‌بندی تبلیغات دیجیتال نیلسن دریافت می‌شود. صورتحساب از طریق DV360 صادر می‌شود.
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 هزینه استفاده از ویزو دریافت می‌شود و توسط شریک پرداخت می‌شود.
PARTNER_COST_TYPE_CUSTOM_FEE_1 هزینه به عنوان هزینه سفارشی ۱ دریافت می‌شود. توسط شریک صورتحساب می‌شود.
PARTNER_COST_TYPE_CUSTOM_FEE_2 هزینه به عنوان هزینه سفارشی ۲ دریافت می‌شود. توسط شریک صورتحساب می‌شود.
PARTNER_COST_TYPE_CUSTOM_FEE_3 هزینه به عنوان هزینه سفارشی ۳ دریافت می‌شود. توسط شریک صورتحساب می‌شود.
PARTNER_COST_TYPE_CUSTOM_FEE_4 هزینه به عنوان هزینه سفارشی ۴ دریافت می‌شود. توسط شریک صورتحساب می‌شود.
PARTNER_COST_TYPE_CUSTOM_FEE_5 هزینه به عنوان هزینه سفارشی ۵ دریافت می‌شود. توسط شریک صورتحساب می‌شود.
PARTNER_COST_TYPE_SCIBIDS_FEE

هزینه برای استفاده از Scibids دریافت می‌شود. صورتحساب از طریق DV360 صادر می‌شود.

این نوع در حال حاضر فقط برای برخی از مشتریان در دسترس است. سایر مشتریانی که سعی در استفاده از این نوع دارند، با خطا مواجه خواهند شد.

هزینه همکارنوع کارمزد

انواع هزینه‌های احتمالی برای یک شریک.

انوم‌ها
PARTNER_COST_FEE_TYPE_UNSPECIFIED مقدار در این نسخه مشخص نشده یا ناشناخته است.
PARTNER_COST_FEE_TYPE_CPM_FEE

هزینه همکاری، یک هزینه ثابت CPM است.

زمانی که هزینه شریک 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 : هزینه_ویدیوی_مسابقه_مشارکت).

هزینه شریکنوع فاکتور

انواع فاکتورهای احتمالی برای هزینه شریک.

انوم‌ها
PARTNER_COST_INVOICE_TYPE_UNSPECIFIED مقدار نوع در این نسخه مشخص نشده یا ناشناخته است.
PARTNER_COST_INVOICE_TYPE_DV360 هزینه همکار از طریق DV360 محاسبه می‌شود.
PARTNER_COST_INVOICE_TYPE_PARTNER هزینه همکاری توسط همکار محاسبه می‌شود.