PartnerCost

Ustawienia, które kontrolują koszt partnera.

Koszt partnera to dowolny rodzaj wydatku związany z prowadzeniem kampanii, inny niż koszty zakupu wyświetleń (nazywane kosztem mediów) oraz korzystania z danych o segmentach odbiorców firm zewnętrznych (opłata za dane). Przykładami kosztów partnera są np. opłaty za używanie DV360, serwera reklamowego firmy zewnętrznej i usługi weryfikacyjnej wyświetlania reklam firm zewnętrznych.

Zapis 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.
}
Pola
costType

enum (PartnerCostType)

Wymagane. Typ kosztu partnera.

feeType

enum (PartnerCostFeeType)

Wymagane. Typ opłaty dla tego kosztu partnera.

invoiceType

enum (PartnerCostInvoiceType)

Typ faktury dla tego kosztu partnera.

  • Wymagane, gdy costType ma jedną z tych wartości:
    • PARTNER_COST_TYPE_ADLOOX
    • PARTNER_COST_TYPE_DOUBLE_VERIFY
    • PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE.
  • W przypadku innych typów tylko dane wyjściowe.
Ma zastosowanie, gdy wartość cost_type nie jest równa PARTNER_COST_TYPE_DV360_FEE. W przypadku PARTNER_COST_TYPE_DV360_FEE pole będzie miało wartość 0 podczas odczytu, a opłata zostanie naliczona automatycznie. Poniżej znajduje się lista pól, które się wzajemnie wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
feeAmount

string (int64 format)

Wartość opłaty CPM w mikro w walucie reklamodawcy.

Obowiązuje, gdy wartość właściwości feeType to PARTNER_FEE_TYPE_CPM_FEE. Wartość musi być większa od lub równa 0.

Na przykład w przypadku 1,5 jednostki standardowej waluty reklamodawcy ustaw to pole na 1500000.

feePercentageMillis

string (int64 format)

Procent opłaty za media w milisekundach (1/1000 procenta).

Obowiązuje, gdy wartość właściwości feeType to PARTNER_FEE_TYPE_MEDIA_FEE. Wartość musi być większa od lub równa 0.

Na przykład 100 oznacza 0,1%.

Koniec pól wykluczających się nawzajem.

PartnerCostType

Możliwe typy kosztów partnera.

