Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Licytujący mogą korzystać z zasobu pretargetingConfigs, aby otrzymywać pytania o stawkę tylko za wyświetlenia pasujące do ich kryteriów kierowania.Możesz mieć maksymalnie 10 konfiguracji kierowania wstępnego.
Każda konfiguracja kierowania wstępnego rozdziela pytania o stawkę między wszystkie punkty końcowe.
Pytania o stawkę nie zawsze są równomiernie rozkładane na wszystkie punkty końcowe. Na przykład konfiguracja kierowania wstępnego w przypadku określonych identyfikatorów geograficznych w danym regionie może mieć mniej dopasowań w lokalizacjach handlowych znajdujących się dalej od tego regionu. Punkty końcowe znajdujące się w pobliżu bardziej odległych lokalizacji transakcji mogą otrzymywać mniej pytań o stawkę.
Sprawdzone metody
Aby otrzymywać pytania o stawkę, musisz utworzyć co najmniej 1 konfigurację kierowania wstępnego. Oto kilka wskazówek, jak zarządzać konfiguracjami kierowania wstępnego:
Zakres
Kierowanie wstępne działa podobnie do filtrowania. Kryteria kierowania wstępnego pozwalają odfiltrowywać pytania o stawkę tylko do tych, które pasują do Twojego zastosowania. Jeśli nie ustawisz żadnych kryteriów kierowania wstępnego, możesz otrzymywać pytania o stawkę dotyczące wszystkich wyświetleń.
Jeśli nie otrzymujesz wystarczającej liczby pytań o stawkę związanych z daną konfiguracją kierowania wstępnego, możesz poszerzyć kryteria kierowania wstępnego.
Operatory logiczne
Wartości w polach kierowania najwyższego poziomu są przetwarzane przez logiczne OR. Oznacza to, że możesz otrzymywać pytania o stawkę, które mają co najmniej jedną z wartości określonych przez Ciebie w polu najwyższego poziomu. Jeśli np. w konfiguracji kierowania wstępnego masz wartości languageCodesen, de i sv, możesz otrzymywać pytania o stawkę z wykrytym językiem en, de lub sv.
Różne pola są przetwarzane z wartością logiczna AND. Otrzymujesz tylko pytania o stawkę pasujące do co najmniej 1 wartości w każdym ustawionym przez Ciebie polu kierowania wstępnego. Jeśli na przykład Twoja konfiguracja zawiera languageCodes wartości en, de i sv oraz includedPlatforms – PERSONAL_COMPUTER, będziesz otrzymywać tylko pytania o stawkę, w których wykryto język en, de lub sv i typ urządzenia PERSONAL_COMPUTER.
Ze względu na logiczną wartość AND w polach kierowania wstępnego nie możesz uwzględniać sprzecznych kryteriów. Na przykład wstawienie tej samej wartości w kryterium includedIds i excludedIds w kryterium NumericTargetingDimensions spowoduje błąd.
Pokrywający się zasięg
Pytania o stawkę mogą być uwzględniane w wielu konfiguracjach kierowania wstępnego.
Możesz utworzyć maksymalnie 10 konfiguracji kierowania wstępnego, aby kierować reklamy na różne rodzaje zasobów reklamowych. Konfiguracje kierowania wstępnego mogą się pokrywać, więc jedno pytanie o stawkę może być odpowiednie dla wielu konfiguracji tego kierowania. W tym przypadku pole billing_id w pytaniu o stawkę zawiera wartość billingId każdej odpowiedniej konfiguracji. Jeśli w pytaniu o stawkę znajduje się wiele identyfikatorów płatności, w polu billing_id w odpowiedzi na stawkę musisz podać identyfikator płatności, dla którego ustalasz stawkę.
Identyfikatory geograficzne
Ze względu na zasady nie można kierować reklam na niektóre identyfikatory geograficzne. Na przykład na niektóre regiony o małej populacji nie można kierować reklam, ponieważ naruszałoby to naszą politykę prywatności. Nasze zasady mogą ulec zmianie. Jeśli określisz w geoTargeting konfiguracji kierowania wstępnego identyfikator geograficzny, który później stanie się nieprawidłowy, będzie on widoczny w polu invalidGeoIds. Identyfikatory geograficzne w polu invalidGeoIds nie mają wpływu na kierowanie. Jeśli identyfikator goegraficzny w invalidGeoIds stanie się prawidłowy, zostanie dodany do pola geoTargeting konfiguracji kierowania wstępnego.
Plik geo-table.csv zawiera listę identyfikatorów geograficznych, na które można kierować reklamy. Jest on okresowo aktualizowany w miarę dodawania i usuwania identyfikatorów.
Liczba pytań o stawkę
Skonfiguruj maksymalną liczbę zapytań na sekundę w punktach końcowych licytującego i zezwól systemowi limitów wywołań na zarządzanie ruchem wysyłanym do punktów końcowych na potrzeby każdej konfiguracji kierowania wstępnego.
Oto skrajne przypadki, w których zarządzanie maksymalną liczbą zapytań na sekundę za pomocą właściwości maximumQps może być przydatne na poziomie konfiguracji kierowania wstępnego:
Otrzymuję zbyt wiele żądań
Jeśli w przypadku danej konfiguracji kierowania wstępnego system limitów objaśnień wysyła wyjątkowo dużą liczbę pytań o stawkę do punktów końcowych licytującego, możesz ręcznie dostosować liczbę tych żądań za pomocą metody maximumQps.
Testowanie konfiguracji nowych zasobów reklamowych
Jeśli chcesz obsługiwać nowe zasoby reklamowe, np. nowy format kreacji, możesz wdrożyć konfigurację kierowania wstępnego, aby kierować reklamy tylko na te zasoby o niskiej wartości maximumQps.
W przypadku zasobów reklamowych, na które kierujesz wiele konfiguracji kierowania wstępnego, pytania o stawkę są wysyłane do punktów końcowych licytującego, w tym do punktu końcowego billingId w przypadku każdej konfiguracji, o ile co najmniej 1 z konfiguracji nie osiągnęła limitu maximumQps.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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."]]
