Kierowanie na klienta użytkownika

Klient użytkownika był wcześniej uwzględniany w pytaniach o stawkę, by zapewnić dane kierowania, np. przeglądarkę i platformę urządzenia inicjującego. Pamiętaj jednak: często usuwają klienta użytkownika ze względu na trudność w obsłudze aby lepiej chronić prywatność użytkowników. W związku z tym Google obsługuje User-Agent Client Hints, czyli są uwzględniane w pytaniach o stawkę, jeśli są dostępne jako uzupełnienie nagłówka User-Agent. Wskazówki te można pozyskać z nagłówków Sec-Ch-UA* lub za pomocą interfejsu JavaScript Client Hints API.

W zależności od używanego protokołu nagłówek User-Agent jest ujawniany z jednym z następujące pola ciągu:

  • OpenRTB: BidRequest.device.ua
  • RTB Google (wycofane): BidRequest.user_agent

W wiadomości UserAgent pojawią się wskazówki klienta, gdy dostępny, ale w innym przypadku zostanie uzupełniony na podstawie wartości przeanalizowanych z Nagłówek klienta użytkownika. W zależności od użytego protokołu będzie ona widoczna jako jeden tych pól:

  • OpenRTB: BidRequest.device.sua
  • RTB Google (wycofane): BidRequest.user_agent_data

Zdecydowanie zalecamy licytujących, aby używali wiadomości UserAgent zamiast Ciąg znaków klienta użytkownika.

Jak wypełniane są pola UserAgent

W przeciwieństwie do nagłówka User-Agent komunikat UserAgent reprezentuje klienta użytkownika podzielone na różne pola, w których można znaleźć konkretne dane.

Zależnie od tego, czy w żądaniu reklamy dostępne są wskazówki klienta, Wiadomość UserAgent można wypełnić na te sposoby:

  • Jeśli żądanie zawiera co najmniej niska entropia Wskazówki klienta, pole UserAgent jest wypełniane na podstawie ich zawartości.
  • Jeśli żądanie zawiera tylko nagłówek User-Agent, UserAgent to jest wypełniane na podstawie tego, co można przeanalizować z nagłówka.
.

Przykład: wypełnianie pola UserAgent na podstawie nagłówka User-Agent

Załóżmy, że mamy do czynienia z żądaniem reklamy, w którym przeglądarka wysyła te nagłówki:

User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)
            AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36

Pole UserAgent wypełniane wyłącznie na podstawie nagłówka User-Agent może wyglądać tak następujące:

browsers: [{ brand: "Mozilla", version: ["5", "0"] },
           { brand: "AppleWebKit", version: ["537", "36"] },
           { brand: "Chrome", version: ["103", "0", "0", "0"] },
           { brand: "Safari", version: ["537", "36"] }],
platform: { brand: "Windows NT", version: ["10", "0"] },
mobile: false,
architecture: "x86",
bitness: "64",
model: "x64",
source: USER_AGENT_STRING

Przykład: wypełnianie pola UserAgent na podstawie wskazówek klienta

Załóżmy, że mamy do czynienia z żądaniem reklamy, w którym przeglądarka wysyła te nagłówki:

User-Agent:                 Mozilla/5.0 (Windows NT 10.0; Win64; x64)
                            AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36
Sec-Ch-Ua:                  ".Not/A)Brand";v="99", "Google Chrome";v="103", "Chromium";v="103"
Sec-Ch-Ua-Arch:             x86
Sec-Ch-Ua-Full-Version:     103.0.5060.134
Sec-Ch-Ua-Mobile:           ?0
Sec-Ch-Ua-Platform:         Windows
Sec-Ch-Ua-Platform-Version: 15.0.0

W przypadkach, gdy uwzględnione są co najmniej wskazówki klienta o niskiej entropii, UserAgent zostanie wypełniony na podstawie zawartości tych nagłówków, nawet jeśli parametr User-Agent nagłówki. Wygląda to tak:

browsers: [{ brand: ".Not/A)Brand", version: ["99", "0", "0", "0"] },
           { brand: "Google Chrome", version: ["103", "0", "5060", "134"] },
           { brand: "Chromium", version: ["103", "0", "5060", "134"] }],
platform: { brand: "Windows", version: ["15", "0", "0"] },
mobile: false,
architecture: "x86",
bitness: "64",
source: CLIENT_HINTS_HIGH_ENTROPY

Wypełnianie na podstawie nagłówka User-Agent a wskazówki dotyczące klienta

Niektóre pola są wypełniane w różny sposób w zależności od tego, czy dane nagłówek User-Agent lub wskazówki dotyczące klienta. Poniżej znajduje się ich podsumowanie. różnice:

  • W przypadku identycznych przeglądarek i platform parametry UserAgent.browsers.brand oraz Wartość UserAgent.platform.brand często różni się między UserAgent ze względu na nagłówek User-Agent lub wskazówki dotyczące klienta. Przykład: Plik UserAgent.platform.brand może być oznaczony jako „Windows NT”, jeśli został oparty na nagłówek User-Agent lub „Windows”, jeśli bazuje na wskazówek dotyczących klienta.
  • Niektóre wpisy UserAgent.browsers są unikalne dla nagłówka User-Agent lub do wskazówek klienta. Na przykład „AppleWebKit” pojawi się, jeśli UserAgent opierała się na nagłówku User-Agent, natomiast hasło „Chromium” pojawiało się tylko (jeśli opiera się na podpowiedziach klienta).
  • Blokowane wartości może zawierać tylko nagłówek UserAgent utworzony na podstawie nagłówka User-Agent. Jeśli na przykład platformą był Windows 11 22H2, UserAgent.platform.brand zostanie ustawiony na „Windows NT” i Wartość UserAgent.platform.version zostałaby ustawiona na [“10”, “0”], ponieważ zablokowanej wartości w przypadku dowolnej wersji systemu Windows równej 10 lub nowszej.

