PartnerCost

הגדרות שקובעות את העלות לשותף.

עלות שותף היא כל סוג של הוצאה שקשורה להפעלת קמפיין, מלבד העלויות של רכישת חשיפות (שנקראת עלות המדיה) ושל שימוש בנתונים של פלחים של קהלים מצד שלישי (עמלת נתונים). דוגמאות לעלויות שותפים: עמלות על שימוש ב-DV360, בשרת מודעות של צד שלישי או בשירות אימות של שרת להצגת מודעות על ידי צד שלישי (3PAS).

ייצוג ב-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 או שווה ל-0.

לדוגמה, אם המחיר הוא 1.5 יחידות סטנדרטיות של המטבע של המפרסם, צריך להגדיר בשדה הזה את הערך 1500000.
feePercentageMillis

string (int64 format)

שיעור עמלת המדיה באלפיות (1/1000 של אחוז).

רלוונטי כשהערך של feeType הוא PARTNER_FEE_TYPE_MEDIA_FEE. הערך חייב להיות גדול מ-0 או שווה ל-0.

לדוגמה: הערך 100 מייצג 0.1%.
סוף השדות הבלעדיים.

PartnerCostType

סוגים אפשריים של עלויות שותפים.

טיפוסים בני מנייה (enum)
PARTNER_COST_TYPE_UNSPECIFIED ערך הסוג לא צוין או לא ידוע בגרסה הזו.
PARTNER_COST_TYPE_ADLOOX העלות היא על השימוש ב-Scope3 (שנקראה בעבר Adloox). החיוב מתבצע על ידי השותף.
PARTNER_COST_TYPE_ADLOOX_PREBID העלות היא על השימוש ב-Scope3 (שנקראה בעבר Adloox) Pre-Bid. החיוב מתבצע דרך 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 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 Digital Ad Ratings. החיוב מתבצע דרך 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 העלות נגבית כעמלה מותאמת אישית 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. החיוב מתבצע דרך DV360.

הסוג הזה זמין כרגע רק ללקוחות מסוימים. לקוחות אחרים שינסו להשתמש בסוג הזה יקבלו שגיאה.

PartnerCostFeeType

סוגי העמלות האפשריים של עלות שותף.

טיפוסים בני מנייה (enum)
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

סוגי החשבוניות האפשריים של עלות שותף.

טיפוסים בני מנייה (enum)
PARTNER_COST_INVOICE_TYPE_UNSPECIFIED ערך הסוג לא צוין או לא ידוע בגרסה הזו.
PARTNER_COST_INVOICE_TYPE_DV360 החיוב על עלות השותף מתבצע דרך DV360.
PARTNER_COST_INVOICE_TYPE_PARTNER השותף מחייב את עלות השותף.