Ç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ştirmenizi ve daha etkili teklif verme seçimleri yapmanıza yardımcı olabilecek kullanıcı listeleri oluşturmanızı sağlayan 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 çerezlerin içeriğini ayarlar. Bu çerezler, söz konusu alandaki 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.

Dijital reklamcılık bağlamında Google, 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 belirli bir 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 veren, teklif isteğinde gönderilen bir gösterimin hedeflenen kullanıcılardan biriyle ilişkili olup olmadığını belirleyebilir, kendi çerez verilerini veya teklif isteğindeki doubleclick.net çerezinin şifrelenmiş bir biçimi olan teklif verene özgü Google User-ID'yi alabilir.

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. Oluşturulan eşleşmeler 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 uç noktanız, kullanımdan kaldırılan Google GZT protokolünü kullanacak şekilde yapılandırılmışsa bunu BidRequest.hosted_match_data alanı üzerinden kodu çözülmüş bayt 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 özellik, çerez alanınızın dışındaki kullanıcılara alaka düzeyi daha düşük gösterimleri ortadan kaldırmak için kullanılabilir.

Kullanıcı listeleri

Kullanıcı listeleri, Gerçek Zamanlı Teklif Verme API'si ile oluşturulup 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ına yerleştirmeniz gereken etiket. Bu öğe, reklamlarla birlikte yayınlanabilir veya reklamların dışındaki web mülklerine yerleştirilebilir.
  • Çerez Eşleştirme Raporu URL'si (isteğe bağlı): Tek Yönlü Çerez Eşleştirme İş Akışında bu, çerez eşleştirmenin bir HTTP 302 yönlendirmesi aracılığıyla 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 bir 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şleştirme URL'sini şuna 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 için Etiket URL Parametrelerini Eşleştirme bölümüne bakın.

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ği'ni ve sürüm numarasını belirten sorgu parametrelerini içerir. Teklif veren de istek başlıklarında çerezini 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 sonrasında artar.

Google, eşleşme isteğinizi işlerken bir hatayla karşılaşırsa bunun yerine 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 ve Google'ın ikinci adımda sağladığı parametreler dahil olmak üzere çerez eşleştirme URL'sine bir yönlendirme alır. 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ı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 (varsa) ayarlar. 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 en fazla 40 bayt 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 sayede Google, iş ortaklarına yapılan zincirleme çağrıda en önde yer alabilir. 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 userlistid[,timestamp] olması beklenen biçim:
  • 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

