PartnerCost

Configurações que controlam um custo do parceiro.

O custo do parceiro é qualquer tipo de despesa envolvida na exibição de uma campanha. Isso não inclui os gastos com a compra de impressões (chamados de custo de mídia) nem o uso de dados de segmento 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 da veiculação de anúncios terceirizada.

Representação 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.
}
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 é um dos seguintes:
    • PARTNER_COST_TYPE_ADLOOX
    • PARTNER_COST_TYPE_DOUBLE_VERIFY
    • PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE.
  • Apenas saída para outros tipos.
Aplicável quando o cost_type não é PARTNER_COST_TYPE_DV360_FEE. Para PARTNER_COST_TYPE_DV360_FEE, o campo será 0 na leitura, e uma taxa automática será aplicada. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
feeAmount

string (int64 format)

O valor da taxa de CPM em micros da 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 este campo como 1500000.
feePercentageMillis

string (int64 format)

A porcentagem da taxa de mídia em milissegundos (1/1000 de um por cento).

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

Por exemplo, 100 representa 0,1%.
Fim dos campos mutuamente exclusivos.

PartnerCostType

Possíveis tipos de custo do parceiro.

Tipos enumerados
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 do Scope3 (antes conhecido como Adloox). Faturado pelo parceiro.
PARTNER_COST_TYPE_ADLOOX_PREBID O custo é cobrado pelo uso do pré-lance da Scope3 (antes conhecida como Adloox). Faturado pelo DV360.
PARTNER_COST_TYPE_ADSAFE O custo é cobrado pelo uso do AdSafe. Faturado pelo parceiro.
PARTNER_COST_TYPE_ADXPOSE O custo é cobrado pelo uso do AdExpose. Faturado pelo parceiro.
PARTNER_COST_TYPE_AGGREGATE_KNOWLEDGE O custo é cobrado pelo uso do 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 gestão 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 do DoubleVerify. Faturado pelo parceiro.
PARTNER_COST_TYPE_DOUBLE_VERIFY_PREBID O custo é cobrado pelo uso da pré-abertura de lances da DoubleVerify. Faturado pelo DV360.
PARTNER_COST_TYPE_EVIDON O custo é cobrado pelo uso do Evidon. Faturado pelo parceiro.
PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_VIDEO O custo é cobrado pelo uso do vídeo do Integral Ad Science. Faturado pelo parceiro.
PARTNER_COST_TYPE_INTEGRAL_AD_SCIENCE_PREBID O custo é cobrado pelo uso da pré-bid 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. Faturado pelo parceiro.
PARTNER_COST_TYPE_MOAT_VIDEO O custo é cobrado pelo uso do MOAT Video. 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 do 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 do TrustMetrics. Faturado pelo parceiro.
PARTNER_COST_TYPE_VIZU O custo é cobrado pelo uso do Vizu. Faturado pelo parceiro.
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. Faturado pelo parceiro.
PARTNER_COST_TYPE_SCIBIDS_FEE

O custo é cobrado pelo uso da 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 um erro.

PartnerCostFeeType

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

Tipos enumerados
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 é 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 aplicável quando o costType do parceiro é 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 faturas de um custo do parceiro.

Tipos enumerados
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 é faturado pelo DV360.
PARTNER_COST_INVOICE_TYPE_PARTNER O custo do parceiro é faturado pelo parceiro.