Çerez Eşleştirme

Çerez Eşleştirme, çerezinizi (ör. web sitenize göz atan 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 işleminde kullanılan kavramlar, farklı çerez eşleştirme iş akışları ve belirli kullanım alanları için bu iş akışlarında olabilecek varyasyonlar açıklanmaktadır.

Kavramlar

Alan adı sahipleri genellikle sitelerine göz atan kullanıcılar için çerezlerin içeriğini ayarlar. Bu çerezler, kullanıcıları söz konusu alan adı içinde tanımlamak için kullanılır. İki alan adı sahibi bu verileri değiştirmeyi kabul etse bile internet tarayıcılarının güvenlik modeli, birinin başka bir alan adı tarafından ayarlanan çerezi okumasını kısıtlar.

Google, dijital reklamcılık bağlamında kullanıcıları doubleclick.net alanına ait çerezlerle tanımlar ve anlık teklif verme işlemine katılan teklif verenler, reklam göstermek istedikleri bir grup kullanıcıyı 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, bir teklif isteğinde gönderilen gösterimin hedeflenen kullanıcılardan biriyle ilişkili olup olmadığını belirleyebilir. Bu durumda, teklif isteğindeki doubleclick.net çerezinin şifrelenmiş biçimi olan kendi çerez verilerini veya 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 kullanıcı kimliği arasındaki ilişkilendirmenin oluşturulmasını ve sürdürülmesini kolaylaştırır. Ayrıca, kullanıcı listelerinin doldurulmasına da olanak tanır.

Eşleşme tabloları

Bir eşleşme tablosu, bir alandaki kimliği veya diğer verileri başka bir alanla eşlemek için kullanılabilir. Teklif verenler, belirli bir kullanıcının çerezini 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 hizmetini 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ı

Bakımı kolaylaştırmak, gecikmeyi azaltmak ve belirli bölgelerdeki kullanıcıların maç verilerine erişmesini sağlamak için Google'ın maç tablonuzu barındırmasına izin vermeniz önerilir. Bu, belirli bir kullanıcı için 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) belirtmenize olanak tanır. Eşleşme oluşturulduktan sonra aşağıdaki şekillerde kullanılabilir:

  • Gerçek zamanlı teklif: Kullanıcıyla ilişkili gösterimler için sonraki teklif isteklerinde Google, Google kullanıcı kimlikleriyle eşleştirdiğiniz barındırılan eşleşme verilerini size gönderir. Google, BidRequest.user.buyeruid değerini web güvenli Base64 kodlu bir dize olarak belirtir.

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

  • Ön hedefleme: Ön hedeflemenizi yalnızca barındırılan eşleşme verilerini içeren teklif isteklerini alacak şekilde yapılandırabilirsiniz. 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'si ile oluşturulup yönetilebilir. Oluşturulduktan sonra bu listeleri aşağıdaki çerez eşleştirme iş akışlarıyla veya toplu yükleme hizmeti aracılığıyla doldurabilirsiniz.

Başlarken

Çerez eşleştirme özelliğini 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'si. Teklif verenler, Çerez Eşleme iş akışlarında kendisine aktarılan parametrelerin sıralamasını kontrol etmek için bu URL'ye makrolar yerleştirebilir.
  • Eşleşme Etiketi: Teklif veren tarafından başlatılan çerez eşleşmeli 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şleme Raporu URL'si (isteğe bağlı): Tek Yönlü Çerez Eşleme İş Akışında, bu, 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 bir hata varsa bu URL'ye gönderilir ancak teklif verenler, yönlendirmenin her zaman gönderilmesini isteyebilir.
  • Çerez Eşleme Desteği URL'si: Çerez Eşleme Desteği iş akışını uygulayan borsalar için bu, gelen isteklere yanıt vermesi amaçlanan uç noktanın temel URL'sidir.
  • Çerez Eşleştirme Desteği Kotası: Çerez Eşleştirme Desteği iş akışını uygulayan borsalar için bu, Çerez Eşleştirme URL'lerinin her saniye alabileceği maksimum istek sayısıdır. Bu, CMA isteklerinin borsa sunucularını isteklerle aşırı yüklemesini önlemeyi amaçlar.

Desteklenen çerez eşleme iş akışlarının herhangi birinde, teklif verenin çerez eşleme URL'sine genellikle parametreler eklenir ancak bu parametrelerin sırası garanti edilmez. Parametrelerin tutarlı bir şekilde sıralanmasını gerektiren entegrasyonlara sahip teklif verenler, yerleşimlerini belirtmek için çerez eşleştirme URL'lerine makro yerleştirebilir.

Desteklenen makrolar

Teklif verenler, çerez eşleştirme URL'lerini isteğe bağlı olarak %%GOOGLE_<PARAM_NAME>%% veya %%GOOGLE_<PARAM_NAME>_PAIR%% biçiminde bir ya da 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ç nokta ile çerez eşleştirme entegrasyonu vardır ve uygulaması, piksel eşleştirme parametrelerine ek olarak teklif veren tarafından tanımlanan önceden ayarlanmış parametreleri şu sırayla gerektirir: google_push, google_gid, google_cver ve google_error. Teklif veren, çerez eşleme URL'sini aşağıdaki gibi ayarlayarak bunu gerçekleştirebilir:

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ğıdakine benzer şekilde 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 aşağıdaki üç iş akışını destekler.

Çift yönlü çerez eşleştirme, teklif veren tarafından başlatılan bir iş akışını ifade eder. Bu iş akışında, teklif veren kullanıcının tarayıcısına, tarayıcıyı Google'a yönlendiren bir eşleşme etiketi yerleştirir. 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ışına bir örnek verilmiştir.

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

Bu akışı başlatmak için teklif veren, eşleşme etiketini kullanıcının tarayıcısında oluşturulacak şekilde yerleştirmelidir. Yalnızca Google kullanıcı kimliğini teklif verene döndüren 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 başka parametreler de vardır. Bu parametreler hakkında daha fazla bilgi edinmek için Eşleşme Etiketi URL Parametreleri başlıklı makaleyi inceleyin.

2. adım: Google, eşleşme verilerini içeren bir yönlendirme ile yanıt verir.

Eşleşme etiketi, Google'ın çerez eşleştirme hizmetinin kullanıcının tarayıcısından bir istek almasına neden olur. Bu istek, teklif verenin çerez eşleştirme URL'sine bir HTTP 302 yönlendirme yayınlar. Yönlendirme, URL'de Google kullanıcı kimliğini ve sürüm numarasını belirten sorgu parametrelerini içerir. Ayrıca teklif veren, istek başlıklarına dahil edilen çerezini de alır. Uygulamada, https://ad.network.com/pixel olarak belirtilen bir çerez eşleme URL'si için önceki 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 parametresiyle iletilen Google kullanıcı kimliği, doldurulmamış ve web için güvenli base64 kodlu bir 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 depolaması önerilir. Sonraki teklif isteklerinde bu, BidRequest.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. Bu durumda kimlik artırılır.

Google, eşleştirme 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 pikselle yanıt verir

Teklif veren, ilk adımda belirttiği ve Google'ın ikinci adımda sağladığı parametreleri içeren çerez eşleştirme URL'sine yönlendirilir. Ayrıca, çerezlerini HTTP üstbilgilerinde 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 verenlerin, çerez eşleştirme hizmeti tarafından döndürülen dizeyi tam olarak saklaması önerilir.

İşlem başarısız olursa teklif veren, yönlendirmede google_error parametresini alır. Bu, farklı hata durumlarına karşılık gelen ve meydana gelen hatayı tanımlayan sayısal bir değerdir. Olası hata değerleri hakkında daha fazla bilgiyi google_error URL parametresinin açıklamasında bulabilirsiniz. Hata alırsanız yeni bir eşleşme etiketi yerleştirerek söz konusu kullanıcı için tekrar eşleşme denemesi yapabilirsiniz.

Teklif veren, her zaman 1x1 boyutunda görünmez bir piksel resmi sunarak yanıt vermelidir veya alternatif olarak HTTP 204 No Content (İçerik Yok) yanıtı döndürmelidir.

Bu 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 listelenmiştir.

Eşleşme etiketi URL parametreleri

Parametre Açıklama
google_nid Teklif veren hesabının ağ kimliği (NID). Bu kimlik, Bidders kaynağı aracılığıyla alınabilir.
google_cm Google'ın çerez eşleştirme hizmetine çerez eşleştirmesi yapması gerektiğini belirtir. Parametrenin değeri yoksayılır ve atlanabilir.
google_sc Bu parametre kullanımdan kaldırılmıştır. Google'ın çerezini, kullanıcı için ayarlanmamışsa ayarlar. Parametrenin değeri yok sayılır ve atlanabilir. Parametrenin atlanması, çerez yoksa hataya neden olur.
google_no_sc Bu parametre kullanımdan kaldırılmıştır. Bu, Google'ın Çerez Eşleştirme Hizmeti'ne, kullanıcı için çerez yoksa çerez ayarlamaması gerektiğini 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 güvenli base64 kodlu bir dizedir (doldurma isteğe bağlıdır). Ham veriler en fazla 40 bayt olmalıdır. Örneğin, Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u.
google_redir Bir teklif verenin, Google'ı bu eşleşme etiketi için HTTP 302 yönlendirmesini kodlanmış URL'ye göndermeye yönlendirmek istemesi durumunda belirtebileceği URL kodlu bir dize. Bu, Google'ın iş ortaklarına yapılan zincirleme bir çağrıda en öne yerleştirilmesine olanak tanır. Bu özellik, google_hm olmadan veya google_cm ile belirtilirse hataya neden olur.
google_ula Kullanıcıyı mevcut bir kullanıcı listesine eklemek için kullanılan dize. Değerin beklenen biçimi userlistid[,timestamp]:
  • userlistid: Tek bir sayısal kullanıcı listesi kimliği.
  • timestamp: POSIX biçiminde isteğe bağlı bir zaman damgasıdır. Kullanıcının kullanıcı listesine ne zaman eklendiğini gösterir.

Bu URL parametresi, kullanıcının birden fazla listeye eklenmesi için tekrarlanabilir.
gdpr İsteğin, veri kullanımına ilişkin GDPR kısıtlamalarına tabi olduğunu gösterir. Daha fazla bilgi için AB kullanıcı rızası şartları veya Çerez eşleme uygunluğu üzerindeki etki başlıklı makaleyi inceleyin. Bu makaleler, Yetkili Alıcılar IAB TCF 2.0 sürümü dokümanlarında yer almaktadır.

Örnek: gdpr=1
gdpr_consent Son kullanıcı iznini temsil eden bir TC dizesi. Daha fazla bilgi için AB kullanıcı izni şartları veya Yetkili Alıcılar IAB TCF 2.0 sürümü dokümanlarındaki TC dizesi nasıl iletilecek? başlıklı makaleyi inceleyin.
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, önceki 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ştirme için ayrıldığından ve parametrelerin sıralamasının korunacağı garanti edilmediğinden yoksayılacağını unutmayın. Teklif veren tarafından tanımlanan parametreleri içeren bir eşleşme 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, bir teklif verenin hesabı için yapılandırılan temel çerez eşleştirme URL'sinden oluşturulur. Bu URL, eşleşme etiketinde belirtilenlere bağlı olarak google_ ve teklif veren tarafından tanımlanan parametreleri içerir. Aşağıdaki google_ yanıt parametreleri tanımlanır:

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

Genel istek hatasını gösteren bir tam sayı değeri. Yanıt alındığında herhangi bir işlem yapılmadığı ve diğer google_ yanıt parametrelerinin ayarlanmadığı anlaşılır. Desteklenen hata değerleri şunlardır:

  • 1: Kullanıcının Google çerezi var ancak bu çerez kullanılarak yapılan izlemeyi devre dışı bırakmış.
  • 2: Geçerli işlem belirtilmedi. Örneğin, işlem yapmayan bir istek alındı.
  • 3: Kullanıcının Google çerezi yok. Google, çerezi Çerez Eşleştirme Hizmeti aracılığıyla ayarlamaz.
  • 4: Çakışan işlemler belirtildi. Çakışan amaçları olduğundan, aynı istekte hem google_push hem de google_cm işaretlerini belirtmenize izin verilmez.
  • 5: Bir Google sunucusuna yönlendirmede, iki yönlü piksel eşleştirme isteğinin bir parçası olarak geçersiz bir google_push parametresi iletildi. Yönlendirmeniz, google_push değerini ilk piksel isteğinde size iletilen değerle aynı olacak şekilde ayarlamalıdır.
  • 6: Eşleşme 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 ayarlama girişimi yapıldı.
  • 10: google_redir parametresi, google_hm belirtilmeden kullanıldı veya google_cm'e ek olarak kullanıldı.
  • 15: İstek, Google'ın eşleşme tablosunun Google tarafından barındırılmasını zorunlu kıldığı bir bölgeden geliyor. Bu nedenle, bu yanıtta Google kullanıcı kimliği yer almaz.
google_hm

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

  • 1 - Yasaklandı: Müşterinin, barındırılan eşleşme tablosu girişlerine yazma erişimi yoktur.
  • 2 - Kod çözme hatası: Parametre değeri çözülemedi.
  • 3 - Yük çok uzun: Parametre değeri, 40 bayttan fazla veri olarak kod çözülmüş.
  • 4 - Dahili hata: Veriler depolanırken dahili bir hata oluştu.
  • 5 - Sınırlanmış: Bu yazma işlemi, sınırlama nedeniyle işlenmedi.
google_ula

Kullanıcı listesi ekleme işleminin durumu. İstek içinde birden fazla google_ula belirtilmişse tekrarlanır. Biçim şöyledir:
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 - Geçersiz 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 kapatıldı.
  • 10 - Dahili hata. Çerez Eşleştirme hizmetinde dahili bir hata oluştu. 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

Ayşe, tüm çerezlerin önbelleğini temizler. Ardından ExampleNews.com'un ana sayfasını ziyaret eder.

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

  1. ExampleNews.com oluşturulur ve Google'dan (Ad Manager) reklamlar çağrılır.
  2. Reklam birimi dinamik ayırmaya uygun olduğundan Google, Gerçek Zamanlı Teklif 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, 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. Açık artırmayı FinestDSP kazanır. Google, FinestDSP'nin reklamını ve eşleşme etiketini Jane'e yayınlar.
  6. Eşleşme etiketi, google_nid ve google_cm parametrelerini belirterek Google'ın çerez eşleştirme hizmetini çağırır.
  7. Çerez Eşleme Hizmeti, Jane'in Google çerezini okur ve Jane'in tarayıcısına, google_gid ve google_cver parametreleri ayarlanmış olarak FinestDSP'nin çerez eşleme URL'sine yönlendirme gönderir.
  8. Ayşe'nin tarayıcısı, FinestDSP'nin çerez eşleme 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ındaki Jane'in çerezini içeren yönlendirme isteğini işler. FinestDSP artık çerezlerinin google_gid ile eşlemesini eşleşme tablolarında saklayabilir.
  10. FinestDSP, yönlendirmeye görünmez bir 1x1 pikselle yanıt verir.
2. senaryo: Mevcut eşlemeye sahip kullanıcı

1. Senaryo'dan 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şme nasıl çalışır?

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

Tek yönlü çerez eşleştirme, çift yönlü iş akışına benzer ancak yalnızca Google'ın eşleşme tablosunu barındırıp dolduracak şekilde değiştirilmiştir. Bu, teklif verenin kendi eşleşme tablosunda Google kullanıcı kimliklerini barındırmasına izin verilmeyen durumlarda kullanılabilir. Bu akışı kullanmak için teklif verenlerin Google'ın eşleşme tablosunu barındırmasına izin vermesi, Google'ın çerez eşleştirme hizmetine yapılan isteklerde artık google_cm belirtmemesi ve sonuç olarak kendi eşleşme tablolarını doldurmak için google_gid almaması gerekir. Google bir kullanıcı için eşleşme oluşturduktan sonra teklif verenler, kendi çerez verilerini kullanarak bu kullanıcıları kullanıcı listelerine ekleyebilir. Benzer şekilde, bu kullanıcılarla ilgili teklif isteklerinde Google kullanıcı kimliği hariç tutulur ancak barındırılan eşleşme verileri dahil edilir. Gözden geçirilmiş iş akışının bir örneği aşağıdaki adımlarda özetlenmiştir.

1. adım: Teklif verenin çerez eşleme URL'sine yönlendirilen eşleşme etiketini yerleştirin

Bu akışı başlatmak için bir teklif veren, kullanıcının tarayıcısında oluşturulacak şekilde bir eşleşme etiketi yerleştirmelidir. Gizlilik kısıtlamaları olan bir ABD eyaletinden olmayan kullanıcıların iş akışından farklı olarak, 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ına yüklenirken teklif verenin çerez eşleştirme URL'sinden bir piksel istenir. Bu istek, HTTP üstbilgisinde çerezlerini içerir. Bu çerez, sonraki adım için ayıklanmalıdır.

Teklif verenin çerez eşleme uç noktası, web güvenli base64 kodlu çerez verileriyle doldurulmuş 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 üstbilgilerindeki 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ılı veya hatalı yönlendirmede 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 boyutunda şeffaf bir piksel yayınlar ve iş akışı burada sona erer. Sonraki teklif isteklerinde bu kullanıcı için gösterimler, teklif verenin BidRequest.user.buyeruid içindeki barındırılan eşleşme verilerini içerir. Ayrıca teklif verenler, belirttikleri barındırılan eşleşme verilerini kullanarak kullanıcı listelerini doldurabilir.

Aksi takdirde, bir hata oluşursa Google, teklif verenin çerez eşleştirme raporu URL'sine google_error parametresinde belirtilen hata nedeni ile birlikte bir yönlendirme 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 boyutunda şeffaf piksel sunar

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

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

Parametre Açıklama
google_nid Teklif veren hesabının ağ kimliği (NID). Bu kimlik, Bidders kaynağı aracılığıyla alınabilir.
google_sc Bu parametre kullanımdan kaldırılmıştır. Google'ın çerezini, kullanıcı için ayarlanmamışsa ayarlar. Parametrenin değeri yok sayılır ve atlanabilir. Parametrenin atlanması, çerez yoksa hataya neden olur.
google_no_sc Bu parametre kullanımdan kaldırılmıştır. Bu, Google'ın Çerez Eşleştirme Hizmeti'ne, kullanıcı için çerez yoksa çerez ayarlamaması gerektiğini 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ış URL. Belirtilen URL, hem hatalar hem de başarılı işlemler için google_error parametresiyle yönlendirmeler alır.
google_ula Kullanıcıyı mevcut bir kullanıcı listesine eklemek için kullanılan dize. Değerin beklenen biçimi userlistid[,timestamp]:
  • userlistid: Tek bir sayısal kullanıcı listesi kimliği.
  • timestamp: POSIX biçiminde isteğe bağlı bir zaman damgasıdır. Kullanıcının kullanıcı listesine ne zaman eklendiğini gösterir.

Bu URL parametresi, kullanıcının birden fazla listeye eklenmesi için tekrarlanabilir.
gdpr İsteğin, veri kullanımına ilişkin GDPR kısıtlamalarına tabi olduğunu gösterir. Daha fazla bilgi için AB kullanıcı rızası şartları veya Çerez eşleme uygunluğu üzerindeki etki başlıklı makaleyi inceleyin. Bu makaleler, Yetkili Alıcılar IAB TCF 2.0 sürümü dokümanlarında yer almaktadır.

Örnek: gdpr=1
gdpr_consent Son kullanıcı iznini temsil eden bir TC dizesi. Daha fazla bilgi için AB kullanıcı izni şartları veya Yetkili Alıcılar IAB TCF 2.0 sürümü dokümanlarındaki TC dizesi nasıl iletilecek? başlıklı makaleyi inceleyin.
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ı gösteren bir tam sayı değeri. Yanıt alındığında herhangi bir işlem yapılmadığı ve diğer google_ yanıt parametrelerinin ayarlanmadığı anlaşılır. Desteklenen hata değerleri şunlardır:

  • 1: Kullanıcının Google çerezi var ancak bu çerez kullanılarak yapılan izlemeyi devre dışı bırakmış.
  • 2: Geçerli işlem belirtilmedi. Örneğin, işlem yapmayan bir istek alındı.
  • 3: Kullanıcının Google çerezi yok. Google, çerezi Çerez Eşleştirme Hizmeti aracılığıyla ayarlamaz.
  • 4: Çakışan işlemler belirtildi. Çakışan amaçları olduğundan, aynı istekte hem google_push hem de google_cm işaretlerini belirtmenize izin verilmez.
  • 5: Bir Google sunucusuna yönlendirmede, iki yönlü piksel eşleştirme isteğinin bir parçası olarak geçersiz bir google_push parametresi iletildi. Yönlendirmeniz, google_push değerini ilk piksel isteğinde size iletilen değerle aynı olacak şekilde ayarlamalıdır.
  • 6: Eşleşme 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 ayarlama girişimi yapıldı.
  • 10: google_redir parametresi, google_hm belirtilmeden kullanıldı veya google_cm'e ek olarak kullanıldı.
  • 15: İstek, Google'ın eşleşme tablosunun Google tarafından barındırılmasını zorunlu kıldığı bir bölgeden geliyor. Bu nedenle, bu yanıtta Google kullanıcı kimliği yer almaz.

Google tarafından başlatılan: Çift Yönlü Piksel Eşleme

Çift yönlü piksel eşleştirme, Google'ın çerez eşleştirme hizmetine yönelik bir iş akışıdır. Bu iş akışında Google, bir Google kullanıcı kimliğini gerçek zamanlı teklif verme açık artırmasının kazananı dışındaki algoritmik olarak seçilmiş bir teklif sahibiyle eşleştirmeye çalışır. 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 işlem, hem Google'ın hem de teklif verenin belirli bir kullanıcıyla eşleşme tablosunu doldurmasına olanak tanır. Aşağıda bu iş akışına bir örnek verilmiştir.

1. adım: Google, 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çilmiş 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şleme 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 istekleri alan teklif verenlerin, aşağıdaki şekilde yapılandırılmış bir Google Çerez Eşleştirme Hizmeti yönlendirmesiyle 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 benzediğini unutmayın. Piksel eşleştirme işleminde google_cm parametresinin yerini google_push parametresi alır ve 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 ek işlemleri gerçekleştirir. Son olarak, Google 1x1 boyutunda şeffaf bir pikselle yanıt verir.

Piksel eşleme iş akışı şeması

Bu 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 listelenmiştir.

Google eşleşme etiketi isteği parametreleri

Parametre Açıklama
google_gid Google kullanıcı kimliği. Gizlilik kısıtlamaları olan bir ABD eyaletinden olmayan kullanıcılar için bu değer 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 [AB kullanıcı rızası şartları](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) veya [Yetkili Alıcılar IAB TCF 2.0 dokümanlarındaki](//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ın ağ kimliği (NID). Bu kimlik, Bidders kaynağı aracılığıyla alınabilir.
google_push Bu yönlendirmenin Pixel eşleştirme iş akışını tamamladığını gösterir. Burada, ilgili Google eşleşme etiketinin değeri 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 dize. Değerin beklenen biçimi userlistid[,timestamp]:
  • userlistid: Tek bir sayısal kullanıcı listesi kimliği.
  • timestamp: POSIX biçiminde isteğe bağlı bir zaman damgasıdır. Kullanıcının kullanıcı listesine ne zaman eklendiğini gösterir.

Bu URL parametresi, kullanıcının birden fazla listeye eklenmesi için tekrarlanabilir.
gdpr_consent Son kullanıcı iznini temsil eden bir TC dizesi. Daha fazla bilgi için [AB kullanıcı rızası şartları](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) bölümüne veya [Authorized Buyers IAB TCF v2.0 dokümanlarındaki](//support.google.com/authorizedbuyers/answer/9789378) **TC dizesi nasıl iletilecek?** bölümüne bakın.

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

Tek yönlü piksel eşleme, çift yönlü iş akışından farklı olarak Google'ın eşleşme etiketi, Google kullanıcı kimliğini belirten bir parametre içermez ancak Google tarafından barındırılan bir eşleşme tablosunu doldurmaya devam eder. Bu özellik, teklif verenin kendi eşleşme tablosunda Google kullanıcı kimliklerini barındırmasına izin verilmeyen durumlarda kullanılabilir. Revize edilen iş akışının bir örneği aşağıdaki adımlarda özetlenmiştir.

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

Google, algoritmik olarak seçilen bir teklif veren için eşleşme etiketi yerleştirir. Eşleşme etiketinde google_push parametresi bulunuyor. 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 çerez 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 URL, HTTP üst bilgilerinde teklif verenin çerezini içerir.

Teklif verenin çerez eşleme uç noktası, web güvenli base64 kodlu çerez verileriyle doldurulmuş 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 üstbilgilerindeki Google çerezine ek olarak, belirttiğiniz parametreleri içeren bir yönlendirme alır. İşlem başarılı olursa sonraki teklif isteklerinde bu kullanıcının gösterimleri, BidRequest.user.buyeruid 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 kullanıcı listelerini de doldurabilir.

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

Open Bidding, exchange'lerin bir Google kullanıcı kimliğini ç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ımcısı (CMA), borsaların kendi teklif verenleriyle eşleşme tabloları oluşturmasını sağlayan ek bir özelliktir.

  1. Google, bir reklam yerleştirirken algoritmik olarak katılımcı bir borsa 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şleşme etiketi, borsa Cookie Matching URL'sinin bir piksel isteği almasına neden olur.

  3. Borsanın çerez eşleme uç noktası isteği alır. Burada, kendi çerez eşleme hizmeti, kullanıcı kimliğini teklif verenlerinden biriyle eşlemekten sorumludur. Aşağıdaki şemada, borsa çerez eşleştirme hizmeti, kullanıcının tarayıcısına teklif verenlerden birinin uç noktasına yönlendirme yaparak yanıt verir.
  4. Teklif veren, isteği ve exchange tarafından belirtilen, kullanıcı kimliğini çerezleriyle eşleştirmek için kullanılan tüm parametreleri alır.

Kısıtlamalar

Yeni eşleşme isteklerinin sıklığını sınırlama

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

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

Piksel eşleştirme iş akışını kullanan teklif verenlerin, gelen tüm piksel eşleştirme isteklerine google_push parametresini içeren bir yanıtla karşılık vermesi beklenir. Bu sayede Google, kullanımı izleyerek politikaları zorunlu kılabilir. Bir teklif verenin yanıt oranı %90'dan düşükse Google, hesabına gönderilen piksel eşleştirme isteklerinin sayısını sınırlar.

HTTPS uç noktaları kullanma

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

HTTPS üzerinden size gönderilen bir Pixel eşleştirme isteğine yanıt verirken HTTPS üzerinden çerez eşleştirme hizmetine yönlendirmeniz gerekir. Aynı şekilde, teklif verenlere yönlendiren bir çerez eşleştirme yardım uç noktası da HTTPS kullanmalıdır. Google'a 2 dakikada birden daha sık HTTP üzerinden istek gönderirseniz hesabınıza gönderilen eşleşme isteği sayısı kısıtlanır.

Google'ın AB kullanıcı rızası politikasına tabi olan çerez eşleştirme isteklerinde son kullanıcı izni belirtilmelidir. Bu tür isteklerde, iznin aşağıdaki yöntemlerden biri kullanılarak alındığı belirtilmelidir:

Ö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 eyaletinden olmadığı varsayılır.

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

Bir teklif veren, eşleme etiketinde yalnızca google_nid ve google_cm parametrelerini sağlayarak kendi eşleme tablosunu doldurmak için çerez eşleme iş akışını kullanabilir. Bu durum şö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ı olursa 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

Çerez eşleştirme işlemi, kullanıcının Google çerezi olmadığı için başarısız olursa yanıt şu şekilde 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ışıyla ilgili olası hata kodları hakkında daha fazla bilgi edinmek için yönlendirme URL'si parametreleri başlıklı makaleyi inceleyin.

Tek kullanıcılı listeye ekleme

google_ula parametresi, kullanıcının belirli bir kimliğe sahip kullanıcı listesine eklenmesi 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, tam ç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. Çerez eşleştirme hizmetini çağırmayla ilgili kısıtlamalar hakkında daha fazla bilgi edinin. İlgili eşleşme 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'si google_error parametresini içerir:

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

Kullanıcının listeye eklenmesiyle ilgili özel bir hata varsa yönlendirmede google_ula alırsınız. Bu parametre, ilgili eşleşme etiketi parametresinin aksine, işlemin başarılı olduğunu belirtmek için zaman damgasının yerine bir durum kodu kullanır. Örneğin, teklif veren hesabının belirtilen kullanıcı listesine erişimi olmadığı için istek başarısız olduysa 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 şu şekilde 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 bildirilir:

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

Önceki yönlendirmede, 45678 kimlikli kullanıcı listesi için işlemin başarılı olduğunu ancak teklif verenin erişim izni olmadığı için 12345 kimlikli kullanıcı listesi için işlemin başarısız olduğunu görüyoruz.

Çerez eşleme işlemini gerçekleştirmek ve kullanıcıyı tek bir istekte kullanıcı listesine eklemek için teklif verenin eşleme etiketi google_cm ve google_ula değerlerini 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'yi 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

Google tarafından barındırılan bir maç tablosunda maç depolama

Bir teklif veren, çerez verilerini Google tarafından barındırılan bir eşleşme tablosunda depolamak istiyorsa ve kendi eşleşme tablosunda Google kullanıcı kimliğiyle eşleşme depolamak istemiyorsa eşleşme etiketi google_hm parametresini içermelidir. Bu parametrenin değeri, web açısından güvenli Base64 kodlu bir dize olmalıdır. Teklif verenin kodlanmamış çerez verilerinin Cookie number 1! olduğu bir kullanıcı için kodlanmış değer Q29va2llIG51bWJlciAxIQ== olur ve 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şleşme etiketi google_cm içermediği ve google_hm başarılı yanıtlara dahil edilmediği için google_gid parametresi yönlendirmede yer almıyor. Bu kullanıcı için gelecekteki gösterim teklif isteklerinde teklif veren, barındırılan eşleşme verilerini BidRequest.user.buyeruid içinde alır.

Teklif veren bunun yerine google_hm değerinin base64 ile kodlanmadığı bir eşleşme etiketi kullandıysa (ör. chocolate_chunk!) yönlendirme URL'si aşağıdaki gibi görünebilir:

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

Önceki yönlendirme URL'si, google_hm değerini 2 olarak içeriyor. Bu durum, değerin kodu çözülemediği için işlemin başarısız olduğunu gösteriyor.

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ştirmek ve 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 ve aşağıdaki gibi bir eşleşme etiketi oluşturulur:

<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

Yönlendirme alındığında teklif veren, 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ı olduğunu belirleyebilirler. Sonuç olarak, teklif verenin belirtilen kullanıcı listesi kimliğini hedeflemek için yapılandırdığı tüm ön hedeflemeler artık teklif verenin kullanıcıdan gelen gösterimler için teklif istekleri almasına neden olacak. Aynı şekilde, bu teklif isteklerinde teklif veren, barındırılan eşleşme verilerini BidRequest.user.buyeruid içinde alır.