Çerez Eşleştirme

Çerez Eşleştirme, çerezinizi (ör. web sitenizde gezinen bir kullanıcının kimliği) ilgili teklif verene özel Google kullanıcı kimliğiyle eşleştirmenize ve daha etkili teklif verme seçimleri yapmanıza yardımcı olabilecek kullanıcı listeleri oluşturmanıza olanak tanıyan bir özelliktir. Bu kılavuzda, Çerez Eşleştirme'de kullanılan kavramlar, farklı Çerez Eşleştirme iş akışları ve belirli kullanım alanları için bu iş akışlarında bulunabilecek tüm varyasyonlar açıklanmaktadır.

Kavramlar

Alan sahipleri genellikle sitelerine göz atan kullanıcılar için çerez içeriklerini ayarlar. Bu çerezler, ilgili alan adındaki kullanıcıları tanımlamak için kullanılır. İki alan adı sahibi bu verileri paylaşmayı kabul etse bile internet tarayıcıların güvenlik modeli, bir alan adının başka bir alan adı tarafından ayarlanan çerezlerini okumasını kısıtlar.

Google, dijital reklamcılık bağlamında kullanıcıları doubleclick.net alanına ait çerezlerle tanımlar. Gerçek Zamanlı Teklif Verme'ye katılan teklif verenler, reklam göstermek istedikleri kullanıcı grubunu tanımladıkları kendi alanlarına sahip olabilir. Çerez Eşleştirme, teklif verenin çerezlerini Google'ın çerezleriyle eşleştirmesini sağlar. Böylece, teklif isteğinde gönderilen bir gösterimin hedeflenen kullanıcılardan biriyle ilişkili olup olmadığını belirleyebilirler. Teklif veren, kendi çerez verilerini veya teklif isteklerindeki doubleclick.net çerezinin şifrelenmiş bir biçimi olan teklif verene özel bir Google kullanıcı kimliği alır.

Bu kılavuzda açıklanan çerez eşleştirme hizmeti, teklif verenin çerezi ile Google User-ID arasındaki ilişkilendirmenin oluşturulmasını ve sürdürülmesini kolaylaştırır ve kullanıcı listelerinin doldurulmasına da olanak tanır.

Eşleşme tabloları

Eşleşme tabloları, bir alandaki kimliği veya diğer verileri başka bir alanla eşlemek için kullanılabilir. Teklif verenler, belirli bir kullanıcıya ait çerezlerini kullanıcının Google kullanıcı kimliğiyle eşleyerek kendi eşleme tablolarını doldurmak veya Google tarafından barındırılan bir eşleme tablosunu doldurmak için Çerez Eşleme Hizmeti'ni kullanabilir. Eşleşme tabloları, teklif verenin teklif veren uygulamasının gösterim gösterilen kullanıcının çerez verilerine erişmesi için gereklidir.

Google tarafından barındırılan eşleşme tabloları

Daha kolay bakım, gecikme süresi iyileştirmeleri ve belirli bölgelerdeki kullanıcılar için eşleşme verilerine erişim için Google'ın eşleşme tablonuzu barındırmasına izin vermeniz önerilir. Bu sayede, belirli bir kullanıcının Google kullanıcı kimliğiyle eşlenecek bir web için güvenli Base64 ile kodlanmış dize (bundan sonra barındırılan eşleşme verileri olarak anılacaktır) belirtebilirsiniz. Eşleşmeler oluşturulduktan sonra aşağıdaki şekillerde kullanılabilir:

  • Gerçek Zamanlı Teklif Verme: Kullanıcıyla ilişkili gösterimler için sonraki teklif isteklerinde Google, Google kullanıcı kimliğiyle eşleştirdiğiniz barındırılan eşleşme verilerini size gönderir. Google'ın OpenRTB uygulamasında, BidRequest.user.buyeruid bunu web güvenli base64 kodlamalı bir dize olarak belirtir. Teklif verme uç noktanız desteği sonlandırılan Google RTB protokolünü kullanacak şekilde yapılandırılmışsa bunu BidRequest.hosted_match_data alanı üzerinden kod çözülmüş baytlar olarak alırsınız.

  • Kullanıcı Listeleri: Kullanıcı listeleri Google kullanıcı kimlikleriyle veya barındırılan eşleşme verileriyle doldurulabilir.

  • Ön hedefleme: Ön hedeflemenizi, yalnızca barındırılan eşleşme verileri içeren teklif istekleri almanız Bu, çerez alanınızın dışındaki kullanıcılar için daha az alakalı gösterimleri ortadan kaldırmak amacıyla kullanılabilir.

Kullanıcı listeleri

Kullanıcı listeleri Gerçek Zamanlı Teklif Verme API ile oluşturulabilir ve yönetilebilir. Oluşturulan bu listeleri, aşağıda açıklanan çerez eşleştirme iş akışlarıyla veya Toplu Yükleyici Hizmeti aracılığıyla doldurabilirsiniz.

Başlarken

Çerez eşleştirmeyi kullanmaya başlamak için teknik hesap yöneticinizle iletişime geçmeniz gerekir. Teknik hesap yöneticiniz belirli iş akışlarını etkinleştirebilir ve aşağıdakileri yapılandırmanıza yardımcı olabilir:

  • Çerez Eşleme Ağ Kimliği (NID): Çerez Eşleme ve ilgili diğer işlemler için teklif veren hesabını benzersiz şekilde tanımlayan dize kimliği.
  • Çerez Eşleme URL'si: Çerez Eşleme iş akışlarının parçası olarak gelen istekleri kabul edecek ve işleyecek uç noktanın temel URL'sidir. Teklif verenler, Çerez Eşleme iş akışlarında bu URL'ye iletilen parametrelerin sırasını kontrol etmek için bu URL'ye makro yerleştirebilir.
  • Eşleşme Etiketi: Teklif veren tarafından başlatılan çerez eşleştirme iş akışı için kullanıcının tarayıcısından yerleştirmeniz gereken etiket. Bu öğe, reklamlarla birlikte yayınlanabilir veya reklamların dışındaki web mülklerine yerleştirilebilir.
  • Çerez Eşleme Raporu URL'si (isteğe bağlı): Tek yönlü çerez eşleme iş akışında, bu URL, bir HTTP 302 yönlendirmesi aracılığıyla çerez eşlemesinin başarısız olması durumunda hata ayrıntılarını alacak bir uç nokta belirtmek için sağlanabilen isteğe bağlı bir URL'dir. Varsayılan olarak, yanıtlar yalnızca çerez eşleştirme işleminde hata varsa bu URL'ye gönderilir ancak teklif verenler, yönlendirmenin her zaman gönderilmesini isteyebilir.
  • Çerez Eşleştirme Yardımı URL'si: Çerez Eşleştirme Yardımı iş akışını uygulayan exchange'ler için bu, gelen isteklere yanıt vermek üzere tasarlanmış uç noktanın temel URL'sidir.
  • Çerez Eşleştirme Desteği Kotası: Çerez Eşleştirme Desteği iş akışını uygulayan exchange'ler için bu, Çerez Eşleştirme URL'lerinin her saniye alabileceği maksimum istek sayısıdır. Bu, CMA isteklerinin exchange'in sunucularını isteklerle aşırı yüklemesini önlemek için tasarlanmıştır.

