Ç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ında kullanabilecekleri tüm varyasyonlar açıklanmaktadır.

Kavramlar

Çerez Eşleştirme nedir?

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 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 isteğinde bulunan 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 Kullanıcı Kimliği arasındaki ilişkilendirmenin oluşturulmasını ve sürdürülmesini kolaylaştırır ve ayrıca, kullanıcı listelerinin doldurulmasına 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 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 kodlu 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ı Kimlikleri 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şleştirme Ağ Kimliği (NID): Çerez Eşleştirme ve diğer ilgili işlemler için teklif veren hesabını benzersiz şekilde tanımlayan bir dize kimliği.
• Çerez Eşleştirme URL'si: Çerez Eşleştirme iş akışlarının bir parçası olarak gelen istekleri kabul edecek ve işleyecek bir uç noktanın temel URL'si. Teklif verenler, Çerez Eşleştirme iş akışlarında bu URL'ye iletilen parametrelerin sıralamasını kontrol etmek için makrolar bu URL'ye 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 Desteği URL'si: Çerez Eşleştirme Desteği iş akışını uygulayan exchange'ler için 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 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.

Çerez eşleştirme makroları

Desteklenen Çerez Eşleştirme iş akışlarının herhangi birinde, teklif verenin Çerez Eşleştirme URL'sine genellikle garanti edilmeyen bir siparişe eklenen 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 ö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 eşleşme isteği gönderdiğinde, istek aşağıdakine benzer bir ş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

Çerez Eşleştirme Hizmeti iş akışları

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

Teklif veren tarafından başlatılan: İki yönlü çerez eşleştirme

İ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ği'ni 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ğini ve sürüm numarasını belirten sorgu parametreleri içerir. Teklif veren, çerezini de istek üstbilgilerine dahil edilmiş olarak alır. Uygulamada, https://ad.network.com/pixel olarak belirtilen bir çerez eşleştirme URL'si için yukarıda görüldüğü gibi 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 veya kullanımdan kaldırılan Google GZT protokolündeki BidRequest.google_user_id aracılığıyla belirtilen değerlere karşılık gelir.

google_cver öğesinde belirtilen sürüm, Google Kullanıcı Kimliği'nin sayısal sürüm numarasını belirtir. 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 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, ç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 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 resim yayınlayarak yanıt vermeli veya alternatif olarak HTTP 204 İçerik Yok yanıtı döndürmelidir.

Çerez eşleştirme iş akışı diyagramı

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

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:

Çerez eşleme iş akışı örnek senaryoları

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. Daha sonra ExampleNews.com'un ana sayfasını ziyaret ederler.

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

1. OrnekNews.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ştirme 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ş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 pikselle yanıt verir.

2. senaryo: Mevcut eşlemeye sahip kullanıcı

Senaryo 1'den bir hafta sonra Jane, ExampleNews.com'u tekrar ziyaret eder. Jale'nin makinesinde hem teklif veren hem de Ad Manager çerezleri olduğuna göre, eşleştirmenin işleyiş şekli şöyledir.

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 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 mantığı, çerezle ilişkilendirilen bilgilere dayanarak gösterim için bir 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.

Teklif veren tarafından başlatılan: Tek Yönlü Çerez Eşleştirme

Tek Yönlü Çerez Eşleştirme, Çift Yönlü iş akışına benzer. Ancak bu işlemin yalnızca Google'ın bir eşleşme tablosunu barındırıp dolduracağı şekilde değiştirilmesi gerekir. Bu özellik, teklif verenin Google Kullanıcı Kimliklerini kendi eşleşme tablosunda barındırmasına izin verilmediği 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.

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

Bu akışı başlatmak için teklif verenin, kullanıcının tarayıcısında oluşturulacak bir eşleşme etiketi 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, 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, sonraki adım için ayıklanacak olan HTTP başlığında çerezini içerir.

2. Adım: Google'ın Çerez Eşleştirme hizmetine yönlendirin

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

3. Adım: Kullanıcının tarayıcısı Google'ın Çerez Eşleştirme hizmetine yönlendirilir

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 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" />

5. Adım: Kullanıcının tarayıcısı, teklif verenin Çerez Eşleme Raporu URL'sine yönlendirilir.

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 çerez eşleme iş akışı şeması

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.

Google'ın Çerez Eşleme hizmetine teklif veren yönlendirmesi için URL parametreleri

Google'ın teklif verenin çerez eşleme raporu URL'sine yönlendirmesi için URL parametreleri

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" />

2. Adım: Teklif veren, Google'ın Çerez Eşleştirme Hizmeti URL'sine yönlendirme yaparak yanıt vermelidir

Piksel eşleştirme istekleri alan teklif verenlerin, aşağıdaki şekilde yapılandırılan Google Çerez Eşleştirme Hizmeti'ne 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 üzerinden istenen ek işlemleri işler. Son olarak Google, 1x1 şeffaf pikselle yanıt verir.

Piksel Eşleştirme iş akışı şeması

Bu iş akışı, isteklerin ve yanıtların bir okla temsil edildiğ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

Teklif veren piksel eşleme yönlendirme parametreleri

Google Tarafından Başlatılan: Tek Yönlü Piksel Eşleştirme

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ç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.

3. Adım: Google'ın Çerez Eşleştirme Hizmeti'ne yönlendirme

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

4. adım: Kullanıcının tarayıcısı Google'ın Çerez Eşleştirme hizmetine yönlendirilir

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.

Çerez Eşleştirme Yardımı

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.

Cookie Match Assist nasıl çalışır?

1. Google, reklam yerleştirirken katılımcı exchange'i algoritmik olarak seçer ve aşağıdaki yapıya sahip bir Cookie Match Assist 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şleştirme 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 dakikada bir defadan daha sık istek gönderirseniz hesabınıza gönderilen eşleşme isteklerinin sayısı kısıtlanır.

AB kullanıcı rızası şartları

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 veren, eşleşme etiketinde yalnızca google_nid ve google_cm parametrelerini sağlayarak kendi eşleşme tablosunu 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şleştirme iş akışında olası hata kodları hakkında daha fazla bilgi edinmek için yönlendirme URL'si parametreleri bölümüne bakın.

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. Karşılık gelen eşleşme etiketi şöyle 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 bulunur:

• 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 olur:

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

Birden fazla kullanıcı listesine ekle

Teklif verenler, eşleşme etiketine birden çok 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 bir 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ştirme iş akışını adım adım öğrenin ve kullanıcı listesine ekleyin

Ç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

Teklif veren, çerez verilerini Google tarafından barındırılan bir eşleşme tablosunda depolamak istiyor ve eşleşmeyi kendi eşleşme tablosunda Google Kullanıcı Kimliği ile depolamak istemiyorsa eşleşme etiketinde google_hm parametresi bulunmalıdır. Buradaki değer, web 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. 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 ve 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 özelliğinde belirtilen Google Kullanıcı Kimliği'ni, eşleşme 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, OpenRTB için BidRequest.user.buyeruid veya desteği sonlandırılmış Google GZT protokolü için BidRequest.hosted_match_data içinde barındırılan eşleşme verilerini alır.