Kullanıcı Aracısı hedefleme

Kullanıcı Aracısı başlık, öncekinden beri teklif isteklerine dahil ediliyordu. Başlatan cihazın tarayıcısı ve platformu gibi hedefleme verileri. Ancak, Tarayıcılar, kullanım zorluğu nedeniyle Kullanıcı Aracısı'nı çoğu zaman kullanarak kullanıcı gizliliğini daha iyi koruyabilir. Buna yanıt olarak Google, Kullanıcı Aracısı İstemci İpuçları Kullanıcı Aracısı başlığını tamamlamak için uygun olduğunda teklif isteklerine dahil edilir. Bu İstemci İpuçları (kısaca), Sec-Ch-UA* başlıklarından veya JavaScript İstemci İpuçları API'sinden geliştirmeniz gerekir.

Kullanılan protokole bağlı olarak, User-Agent üstbilgisi aşağıdaki dize alanlarını da kullanabilirsiniz:

  • OpenRTB: BidRequest.device.ua
  • Google GZT (Kullanımdan kaldırıldı): BidRequest.user_agent

Ayarlandığında, istemci ipuçları ile UserAgent mesajı doldurulur kullanılabilir ancak veriler, User-Agent üstbilgisi. Kullanılan protokole bağlı olarak, şu alanları doldurun:

  • OpenRTB: BidRequest.device.sua
  • Google GZT (Kullanımdan kaldırıldı): BidRequest.user_agent_data

Teklif verenlerinUserAgent User-Agent dizesi.

UserAgent nasıl doldurulur?

User-Agent üstbilgisinden farklı olarak UserAgent mesajı, kullanıcı aracısını temsil eder. birden çok alana bölünmüş bilgilere karşılık gelir.

Reklam isteğinde İstemci İpuçlarının kullanılabilir olup olmadığına bağlı olarak, UserAgent mesajı aşağıdaki şekillerde doldurulabilir:

  • İstek en az düşük entropi İstemci İpuçları, UserAgent içeriklerine göre doldurulur.
  • İstek yalnızca User-Agent başlığını içeriyorsa UserAgent başlıktan nelerin ayrıştırılabileceğine göre doldurulur.
ziyaret edin.

Örnek: UserAgent alanını User-Agent başlığına göre doldurma

Tarayıcının aşağıdaki başlıkları gönderdiği bir reklam isteği olduğunu varsayalım:

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

Yalnızca User-Agent başlığına göre doldurulan bir UserAgent şöyle görünebilir: şu:

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

Örnek: UserAgent alanını istemci ipuçlarına göre doldurma

Tarayıcının aşağıdaki başlıkları gönderdiği bir reklam isteği olduğunu varsayalım:

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

En az düşük entropili İstemci İpuçlarının eklendiği durumlarda UserAgent kullanıcı aracısı olsa bile bu üstbilgilerin içeriğine göre doldurulur emin olun. Aşağıdaki gibi görünür:

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

Kullanıcı Aracısı başlığına ve İstemci İpuçlarına göre doldurma

Bazı alanlar, çalışma alanına dayalı olarak kullanıcı aracısı başlığı veya istemci ipuçları. Aşağıda bu risklerin farklar:

  • Aynı tarayıcılar ve platformlar için UserAgent.browsers.brand ve UserAgent.platform.brand genellikle bağlı olarak UserAgent arasında farklılık gösterir kullanıcı aracısı başlığı veya istemci ipuçları. Örneğin, UserAgent.platform.brand, Windows NT yerine "Windows NT" olarak görünebilir. Kullanıcı Aracısı üstbilgisini veya İstemci İpuçlarını temel alıyorsa “Windows”u gösterir.
  • Bazı UserAgent.browsers girişleri, User-Agent başlığına veya tekrar deneyin. Örneğin, UserAgent şu durumda "AppleWebKit" görünür: User-Agent üstbilgisine dayalıyken "Chromium" yalnızca değişeceğini unutmayın.
  • Yalnızca User-Agent başlığına dayalı bir UserAgent dondurulmuş değerler içerebilir. Örneğin, platform Windows 11 22H2 ise UserAgent.platform.brand, “Windows NT” ve UserAgent.platform.version, [“10”, “0”] olarak ayarlanır, çünkü bu 10 veya üzerindeki herhangi bir Windows sürümü için dondurulmuş değer.

UserAgent içindeki İstemci İpuçlarına dayalı veriler normalde dondurulmuş veya çıkartılmış bilgilerin yanlış bir şekilde değiştirilmesi. Varsa İstemciye bağlı olarak User-Agent başlığı ile UserAgent arasındaki tutarsızlık İpuçları, UserAgent bilgileri tercih edilmelidir.

UserAgent nesne alanları

Bu bölümde her alan, Google'ın GZT'ye özgü yönlerine odaklanarak özetlenmektedir. en iyi uygulamaları ele alacağız.

Tarayıcılar

