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, השדה יהיה 0 בקריאה ותחול עמלה אוטומטית. זו רשימה של שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
feeAmount

string (int64 format)

סכום העמלה על עלות לאלף חשיפות במיקרו-יחידות של מטבע המפרסם.

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

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

string (int64 format)

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

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

לדוגמה: 100 מייצג 0.1%.
סוף השדות שמוציאים זה את זה.

PartnerCostType

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

טיפוסים בני מנייה (enum)
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 העלות הזו נגבית על השימוש בדסק למסחר של סוכנות פרסום. החיוב מתבצע על ידי השותף.
PARTNER_COST_TYPE_DV360_FEE העלות היא על השימוש ב-DV360. החיוב מתבצע דרך DV360.
PARTNER_COST_TYPE_COMSCORE_VCE העלות מחויבת על השימוש ב-comScore vCE. החיוב מתבצע דרך DV360.
PARTNER_COST_TYPE_DATA_MANAGEMENT_PLATFORM העלות נגבית על השימוש בפלטפורמה לניהול נתונים (DMP). החיוב מתבצע על ידי השותף.
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.

הסוג הזה זמין כרגע רק ללקוחות מסוימים. לקוחות אחרים שינסו להשתמש בסוג הזה יקבלו הודעת שגיאה.
PARTNER_COST_TYPE_PEER39 העלות מחויבת על השימוש ב-Peer39. החיוב מתבצע על ידי השותף.
PARTNER_COST_TYPE_PEER39_PREBID העלות מחויבת על השימוש ב-Peer39 Pre-Bid. החיוב מתבצע דרך 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 השותף מחייב על עלות השותף.