Desteklenen çerez eşleme iş akışlarının herhangi birinde, teklif verenin çerez eşleme URL'sine genellikle garanti edilmeyen bir sıralamada parametreler eklenir. Parametrelerin tutarlı bir şekilde sıralanmasını gerektiren entegrasyonlara sahip olan teklif verenler, yerleşimlerini garanti etmek için Çerez Eşleştirme URL'lerine makro yerleştirebilir.

Desteklenen makrolar

Teklif verenler, isteğe bağlı olarak Çerez Eşleştirme URL'lerini %%GOOGLE_<PARAM_NAME>%% veya %%GOOGLE_<PARAM_NAME>_PAIR%% şeklinde bir veya daha fazla makro içerecek şekilde yapılandırabilir. Desteklenen makrolar ve genişletilmiş değerleri şunlardır:

Makro Genişletilmiş değer
GOOGLE_GID GOOGLE_USER_ID
GOOGLE_GID_PAIR &google_gid=GOOGLE_USER_ID
GOOGLE_CVER COOKIE_VERSION_NUMBER
GOOGLE_CVER_PAIR &cver=COOKIE_VERSION_NUMBER
GOOGLE_ERROR ERROR_ID
GOOGLE_ERROR_PAIR &google_error=ERROR_ID
GOOGLE_PUSH PIXEL_MATCH_DATA
GOOGLE_PUSH_PAIR &google_push=PIXEL_MATCH_DATA
GOOGLE_ALL_PARAMS google_gid=GOOGLE_USER_ID&cver=COOKIE_VERSION_NUMBER&google_error=ERROR_ID

Makro örneği

Bir teklif verenin, https://user.bidder.com/cookies adresinde barındırılan bir uç noktayla çerez eşleştirme entegrasyonu vardır ve bu entegrasyonun uygulanması için Pixel Eşleştirme parametrelerine ek olarak aşağıdaki sırayla teklif veren tarafından önceden tanımlanmış parametreler gerekir: google_push, google_gid, google_cver ve google_error. Teklif veren, Çerez Eşleme URL'sini şu şekilde ayarlayarak bunu yapabilir:

https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%

Google daha sonra bu teklif verene bir eşleşme isteği gönderdiğinde, bu istek aşağıdaki gibi genişletilir:

https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3

Google'ın Çerez Eşleştirme Hizmeti şu anda aşağıda açıklanan farklı kullanım alanları için üç iş akışını desteklemektedir.

İki yönlü çerez eşleştirme, teklif verenin kullanıcının tarayıcısına Google'a yönlendiren bir eşleşme etiketi yerleştirdiği, teklif veren tarafından başlatılan bir iş akışını ifade eder. Bu iş akışı, hem Google'ın hem de teklif verenin eşleşme tablolarını doldurmasına olanak tanır. Aşağıda bu iş akışının basit bir örneği verilmiştir.

1. adım: Eşleşme etiketini yerleştirin

Bu akışı başlatmak için teklif verenin eşleşme etiketini kullanıcının tarayıcısında oluşturulacak şekilde yerleştirmesi gerekir. Teklif verene yalnızca Google kullanıcı kimliğini döndüren basit bir eşleşme etiketi aşağıdaki gibi yapılandırılabilir:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />

Farklı kullanım alanlarını karşılamak için eşleşme etiketine ekleyebileceğiniz ek parametreler vardır. Bu parametreler hakkında daha fazla bilgi edinmek için Eşleme Etiketi URL Parametreleri başlıklı makaleyi inceleyin.

2. Adım: Google, eşleşme verilerini içeren yönlendirmeyle yanıt verir

Eşleşme etiketi, Google'ın Çerez Eşleştirme Hizmeti'nin kullanıcının tarayıcısından istek almasına neden olur. Bu istek, teklif verenin Çerez Eşleştirme URL'sine HTTP 302yönlendirme gönderir. Yönlendirme, URL'de Google kullanıcı kimliğini ve sürüm numarasını belirten sorgu parametreleri içerir. Teklif veren, çerezini de istek üstbilgilerine dahil edilmiş olarak alır. Pratikte, https://ad.network.com/pixel olarak belirtilen bir çerez eşleme URL'si için yukarıda gösterilen basit eşleme etiketinin yönlendirme URL'si aşağıdaki gibi görünebilir:

https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1

google_gid parametresi aracılığıyla iletilen Google kullanıcı kimliği, doldurulmamış, web için güvenli bir base64 kodlu dizedir. Eşleşme tablosu barındırmayı seçen teklif verenlerin, Çerez Eşleştirme Hizmeti tarafından döndürülen tam dizeyi depolamaları önerilir. Sonraki teklif isteklerinde bu, OpenRTB'de BidRequest.user.id aracılığıyla veya desteği sonlandırılan Google GZT protokolünde BidRequest.google_user_id aracılığıyla belirtilen değerlere karşılık gelir.

google_cver içinde belirtilen sürüm, Google kullanıcı kimliğinin sayısal sürüm numarasını gösterir. Belirli bir kullanıcının Google kullanıcı kimliği nadiren değişir ve ardından artar.

Google, eşleşme isteğinizi işlerken bir hatayla karşılaşırsa bunun yerine bir google_error parametresi belirtilir.

3. adım: Teklif veren, yönlendirmeyi işler ve piksel ile yanıt verir

Teklif veren, ilk adımda belirttiği parametreleri ve Google'ın ikinci adımda sağladığı parametreleri içeren çerez eşleştirme URL'sine yönlendirilir. Ayrıca, HTTP başlıklarında çerezlerini de alırlar. İşlem başarılı olduysa kendi eşleşme tablosunu barındıran bir teklif veren, çerezini yanıtta yer alan Google kullanıcı kimliğiyle eşleştirebilir. Teklif verenler, Çerez Eşleştirme Hizmeti tarafından döndürülen tam dizeyi saklamalıdır.

İşlem başarısız olursa teklif veren, yönlendirmede bir google_error parametresi alır. Bu, gerçekleşen hatayı tanımlayan farklı hata durumlarına karşılık gelen bir sayısal değerdir. Olası hata değerleri hakkında daha fazla bilgiyi buradan edinebilirsiniz. Hata alırsanız yeni bir eşleşme etiketi ekleyerek bu kullanıcı için eşleşmeyi tekrar deneyebilirsiniz.

