PartnerCost

Configurações que controlam o custo de um parceiro.

O custo do parceiro é qualquer tipo de despesa envolvida na execução de uma campanha, exceto os custos de compra de impressões (o que é chamado de custo de mídia) e o uso de dados de segmentos de público-alvo de terceiros (taxa de dados). Alguns exemplos de custos do parceiro incluem as taxas pelo uso do DV360, de um servidor de anúncios de terceiros ou de um serviço de verificação de veiculação de anúncios de terceiros.

Representação 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.
}
Campos
costType

enum (PartnerCostType)

Obrigatório. É o tipo de custo do parceiro.

feeType

enum (PartnerCostFeeType)

Obrigatório. É o tipo de taxa para esse custo do parceiro.

invoiceType

enum (PartnerCostInvoiceType)

O tipo de fatura para esse custo do parceiro.

  • Obrigatório quando costType for:
    • PARTNER_COST_TYPE_ADLOOX
    • PARTNER_COST_TYPE_DOUBLE_VERIFY
    • PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE.
  • Saída apenas para outros tipos.
Campo de união fee_value. Aplicável quando o cost_type não é PARTNER_COST_TYPE_DV360_FEE. Para PARTNER_COST_TYPE_DV360_FEE, o campo vai ser 0 na leitura, e uma taxa automática vai ser aplicada. fee_value pode ser apenas de um dos tipos a seguir:
feeAmount

string (int64 format)

O valor da taxa de CPM em micros na moeda do anunciante.

Aplicável quando o feeType é PARTNER_FEE_TYPE_CPM_FEE. Deve ser maior ou igual a 0.

Por exemplo, para 1,5 unidade padrão da moeda do anunciante, defina esse campo como 1500000.

feePercentageMillis

string (int64 format)

É a porcentagem da taxa de mídia em milissegundos (1/1.000 de um percentual).

Aplicável quando o feeType é PARTNER_FEE_TYPE_MEDIA_FEE. Deve ser maior ou igual a 0.

Por exemplo: 100 representa 0,1%.

PartnerCostType

Possíveis tipos de custo do parceiro.

Enums
PARTNER_COST_TYPE_UNSPECIFIED O valor do tipo não está especificado ou é desconhecido nesta versão.
PARTNER_COST_TYPE_ADLOOX e cobramos pelo uso da Adloox. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_ADLOOX_PREBID O custo será cobrado pelo uso do pré-lance da Adloox. Faturado pelo DV360.
PARTNER_COST_TYPE_ADSAFE O custo será cobrado pelo uso do AdSafe. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_ADXPOSE O custo é cobrado ao usar o AdExpor. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_AGGREGATE_KNOWLEDGE e há cobrança pelo uso da Aggregate Knowledge. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_AGENCY_TRADING_DESK O custo é cobrado ao usar uma agência negociadora. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_DV360_FEE O custo é cobrado pelo uso do DV360. Faturado pelo DV360.
PARTNER_COST_TYPE_COMSCORE_VCE O custo é cobrado pelo uso do comScore VCE. Faturado pelo DV360.
PARTNER_COST_TYPE_DATA_MANAGEMENT_PLATFORM O custo é cobrado ao usar uma plataforma de gerenciamento de dados. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_DEFAULT O tipo de custo padrão. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_DOUBLE_VERIFY e cobramos pelo uso da DoubleVerify. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_DOUBLE_VERIFY_PREBID O custo é cobrado pelo uso do pré-lance da DoubleVerify. Faturado pelo DV360.
PARTNER_COST_TYPE_EVIDON O custo será cobrado pela utilização da Evidon. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_VIDEO O custo será cobrado pelo uso do vídeo da Integral Ad Science. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_PREBID O custo será cobrado pelo uso do pré-lance da Integral Ad Science. Faturado pelo DV360.
PARTNER_COST_TYPE_MEDIA_COST_DATA O custo é cobrado com base no uso dos dados de custo de mídia. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_MOAT_VIDEO O uso do vídeo da MOAT é cobrado. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_NIELSEN_DAR O custo será cobrado pelo uso da Nielsen Digital Ad Ratings. Faturado pelo DV360.
PARTNER_COST_TYPE_SHOP_LOCAL O custo é cobrado pelo uso do ShopLocal. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_TERACENT O custo é cobrado pelo uso do Teracent. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_THIRD_PARTY_AD_SERVER O custo é cobrado ao usar um servidor de anúncios de terceiros. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_TRUST_METRICS O custo é cobrado pelo uso do TrustMetrics. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_VIZU O uso do Vizu é cobrado. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_ADLINGO_FEE O custo é cobrado pelo uso do AdLingo. Faturado pelo DV360.
PARTNER_COST_TYPE_CUSTOM_FEE_1 O custo é cobrado como taxa personalizada 1. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_CUSTOM_FEE_2 O custo é cobrado como taxa personalizada 2. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_CUSTOM_FEE_3 O custo é cobrado como taxa personalizada 3. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_CUSTOM_FEE_4 O custo é cobrado como taxa personalizada 4. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_CUSTOM_FEE_5 O custo é cobrado como taxa personalizada 5. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_SCIBIDS_FEE

O custo é cobrado para usar o Scibids. Faturado pelo DV360.

No momento, esse tipo está disponível apenas para alguns clientes. Outros clientes que tentarem usar esse tipo vão receber uma mensagem de erro.

PartnerCostFeeType

Possíveis tipos de tarifa de um custo de parceiro.

Enums
PARTNER_COST_FEE_TYPE_UNSPECIFIED O valor não foi especificado ou é desconhecido nesta versão.
PARTNER_COST_FEE_TYPE_CPM_FEE

O custo do parceiro é uma taxa de CPM fixa.

Não aplicável quando o custo do parceiro costType for um dos seguintes:

  • PARTNER_COST_TYPE_MEDIA_COST_DATA
  • PARTNER_COST_TYPE_DV360_FEE.
PARTNER_COST_FEE_TYPE_MEDIA_FEE

O custo do parceiro é uma porcentagem de sobretaxa baseada no custo de mídia.

Não se aplica quando o parceiro costType é um dos seguintes:

  • PARTNER_COST_TYPE_SHOP_LOCAL
  • PARTNER_COST_TYPE_TRUST_METRICS
  • PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_VIDEO
  • PARTNER_COST_TYPE_MOAT_VIDEO.

PartnerCostInvoiceType

Possíveis tipos de fatura de um custo do parceiro.

Enums
PARTNER_COST_INVOICE_TYPE_UNSPECIFIED O valor do tipo não está especificado ou é desconhecido nesta versão.
PARTNER_COST_INVOICE_TYPE_DV360 O custo do parceiro é faturado pelo DV360.
PARTNER_COST_INVOICE_TYPE_PARTNER O custo do parceiro é cobrado pelo parceiro.