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 o proponente 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 negociadora pode optar por trabalhar com uma ou mais DSPs. Há duas opções disponíveis para compradores que trabalham com uma 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 a 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 pretende 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 envia uma solicitação de lance que contém um ou mais IDs de faturamento associados a compradores e configurações de pré-segmentação 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, BidResponse.seatbid.bid.ext.billing_id é obrigatório para que o Google saiba a qual conta associar o lance. Qualquer resposta que não defina o campo será 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 um ID de faturamento de 123 e o outro com o ID de faturamento 124. O proponente configura uma configuração de pré-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 fossem suas únicas configurações de pré-segmentação ativas, você não receberia solicitações de lance para impressões que não fossem originadas de um computador pessoal e incluíssem conteúdo que não fosse em inglês.

Exemplo de BidRequests

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

Protobuf do OpenRTB

Mostrar o exemplo

Solicitação serializada

id: "2Ic9Szo73ub9164McIS5z4"
imp {
  id: "1"
  banner {
    w: 300
    h: 250
    pos: ABOVE_THE_FOLD
    format {
      w: 300
      h: 250
    }
    format {
      w: 320
      h: 100
    }
  }
  tagid: "3354852099"
  bidfloor: 1.0
  bidfloorcur: "JPY"
  secure: true
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.0004362155741546303
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.07
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 14872229026
    billing_id: 65822939644
    publisher_settings_list_id: 5996751740207644979
    publisher_settings_list_id: 7279221809215794243
    allowed_vendor_type: 0
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    buyer_generated_request_data {
      data: "Test Data"
    }
    buyer_generated_request_data {
      data: "Test Data"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    allowed_restricted_category: 32
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    gpid: "/7780786/example.com/homepage/image_top"
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "GB"
    }
  }
  content {
    language: "en"
  }
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    uact {
      wasact: true
      isact: false
    }
    ntype: NAVIGATION_TYPE_NAVIGATE
  }
}
device {
  ua: "OMITTED"
  geo {
    lat: 0.0
    lon: 0.0
    country: "GBR"
    region: "GB-ENG"
    zip: "S11"
    type: IP
    utcoffset: 60
    accuracy: 2754
    [com.google.doubleclick.geo] {
      geo_criteria_id: 9046364
    }
  }
  ipv6: "2a02:c7c:c202::"
  language: "en"
  os: "X11"
  devicetype: PERSONAL_COMPUTER
  w: 1536
  h: 864
  pxratio: 1.25
  sua {
    browsers {
      brand: "Google Chrome"
      version: "147"
      version: "0"
    }
    browsers {
      brand: "Not.A/Brand"
      version: "8"
      version: "0"
    }
    platform {
      brand: "Chrome OS"
      version: "16610"
      version: "57"
    }
    mobile: false
    architecture: "x86"
    bitness: "64"
    source: CLIENT_HINTS_HIGH_ENTROPY
  }
}
user {
  data {
    id: "0"
    segment {
      id: "OMITTED"
    }
    segment {
      id: "OMITTED"
    }
    [com.google.doubleclick.data] {
      segtax: 4
    }
  }
  consent: "OMITTED"
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 2577
      consented_providers: 2309
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    eids {
      source: "OMITTED_SOURCE"
      uids {
        id: "OMITTED_ID"
      }
    }
    eids {
      source: "OMITTED_SOURCE"
      uids {
        id: "OMITTED_ID"
      }
    }
  }
}
at: FIRST_PRICE
tmax: 500
cur: "BRL"
cur: "GBP"
bcat: "3"
bcat: "4"
regs {
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  google_query_id: "ANy-zcBbZN-AVQv37tjp208071nti0SFDv2FtD6776DgTHiouw72l227G6q3tZ1777nj5N4A"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE
  privacy_treatments {
    allow_user_data_collection: true
  }
}

JSON do OpenRTB

Mostrar o exemplo

{
  "id": "2Ic9Szo73ub9164McIS5z4",
  "imp": [
    {
      "id": "1",
      "banner": {
        "w": 300,
        "h": 250,
        "pos": 1,
        "format": [
          {
            "w": 300,
            "h": 250
          },
          {
            "w": 320,
            "h": 100
          }
        ]
      },
      "tagid": "3354852099",
      "bidfloor": 1.0,
      "bidfloorcur": "JPY",
      "secure": 1,
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.0004362155741546303,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.07,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "14872229026",
          "65822939644"
        ],
        "publisher_settings_list_id": [
          "5996751740207644979",
          "7279221809215794243"
        ],
        "allowed_vendor_type": [
          0
        ],
        "ampad": 3,
        "buyer_generated_request_data": [
          {
            "data": "Test Data"
          },
          {
            "data": "Test Data"
          }
        ],
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "allowed_restricted_category": [
          32
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "gpid": "/7780786/example.com/homepage/image_top"
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "GB"
      }
    },
    "content": {
      "language": "en"
    },
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "uact": {
        "wasact": 1,
        "isact": 0
      },
      "ntype": 1
    }
  },
  "device": {
    "ua": "OMITTED",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "GBR",
      "region": "GB-ENG",
      "zip": "S11",
      "type": 2,
      "utcoffset": 60,
      "accuracy": 2754,
      "ext": {
        "geo_criteria_id": 9046364
      }
    },
    "ipv6": "2a02:c7c:c202::",
    "language": "en",
    "os": "X11",
    "devicetype": 2,
    "w": 1536,
    "h": 864,
    "pxratio": 1.25,
    "sua": {
      "browsers": [
        {
          "brand": "Google Chrome",
          "version": [
            "147",
            "0"
          ]
        },
        {
          "brand": "Not.A/Brand",
          "version": [
            "8",
            "0"
          ]
        }
      ],
      "platform": {
        "brand": "Chrome OS",
        "version": [
          "16610",
          "57"
        ]
      },
      "mobile": 0,
      "architecture": "x86",
      "bitness": "64",
      "source": 2
    }
  },
  "user": {
    "data": [
      {
        "id": "0",
        "segment": [
          {
            "id": "OMITTED"
          },
          {
            "id": "OMITTED"
          }
        ],
        "ext": {
          "segtax": 4
        }
      }
    ],
    "consent": "OMITTED",
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "2577",
          "2309"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "eids": [
        {
          "source": "OMITTED_SOURCE",
          "uids": [
            {
              "id": "OMITTED_ID"
            }
          ]
        },
        {
          "source": "OMITTED_SOURCE",
          "uids": [
            {
              "id": "OMITTED_ID"
            }
          ]
        }
      ]
    }
  },
  "at": 1,
  "tmax": 500,
  "cur": [
    "BRL",
    "GBP"
  ],
  "bcat": [
    "3",
    "4"
  ],
  "regs": {
    "ext": {
      "gdpr": 1
    }
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    }
  },
  "cattax": 500,
  "ext": {
    "google_query_id": "ANy-zcBbZN-AVQv37tjp208071nti0SFDv2FtD6776DgTHiouw72l227G6q3tZ1777nj5N4A",
    "fcap_scope": 1,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}