Teklif veren her zaman 1x1 görünmez piksel resmi yayınlayarak yanıt vermelidir veya alternatif olarak HTTP 204 İçerik Yok yanıtı döndürmelidir.

Bu iş akışı, isteklerin ve yanıtların bir okla gösterildiği ve bunlara eşlik eden veri öğelerinin parantez içinde listelendiği aşağıdaki şemada gösterilmektedir.

Eşleme Etiketi URL Parametreleri

Parametre Açıklama
google_nid Teklif veren hesabın ağ kimliği (NID). Bu kimlik, Teklif Verenler kaynağı aracılığıyla alınabilir.
google_cm Google'ın Çerez Eşleştirme Hizmeti'ne çerez eşleştirme yapması gerektiğini belirtir. Parametrenin değeri yoksayılır ve atlanabilir.
google_sc Bu parametre kullanımdan kaldırılmıştır. Kullanıcı için Google çerezini belirler (mevcutsa). Parametrenin değeri yoksayılır ve atlanabilir. Çerez yoksa parametrenin atlanması hatayla sonuçlanır.
google_no_sc Bu parametre kullanımdan kaldırılmıştır. Bu, Google'ın Çerez Eşleştirme Hizmeti'ne, mevcut bir çerez yoksa kullanıcı için çerez ayarlamamasını belirtir. Parametrenin değeri yoksayılır ve atlanabilir.
google_hm

Teklif verenin Google tarafından barındırılan bir eşleşme tablosunda depolamak istediği veriler.

Değer, web'de güvenli base64 kodlu bir dizedir (dolgu isteğe bağlıdır). Ham veriler 40 bayt veya daha kısa olmalıdır. Örneğin, Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u.

google_redir Google'ın HTTP 302 yönlendirmesini bu eşleşme etiketi için kodlanmış URL'ye göndermesini isteyen bir teklif verenin belirtebileceği URL kodlamalı bir dize. Bu, Google'ın iş ortaklarına zincirlenmiş bir çağrıda öne yerleştirilmesine olanak tanır. google_hm olmadan veya google_cm ile belirtilirse bu durum hatayla sonuçlanır.
google_ula Kullanıcıyı mevcut bir kullanıcı listesine eklemek için kullanılan bir dize. Değerin beklenen biçimi userlistid[,timestamp] olmalıdır:
  • userlistid: Tek bir sayısal kullanıcı listesi kimliği.
  • timestamp: POSIX biçiminde isteğe bağlı bir zaman damgası. Kullanıcının kullanıcı listesine ne zaman eklendiğini gösterir.

Bu URL parametresi, kullanıcıyı birden fazla listeye eklemek için tekrarlanabilir.
gdpr İsteğin, veri kullanımıyla ilgili GDPR kısıtlamalarına tabi olduğunu gösterir. Daha fazla bilgi için aşağıdaki AB kullanıcı rızası koşulları bölümüne veya Authorized Buyers IAB TCF v2.0 dokümanlarında Çerez eşleşme uygunluğunun etkilenmesi başlıklı makaleye bakın.

Örnek: gdpr=1
gdpr_consent Son kullanıcı iznini temsil eden bir TC dizesi. Daha fazla bilgi için aşağıdaki AB kullanıcı rızası koşulları bölümüne veya Authorized Buyers IAB TCF v2.0 belgelerindeki TC dizesi nasıl iletilir? başlıklı makaleye bakın.
process_consent Teklif verenin, Google'ın AB Kullanıcı Rızası Politikası'nda belirtilen veri kullanımları için son kullanıcı izni aldığını gösterir.

İstek AB Kullanıcı Rızası Politikası'na tabi değilse veya istekte başka izin parametreleri varsa (gdpr_consent) bu parametre yoksayılır.

Örnek: process_consent=T

Teklif verenler, yukarıdaki parametrelere ek olarak kendi parametrelerini de belirtebilir. Bu parametreler, yönlendirme URL'sine parametre olarak eklenir. google_ ön ekiyle adlandırılan, teklif veren tarafından tanımlanan parametrelerin Google tarafından gelecekteki geliştirmeler için ayrılmış olması ve parametrelerin sıralamasının korunmasının garanti edilmemesi nedeniyle dikkate alınmayacağını unutmayın. Teklif veren tarafından tanımlanan parametreleri içeren bir eşleme etiketi şu şekilde görünebilir:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />

Yönlendirme URL Parametreleri

Yönlendirme URL'si, teklif verenin hesabı için yapılandırılmış temel Çerez Eşleştirme URL'sinden oluşturulur. Bu URL'de, eşleşme etiketinde belirtilenlere bağlı olarak google_ ve teklif veren tarafından tanımlanan parametreler yer alır. Aşağıdaki google_ yanıt parametreleri tanımlanır:

Parametre Açıklama
google_gid Google kullanıcı kimliği. İstekte google_cm belirtilmişse ve istek başarılıysa ayarlanır.
google_cver Çerez sürümü. İstekte google_cm belirtilmişse ve istek başarılıysa ayarlanır.
google_error

Genel istek hatasını belirten bir tam sayı değeri. Alındığında, hiçbir işlem yapılmadığını ve başka google_ yanıt parametresinin ayarlanmayacağını gösterir. Desteklenen hata değerleri şunlardır:

  • 1: Kullanıcının Google çerezi vardır ancak bu çerez kullanılarak yapılan izlemeyi devre dışı bırakmıştır.
  • 2: Geçerli işlem belirtilmedi. Örneğin, işlemsiz bir istek alındı.
  • 3: Kullanıcının Google çerezi yok. Google, çerezi Çerez Eşleme Hizmeti üzerinden ayarlamaz.
  • 4: Çakışan işlemler belirtildi. Çakışık amaçları olduğundan aynı istekte hem google_push hem de google_cm işaretlerini belirtmenize izin verilmez.
  • 5: İki yönlü piksel eşleştirme isteğinin bir parçası olarak, bir Google sunucusuna yönlendirmede geçersiz bir google_push parametresi iletildi. Yönlendirmeniz, google_push değerini ilk piksel isteğinde size iletilen değere ayarlamalıdır.
  • 6: Eşleme etiketinde geçersiz bir NID sağlandı.
  • 7: Geçersiz bir çerez algılandı.
  • 8: Kullanımdan kaldırıldı. Çerez bulunamadı.
  • 9: Çerez bulunamadı, test çerezi ayarlamaya çalışılır.
  • 10: google_redir parametresi, google_hm belirtilmeden veya google_cm'a ek olarak kullanıldı.
  • 15: İstek, eşleşme tablosunun Google tarafından barındırılmasının Google tarafından zorunlu kılındığı bir bölgeden geliyor. Bu nedenle, bu yanıtta Google kullanıcı kimliği yer almaz. Bu özellik şu anda trafiğin yalnızca küçük bir yüzdesinde etkindir ancak Haziran 2020'de tamamen etkinleştirilmesi planlanmaktadır.
