PartnerCost

Configurações que controlam um custo do parceiro.

O custo do parceiro é qualquer tipo de despesa envolvida na exibição de uma campanha, além dos custos da compra de impressões (chamados de custo de mídia) e do uso de dados de segmento de público-alvo de terceiros (taxa de dados). Alguns exemplos de custos de parceiros incluem as taxas pelo uso do DV360, do 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 desse custo do parceiro.

invoiceType

enum (PartnerCostInvoiceType)

O tipo de fatura desse custo do parceiro.

  • Obrigatório quando costType for um dos seguintes:
    • 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 cost_type não é PARTNER_COST_TYPE_DV360_FEE. No caso de PARTNER_COST_TYPE_DV360_FEE, o campo será 0 no momento da leitura, e uma taxa automática será aplicada. fee_value pode ser apenas um dos seguintes:
feeAmount

string (int64 format)

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

Aplicável quando 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 milésimos (1/1000 de um por cento).

Aplicável quando 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 foi especificado ou é desconhecido nesta versão.
PARTNER_COST_TYPE_ADLOOX O custo é cobrado pelo uso da Adloox. Faturado pelo parceiro.
PARTNER_COST_TYPE_ADLOOX_PREBID O custo é cobrado pelo uso do pré-lance da Adloox. Faturado pelo DV360.
PARTNER_COST_TYPE_ADSAFE O custo é cobrado pelo uso do AdSafe. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_ADXPOSE O custo é cobrado pelo uso do AdExper. Faturado pelo parceiro.
PARTNER_COST_TYPE_AGGREGATE_KNOWLEDGE O custo é cobrado pelo uso da Aggregate Knowledge. Faturado pelo parceiro.
PARTNER_COST_TYPE_AGENCY_TRADING_DESK O custo é cobrado pelo uso de uma agência negociadora. Faturado 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 pelo uso de uma plataforma de gerenciamento de dados. Faturado pelo parceiro.
PARTNER_COST_TYPE_DEFAULT O tipo de custo padrão. Faturado pelo parceiro.
PARTNER_COST_TYPE_DOUBLE_VERIFY O custo é cobrado 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 é cobrado pelo uso do Evidon. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_VIDEO O custo é cobrado pelo uso do vídeo da Integral Ad Science. Faturado pelo parceiro.
PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_PREBID O custo é cobrado pelo uso do pré-lance da Integral Ad Science. Faturado pelo DV360.
PARTNER_COST_TYPE_MEDIA_COST_DATA O custo é cobrado pelo uso de dados de custo de mídia. O faturamento é feito pelo parceiro.
PARTNER_COST_TYPE_MOAT_VIDEO O uso da MOAT Video é cobrado à parte. Faturado pelo parceiro.
PARTNER_COST_TYPE_NIELSEN_DAR O custo é cobrado pelo uso da Nielsen Digital Ad Ratings. Faturado pelo DV360.
PARTNER_COST_TYPE_SHOP_LOCAL O custo é cobrado pelo uso do ShopLocal. Faturado pelo parceiro.
PARTNER_COST_TYPE_TERACENT O custo é cobrado pelo uso da Teracent. Faturado pelo parceiro.
PARTNER_COST_TYPE_THIRD_PARTY_AD_SERVER O custo é cobrado pelo uso de um servidor de anúncios de terceiros. Faturado pelo parceiro.
PARTNER_COST_TYPE_TRUST_METRICS O custo é cobrado pelo uso da TrustMetrics. Faturado pelo parceiro.
PARTNER_COST_TYPE_VIZU O custo é cobrado pelo uso do Vizu. Faturado 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. Faturado pelo parceiro.
PARTNER_COST_TYPE_CUSTOM_FEE_2 O custo é cobrado como taxa personalizada 2. Faturado pelo parceiro.
PARTNER_COST_TYPE_CUSTOM_FEE_3 O custo é cobrado como taxa personalizada 3. Faturado pelo parceiro.
PARTNER_COST_TYPE_CUSTOM_FEE_4 O custo é cobrado como taxa personalizada 4. Faturado 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 pelo uso da Scibids. Faturado pelo DV360.

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

PartnerCostFeeType

Tipos de taxas possíveis 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 se aplica quando o custo do parceiro costType é 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 sobretaxa percentual com base no custo de mídia.

Não aplicável 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 foi especificado ou é desconhecido nesta versão.
PARTNER_COST_INVOICE_TYPE_DV360 O custo do parceiro é cobrado pelo DV360.
PARTNER_COST_INVOICE_TYPE_PARTNER O custo do parceiro é cobrado por ele.