PartnerCost

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

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

ייצוג JSON 
{
  "costType": enum (PartnerCostType),
  "feeType": enum (PartnerCostFeeType),
  "invoiceType": enum (PartnerCostInvoiceType),

  // Union field fee_value can be only one of the following:
  "feeAmount": string,
  "feePercentageMillis": string
  // End of list of possible types for union field fee_value.
}
שדות
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.
  • פלט רק לסוגי מודעות אחרים.
שדה האיחוד fee_value. רלוונטי כאשר הערך של cost_type הוא לא PARTNER_COST_TYPE_DV360_FEE. עבור PARTNER_COST_TYPE_DV360_FEE הערך של השדה יהיה 0 בזמן קריאה ותחול עמלה אוטומטית. הערך של fee_value יכול להיות רק אחת מהאפשרויות הבאות:
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_ADLOOX העלות נגבית על השימוש ב-Adloox. החיוב מתבצע על ידי השותף.
PARTNER_COST_TYPE_ADLOOX_PREBID העלות מחויבת על השימוש ב-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. החיוב מתבצע על ידי 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_ADLINGO_FEE אנחנו מחייבים את השימוש ב-AdLingo. החיוב מתבצע דרך DV360.
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 השותף מחייב את עלות השותף.