Lance em nome de várias contas

Um proponente pode comprar inventário para vários compradores em uma única resposta de lance. Por exemplo, uma plataforma de demanda (DSP) pode usar o aplicativo de lances para comprar inventário para vários profissionais de marketing ou agências que são compradores. Este guia explica como programar seu bidder para processar uma única solicitação enviada em nome de vários compradores.

Contexto

Em alguns casos, uma rede de publicidade ou uma agência de trading desk pode optar por trabalhar com uma ou mais DSPs. Há duas opções disponíveis para compradores que trabalham com um DSP:

• A DSP compra inventário para profissionais de marketing ou agências que não são compradores. Nesse caso, a DSP recebe uma solicitação de lance e responde com um lance. O Google fatura o DSP diretamente.
• A DSP compra inventário para profissionais de marketing ou agências que são compradores. A DSP recebe uma solicitação de lance que inclui vários IDs de faturamento associados a compradores qualificados e pode fazer lances distintos para cada comprador em nome de quem eles querem dar lances. Nesse modelo, o Google fatura o comprador, não a DSP. O restante deste guia se concentra nesse cenário.

Configuração e pré-segmentação

O Google vai enviar uma solicitação de lance com um ou mais IDs de faturamento associados a compradores e configurações de segmentação antecipada que segmentaram a impressão. Eles podem ser encontrados no campo BidRequest.imp.ext.billing_id.

Ao responder a uma BidRequest que contém IDs de faturamento de vários compradores, o BidResponse.seatbid.bid.ext.billing_id é necessário para que o Google saiba qual conta associar ao lance. Qualquer resposta que não defina o campo é filtrada. O campo continua sendo opcional para qualquer BidRequest que inclua apenas um ID de faturamento.

Exemplo de pré-segmentação

Um proponente dá lances em nome de dois compradores, um com o ID de faturamento 123 e o outro com o ID de faturamento 124. O bidder configura uma configuração de segmentação com o ID de faturamento 213 para segmentar o idioma inglês e outra com o ID de faturamento 231 para segmentar computadores pessoais. A seguir, descrevemos os IDs de faturamento que aparecem em solicitações de lance para diferentes tipos de impressões.

Descrição da impressão	IDs de faturamento na solicitação de lance
Conteúdo em japonês em um computador pessoal.	123, 124, 231
Conteúdo em inglês em um smartphone.	123, 124, 213
Conteúdo em inglês em um computador pessoal.	123, 124, 213, 231

Importante:se essas forem suas únicas configurações de segmentação antecipada ativas, você não vai receber solicitações de lance para impressões que não foram originadas em um computador pessoal e incluem conteúdo que não é em inglês.

Exemplos de BidRequests

Confira abaixo exemplos de BidRequest. Há vários IDs de faturamento nessas solicitações porque elas são aplicáveis a várias contas.

Protobuf do OpenRTB

sample

id: "n9YFp0D9qE02Q5A49bo68a"
imp {
  id: "1"
  banner {
    w: 320
    h: 50
    pos: ABOVE_THE_FOLD
    api: MRAID_1
    api: MRAID_2
    format {
      w: 320
      h: 50
    }
  }
  displaymanager: "GoogleMobileAds-iOS"
  displaymanagerver: "11.2.0"
  tagid: "2913643481"
  bidfloor: 0.04
  bidfloorcur: "USD"
  secure: true
  exp: 3600
  clickbrowser: true
  metric {
    type: "click_through_rate"
    value: 0.0003642654628492892
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.98
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 41048190734
    billing_id: 87998475627
    publisher_settings_list_id: 5889715199959683550
    publisher_settings_list_id: 3379823455061055318
    allowed_vendor_type: 566
    allowed_vendor_type: 113
    ampad: AMP_AD_NOT_ALLOWED
    skadn {
      sourceapp: "com.google.testapp"
      skadnetids: "6ZVs3vs4"
      versions: "2.0"
      versions: "2.1"
      fidelities: VIEW_THROUGH_ADS
      fidelities: STOREKIT_RENDERED_ADS
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
app {
  name: "Test App"
  bundle: "com.google.testapp"
  publisher {
    id: "pub-6227762759521589"
    [com.google.doubleclick.publisher] {
      country: "US"
    }
  }
  content {
    url: "https://www.google.com"
    livestream: false
    language: "en"
  }
  storeurl: "https://www.google.com"
  [com.google.doubleclick.app] {
    inventorypartnerdomain: "OMITTED"
  }
}
device {
  ua: "Mozilla/5.0 (iPhone; CPU iPhone OS 17_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "USA"
    region: "TX"
    metro: "623"
    city: "Lewisville"
    type: IP
    utcoffset: -300
    accuracy: 6225
  }
  make: "Apple"
  model: "iPhone13,2"
  os: "iOS"
  osv: "17.4.1"
  connectiontype: WIFI
  devicetype: HIGHEND_PHONE
  lmt: true
  hwv: "iPhone13,2"
  w: 390
  h: 844
  pxratio: 3.0
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "AppleWebKit"
      version: "605"
      version: "1"
    }
    platform {
      brand: "iPhone"
      version: "17"
      version: "4"
    }
    mobile: true
    bitness: "64"
    model: "iPhone"
    source: USER_AGENT_STRING
  }
  [com.google.doubleclick.device] {
    atts: 2
  }
}
at: FIRST_PRICE
tmax: 1000
cur: "USD"
bcat: "IAB18-5"
bcat: "IAB23-4"
bapp: "359917414"
bapp: "1446254576"
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
  [com.google.doubleclick.source] {
    omidpn: "Google"
    omidpv: "afma-sdk-i-v11.2.0"
    schain {
      complete: 1
      nodes {
        asi: "testssp.com"
        sid: "pub-1111111111111111"
        hp: 1
      }
      ver: "1.0"
    }
  }
}
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-z17251-40u3eXfXPL5j3MDPa7n6Ree92uf7354o71FP67Rk5i3G30Ez7p39Ze1722D8H"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_APP
  privacy_treatments {
    allow_user_data_collection: true
  }
}