Yukarıdaki parametrelere ek olarak, teklif verenler kendi parametrelerini belirtebilir. Bunlar, 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'si 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 belirtildiyse ve isteğin başarılı olup olmadığını ayarlayın.
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. Çelişen amaçlara sahip olduğundan aynı istekte hem google_push hem de google_cm işaretlerini belirtmenize izin verilmiyor.
  • 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 oluşturulmaya çalışıldı.
  • 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_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. Cookie Match Service, Zeynep'in Google çerezini okur ve Jale'nin tarayıcısına, google_gid ve google_cver parametreleri ayarlanmış olarak FinestDSP'nin Çerez Eşleştirme URL'sine bir 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şleme 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 Jane, 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 (Ad Manager) sayfada 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 öğesini arar ve bir hafta önce oluşturulan Jale ile ilişkili çerezi bulur (1. Senaryo'da).
  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 vermeli, Google'ın Çerez Eşleştirme Hizmeti'ne yapılan isteklerde artık google_cm belirtemez ve bunun sonucunda kendi eşleşme tablosunu doldurmak için google_gid almaz. Google bir kullanıcı için eşleşme belirledikten sonra teklif verenler, kendi çerez verilerini kullanarak bunları 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 bulunmayan 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, Çerez Eşleştirme URL'si https://ad.network.com/pixel olarak yapılandırıldığında aşağıdaki gibi 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, sonraki adım için ayıklanacak olan HTTP başlığında çerezini içerir.

Teklif verenin çerez eşleştirme uç noktası, web güvenli base64 kodlu çerez verileriyle doldurulan google_hm parametresi dahil olmak üzere Google'ın Çerez Eşleştirme 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: Rapor URL'si belirtilirse Google, pikseli başarılı veya hata yönlendirmesinde 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 kullanıcı listelerini de 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şleştirme Raporu URL'si https://ad.network.com/report olsaydı yönlendirme URL'si şöyle görünürdü:

<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. Burada istekler ve yanıtlar bir okla, bunlara eşlik eden veri öğeleri parantez içinde listelenmiştir.

Parametre Açıklama
google_nid Teklif veren hesabını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 (varsa) ayarlar. 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ıldı. 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 userlistid[,timestamp] olması beklenen biçim:
  • 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ında GDPR kısıtlamalarına tabi olduğunu belirtir. 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ıdan izin 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 şunları içerir:

  • 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 oluşturulmaya çalışıldı.
  • 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üzdesi için etkindir. Ancak Haziran 2020'de tamamen etkinleştirilmesi planlanmaktadır.

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

İ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şleştirme İş 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. Ayrıca teklif veren tarafından başlatılan iş akışına benzer şekilde, ek kullanım alanlarını karşılamak için ek parametreler belirtilebilir.

3. Adım: Google, yönlendirmeyi işler ve pikselle 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 ikamet etmeyen 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 karşılık gelen 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şleştirme yönlendirme parametreleri

Parametre Açıklama
google_nid Teklif veren hesabını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. Karşılık gelen Google eşleşme 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 özellik, teklif verenin kendi eşleşme tablosunda Google Kullanıcı Kimliklerini barındırmasına izin verilmediği 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çerir. 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 Yemek Pişirme 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 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_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ı olursa sonraki teklif isteklerinde yer alan gösterimler, OpenRTB için BidRequest.user.buyeruid veya kullanımdan kaldırılan Google GZT Protokolü için BidRequest.hosted_match_data ürününde 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 User-ID'yi çerezleriyle eşleştirmek 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önlendirmeyle 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 bir giriş olan kullanıcılar için Çerez Eşleştirme hizmetine yapılan çağrıların sayısını sınırlandırmak teklif verenlerin sorumluluğundadır. Barındırılan eşleşme tablosundaki bir girişin 14 gün sonra süresi dolmuş olarak kabul edilebilir. Bu sürenin ardından 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: Bu, gdpr ve gdpr_consent parametrelerini içerir. 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, hakkında işlem yapılan kullanıcının gizlilik kısıtlamalarına sahip bir ABD eyaletinden olmadığı varsayılmıştır.

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 (örneğin, kullanıcı için herhangi bir Google çerezi yoksa) yönlendirme URL'si google_error parametresini içerir:

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

Özellikle kullanıcının listeye eklenmesiyle ilgili bir hata varsa yönlendirmede google_ula bildirimi 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 olur:

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

Birden fazla kullanıcı listesine ekle

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. Bu durum uygulamada şöyle 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 kimliğine sahip kullanıcı listesi için başarılı olduğunu, ancak teklif verenin erişim izni olmadığı için 12345 kullanıcı listesi kimliği için başarısız olduğunu görebiliyoruz.

Çerez eşleştirmeyi gerçekleştirmek ve kullanıcıyı tek bir istekle kullanıcı listesine eklemek için teklif verenin eşleşme 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österimleriyle ilgili gelecekteki teklif isteklerinde teklif veren, barındırılan eşleşme verilerini OpenRTB için BidRequest.user.buyeruid veya desteği sonlandırılmış Google GZT protokolü için BidRequest.hosted_match_data içinde alır.

Teklif veren bunun yerine, google_hm değerinin base64 olarak kodlanmadığında (ör. chocolate_chunk!) bir eşleşme etiketi kullandıysa 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ı

Teklif veren, Google tarafından barındırılan kullanıcı listesinin yanı sıra kendi kullanım listesini de barındırıyorsa ve tek bir eşleşme etiketinin her iki tabloyla eşleşip kullanıcıyı belirli bir kullanıcı listesine eklemesini isterse eşleşme etiketinde 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ı belirleyebilir. Sonuç olarak, teklif verenin belirtilen kullanıcı listesi kimliğini hedeflemek üzere yapılandırılmış tüm ön hedefleme işlemleri artık teklif verenin kullanıcıdan gösterimlerle ilgili teklif istekleri almasına neden olacaktır. 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.