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_PEER39
    • PARTNER_COST_TYPE_DOUBLE_VERIFY
    • PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE.
  • فقط برای انواع دیگر برونداد ارائه شود.
زمانی قابل‌اجرا است که cost_type PARTNER_COST_TYPE_DV360_FEE نباشد. برای PARTNER_COST_TYPE_DV360_FEE، فیلد در خواندن ۰ خواهد بود و کارمزد خودکار اعمال خواهد شد. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
feeAmount

string (int64 format)

مبلغ کارمزد هزارظهوربها به میکرو واحد پول تبلیغ‌کننده.

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

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

feePercentageMillis

string (int64 format)

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

قابل‌اعمال وقتی feeType PARTNER_FEE_TYPE_MEDIA_FEE باشد. باید بزرگ‌تر یا مساوی با ۰ باشد.

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

پایان فیلدهای متقابلاً انحصاری.

PartnerCostType

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

شمارشی‌ها
PARTNER_COST_TYPE_UNSPECIFIED مقدار نوع مشخص نشده است یا در این نسخه ناشناخته است.
PARTNER_COST_TYPE_ADSAFE هزینه برای استفاده از AdSafe کسر می‌شود. صورت‌حساب ازسوی شریک صادر می‌شود.
PARTNER_COST_TYPE_ADXPOSE هزینه برای استفاده از AdExpose کسر می‌شود. صورت‌حساب ازسوی شریک صادر می‌شود.
PARTNER_COST_TYPE_AGGREGATE_KNOWLEDGE هزینه برای استفاده از Aggregate Knowledge کسر می‌شود. صورت‌حساب ازسوی شریک صادر می‌شود.
PARTNER_COST_TYPE_AGENCY_TRADING_DESK هزینه برای استفاده از 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 Pre-Bid کسر می‌شود. صورت‌حساب ازطریق 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 Pre-Bid کسر می‌شود. صورت‌حساب ازطریق DV360 صادر شده است.
PARTNER_COST_TYPE_MEDIA_COST_DATA هزینه برای استفاده از داده‌های هزینه رسانه کسر می‌شود. صورت‌حساب ازسوی شریک صادر می‌شود.
PARTNER_COST_TYPE_MOAT_VIDEO هزینه برای استفاده از MOAT Video کسر می‌شود. صورت‌حساب ازسوی شریک صادر می‌شود.
PARTNER_COST_TYPE_NIELSEN_DAR این هزینه برای استفاده از «رتبه‌بندی آگهی‌های دیجیتال Nielsen» کسر می‌شود. صورت‌حساب ازطریق 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 هزینه برای استفاده از 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_TYPE_PEER39 هزینه برای استفاده از Peer39 کسر می‌شود. صورت‌حساب ازسوی شریک صادر می‌شود.
PARTNER_COST_TYPE_PEER39_PREBID هزینه برای استفاده از Peer39 Pre-Bid کسر می‌شود. صورت‌حساب ازطریق DV360 صادر شده است.

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 هزینه شریک ازطریق DV360 صورت‌حساب می‌شود.
PARTNER_COST_INVOICE_TYPE_PARTNER هزینه شریک توسط شریک صورت‌حساب می‌شود.