Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Bieter können über die Ressource pretargetingConfigs nur Gebotsanfragen für Impressionen erhalten, die ihren Targeting-Kriterien entsprechen.Sie können bis zu zehn Pre-Targeting-Konfigurationen gleichzeitig einrichten.
Bei jeder Pre-Targeting-Konfiguration werden Gebotsanfragen auf alle Endpunkte verteilt.
Gebotsanfragen werden nicht immer gleichmäßig auf alle Endpunkte verteilt. Beispielsweise kann eine Pre-Targeting-Konfiguration für bestimmte geografische IDs in einer bestimmten Region weniger Übereinstimmungen in Handelsstandorten haben, die weiter von dieser Region entfernt sind. Endpunkte in der Nähe dieser weiter entfernten Media-Einkaufszentralen erhalten möglicherweise weniger Gebotsanfragen.
Best Practices
Um Gebotsanfragen zu erhalten, müssen Sie mindestens eine Pre-Targeting-Konfiguration erstellen. Hier einige Tipps zum Verwalten Ihrer Pre-Targeting-Konfigurationen:
Umfang
Pre-Targeting ist mit Filtern vergleichbar. Sie sollten Pre-Targeting-Kriterien verwenden, um Gebotsanfragen so zu filtern, dass sie für Ihren Anwendungsfall relevant sind. Wenn Sie keine Pre-Targeting-Kriterien festlegen, können Sie Gebotsanfragen für alle Impressionen erhalten.
Wenn Sie mit einer bestimmten Pre-Targeting-Konfiguration nicht genügend Gebotsanfragen erhalten, sollten Sie Ihre Pre-Targeting-Kriterien erweitern.
Logik
Werte in Targeting-Feldern der obersten Ebene werden mit dem logischen Wert OR verarbeitet. Sie können also Gebotsanfragen mit mindestens einem der Werte erhalten, die Sie im Feld auf der obersten Ebene angeben. Wenn Ihre Pre-Targeting-Konfiguration beispielsweise die languageCodes-Werte en, de und sv enthält, erhalten Sie möglicherweise Gebotsanfragen mit der erkannten Sprache en, de oder sv.
Verschiedene Felder werden mit dem logischen AND verarbeitet. Sie erhalten nur Gebotsanfragen, die mit mindestens einem Wert in jedem von Ihnen festgelegten Pre-Targeting-Feld übereinstimmen. Wenn Ihre Konfiguration beispielsweise die languageCodes-Werte en, de und sv sowie den includedPlatforms-Wert PERSONAL_COMPUTER enthält, erhalten Sie nur Gebotsanfragen mit der erkannten Sprache en, de oder sv und dem Gerätetyp PERSONAL_COMPUTER.
Aufgrund des logischen AND in allen Pre-Targeting-Feldern können Sie keine widersprüchlichen Kriterien angeben. Wenn Sie beispielsweise denselben Wert in includedIds und excludedIds in einem NumericTargetingDimensions-Kriterium verwenden, führt dies zu einem Fehler.
Überschneidungen
Gebotsanfragen können für mehrere Pre-Targeting-Konfigurationen infrage kommen.
Sie können bis zu zehn Pre-Targeting-Konfigurationen für verschiedene Arten von Inventar erstellen. Pre-Targeting-Konfigurationen können sich überschneiden, sodass eine einzelne Gebotsanfrage möglicherweise für mehrere Pre-Targeting-Konfigurationen infrage kommt. In diesem Fall enthält das Feld billing_id der Gebotsanfrage den billingId jeder anwendbaren Konfiguration. Werden in der Gebotsanfrage mehrere Abrechnungs-IDs gefunden, müssen Sie im Feld billing_id der Gebotsantwort angeben, auf welche Abrechnungs-ID Sie bieten.
Geografische IDs
Für einige geografische IDs ist aufgrund von Richtlinienverstößen keine Ausrichtung möglich. Beispielsweise können einige Regionen mit einer kleinen Bevölkerungsgruppe nicht gezielt angesprochen werden, da dies gegen unsere Datenschutzerklärung verstoßen würde. Unsere Richtlinien können sich ändern. Wenn Sie im geoTargeting Ihrer Pre-Targeting-Konfiguration eine geografische ID angeben, die später ungültig wird, wird die ID zu diesem Zeitpunkt im Feld invalidGeoIds angezeigt. Geografische IDs unter invalidGeoIds haben keinen Einfluss auf das Targeting. Wenn eine goegraphische ID in invalidGeoIds gültig wird, wird sie dem Feld geoTargeting der Pre-Targeting-Konfiguration hinzugefügt.
Die Datei geo-table.csv enthält eine Liste geografischer IDs, die für das Targeting verwendet werden können. Sie wird regelmäßig aktualisiert, wenn IDs hinzugefügt oder entfernt werden.
Anzahl der Gebotsanfragen
Sie sollten die maximale Anzahl von Abfragen pro Sekunde für Ihre Bieterendpunkte konfigurieren und zulassen, dass das Callout-Kontingentsystem den an Ihre Endpunkte gesendeten Traffic für jede Ihrer Pre-Targeting-Konfigurationen verwaltet.
In den folgenden Grenzfällen kann es nützlich sein, die maximalen Abfragen pro Sekunde auf der Ebene der Pre-Targeting-Konfiguration mit maximumQps zu verwalten:
Zu viele Anfragen erhalten
Wenn das Callout-Kontingentsystem für eine bestimmte Pre-Targeting-Konfiguration ungewöhnlich viele Gebotsanfragen an Bieterendpunkte sendet, können Sie die Anzahl der Anfragen mit maximumQps manuell anpassen.
Konfiguration für neues Inventar testen
Wenn Sie neues Inventar unterstützen möchten, z. B. ein neues Creative-Format, können Sie eine Pre-Targeting-Konfiguration implementieren, die nur auf dieses Inventar mit einem niedrigen Wert für maximumQps ausgerichtet ist.
Bei Inventar, auf das mehrere Pre-Targeting-Konfigurationen ausgerichtet sind, werden Gebotsanfragen an die Endpunkte des Bieters gesendet, einschließlich billingId für jede Konfiguration, sofern mindestens eine der Konfigurationen das Limit für maximumQps nicht erreicht hat.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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."]]