Wartości w polu enum
PARTNER_COST_TYPE_UNSPECIFIED Wartość typu nie jest określona lub jest nieznana w tej wersji.
PARTNER_COST_TYPE_ADLOOX Koszt jest naliczany za korzystanie z usługi Scope3 (wcześniej znanej jako Adloox). Rozliczane przez partnera.
PARTNER_COST_TYPE_ADLOOX_PREBID Opłata jest naliczana za korzystanie z usługi Scope3 (wcześniej Adloox) Pre-Bid. Płatności obsługiwane przez DV360.
PARTNER_COST_TYPE_ADSAFE Opłata jest naliczana za korzystanie z usługi AdSafe. Rozliczane przez partnera.
PARTNER_COST_TYPE_ADXPOSE Koszt jest naliczany za korzystanie z usługi AdExpose. Rozliczane przez partnera.
PARTNER_COST_TYPE_AGGREGATE_KNOWLEDGE Opłata jest naliczana za korzystanie z funkcji Aggregate Knowledge. Rozliczane przez partnera.
PARTNER_COST_TYPE_AGENCY_TRADING_DESK Opłata jest naliczana za korzystanie z agencyjnej platformy zakupowej. Rozliczane przez partnera.
PARTNER_COST_TYPE_DV360_FEE Koszt jest naliczany za korzystanie z DV360. Płatności obsługiwane przez DV360.
PARTNER_COST_TYPE_COMSCORE_VCE Opłata jest naliczana za korzystanie z comScore vCE. Płatności obsługiwane przez DV360.
PARTNER_COST_TYPE_DATA_MANAGEMENT_PLATFORM Opłata jest naliczana za korzystanie z platformy zarządzania danymi. Rozliczane przez partnera.
PARTNER_COST_TYPE_DEFAULT Domyślny typ kosztu. Rozliczane przez partnera.
PARTNER_COST_TYPE_DOUBLE_VERIFY Opłata jest naliczana za korzystanie z usługi DoubleVerify. Rozliczane przez partnera.
PARTNER_COST_TYPE_DOUBLE_VERIFY_PREBID Opłata jest naliczana za korzystanie z DoubleVerify Pre-Bid. Płatności obsługiwane przez DV360.
PARTNER_COST_TYPE_EVIDON Opłata jest naliczana za korzystanie z usługi Evidon. Rozliczane przez partnera.
PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_VIDEO Opłata jest pobierana za korzystanie z usługi Integral Ad Science Video. Rozliczane przez partnera.
PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_PREBID Opłata jest pobierana za korzystanie z usługi Integral Ad Science Pre-Bid. Płatności obsługiwane przez DV360.
PARTNER_COST_TYPE_MEDIA_COST_DATA Opłata jest naliczana za korzystanie z danych o kosztach mediów. Rozliczane przez partnera.
PARTNER_COST_TYPE_MOAT_VIDEO Koszt jest naliczany za korzystanie z MOAT Video. Rozliczane przez partnera.
PARTNER_COST_TYPE_NIELSEN_DAR Opłata jest pobierana za korzystanie z usługi Nielsen Digital Ad Ratings. Płatności obsługiwane przez DV360.
PARTNER_COST_TYPE_SHOP_LOCAL Opłata jest naliczana za korzystanie z usługi ShopLocal. Rozliczane przez partnera.
PARTNER_COST_TYPE_TERACENT Koszt jest naliczany za korzystanie z usługi Teracent. Rozliczane przez partnera.
PARTNER_COST_TYPE_THIRD_PARTY_AD_SERVER Opłata jest naliczana za korzystanie z serwera reklamowego firmy zewnętrznej. Rozliczane przez partnera.
PARTNER_COST_TYPE_TRUST_METRICS Opłata jest naliczana za korzystanie z TrustMetrics. Rozliczane przez partnera.
PARTNER_COST_TYPE_VIZU Opłata jest naliczana za korzystanie z Vizu. Rozliczane przez partnera.
PARTNER_COST_TYPE_CUSTOM_FEE_1 Koszt jest naliczany jako opłata niestandardowa 1. Rozliczane przez partnera.
PARTNER_COST_TYPE_CUSTOM_FEE_2 Koszt jest naliczany jako opłata niestandardowa 2. Rozliczane przez partnera.
PARTNER_COST_TYPE_CUSTOM_FEE_3 Koszt jest naliczany jako opłata niestandardowa 3. Rozliczane przez partnera.
PARTNER_COST_TYPE_CUSTOM_FEE_4 Koszt jest naliczany jako opłata niestandardowa 4. Rozliczane przez partnera.
PARTNER_COST_TYPE_CUSTOM_FEE_5 Koszt jest naliczany jako opłata niestandardowa 5. Rozliczane przez partnera.
PARTNER_COST_TYPE_SCIBIDS_FEE

Opłata jest naliczana za korzystanie z usługi Scibids. Płatności obsługiwane przez DV360.

Ten typ jest obecnie dostępny tylko dla niektórych klientów. Inni klienci, którzy spróbują użyć tego typu, otrzymają błąd.

PartnerCostFeeType

Możliwe typy opłat kosztu partnera.

Wartości w polu enum
PARTNER_COST_FEE_TYPE_UNSPECIFIED Wartość nie jest określona lub jest nieznana w tej wersji.
PARTNER_COST_FEE_TYPE_CPM_FEE

Koszt partnera to stała opłata CPM.

Nie ma zastosowania, gdy koszt partnera costType jest jednym z tych typów:

  • PARTNER_COST_TYPE_MEDIA_COST_DATA
  • PARTNER_COST_TYPE_DV360_FEE.
PARTNER_COST_FEE_TYPE_MEDIA_FEE

Koszt partnera to procentowa opłata dodatkowa zależna od kosztu mediów.

Nie ma zastosowania, gdy partner costType jest jednym z tych podmiotów:

  • PARTNER_COST_TYPE_SHOP_LOCAL
  • PARTNER_COST_TYPE_TRUST_METRICS
  • PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_VIDEO
  • PARTNER_COST_TYPE_MOAT_VIDEO.

PartnerCostInvoiceType

Możliwe typy faktur kosztów partnera.

Wartości w polu enum
PARTNER_COST_INVOICE_TYPE_UNSPECIFIED Wartość typu nie jest określona lub jest nieznana w tej wersji.
PARTNER_COST_INVOICE_TYPE_DV360 Koszt partnera jest rozliczany w DV360.
PARTNER_COST_INVOICE_TYPE_PARTNER Koszt partnera jest rozliczany przez partnera.