Dane w UserAgent, które opierają się na podpowiedziach klienta, nie będą zazwyczaj niedokładnego zastąpienia zamrożonych lub pominiętych informacji. Jeśli są niespójność między nagłówkiem User-Agent a UserAgent na podstawie klienta Preferowane są informacje z UserAgent.

Pola obiektu UserAgent

W tej sekcji podsumowujemy wszystkie pola, koncentrując się na kwestiach związanych z określaniem stawek w czasie rzeczywistym (RTB) w Google i sprawdzone metody użytkowania.

Przeglądarki

Zawiera listę BrandVersion są zwykle uporządkowane według szczegółowości – na przykład jeśli chcesz wyświetli się zawartość browsers, może pojawić się brand dla każdego wpisu w tej kolejności:

marka; Znaczenie
Mozilla Zgodność z systemem Mozilla
AppleWebKit Oparta na AppleWebKit, podzbiór Mozilli.
Chrome Przeglądarka Chrome, podzbiór przeglądarek zgodnych z AppleWebKit
Safari wersji na komputery, a nie na urządzenia mobilne;

UserAgent nie zawsze wyświetla przeglądarki w określonej kolejności, zwłaszcza o ile bazuje na podpowiedziach klienta. Poniżej opisujemy inne różnice. których możesz się spodziewać, bazując na wartości source:

  • USER_AGENT: pole version można zmniejszyć do wersji głównej lub zablokowane (zależy od zasad dla danego agenta). Zwróć uwagę, że nie będzie wskazuje, że wartość jest zablokowana.
  • CLIENT_HINTS_LOW_ENTROPY i CLIENT_HINTS_HIGH_ENTROPY: wpisy są nieuporządkowane według żadnych kryteriów; na przykład ta sama przeglądarka może wysyłać te wpisy w różnej kolejności w każdym żądaniu. Mogą one też zawierać wpis GREASE, który należy zignorować.
  • CLIENT_HINTS_HIGH_ENTROPY: wszystkie pola version znalezione w przeglądarkach mogą być ustawione na pełne wersje.

Platforma

BrandVersion wpis opisujący platformę. Może ona nie być zgodna z klientem użytkownika nagłówka i wskazówek dla klienta, dlatego kierowanie reklam na niektóre platformy może wymagać dwie nazwy. Na przykład system operacyjny Apple Macintosh jest oznaczony jako „Macintosh” w nagłówku User-Agent i „macOS” w sekcji Wskazówki dotyczące klienta. Poniżej opisujemy inne różnice, których możesz się spodziewać w przypadku wartość source:

  • USER_AGENT: pole version można zmniejszyć do wersji głównej lub zablokowany. Zwróć uwagę, że nie oznacza to, że wartość jest zablokowana.
  • CLIENT_HINTS_LOW_ENTROPY: pole version nie zostanie wypełnione.
  • CLIENT_HINTS_HIGH_ENTROPY: pole version może zawierać pełne wersji.

Urządzenia mobilne

Wskazuje, czy treści takie jak reklamy powinny być zoptymalizowane pod kątem małych ekranów lub dotykowe wprowadzanie danych. Pamiętaj, że nie musi to być typ urządzenia, przeglądarki mobilne można skonfigurować tak, aby żądały „strony na komputery”.

Architektura

Identyfikuje architekturę platformy, np. „x86” lub „arm”.

W przypadku kategorii UserAgent wykorzystujących wskazówki klienta ta wartość zostanie wypełniona tylko gdy source ma wartość CLIENT_HINTS_HIGH_ENTROPY.

Szybkość

Określa, czy platforma jest 32- czy 64-bitowa. CPU. Pole to ciąg liczby całkowitej zawierający dodatkowe informacje na temat: jego architekturę, Na przykład architektura „x86” może mieć bitę „32” lub „64”.

W przypadku kategorii UserAgent wykorzystujących wskazówki klienta ta wartość zostanie wypełniona tylko gdy source ma wartość CLIENT_HINTS_HIGH_ENTROPY.

Model

Identyfikuje model urządzenia. w przypadku urządzeń mobilnych, czyli nie laptopów ani komputerów – pojawi się nazwa modelu, np. „Pixel 6 Pro”.

Poniżej opisujemy różnice, których możesz się spodziewać w przypadku wartość source:

  • USER_AGENT
    • Urządzenia inne niż mobilne: pole model często zawiera kombinację architektury i wartości bitów, np. „x64” w przypadku systemu Windows. Ta wartość to nie działają na wielu platformach; Linux może na przykład użyć „x86_64” dla tej samej sprzęt.
    • Urządzenia mobilne: to pole nie obejmuje architektury ani jakości bitów. Jeśli interesują Cię te wartości, zobacz UserAgent.architecture i UserAgent.bitness
  • CLIENT_HINTS_LOW_ENTROPY: pole model nie zostanie wypełnione.
  • CLIENT_HINTS_HIGH_ENTROPY: pole model będzie wypełnione tylko w przypadku model urządzeń mobilnych. Nie ustawiono wartości dla platform komputerowych.

Źródło

Określa, które nagłówki zostały użyte do utworzenia elementu UserAgent. Wskazówki dla klienta to również rozróżnia 2 następujące przypadki:

  • CLIENT_HINTS_LOW_ENTROPY: dostępne są tylko podstawowe wskazówki dla klienta.
  • CLIENT_HINTS_HIGH_ENTROPY: dostępne są wskazówki klienta, w tym przynajmniej jedno pole sklasyfikowane jako o wysokiej entropii.