Configurazioni di pretargeting
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Gli offerenti possono utilizzare la risorsa pretargetingConfigs
per ricevere solo richieste di offerta per le impressioni che corrispondono ai loro criteri di targeting.Puoi avere fino a 10 configurazioni di pretargeting contemporaneamente.
Ogni configurazione di pretargeting distribuisce le richieste di offerta su tutti gli endpoint.
Non sempre le richieste di offerta sono distribuite in modo uniforme tra tutti gli endpoint. Ad esempio, una configurazione di pretargeting per ID geografici specifici in una determinata regione potrebbe avere meno corrispondenze in località di scambio più distanti da quella regione. Gli endpoint vicini a queste località di scambio più lontane potrebbero ricevere meno richieste di offerta.
best practice
Per ricevere richieste di offerta, devi creare almeno una configurazione di pretargeting. Ecco alcuni suggerimenti per la gestione delle configurazioni di pretargeting:
- Ambito
Il pretargeting è come usare i filtri. Dovresti utilizzare i criteri di pretargeting per filtrare le richieste di offerta in base a quelle pertinenti al tuo caso d'uso. Se non imposti alcun criterio di pretargeting, puoi ricevere richieste di offerta per tutte le impressioni.
Se non ricevi un numero sufficiente di richieste di offerta relative a una determinata configurazione di pretargeting, ti consigliamo di ampliare i criteri di pretargeting.
- Funzione logica
I valori nei campi di targeting di primo livello vengono elaborati con l'impostazione logica OR
. Ciò significa che puoi ricevere richieste di offerta che contengono almeno uno dei valori da te specificati nel campo di primo livello. Ad esempio, se la configurazione di pretargeting presenta valori languageCodes
en
, de
e sv
, potresti ricevere richieste di offerta con en
, de
o sv
come lingua rilevata.
Campi diversi vengono elaborati con la logica AND
. Ricevi solo richieste di offerta che presentano una corrispondenza per almeno un valore in ogni campo di pretargeting che hai impostato. Ad esempio, se la configurazione presenta i valori languageCodes
en
, de
e sv
e il valore includedPlatforms
PERSONAL_COMPUTER
, ricevi solo richieste di offerta che hanno rilevato una lingua en
, de
o sv
e un tipo di dispositivo PERSONAL_COMPUTER
.
A causa della logica AND
nei campi di pretargeting, non puoi includere criteri contraddittori. Ad esempio, l'inclusione dello stesso valore in includedIds
e excludedIds
in un criterio NumericTargetingDimensions
genera un errore.
- Sovrapposizione
Le richieste di offerta possono essere idonee per più configurazioni di pretargeting.
Puoi creare fino a 10 configurazioni di pretargeting per scegliere come target diversi tipi di inventario. Le configurazioni di pretargeting possono sovrapporsi, pertanto una singola richiesta di offerta potrebbe essere idonea per più configurazioni di pretargeting. In questo caso, il campo billing_id
della richiesta di offerta contiene il valore billingId
di ogni configurazione applicabile. Se nella richiesta di offerta sono presenti più ID fatturazione, devi specificare l'ID fatturazione per cui stai facendo l'offerta nel campo billing_id
della risposta all'offerta.
ID geografici
Per motivi legati alle norme, non è possibile scegliere come target alcuni ID geografici. Ad esempio, alcune
regioni con popolazioni limitate non possono essere scelte come target perché violerebbero le nostre
norme sulla privacy. Le nostre norme sono soggette a modifiche. Se specifichi
un ID geografico nell'geoTargeting
della configurazione di pretargeting che non sarà più valido in un secondo momento, in quel momento l'ID verrà visualizzato
nel campo invalidGeoIds
. Gli ID geografici in invalidGeoIds
non hanno alcun impatto sul targeting. Se un ID
goegrafico in invalidGeoIds
diventa valido, viene aggiunto al campo geoTargeting
della
configurazione di pretargeting.
Il file geo-table.csv elenca gli ID geografici selezionabili come target e viene aggiornato periodicamente man mano che gli ID vengono aggiunti e rimossi.
Conteggio richieste di offerta
Devi configurare il numero massimo di QPS per gli endpoint dello strumento di offerta e consentire al sistema di quote dei callout di gestire il traffico inviato ai tuoi endpoint per ciascuna delle configurazioni di pretargeting.
Ecco alcuni casi limite in cui potrebbe essere utile gestire il QPS massimo a livello di configurazione di pretargeting con maximumQps
:
- Ricezione di troppe richieste
- Se il sistema di quote dei callout invia un numero insolitamente elevato di richieste di offerta agli endpoint dello strumento di offerta per una determinata configurazione di pretargeting, puoi utilizzare
maximumQps
per regolare manualmente il numero di richieste.
- Test di una configurazione per un nuovo inventario
- Se stai cercando di supportare un nuovo inventario, come un nuovo formato di creatività,
puoi implementare una configurazione di pretargeting che abbia come target solo quell'inventario
con un valore basso di
maximumQps
.
Per l'inventario scelto come target da più configurazioni di pretargeting, le richieste di offerta vengono inviate agli endpoint dell'offerente, incluso billingId
per ogni configurazione, a condizione che almeno una delle configurazioni non abbia raggiunto il limite di maximumQps
.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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."]]