Opciones de configuración de la orientación previa
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Los ofertantes pueden usar el recurso pretargetingConfigs para recibir solo solicitudes de ofertas por las impresiones que coincidan con sus criterios de segmentación.Puedes tener hasta 10 configuraciones de segmentación previa a la vez.
Cada configuración de segmentación previa distribuye las solicitudes de oferta a todos los extremos.
Las solicitudes de oferta no siempre se distribuyen de manera uniforme entre todos los extremos. Por ejemplo, una configuración de segmentación previa para ID geográficos específicos en una región determinada podría tener menos coincidencias en las ubicaciones de comercio que se encuentren más lejos de esa región. Los extremos cercanos a esas ubicaciones de comercio más lejanas podrían recibir menos solicitudes de ofertas.
Prácticas recomendadas
Para recibir solicitudes de ofertas, debes crear al menos una configuración de segmentación previa. A continuación, se incluyen algunas sugerencias para administrar la configuración de la segmentación previa:
- Permiso
La segmentación previa es como el filtrado. Debes usar criterios de segmentación previa para filtrar las solicitudes de ofertas según las que sean relevantes para tu caso de uso. Si no estableces ningún criterio de segmentación previa, puedes recibir solicitudes de oferta para todas las impresiones.
Si no recibes suficientes solicitudes de ofertas en relación con una configuración de segmentación previa determinada, te recomendamos que amplíes tus criterios de segmentación previa.
- Lógica
Los valores de los campos de segmentación de nivel superior se procesan con un OR lógico. Esto significa que puedes recibir solicitudes de ofertas que tengan al menos uno de los valores que especificaste en el campo de nivel superior. Por ejemplo, si la configuración de segmentación previa tiene valores languageCodes (en, de y sv), es posible que recibas solicitudes de ofertas con en, de o sv como el idioma detectado.
Los diferentes campos se procesan con un AND lógico. Solo recibirás solicitudes de ofertas que coincidan con, al menos, un valor en cada campo de segmentación previa que configures. Por ejemplo, si tu configuración tiene los valores languageCodes en, de y sv, y includedPlatforms el valor PERSONAL_COMPUTER, solo recibirás solicitudes de ofertas que tengan el idioma detectado en, de o sv, y el tipo de dispositivo PERSONAL_COMPUTER.
Debido al AND lógico en los campos de segmentación previa, no puedes incluir
criterios contradictorios. Por ejemplo, incluir el mismo valor en includedIds y excludedIds en un criterio NumericTargetingDimensions dará como resultado un error.
- Superposición
Las solicitudes de oferta pueden ser aptas para varios parámetros de configuración de segmentación previa.
Puedes crear hasta 10 configuraciones de segmentación previa para orientar
diferentes tipos de inventario. Los parámetros de configuración de segmentación previa pueden superponerse, por lo que una sola solicitud de oferta podría ser apta para varios parámetros de configuración de segmentación previa. En este caso, el campo billing_id de la solicitud de oferta contiene el billingId de cada configuración aplicable. Si se encuentran varios ID de facturación en la solicitud de oferta, debes especificar el ID de facturación para el que estás ofertando en el campo billing_id de la respuesta a la oferta.
IDs geográficos
No es posible segmentar los anuncios para algunos ID geográficos debido a la política. Por ejemplo, algunas regiones con poblaciones pequeñas no se pueden orientar porque infringirían nuestra Política de Privacidad. Nuestras políticas están sujetas a cambios. Si especificas un ID geográfico en el geoTargeting de tu configuración de segmentación previa que no sea válido más adelante, el ID aparecerá en el campo invalidGeoIds en ese momento. Los ID geográficos con invalidGeoIds no afectan la segmentación. Si un ID goegráfico en invalidGeoIds se vuelve válido, se agrega al campo geoTargeting de la configuración de segmentación previa.
El archivo geo-table.csv enumera los ID geográficos que se pueden orientar y se actualiza periódicamente a medida que se agregan y se quitan los ID.
Recuento de solicitudes de oferta
Debes configurar las QPS máximas para los extremos de tu ofertante y permitir que el sistema de cuota de texto destacado administre el tráfico enviado a tus extremos para cada una de las configuraciones de segmentación previa.
Estos son algunos casos extremos en los que podría ser útil administrar las QPS máximas a nivel de la configuración de segmentación previa con maximumQps:
- Recibir demasiadas solicitudes
- Si el sistema de cuotas de texto destacado envía una cantidad inusualmente alta de solicitudes de oferta a los extremos de ofertantes para una configuración de segmentación previa determinada, puedes usar
maximumQps para ajustar la cantidad de solicitudes de forma manual.
- Prueba una configuración para inventario nuevo
- Si quieres admitir inventario nuevo, como un formato de creatividad nuevo,
puedes implementar una configuración de segmentación previa segmentando solo ese inventario
con un
maximumQps bajo.
En el caso del inventario al que se orientan varios parámetros de configuración de segmentación previa,
las solicitudes de ofertas se envían a los extremos del ofertante, incluido el billingId
para cada configuración, siempre que al menos uno de los parámetros de configuración no haya alcanzado su límite de maximumQps.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[[["\u003cp\u003eUse pretargeting configurations to filter bid requests and receive only relevant impressions, with the ability to create up to 10 configurations.\u003c/p\u003e\n"],["\u003cp\u003ePretargeting criteria use logical \u003ccode\u003eOR\u003c/code\u003e within fields and logical \u003ccode\u003eAND\u003c/code\u003e across fields, allowing for flexible but specific targeting.\u003c/p\u003e\n"],["\u003cp\u003eBid requests can match multiple pretargeting configurations, requiring bidders to specify the desired billing ID in their bid response.\u003c/p\u003e\n"],["\u003cp\u003eSome geographic IDs may be untargetable for policy reasons, and the \u003ccode\u003egeo-table.csv\u003c/code\u003e file provides a list of valid targetable IDs.\u003c/p\u003e\n"],["\u003cp\u003eManage bid request traffic using the Callout Quota System and \u003ccode\u003emaximumQps\u003c/code\u003e for specific pretargeting configurations when necessary.\u003c/p\u003e\n"]]],["Bidders use `pretargetingConfigs` to filter bid requests, receiving only those matching their criteria; up to 10 configurations are allowed. These configurations filter requests using logical `OR` within fields and logical `AND` across fields. Bid requests can match multiple configurations, identified by `billingId` in the request. Geographic targeting may have restrictions and invalid IDs are listed under `invalidGeoIds`. You can set `maximumQps` per configuration to manage traffic volume. At least one configuration is required to receive bid requests.\n"],null,["# Pretargeting configurations\n\nBidders can use the `pretargetingConfigs` resource to receive only bid\nrequests for impressions that match their targeting criteria.You can have up to\n10 pretargeting configurations at once.\n\nEach pretargeting configuration distributes bid requests across all endpoints.\nBid requests aren't always distributed evenly across all endpoints. For example,\na pretargeting configuration for specific geographic IDs in a given region might\nhave fewer matches in [trading\nlocations](/authorized-buyers/rtb/peer-guide#trading-locations) that are farther\nfrom that region. Endpoints near those farther trading locations might receive\nfewer bid requests.\n\nBest practices\n--------------\n\nIn order to receive bid requests, you must create at least one\npretargeting configuration. Here are some tips for managing your pretargeting\nconfigurations:\n\nScope\n\n: Pretargeting is like filtering. You should use pretargeting criteria to filter\n bid requests to those that are relevant to your use case. If you don't set any\n pretargeting criteria, you can receive bid requests for all impressions.\n\n If you aren't receiving enough bid requests related to a given pretargeting\n configuration, you might want to broaden your pretargeting criteria.\n\nLogic\n\n: Values in top-level targeting fields are processed with logical `OR`. This\n means you can receive bid requests that have at least one of the values you\n specify in the top-level field. For example, if your pretargeting\n configuration has `languageCodes` values `en`, `de`, and `sv`, you might receive\n bid requests with `en`, `de`, or `sv` as the detected language.\n\n Different fields are processed with logical `AND`. You only receive bid\n requests that have a match for at least one value in every pretargeting field\n you set. For example, if your configuration has `languageCodes` values `en`,\n `de`, and `sv`, and `includedPlatforms` value `PERSONAL_COMPUTER`, you receive\n only bid requests that have a detected language of `en`, `de`, or `sv` and a\n device type of `PERSONAL_COMPUTER`.\n\n Due to the logical `AND` across pretargeting fields, you can't include\n contradictory criteria. For example, including the same value in `includedIds`\n and `excludedIds` in a `NumericTargetingDimensions` criteria results in an\n error.\n\nOverlap\n\n: Bid requests can be eligible for multiple pretargeting configurations.\n\n You can create up to 10 pretargeting configurations to target different\n kinds of inventory. Pretargeting configurations can overlap, so a single bid\n request might be eligible for multiple pretargeting configurations. In this\n case, the bid request's `billing_id` field contains the `billingId` of\n each applicable configuration. If multiple billing IDs are found in the bid\n request, you must specify which billing ID you're bidding on in the bid\n response's `billing_id` field.\n\nGeographic IDs\n--------------\n\nSome geographic IDs aren't targetable for policy reasons. For example, some\nregions with small populations can't be targeted because it would violate our\nprivacy policy. Our policies are subject to change. If you specify\na geographic ID in your pretargeting configuration's `geoTargeting` that becomes\ninvalid at a later date, the ID appears under the `invalidGeoIds` field at that\ntime. Geographic IDs under `invalidGeoIds` have no impact on targeting. If a\ngoegraphic ID in `invalidGeoIds` becomes valid, it's added to your pretargeting\nconfiguration's `geoTargeting` field.\n\nThe\n[geo-table.csv](//storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv)\nfile lists targetable geographic IDs, and is updated periodically as IDs are\nadded and removed.\n\nBid request count\n-----------------\n\nYou should configure the maximum QPS for your bidder endpoints,\nand allow the [Callout Quota System](/authorized-buyers/rtb/callout-quota-system)\nto manage the traffic sent to your endpoints for each of your pretargeting\nconfigurations.\n\nHere are edge cases where managing maximum QPS at the\npretargeting configuration level with `maximumQps` might be useful:\n\nReceiving too many requests\n: If the Callout Quota System is sending an unusually large number of bid\n requests to bidder endpoints for a given pretargeting configuration, you can\n use `maximumQps` to manually adjust the number of requests.\n\nTesting a configuration for new inventory\n: If you're trying to support new inventory, like a new creative format,\n you can implement a pretargeting configuration targeting only that inventory\n with a low `maximumQps`.\n\nFor inventory that's targeted by multiple pretargeting configurations,\nbid requests are sent to the bidder's endpoints, including the `billingId`\nfor each configuration, as long as at least one of the configurations hasn't\nreached its `maximumQps` limit."]]