Şunları içeren bir liste içerir: BrandVersion sıralanan girişlere veya e-postalara göre, örneğin, browsers içeriğini listelerseniz her giriş için brand görünebilir şu sırada:

Marka Meaning
Mozilla Mozilla uyumlu
AppleWebKit AppleWebKit tabanlıdır ve Mozilla'nın bir alt kümesidir.
Chrome Chrome tarayıcı, AppleWebKit uyumlu tarayıcıların bir alt kümesi
Safari Mobil varyantın aksine masaüstü varyantı.

UserAgent, tarayıcıları her zaman belirli bir sırada listelemez. istemci ipuçlarını temel alıp almadığını öğrenebilir. Aşağıda diğer farklılıklar açıklanmaktadır source değerine göre görmeyi bekleyebileceğiniz sonuçlar aşağıda verilmiştir:

  • USER_AGENT: version alanı ana sürüme indirgenebilir veya donduruldu (aracıya özel politikaya bağlıdır). Herhangi bir değerin dondurulduğunu gösterir.
  • CLIENT_HINTS_LOW_ENTROPY ve CLIENT_HINTS_HIGH_ENTROPY: Girişler: Herhangi bir ölçüte göre sıralanmayan; örneğin, aynı tarayıcı bunları her istekte farklı sırada giriş yapılır. Ayrıca, GREASE girişinde yoksayılmalıdır.
  • CLIENT_HINTS_HIGH_ENTROPY: Tarayıcılarda bulunan version alanının tümü aşağıdaki gibi olabilir tam sürümlere ayarlanmış olmalıdır.

Platform

BrandVersion ilgili bir giriş içerir. Bu, Kullanıcı Aracısı genelinde uyumlu olmayabilir gerekir. Bu nedenle, bazı platformların hedeflenmesi için test gerekebilir. iki ad. Örneğin, Apple'ın Macintosh işletim sistemi Kullanıcı Aracısı başlığında "Macintosh", İstemci İpuçları'nda ise "macOS" gösterilir. Aşağıda, source değeri:

  • USER_AGENT: version alanı ana sürüme indirgenebilir veya donduruldu. Değerin dondurulduğunu belirten bir gösterge olmayacağını unutmayın.
  • CLIENT_HINTS_LOW_ENTROPY: version alanı doldurulmaz.
  • CLIENT_HINTS_HIGH_ENTROPY: version alanı tam değere ayarlanabilir sürümünü değil.

Mobil

Reklam gibi içeriklerin küçük ekranlar için optimize edilmesinin ve/veya Dokunmatik giriş. Bunun her zaman bir cihaz türü göstergesi olmadığını, mobil tarayıcılar, bir "masaüstü sitesi" isteyecek şekilde yapılandırılabilir.

Mimari

Platformun "x86" veya "arm" gibi mimarisini tanımlar.

İstemci İpuçlarına dayalı UserAgent için bunun yalnızca doldurulacağını unutmayın source CLIENT_HINTS_HIGH_ENTROPY olarak ayarlandığında.

Bitlik

Platformun bit miktarını (ör. 32 bit mi yoksa 64 bit mi) olduğunu tanımlar CPU. Alan, hakkında ek bilgi sağlayan bir tam sayı dizesidir mimarisi; örneğin, "x86" mimarisinde bir bitlik değeri “32” veya “64”.

İstemci İpuçlarına dayalı UserAgent için bunun yalnızca doldurulacağını unutmayın source CLIENT_HINTS_HIGH_ENTROPY olarak ayarlandığında.

Model

Cihaz modelini tanımlar. Mobil cihazlar için (dizüstü bilgisayar veya bu alan "Pixel 6 Pro" gibi bir model adıyla doldurulur.

Aşağıda, Google Trendler'e göre source değeri:

  • USER_AGENT
    • Mobil olmayan cihazlar: model alanı genellikle mimarisi ve bitlik değeri [ör. "x64" gibi) kullanır. Bu değer platformlar arası değil, Örneğin, Linux, aynı donanım.
    • Mobil cihazlar: Bu alan mimari ve bitlik metriklerini içermez. Bu değerlerle ilgileniyorsanız UserAgent.architecture ve UserAgent.bitness.
  • CLIENT_HINTS_LOW_ENTROPY: model alanı doldurulmaz.
  • CLIENT_HINTS_HIGH_ENTROPY: model alanı yalnızca şunun için doldurulacaktır: mobil cihazların cihaz modeli. Masaüstü platformlar için değer belirlenmez.

Kaynak

UserAgent öğesini oluşturmak için hangi başlıkların kullanıldığını tanımlar. İstemci İpuçları için Bu ayrıca aşağıdaki iki durumu birbirinden ayırır:

  • CLIENT_HINTS_LOW_ENTROPY: Yalnızca temel İstemci İpuçları kullanılabilir.
  • CLIENT_HINTS_HIGH_ENTROPY: En azından aşağıdakiler dahil olmak üzere İstemci İpuçları kullanılabilir. yüksek entropi olarak sınıflandırılır.