google_hm

Yalnızca Google tarafından barındırılan eşleşme tablosuna yazma girişimi başarısız olursa görünür. Bu durumda, değeri aşağıdaki durum kodlarından biri olur:

  • 1 - Yasak: Müşteri, barındırılan eşleşme tablosu girişleri yazmak için henüz beyaz listeye eklenmemiştir.
  • 2 - Kod çözme hatası: Parametre değeri kodu çözülemedi.
  • 3 - Yük çok uzun: Parametre değeri 24'ten fazla baytlık veri olarak kodlandı.
  • 4 - Dahili hata: Veriler saklanırken dahili bir hata oluştu.
  • 5 - Sınırlandırıldı: Bu yazma işlemi, sınırlama nedeniyle işlenmedi.
google_ula

Kullanıcı listesi ekleme işleminin durumu. İstekte birden fazla google_ula belirtilmişse tekrarlanır. Biçim:
userlistid,status code

Örnek: google_ula=1234567890,0

google_ula işlemi aşağıdaki durum kodlarından herhangi birini döndürebilir:

  • 0: Hata yok. Kullanıcı, kullanıcı listesine eklendi.
  • 2: İzin reddedildi. Belirtilen kullanıcı listesine kullanıcı ekleme izniniz yok.
  • 5: Hatalı kullanıcı listesi kimliği. Sağlanan kullanıcı listesi kimliği geçersiz.
  • 6: Kapalı özellik kimliği. Sağlanan kullanıcı listesi kimliği kapalı.
  • 10: Dahili hata. Çerez Eşleştirme hizmeti dahili bir hatayla karşılaştı. Kullanıcıyı tekrar eşleştirmeyi deneyebilirsiniz.

Aşağıdaki senaryolarda, bir web sayfasına göz atan tipik bir kullanıcı için çerez eşleştirmenin nasıl görünebileceği açıklanmaktadır.

1. Senaryo: Kullanıcı çerezlerini temizler ve bir siteye göz atar

Canan, önbelleğini tüm çerezlerden temizler. Ardından ExampleNews.com'un ana sayfasını ziyaret eder.

Süreç şu şekilde işler:

  1. ExampleNews.com, Google'dan (Ad Manager) reklamları oluşturur ve çağırır.
  2. Reklam birimi dinamik ayırmaya uygun olduğundan Google, Gerçek Zamanlı Teklif Verme hizmeti aracılığıyla FinestDSP'ye ve diğer teklif verenlere teklif istekleri gönderir.
  3. FinestDSP'nin teklif veren uygulaması, teklif isteğini alır ve işler, ardından teklif yanıtını gönderir.
  4. Google, FinestDSP'nin eşleşme etiketi (piksel) içeren bir reklamı belirten yanıtı da dahil olmak üzere teklif verenlerden teklif yanıtları alır.
  5. FinestDSP açık artırmayı kazanır. Google, FinestDSP'nin reklamını ve eşleşme etiketini Cemre'ye yayınlar.
  6. Eşleşme etiketi, google_nid ve google_cm parametrelerini belirterek Google'ın Çerez Eşleştirme Hizmeti'ni çağırır.
  7. Çerez Eşleştirme Hizmeti, Cansu'nun Google çerezini okur ve Cansu'nun tarayıcısına google_gid ve google_cver parametreleri ayarlanmış şekilde FinestDSP'nin Çerez Eşleştirme URL'sine yönlendirme gönderir.
  8. Cansu'nun tarayıcısı, FinestDSP'nin Çerez Eşleştirme URL'sine yönlendirmeyi yükler.
  9. FinestDSP'nin çerez eşleştirme uç noktası, Google tarafından ayarlanan URL parametrelerini ve HTTP başlıklarında Cansu için çerezlerini içeren yönlendirme isteğini işler. FinestDSP artık çerezinin google_gid ile eşlemesini eşleşme tablosunda saklayabilir.
  10. FinestDSP, yönlendirmeye görünmez bir 1x1 piksel ile yanıt verir.
2. senaryo: Mevcut eşlemeye sahip kullanıcı

Senaryo 1'den bir hafta sonra Canan, ExampleNews.com'u tekrar ziyaret eder. Jane'in makinesinde hem teklif veren hem de Ad Manager çerezleri bulunduğuna göre eşleştirmenin işleyiş şeklini inceleyelim.

  1. Web sayfası oluşturulur ve Google'ın (Ad Manager) sayfa üzerinde oluşturulacak reklamları istemesine neden olur.
  2. Google, reklam açık artırması sırasında FinestDSP dahil olmak üzere geçerli teklif verenlere bir teklif isteği gönderir.
  3. FinestDSP, google_gid gibi sinyaller de dahil olmak üzere teklif isteğini alır.
  4. FinestDSP, eşleşme tablosunda google_gid değerini arar ve bir hafta önce oluşturulan (Senaryo 1'de) Cansu ile ilişkili çerezi bulur.
  5. FinestDSP'nin teklif verme mantığı, çerezle ilişkili bilgilere dayanarak gösterime teklif verir ve açık artırmayı kazanır.
  6. Jane, FinestDSP'nin sahip olduğu bilgilere dayanarak ilgi alanlarına göre özelleştirilmiş bir reklam görebilir.

Tek yönlü çerez eşleştirme, çift yönlü iş akışına benzer. Tek yönlü çerez eşleştirmenin tek farkı, eşleşme tablosunu yalnızca Google'ın barındırması ve doldurmasıdır. Bu, teklif verenin kendi eşleşme tablosunda Google kullanıcı kimliklerini barındırmasına izin verilmeyen durumlarda kullanılabilir. Bu akışı kullanmak isteyen teklif verenler, Google'ın eşleşme tablosunu barındırmasına izin vermelidir. Artık Google'ın Çerez Eşleştirme Hizmeti'ne gönderilen isteklerde google_cm belirtemezler ve sonuç olarak kendi eşleşme tablolarını doldurmak için google_gid alamazlar. Google bir kullanıcı için eşleşme oluşturduktan sonra teklif verenler kendi çerez verilerini kullanarak kullanıcıyı kullanıcı listelerine ekleyebilir. Benzer şekilde, bu kullanıcılara yönelik teklif isteklerinde Google kullanıcı kimliği hariç tutulur ancak barındırılan eşleşme verileri dahil edilir. Düzeltilen iş akışının basit bir örneği aşağıdaki adımlarda özetlenmiştir.

Bu akışı başlatmak için teklif verenin, eşleşme etiketini kullanıcının tarayıcısında oluşturulacak şekilde yerleştirmesi gerekir. Gizlilik kısıtlamaları olan bir ABD eyaletinde ikamet etmeyen kullanıcılar için iş akışının aksine, eşleşme etiketi kullanıcının tarayıcısını Çerez Eşleştirme URL'nize yönlendirmelidir. Örneğin, https://ad.network.com/pixel olarak yapılandırılmış bir çerez eşleme URL'si şu şekilde görünür:

<img src="https://ad.network.com/pixel" />

Kullanıcının tarayıcısında yüklenirken teklif verenin Çerez Eşleştirme URL'sinden bir piksel ister. Bu istek, HTTP üstbilgisinde kullanıcının çerezini içerir. Bu çerez, sonraki adım için ayıklanmalıdır.

Teklif verenin çerez eşleme uç noktası, web'de güvenli base64 kodlu çerez verileriyle doldurulan google_hm parametresi de dahil olmak üzere Google'ın Çerez Eşleme hizmetine yönlendirmelidir. Yönlendirme URL'si aşağıdaki gibi görünebilir:

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA

Google, HTTP başlıklarındaki Google çerezine ek olarak belirttiğiniz parametreleri içeren bir yönlendirme alır.

4. adım: Google, rapor URL'si belirtilmişse başarı veya hata yönlendirmesinde piksel sunar

Çerez eşleştirme işlemi başarılı olursa veya teklif verenin hesabı için Çerez Eşleştirme Raporu URL'si belirtilmemişse Google varsayılan olarak 1x1 şeffaf piksel yayınlar ve iş akışı burada sona erer. Sonraki teklif isteklerinde bu kullanıcının gösterimleri, OpenRTB için BidRequest.user.buyeruid veya desteği sonlandırılan Google GZT Protokolü için BidRequest.hosted_match_data alanındaki teklif verenin barındırılan eşleşme verilerini içerir. Teklif verenler, belirttikleri barındırılan eşleşme verilerini kullanarak da kullanıcı listelerini doldurabilir.

Aksi takdirde, bir hata meydana gelirse Google, google_error parametresinde belirtilen hatanın nedenini içeren bir yönlendirme, teklif verenin Çerez Eşleştirme Raporu URL'sine gönderir. Teklif verenin Çerez Eşleme Raporu URL'si https://ad.network.com/report ise yönlendirme URL'si şu şekilde görünür:

<img src="https://ad.network.com/report?google_error=ERROR_ID" />

Kullanıcının tarayıcısı, Google tarafından google_error parametresinde belirtilen hata nedeni (varsa) dahil olmak üzere teklif verenin Çerez Eşleştirme Raporu URL'sine yönlendirilir. Hata kodunu yorumlama hakkında daha fazla bilgi edinmek için parametre açıklamasına bakın.

6. adım: Teklif veren 1x1 şeffaf piksel sunar

Teklif veren, kullanıcının tarayıcısına 1x1 şeffaf piksel sunarak yanıt vermelidir.

Gizlilik kısıtlamaları olan ABD eyaletlerindeki kullanıcılar için varsayılan iş akışı aşağıdaki şemada gösterilmektedir. Şemada istekler ve yanıtlar bir okla, bunlara eşlik eden veri öğeleri ise parantez içinde listelenmektedir.

Parametre Açıklama
google_nid Teklif veren hesabın ağ kimliği (NID). Bu kimlik, Teklif Verenler kaynağı aracılığıyla alınabilir.
google_sc Bu parametre kullanımdan kaldırılmıştır. Kullanıcı için Google çerezini belirler (mevcutsa). Parametrenin değeri yoksayılır ve atlanabilir. Çerez yoksa parametrenin atlanması hatayla sonuçlanır.
google_no_sc Bu parametre kullanımdan kaldırılmıştır. Bu, Google'ın Çerez Eşleştirme Hizmeti'ne, mevcut bir çerez yoksa kullanıcı için çerez ayarlamamasını belirtir. Parametrenin değeri yoksayılır ve atlanabilir.
google_hm

Teklif verenin Google tarafından barındırılan bir eşleşme tablosunda depolamak istediği verileri içerir.
google_redir Google'ın HTTP 302 yönlendirmesi göndermesini istediğiniz kodlanmış bir URL. Belirtilen URL, hem hatalar hem de başarılı işlemler için google_error parametresini içeren yönlendirmeler alır.
google_ula Kullanıcıyı mevcut bir kullanıcı listesine eklemek için kullanılan bir dize. Değerin beklenen biçimi userlistid[,timestamp] olmalıdır:
  • userlistid: Tek bir sayısal kullanıcı listesi kimliği.
  • timestamp: POSIX biçiminde isteğe bağlı bir zaman damgası. Kullanıcının kullanıcı listesine ne zaman eklendiğini gösterir.

Bu URL parametresi, kullanıcıyı birden fazla listeye eklemek için tekrarlanabilir.
gdpr İsteğin, veri kullanımıyla ilgili GDPR kısıtlamalarına tabi olduğunu gösterir. Daha fazla bilgi için aşağıdaki AB kullanıcı rızası koşulları bölümüne veya Authorized Buyers IAB TCF v2.0 dokümanlarında Çerez eşleşme uygunluğunun etkilenmesi başlıklı makaleye bakın.

Örnek: gdpr=1
gdpr_consent Son kullanıcı iznini temsil eden bir TC dizesi. Daha fazla bilgi için aşağıdaki AB kullanıcı rızası koşulları bölümüne veya Authorized Buyers IAB TCF v2.0 belgelerindeki TC dizesi nasıl iletilir? başlıklı makaleye bakın.
process_consent Teklif verenin, Google'ın AB Kullanıcı Rızası Politikası'nda belirtilen veri kullanımları için son kullanıcı izni aldığını gösterir.

İstek AB Kullanıcı Rızası Politikası'na tabi değilse veya istekte başka izin parametreleri varsa (gdpr_consent) bu parametre yoksayılır.

Örnek: process_consent=T
Parametre Açıklama
google_error

Genel istek hatasını belirten bir tam sayı değeri. Alındığında, hiçbir işlem yapılmadığını ve başka google_ yanıt parametresinin ayarlanmayacağını gösterir. Desteklenen hata değerleri şunlardır:

  • 1: Kullanıcının Google çerezi vardır ancak bu çerez kullanılarak yapılan izlemeyi devre dışı bırakmıştır.
  • 2: Geçerli işlem belirtilmedi. Örneğin, işlemsiz bir istek alındı.
  • 3: Kullanıcının Google çerezi yok. Google, çerezi Çerez Eşleme Hizmeti üzerinden ayarlamaz.
  • 4: Çakışan işlemler belirtildi. Çakışık amaçları olduğundan aynı istekte hem google_push hem de google_cm işaretlerini belirtmenize izin verilmez.
  • 5: İki yönlü piksel eşleştirme isteğinin bir parçası olarak, bir Google sunucusuna yönlendirmede geçersiz bir google_push parametresi iletildi. Yönlendirmeniz, google_push değerini ilk piksel isteğinde size iletilen değere ayarlamalıdır.
  • 6: Eşleme etiketinde geçersiz bir NID sağlandı.
  • 7: Geçersiz bir çerez algılandı.
  • 8: Kullanımdan kaldırıldı. Çerez bulunamadı.
  • 9: Çerez bulunamadı, test çerezi ayarlamaya çalışılır.
  • 10: google_redir parametresi, google_hm belirtilmeden veya google_cm'a ek olarak kullanıldı.
  • 15: İstek, Google'ın eşleşme tablosunun Google tarafından barındırılmasını gerektiren bir bölgeden geliyor. Bu nedenle, bu yanıtta Google kullanıcı kimliği yer almaz. Bu özellik şu anda trafiğin yalnızca küçük bir yüzdesinde etkindir ancak Haziran 2020'de tamamen etkinleştirilmesi planlanmaktadır.

Google tarafından başlatılan: İki yönlü piksel eşleme

İki yönlü piksel eşleştirme, Google'ın Çerez Eşleştirme Hizmeti için bir iş akışı olup Google'ın bir Google kullanıcı kimliğini, Gerçek Zamanlı Teklif Verme açık artırması galibi dışında algoritmik olarak seçilen bir teklif verenle eşleştirmeye çalıştığı bir işlemdir. Bir reklam yerleştirildiğinde Google, kullanıcının tarayıcısını seçilen teklif verenin Çerez Eşleştirme URL'sinden şeffaf bir piksel yüklemeye yönlendiren bir eşleşme etiketi yerleştirir. Bu sayede hem Google hem de teklif veren, belirli bir kullanıcıyla eşleşme tablosunu doldurabilir. Aşağıda bu iş akışına dair basit bir örnek verilmiştir.

1. adım: Google bir eşleşme etiketi yerleştirir

Katılımcı bir yayıncının sayfası kullanıcının tarayıcısında yüklendiğinde ve bu sayfadaki bir reklam alanı Google tarafından doldurulduğunda, algoritmik olarak seçilen bir teklif verenden piksel isteyen bir eşleşme etiketi yerleştirilebilir. Google tarafından yerleştirilen piksel eşleme etiketi, teklif verenin Çerez Eşleme URL'sini, teklif verenin eşleşme tablosunu doldurmak için kullanabileceği ek parametrelerle birleştirir. https://ad.network.com/pixel olarak belirtilen bir çerez eşleme URL'si aşağıdaki gibi yapılandırılır:

<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />

Piksel eşleştirme isteği alan teklif verenlerin, aşağıdaki şekilde yapılandırılmış bir Google çerez eşleştirme hizmetine yönlendirmeyle yanıt vermesi gerekir:

https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA

Yukarıdaki yönlendirme URL'sinin, Teklif Veren Tarafından Başlatılan Çerez Eşleme İş Akışı için eşleme etiketinde kullanılan URL'ye benzer olduğunu unutmayın. Pixel eşleştirmede google_cm parametresi google_push parametresiyle değiştirilir ve bu parametrenin değeri, Google tarafından istekte sağlanan değere eşit olmalıdır. Teklif veren tarafından başlatılan iş akışına benzer şekilde, ek kullanım alanlarını karşılamak için ek parametreler de belirtilebilir.

3. adım: Google, yönlendirmeyi işler ve piksel ile yanıt verir

Google, kullanıcı için bir eşleşme oluşturulduğunu günlüğe kaydeder ve sorgu parametreleri aracılığıyla istenen tüm ek işlemleri gerçekleştirir. Son olarak Google, 1x1 şeffaf piksel ile yanıt verir.

Pixel eşleme iş akışı şeması

Bu iş akışı, isteklerin ve yanıtların bir okla gösterildiği ve bunlara eşlik eden veri öğelerinin parantez içinde listelendiği aşağıdaki şemada gösterilmektedir.

Google eşleme etiketi istek parametreleri

Parametre Açıklama
google_gid Google kullanıcı kimliği. Gizlilik kısıtlamaları olan bir ABD eyaletinde bulunmayan kullanıcılar için bu durum her zaman Google'ın eşleşme etiketinde belirtilir.
google_cver Çerezin sürümü. Bu değer her zaman Google'ın eşleşme etiketinde belirtilir.
google_push Bu isteğin, piksel eşleştirme iş akışını başlattığını gösterir. Değer, teklif verenin yönlendirme yanıtındaki ilgili parametre aracılığıyla döndürülmelidir.
gdpr_consent Son kullanıcı iznini temsil eden bir TC dizesi. Daha fazla bilgi için aşağıdaki [AB kullanıcı rızası şartlarına](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) veya [Authorized Buyers IAB TCF 2.0 dokümanlarında](//support.google.com/authorizedbuyers/answer/9789378) **TC dizesi nasıl iletilecek?** bölümüne bakın.

Teklif veren piksel eşleme yönlendirme parametreleri

Parametre Açıklama
google_nid Teklif veren hesabın ağ kimliği (NID). Bu kimlik, Teklif Verenler kaynağı aracılığıyla alınabilir.
google_push Bu yönlendirmenin, Pixel eşleştirme iş akışını tamamladığını belirtir. İlgili Google eşleme etiketindeki değer burada belirtilmelidir.
google_hm

Teklif verenin Google tarafından barındırılan bir eşleşme tablosunda depolamak istediği verileri içerir.
google_ula Kullanıcıyı mevcut bir kullanıcı listesine eklemek için kullanılan bir dize. Değerin beklenen biçimi userlistid[,timestamp] olmalıdır:
  • userlistid: Tek bir sayısal kullanıcı listesi kimliği.
  • timestamp: POSIX biçiminde isteğe bağlı bir zaman damgası. Kullanıcının kullanıcı listesine ne zaman eklendiğini gösterir.

Bu URL parametresi, kullanıcıyı birden fazla listeye eklemek için tekrarlanabilir.
gdpr_consent Son kullanıcı iznini temsil eden bir TC dizesi. Daha fazla bilgi için aşağıdaki [AB kullanıcı rızası koşulları](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) bölümüne veya [Authorized Buyers IAB TCF 2.0 dokümanları](//support.google.com/authorizedbuyers/answer/9789378) bölümündeki **TC dizesi nasıl iletilir?** başlıklı makaleye bakın.

Google tarafından başlatılan: Tek yönlü piksel eşleme

Tek yönlü piksel eşleme, Google'ın eşleme etiketinin Google kullanıcı kimliğini belirten bir parametre içermemesi ancak Google tarafından barındırılan bir eşleşme tablosunu doldurmaya devam etmesi açısından iki yönlü iş akışında farklılık gösterir. Bu, teklif verenin kendi eşleşme tablosunda Google kullanıcı kimliklerini barındırmasına izin verilmeyen durumlarda kullanılabilir. Düzeltilen iş akışının basit bir örneği aşağıdaki adımlarda özetlenmiştir.

1. adım: Google bir eşleşme etiketi yerleştirir

Google, algoritmik olarak seçilen bir teklif veren için bir eşleşme etiketi yerleştirir. Eşleşme etiketi, google_push parametresini içeriyor. Aşağıda bununla ilgili bir örnek verilmiştir:

<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />

2. adım: Kullanıcının tarayıcısı, teklif verenin Pişirme Eşleştirme URL'sinden piksel ister

Kullanıcının tarayıcısı, teklif verenin çerez eşleştirme URL'sinden bir piksel ister. Bu istek, HTTP üst bilgilerinde teklif verenin çerezini içerir.

Teklif verenin çerez eşleme uç noktası, web'de güvenli Base64 kodlu çerez verileriyle doldurulan google_hm parametresi dahil olmak üzere Google'ın Çerez Eşleme hizmetine yönlendirmelidir. Yönlendirme URL'si aşağıdaki gibi görünebilir:

https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA

Google, HTTP başlıklarındaki Google çerezine ek olarak belirttiğiniz parametreleri içeren bir yönlendirme alır. İşlem başarılı olduysa sonraki teklif isteklerinde bu kullanıcının gösterimleri, OpenRTB için BidRequest.user.buyeruid veya desteği sonlandırılan Google RTB Protokolü için BidRequest.hosted_match_data içinde teklif verenin barındırılan eşleşme verilerini içerir. Teklif verenler, belirttikleri barındırılan eşleşme verilerini kullanarak da kullanıcı listelerini doldurabilir.

Son olarak Google, kullanıcının tarayıcısına 1x1 şeffaf piksel döndürür.

Open Bidding, exchange'lerin bir Google kullanıcı kimliğini çerezleriyle eşlemek için teklif veren tarafından başlatılan ve Google tarafından başlatılan çerez eşleştirme iş akışlarını kullanmasına olanak tanır. Çerez Eşleştirme Yardımı (CMA), exchange'lerin kendi teklif verenleriyle eşleşme tabloları oluşturmasını sağlayan ek bir özelliktir.

  1. Google, reklam yerleştirirken algoritmik olarak katılımcı bir exchange seçer ve aşağıdaki yapıya sahip bir Çerez Eşleştirme Yardımı etiketi yerleştirir:

    <img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>

  2. Google'ın CMA eşleme etiketi, exchange'in Çerez Eşleme URL'sinin bir piksel isteği almasına neden olur.

  3. İsteği exchange'in Çerez Eşleme uç noktası alır. Burada, kullanıcı kimliğini teklif verenlerinden biriyle eşleştirmekten kendi çerez eşleme hizmeti sorumludur. Aşağıdaki şemada, exchange'in çerez eşleştirme hizmeti, kullanıcının tarayıcısına teklif verenin uç noktalarından birine yönlendirme yaparak yanıt verir.
  4. Teklif veren, isteği ve exchange tarafından kullanıcı kimliğini çereziyle eşleştirmek için belirtilen tüm parametreleri alır.

Kısıtlamalar

Yeni eşleşmeler için isteklerin sıklığını sınırlama

Google tarafından barındırılan eşleşme tablosunda yeni girişi olan kullanıcılar için Çerez Eşleştirme hizmetine yapılan çağrıların sayısını sınırlandırmaktan teklif verenler sorumludur. Barındırılan eşleşme tablosundaki bir girişin süresi 14 gün içinde dolabilir. Bu durumda giriş yenilenebilir.

Tüm piksel eşleştirme isteklerine yanıt verme

Pixel eşleştirme iş akışını kullanan teklif verenlerin, gelen tüm Pixel eşleştirme isteklerine google_push parametresini içeren bir yanıtla yanıt vermesi beklenir. Bu sayede Google, kullanımı izleyerek politikaları uygulayabilir. Bir teklif verenin yanıt oranı %90'ın altına düşerse Google, hesabına gönderilen Pixel Eşleştirme isteklerinin sayısını azaltır.

HTTPS uç noktaları kullanma

Tüm Çerez Eşleme iş akışlarında kullanılan uç noktaların HTTPS kullanması gerekir.

Size HTTPS üzerinden gönderilen bir piksel eşleştirme isteğine yanıt verirken HTTPS üzerinden Çerez Eşleştirme Hizmeti'ne yönlendirmeniz gerekir. Benzer şekilde, teklif verenlere yönlendiren bir Çerez Eşleştirme Yardımı uç noktası da HTTPS kullanmalıdır. Google'a HTTP üzerinden 2 dakikadan daha sık istek gönderirseniz hesabınıza gönderilen eşleşme isteklerinin sayısı sınırlandırılır.

Google'ın AB Kullanıcı Rızası Politikası'na tabi olan çerez eşleştirme isteklerinde son kullanıcı rızası belirtilmelidir. Bu tür taleplerde, izinlerin aşağıdaki yöntemlerden biri kullanılarak toplandığı belirtilmelidir:

  • TCFv2: gdpr ve gdpr_consent parametreleri bu kapsamdadır. Ayrıntılar için Authorized Buyers IAB TCF 2.0 belgelerine bakın.
  • process_consent: Teklif verenin gerekli kullanıcı iznini aldığını belirten bir beyan.

Örnekler

Aşağıdaki örneklerde, belirli hedeflere ulaşmak için Çerez Eşleştirme hizmetinin nasıl kullanılacağı gösterilmektedir. Aksi belirtilmediği sürece, işlem yapılan kullanıcının gizlilik kısıtlamaları olan bir ABD eyaletinde bulunmadığının varsayıldığını unutmayın.

Teklif veren tarafından barındırılan bir eşleşme tablosunu doldurma

Teklif verenler, eşleme etiketlerinde yalnızca google_nid ve google_cm parametrelerini sağlayarak kendi eşleme tablolarını doldurmak için Çerez Eşleştirme iş akışını kullanabilir. Bu, şöyle görünebilir:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />

Teklif verenin Çerez Eşleştirme URL'si https://ad.network.com/pixel?id=1 olarak ayarlanmışsa ve çerez eşleştirme işlemi başarılıysa Google'ın teklif verenin eşleşme etiketine yanıt olarak gönderdiği yönlendirme şu şekilde görünebilir:

https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1

Kullanıcının Google çerezi olmadığı için çerez eşleştirme işlemi başarısız olursa yanıt şu olur:

https://ad.network.com/pixel?id=1&google_error=3

Hata kodu, hatanın temel nedenine bağlıdır. Çerez eşleme iş akışı için olası hata kodları hakkında daha fazla bilgi edinmek istiyorsanız yönlendirme URL parametreleri başlıklı makaleyi inceleyin.

Tek kullanıcı listesine ekleme

google_ula parametresi, kullanıcıyı belirli bir kimliğe sahip bir kullanıcı listesine eklemek için teklif verenin eşleşme etiketinde belirtilebilir. Google veya teklif veren tarafından barındırılan eşleşme tablosunda kullanıcı için yeni bir giriş varsa teklif veren, çerez eşleştirme iş akışını başlatmadan kullanıcıyı belirtilen listeye eklemek için google_nid ve google_ula parametrelerini içeren bir eşleşme etiketi yerleştirebilir. Daha fazla bilgi için Çerez Eşleştirme Hizmeti'ni çağırmayla ilgili kısıtlamalara bakın. İlgili eşleme etiketi şu şekilde görünebilir:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />

Teklif verenin Çerez Eşleştirme URL'sinin https://ad.network.com/pixel olduğu başarılı bir yanıt için Google'ın yönlendirme URL'si şu şekilde olur:

https://ad.network.com/pixel?google_ula=12345,0

Genel bir hata varsa (ör. kullanıcı için Google çerezi yoksa) yönlendirme URL'sinde google_error parametresi yer alır:

  • https://ad.network.com/pixel?google_error=3

Kullanıcının listeye eklenmesiyle ilgili bir hata varsa yönlendirmede google_ula alırsınız. İlgili eşleme etiketi parametresinin aksine bu parametre, zaman damgasını işlemin başarısını belirtmek için bir durum koduyla değiştirir. Örneğin, teklif veren hesabın belirtilen kullanıcı listesine erişimi olmadığı için istek başarısız olursa yönlendirme URL'si şu şekilde olur:

https://ad.network.com/pixel?google_ula=12345,2

Birden fazla kullanıcı listesine ekleme

Teklif verenler, eşleşme etiketine birden fazla google_ula parametresi ekleyerek bir kullanıcının birden fazla kullanıcı listesine eklenmesi gerektiğini belirtebilir. Uygulamada bu durum aşağıdaki gibi görünebilir:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />

Her kullanıcı listesi için işlemin durumu, yönlendirmedeki farklı google_ula parametreleri aracılığıyla benzer şekilde raporlanır:

https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0

Yukarıdaki yönlendirmede, işlemin 45678 kimlikli kullanıcı listesi için başarılı olduğunu ancak teklif verenin erişme izni olmadığı için 12345 kimlikli kullanıcı listesi için başarısız olduğunu görebiliriz.

Çerez eşleştirmeyi gerçekleştirmek ve kullanıcıyı tek bir istekle kullanıcı listesine eklemek için teklif verenin eşleme etiketi google_cm ve google_ula içermelidir:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />

Google tarafından belirtilen yönlendirme URL'si google_gid, google_cver ve google_ula içerir. Bu, aşağıdaki gibi görünebilir:

https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0

Bir eşleşmeyi Google tarafından barındırılan bir eşleşme tablosunda depolama

Bir teklif veren, çerez verilerini Google tarafından barındırılan bir eşleşme tablosunda depolamak istiyorsa ve eşleşmeyi Google kullanıcı kimliğiyle kendi eşleşme tablosunda depolamak istemiyorsa eşleşme etiketinde google_hm parametresi bulunmalıdır. Bu parametrenin değeri, web açısından güvenli bir base64 kodlu dize olmalıdır. Teklif verenin kodlanmamış çerez verilerinin Cookie number 1! olduğu bir kullanıcı için kodlanmış değer Q29va2llIG51bWJlciAxIQ== olur. Bu değer, aşağıdaki gibi bir eşleşme etiketinde kullanılır:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />

Teklif verenin Çerez Eşleştirme URL'sinin https://cookie-monster.com/pixel olduğu başarılı bir yanıt için Google'ın yönlendirme URL'si şu şekilde olur:

https://cookie-monster.com/pixel

Eşleme etiketi google_cm içermediğinden ve google_hm başarılı yanıtlara dahil edilmediğinden google_gid parametresi yönlendirmede yer almıyor. Bu kullanıcının gösterimlerine yönelik gelecekteki teklif isteklerinde, teklif veren, barındırılan eşleşme verilerini OpenRTB için BidRequest.user.buyeruid veya desteği sonlandırılan Google RTB protokolü için BidRequest.hosted_match_data biçiminde alır.

Teklif veren bunun yerine google_hm değerinin base64 kodlamasına tabi tutulmadığı bir eşleme etiketi kullandıysa (chocolate_chunk! gibi) yönlendirme URL'si aşağıdaki gibi görünebilir:

https://cookie-monster.com/pixel?google_hm=2

Yukarıdaki yönlendirme URL'sinde 2 değerine sahip bir google_hm değeri yer alır. Bu, değerin kodu çözülemediği için işlemin başarısız olduğunu gösterir.

Kullanıcı listeleri içeren teklif veren ve Google tarafından barındırılan eşleşme tabloları

Bir teklif veren, Google tarafından barındırılan bir kullanıcı listesine ek olarak kendi kullanım listesini barındırıyorsa ve her iki tabloyu da eşleştirip kullanıcıyı belirli bir kullanıcı listesine eklemek için tek bir eşleşme etiketi istiyorsa eşleşme etiketi google_cm, google_hm ve google_ula parametrelerini içermelidir. Teklif verenin çerez verileri Cookie number 1! ise kodlanmış değer Q29va2llIG51bWJlciAxIQ== olur. Bu da aşağıdaki gibi bir eşleşme etiketi oluşturur:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />

Teklif verenin Çerez Eşleştirme URL'sinin https://cookie-monster.com/pixel olduğu başarılı bir yanıt için Google'ın yönlendirme URL'si aşağıdaki gibi görünür:

https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0

Teklif veren, yönlendirmeyi aldığında google_gid içinde belirtilen Google kullanıcı kimliğini eşleme tablosundaki çerez verileriyle eşleştirebilir. Ayrıca, Google tarafından barındırılan eşleşme tablosu ve kullanıcı listesi işlemlerinin başarılı olup olmadığını belirleyebilirler. Sonuç olarak, teklif verenin belirtilen kullanıcı listesi kimliğini hedeflemek üzere yapılandırılmış tüm ön hedefleme işlemleri, teklif verenin kullanıcıdan gösterimlerle ilgili teklif istekleri almasına neden olur. Benzer şekilde, bu teklif isteklerinde teklif veren, barındırılan eşleşme verilerini OpenRTB için BidRequest.user.buyeruid veya desteği sonlandırılan Google GZT protokolü için BidRequest.hosted_match_data biçiminde alır.