Çerez Eşleştirme, çerezinizi (örneğin, web sitenizde gezinen bir kullanıcının kimliğini) teklif verene özel Google Kullanıcı Kimliği ile eşleştirmenizi ve daha etkili teklif 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ın yanı sıra farklı Çerez Eşleştirme iş akışları ve belirli kullanım alanları için bunların çeşitleri de açıklanmaktadır.
Kavramlar
Çerez Eşleştirme nedir?
Alan sahipleri genellikle çerezlerinin içeriğini, sitelerine göz atan kullanıcılar için ayarlar. Bu çerezler, söz konusu alan adındaki kullanıcıları tanımlamak için kullanılır. İki alan adı sahibi bu verilerin paylaşılmasını normalde kabul etse bile, internet tarayıcılarının güvenlik modeli, birinin başka bir alan adı tarafından oluşturulan çerezi okumasını kısıtlar.
Dijital reklamcılık bağlamında Google, doubleclick.net
alanına ait çerezleri olan kullanıcıları tespit eder ve Gerçek Zamanlı Teklif Verme'ye katılan teklif verenlerin reklam göstermek istedikleri bazı kullanıcı gruplarını tanımladıkları kendi alanları 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ı belirleyebilir. Kendi çerez verilerini veya teklif isteğinde doubleclick.net
çerezinin şifrelenmiş bir biçimi olan teklif verene özel Google Kullanıcı Kimliğini alır.
Bu kılavuzda açıklanan çerez eşleştirme hizmeti, teklif verenin çerezi ile Google User-ID arasındaki ilişkilendirmenin oluşturulmasını ve korunmasını kolaylaştırır. Ayrıca, kullanıcı listelerinin doldurulmasına da olanak tanır.
Eşleşme tabloları
Eşleşme tablosu, bir kimliği veya başka verileri bir alandan diğerine eşlemek için kullanılabilir. Teklif verenler, belirli bir kullanıcıya ait çerezi kullanıcının Google Kullanıcı Kimliği ile eşleyerek kendi eşleşme tablolarını doldurmak veya Google tarafından barındırılan bir eşleşme tablosunu doldurmak için Çerez Eşleştirme Hizmeti'ni kullanabilir. Eşleşme tabloları, teklif verenin teklif veren uygulamasının gösterimin gösterildiği kullanıcıya ait çerez verilerine erişmesi için gereklidir.
Google tarafından barındırılan eşleşme tabloları
Daha kolay bakım, gecikme iyileştirmeleri ve belirli bölgelerdeki kullanıcılarla ilgili verileri eşleştirme erişimi için Google'ın eşleşme tablonuzu barındırmasına izin vermeniz önerilir. Bu işlem, belirli bir kullanıcının Google User-ID'siyle eşlenecek, web için güvenli, base64 kodlu bir dize (bundan sonra barındırılan eşleşme verileri olarak adlandırılacak) belirtmenizi sağlar. Eşleşme oluşturulduktan sonra, aşağıdaki şekillerde kullanılabilir:
Gerçek Zamanlı Teklif Verme: Google, kullanıcıyla ilişkili gösterimler için daha sonraki teklif isteklerinde, kullanıcının Google Kullanıcı Kimliğiyle eşleştirdiğiniz barındırılan eşleşme verilerini size gönderir. Teklif uç noktanız Google'ın 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. Google'ın OpenRTB uygulamasındaBidRequest.user.buyeruid
, bu verileri web için güvenli, base64 kodlu bir dize olarak döndürür.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ın alaka düzeyi daha düşük gösterimleri elemek için kullanılabilir.
Kullanıcı listeleri
Kullanıcı listeleri, Gerçek Zamanlı Teklif Verme API ile oluşturulabilir ve yönetilebilir. Oluşturulduktan sonra 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şlayın
Çerez Eşleştirmeyi kullanmaya başlamak için belirli iş akışlarını etkinleştirebilecek ve aşağıdakileri yapılandırmanıza yardımcı olabilecek Teknik Hesap Yöneticinizle iletişime geçmeniz gerekir:
- Ç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 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 kendisine 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, reklamlarla birlikte sunulabilir 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 üzerinden 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 olması durumunda 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 Çerez Eşleştirme URL'sinin saniyede bir alabileceği maksimum istek sayısıdır. Bunun amacı CMA isteklerinin, isteklerle exchange'in sunucularına aşırı yüklenmesini önlemektir.
Çerez eşleştirme makroları
Desteklenen Çerez Eşleştirme iş akışlarının herhangi birinde, teklif verenin Çerez Eşleme URL'sine genellikle garanti edilmeyen bir sıralamaya eklenmiş parametreler bulunur. Tutarlı parametre sıralaması gerektiren entegrasyonlara sahip teklif verenler, yerleşimlerini garanti etmek için Çerez Eşleştirme URL'lerine makrolar 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%%
biçiminde bir veya daha fazla makro içerecek şekilde yapılandırabilir. Desteklenen makrolar ve genişletilmiş değerleri:
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
Teklif veren, https://user.bidder.com.cookies
adresinde barındırılan bir uç noktayla çerez eşleştirme entegrasyonuna sahiptir ve uygulaması, Pixel Eşleştirme parametrelerine ek olarak şu sırayla önceden ayarlanmış teklif veren tarafından tanımlanan parametreler gerektirir: google_push
, google_gid
, google_cver
ve google_error
. Teklif veren, Çerez Eşleştirme URL'sini şu şekilde 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 eşleşme isteği gönderdiğinde 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
Ç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 veren tarafından başlatılan iş akışını ifade eder. Bu iş akışı, kullanıcının tarayıcısına kullanı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ışının basit bir örneğini görebilirsiniz.
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. Google Kullanıcı Kimliği'ni teklif verene yalnızca döndüren basit bir eşleşme etiketi aşağıdaki gibi yapılandırılabilir:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />
Farklı kullanım alanlarını karşılamak için eşleşme etiketine ekleyebileceğiniz ek parametreler vardır. Bu parametreler hakkında daha fazla bilgi edinmek için Eşleme Etiketi URL Parametreleri bölümüne bakın.
2. Adım: Google, eşleşme verilerini de içeren yönlendirme ile yanıt verir
Eşleşme etiketi, Google'ın Çerez Eşleştirme Hizmeti'nin 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önlendirmesi 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ına dahil edilen çerezini alır. Pratikte, https://ad.network.com/pixel
olarak belirtilen bir çerez eşleştirme URL'si için basit eşleşme etiketinin yukarıda görüldüğü gibi yönlendirme URL'si şöyle görünebilir:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
google_gid
parametresi üzerinden iletilen Google Kullanıcı Kimliği, web için güvenli, base64 olarak kodlanmış, doldurulmamış bir dizedir. Eşleşme tablosu barındırmayı seçen teklif verenlerin, Çerez Eşleştirme Hizmeti tarafından döndürülen dizeyi tam olarak depolamaları önerilir. Sonraki teklif isteklerinde bu, Google'ın GZT protokolünde BidRequest.google_user_id
veya Google'ın OpenRTB uygulamasında 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ı belirtir. Belirli bir kullanıcının Google User-ID'si nadiren değişir ve bu değerden sonra 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 pikselle yanıt verir
Teklif veren, birinci adımda belirttiği parametreleri ve Google'ın ikinci adımda sağladığı parametreleri içeren çerez eşleştirme URL'sine bir yönlendirme alır. Ayrıca, çerezlerini HTTP üstbilgilerinde de alırlar. İşlem başarılı olursa kendi eşleşme tablosunu barındıran teklif veren, çerezini yanıta dahil edilen Google Kullanıcı Kimliği ile eşleştirebilir. Teklif verenlerin, Çerez Eşleştirme Hizmeti tarafından döndürülen dizeyi tam olarak depolaması önerilir.
İşlem başarısız olduysa teklif veren, yönlendirmede bir google_error
parametresi alır. Bu, oluşan belirli bir hatayı tanımlayan farklı hata durumlarına karşılık gelen sayısal bir değerdir. Olası hata değerleri hakkında daha fazla bilgiyi buradan edinebilirsiniz.
Bir hata alırsanız yeni bir eşleşme etiketi yerleştirerek bu kullanıcı için tekrar eşlemeyi deneyebilirsiniz.
Teklif veren, her zaman 1x1 görünmez piksel resim yayınlamalı veya alternatif olarak HTTP 204
İçerik Yok yanıtı döndürmelidir.
Çerez Eşleştirme iş akışı şeması
Bu iş akışı, aşağıdaki şemayla gösterilmiştir. Bu şemada istekler ve yanıtlar okla, bunlara eşlik eden veri öğeleri ise parantez içinde listelenmiştir.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching.png?authuser=7&hl=tr)
Etiket URL Parametrelerini Eşleştirme
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 işlemi yapması gerektiğini belirtir. Parametre değeri yoksayılır ve atlanabilir. |
google_sc |
Bu parametre kullanımdan kaldırılmıştır. Kullanıcı için Google çerezi yoksa bu çerezi ayarlar. Parametre değeri yoksayılır ve atlanabilir. Çerez yoksa parametrenin atlanması hata verir. |
google_no_sc |
Bu parametre kullanımdan kaldırılmıştır. Bu durum, Google'ın Çerez Eşleştirme Hizmeti'ne, kullanıcı için mevcut çerez yoksa bir çerez ayarlamaması gerektiğini belirtir. Parametre 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 (dolgu isteğe bağlıdır). Ham veriler 40 bayt veya daha az olmalıdır. Örneğin, |
google_redir |
Teklif verenin, Google'ı bu eşleşme etiketi için kodlanmış URL'ye HTTP 302 yönlendirmesini göndermeye yönlendirmek isteyip istemediği, belirtebileceği URL kodlu bir dizedir. Bu sayede Google, iş ortaklarına yönelik zincirleme bir çağrıda en ön sırada yer alır. google_hm olmadan veya google_cm ile belirtilirse bu durum hatayla sonuçlanır. |
google_ula |
Kullanıcıyı mevcut bir kullanıcı listesine eklemek için kullanılan dize. Değerin beklenen biçimi userlistid[,timestamp] şeklindedir:
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 belirtir. Daha ayrıntılı bilgi için aşağıdaki
AB kullanıcı rızası şartları veya
Authorized Buyers IAB TCF 2.0 sürümü dokümanlarında Çerez eşleştirme uygunluğu üzerindeki etkisi bölümüne bakın.
Örnek: |
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ı bölümüne veya Authorized Buyers IAB TCF 2.0 sürümü dokümanlarında TC dizesi nasıl iletilir? bölümüne 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ı belirtir.
İstek AB Kullanıcı Rızası Politikası'na tabi değilse veya istekte ( Örnek: |
Yukarıdaki parametrelere ek olarak, teklif verenler kendi parametrelerini belirtebilir. Bu parametreler, yönlendirme URL'sine parametre olarak eklenir. google_
önekiyle adlandırılmış teklif veren tanımlı parametrelerin yoksayılacağını unutmayın. Bunun nedeni, bu parametrelerin gelecekteki geliştirmeler için Google tarafından ayrılması ve parametre sıralamasının korunmasının garanti edilmediğidir. 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, teklif verenin hesabı için yapılandırılan temel Çerez Eşleştirme URL'sinden oluşturulur. Bu URL, eşleştirme 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. İstekte google_cm belirtildiyse ve istek başarılı olduysa ayarlayın. |
google_cver |
Çerez sürümü. İstekte google_cm belirtildiyse ve istek başarılı olduysa ayarlayın. |
google_error |
Genel istek hatasını gösteren bir tam sayı değeri. Alındığında, hiçbir işlem yapılmadığını ve başka
|
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 biridir:
|
google_ula |
Kullanıcı listesine ekleme işleminin durumu. İstekte birden fazla Örnek:
|
Çerez Eşleştirme 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 olabileceği açıklanmaktadır.
1. Senaryo: Kullanıcı çerezlerini temizler ve bir siteye göz atar
Jale, önbellekteki tüm çerezleri temizler. Daha sonra OrnekHaberler.com'un ana sayfasını ziyaret ederler.
Şunlar gerçekleşir:
- Orneki Haberler.com, Google'dan (Ad Manager) gelen reklamları oluşturur ve bunlara çağrı yapar.
- Reklam birimi dinamik ayırma için uygun olduğundan Google, teklif isteklerini Gerçek Zamanlı Teklif Verme hizmeti aracılığıyla FinestDSP ve diğer teklif verenlere gönderir.
- FinestDSP'nin teklif veren uygulaması, teklif isteğini alıp işler ve teklif yanıtını gönderir.
- Google, FinestDSP'nin eşleşme etiketine (piksel) sahip bir reklamı belirten yanıtı da dahil olmak üzere teklif verenlerden teklif yanıtları alır.
- Açık artırmayı FinestDSP kazandı. Google, FinestDSP'nin reklam ve eşleşme etiketini Jale'ye sunar.
- Eşleştirme etiketi,
google_nid
vegoogle_cm
parametrelerini belirterek Google'ın Çerez Eşleştirme Hizmeti'ni çağırır. - Çerez Eşleştirme Hizmeti, Ayşe'nin Google çerezini okur ve Zeynep'in tarayıcısına,
google_user_id
vegoogle_cver
parametreleri ayarlanmış olan FinestDSP'nin Çerez Eşleştirme URL'sine yönlendirme gönderir. - Jale'nin tarayıcısı, FinestDSP'nin Çerez Eşleştirme URL'sine yönlendirmeyi yükler.
- FinestDSP'nin çerez eşleştirme uç noktası, yönlendirme isteğini işler. Bu istek, Google tarafından ayarlanan URL parametrelerini ve HTTP üst bilgilerindeki Jale çerezini içerir. FinestDSP artık çerezlerinin eşleme tablosunda
google_user_id
ile eşlemesini depolayabilir. - FinestDSP, yönlendirmeye görünmez bir 1x1 pikselle yanıt verir.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie-matching-schematic.png?authuser=7&hl=tr)
2. Senaryo: Mevcut eşlemesi olan kullanıcı
1. Senaryodan bir hafta sonra, Jale ExampleNews.com'u tekrar ziyaret eder. Artık Jane'in makinesinde hem teklif veren hem de Ad Manager çerezleri olduğuna göre eşleştirme şu şekilde işler.
- Web sayfası oluşturulur ve Google'ın (Ad Manager) sayfada oluşturulacak reklamlar için istekte bulunmasına neden olur.
- Google, reklam açık artırması sırasında FinestDSP dahil olmak üzere geçerli teklif verenlere bir teklif isteği gönderir.
- FinestDSP,
google_user_id
gibi sinyaller dahil olmak üzere teklif isteğini alır. - FinestDSP, eşleşme tablosunda
google_user_id
için arama yapar ve bir hafta önce (1. Senaryoda) oluşturulan, Jale ile ilişkili çerezi bulur. - FinestDSP'nin teklif verme mantığı, çerezle ilişkili bilgilere göre gösterim için bir teklif verir ve açık artırmayı kazanır.
- Jale, FinestDSP'nin sahip olduğu bilgilere dayalı olarak, ilgi alanlarına göre uyarlanmış 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 benzerdir. Tek Yönlü Çerez Eşleştirme, eşleşme tablosunu yalnızca Google'ın barındırıp dolduracağı şekilde değiştirilir. Bu, teklif verenin kendi eşleşme tablosunda Google Kullanıcı Kimliklerini barındırmasına izin verilmeyen durumlarda kullanılabilir. Teklif verenler bu akışı kullanmak için Google'ın eşleşme tablosunu barındırmasına izin vermelidir, artık Google'ın Çerez Eşleştirme Hizmeti'ne yapılan isteklerde google_cm
belirtemez ve sonuç olarak kendi eşleşme tablosunu doldurmak için google_gid
alamaz. Google bir kullanıcı için eşleşme belirlediğinde, 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 bulunur. Düzeltilen iş akışına dair basit bir örnek aşağıdaki adımlarda özetlenmiştir.
1. Adım: Teklif verenin Çerez Eşleştirme URL'sine yönlendirilen eşleşme 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ı bulunan ABD eyaletlerinden olmayan kullanıcılar için 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şleştirme URL'si şöyle görünür:
<img src="https://ad.network.com/pixel" />
Kullanıcının tarayıcısında yükleme yaparken, teklif verenin Çerez Eşleştirme URL'sinden bir piksel ister. Bu istek, HTTP üstbilgisinde çerezini içerir. Bu çerez bir sonraki adım için ayıklanmalıdır.
2. Adım: Google'ın Çerez Eşleştirme hizmetine yönlendirme
Teklif verenin çerez eşleştirme uç noktası, web için 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
3. Adım: Kullanıcının tarayıcısı Google'ın Çerez Eşleştirme hizmetine yönlendirilir
Google, HTTP üst bilgilerinde Google'ın çerezine ek olarak, belirttiğiniz parametreleri içeren bir yönlendirme alır.
4. Adım: Rapor URL'si belirtilmişse Google, piksel değeri başarılı veya hata yönlendirmesi olduğunda sunar
Çerez eşleştirme işlemi başarılı olursa veya teklif verenin hesabı için bir Çerez Eşleşen Rapor 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, teklif verenin Google Protokolü için BidRequest.hosted_match_data
içinde veya Google'ın OpenRTB uygulaması için BidRequest.user.buyeruid
içinde barındırılan eşleşme verilerini içerir. Teklif verenler, kullanıcı listelerini belirttikleri barındırılan eşleşme verilerini kullanarak da doldurabilir.
Aksi takdirde Google, bir hata oluşursa teklif verenin Çerez Eşleştirme Raporu URL'sine google_error
parametresinde belirtilen hatanın nedeni ile birlikte bir yönlendirme gönderir. Teklif verenin Çerez Eşleştirme Raporu URL'si https://ad.network.com/report
ise yönlendirme URL'si şöyle 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şleştirme Raporu URL'sine yönlendirme yapar
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önlendirir. 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şleştirme iş akışı şeması
Gizlilik kısıtlamaları bulunan ABD eyaletlerindeki kullanıcılar için varsayılan iş akışı, aşağıdaki şemada gösterilmektedir. Bu şemada istekler ve yanıtlar okla, bunlara eşlik eden veri öğeleri parantez içinde listelenmiştir.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching_ca.png?authuser=7&hl=tr)
Google'ın Çerez Eşleştirme hizmetine teklif veren yönlendirmesi için 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_sc |
Bu parametre kullanımdan kaldırılmıştır. Kullanıcı için Google çerezi yoksa bu çerezi ayarlar. Parametre değeri yoksayılır ve atlanabilir. Çerez yoksa parametrenin atlanması hata verir. |
google_no_sc |
Bu parametre kullanımdan kaldırılmıştır. Bu durum, Google'ın Çerez Eşleştirme Hizmeti'ne, kullanıcı için mevcut çerez yoksa bir çerez ayarlamaması gerektiğini belirtir. Parametre 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] şeklindedir:
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 belirtir. Daha ayrıntılı bilgi için aşağıdaki
AB kullanıcı rızası şartları veya
Authorized Buyers IAB TCF 2.0 sürümü dokümanlarında Çerez eşleştirme uygunluğu üzerindeki etkisi bölümüne bakın.
Örnek: |
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ı bölümüne veya Authorized Buyers IAB TCF 2.0 sürümü dokümanlarında TC dizesi nasıl iletilir? bölümüne 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ı belirtir.
İstek AB Kullanıcı Rızası Politikası'na tabi değilse veya istekte ( Örnek: |
Teklif verenin Çerez Eşleştirme Raporu URL'sine Google yönlendirmesi için URL Parametreleri
Parametre | Açıklama |
---|---|
google_error |
Genel istek hatasını gösteren bir tam sayı değeri. Alındığında, hiçbir işlem yapılmadığını ve başka
|
Google Tarafından Başlatılan: Çift Yönlü Piksel Eşleştirme
Çift Yönlü Piksel Eşleştirme, Google'ın Çerez Eşleştirme Hizmeti için bir iş akışıdır. Google, Google kullanıcı kimliğini Gerçek Zamanlı Teklif Verme açık artırmasının kazananı dışında algoritmik olarak seçilen bir teklif verenle 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 sayede hem Google hem de teklif veren, belirli bir kullanıcıyla eşleşme tablosunu doldurabilir. Aşağıda bu iş akışının basit bir örneğini görebilirsiniz.
1. Adım: Google bir eşleşme etiketi yerleştirir
Katılımcı yayıncının sayfası kullanıcının tarayıcısında yüklendiğinde ve bu sayfadaki reklam alanı Google tarafından doldurulduğunda algoritmik olarak seçilen teklif verenden bir piksel isteyen eşleşme etiketi yerleştirilebilir. Google tarafından yerleştirilen Piksel Eşleştirme etiketi, teklif verenin Çerez Eşleştirme 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şleştirme URL'si için şu şekilde 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 ile yanıt vermelidir
Piksel eşleştirme istekleri alan teklif verenlerin, Google'ın Çerez Eşleştirme Hizmeti'ne aşağıdaki şekilde yapılandırılmış bir 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şleşme etiketinde kullanılan URL'ye benzer olduğunu unutmayın.
Pixel Eşleştirmede, google_cm
parametresinin yerini google_push
parametresi alır ve parametrenin değeri, istekte Google tarafından 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 pikselle yanıt verir.
Piksel Eşleştirme iş akışı şeması
Bu iş akışı, aşağıdaki şemayla gösterilmiştir. Bu şemada istekler ve yanıtlar okla, bunlara eşlik eden veri öğeleri ise parantez içinde listelenmiştir.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/pixel_matching.png?authuser=7&hl=tr)
Google eşleştirme etiketi istek parametreleri
Parametre | Açıklama |
---|---|
google_gid |
Google Kullanıcı Kimliği. Bu, gizlilik kısıtlamalarına sahip bir ABD eyaletinde olmayan kullanıcılar için her zaman Google'ın eşleşme etiketinde belirtilir. |
google_cver |
Çerez 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ı belirtir. Değer, teklif verenin yönlendirme yanıtında karşılık gelen parametre ile döndürülmelidir. |
Teklif Veren Pikseli 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 Piksel Eşleştirme iş akışını tamamladığını belirtir. İlgili 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 dize. Değerin beklenen biçimi userlistid[,timestamp] şeklindedir:
Bu URL parametresi, kullanıcıyı birden fazla listeye eklemek için tekrarlanabilir. |
Google Tarafından Başlatılan: Tek Yönlü Piksel Eşleştirme
Tek Yönlü Piksel Eşleştirme, Google'ın eşleşme etiketinin Google Kullanıcı Kimliği'ni belirten bir parametre içermemesi, ancak Google tarafından barındırılan bir eşleşme tablosunu doldurmaya devam etmesi açısından Çift Yönlü iş akışından farklıdır. Bu, teklif verenin kendi eşleşme tablosunda Google Kullanıcı Kimliklerini barındırmasına izin verilmediği durumlarda kullanılabilir. Gözden geçirilmiş 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 teklif veren için bir eşleşme etiketi yerleştirir. Eşleşme etiketi google_push
parametresini içerir. Aşağıda 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 Eşleştirme URL'sinden piksel ister
Kullanıcının tarayıcısı, HTTP üst bilgilerindeki teklif verenin çerezi dahil olmak üzere teklif verenin Çerez Eşleştirme URL'sinden bir piksel ister.
3. Adım: Google'ın Çerez Eşleştirme Hizmeti'ne yönlendirin
Teklif verenin çerez eşleştirme uç noktası, web için 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_push=PUSH_DATA
4. Adım: Kullanıcının tarayıcısı Google'ın Çerez Eşleştirme hizmetine yönlendirilir
Google, HTTP üst bilgilerinde Google'ın ç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, Google Protokolü için BidRequest.hosted_match_data
içinde teklif verenin barındırılan eşleşme verilerini veya Google'ın OpenRTB uygulaması için BidRequest.user.buyeruid
'yi içerir. Teklif verenler, kullanıcı listelerini belirttikleri barındırılan eşleşme verilerini kullanarak da doldurabilir.
Son olarak Google, kullanıcının tarayıcısına bir 1x1 şeffaf piksel döndürür.
Çerez Eşleştirme Desteği
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 Desteği (CMA), exchange'lerin kendi teklif verenleriyle eşleşme tabloları oluşturmalarını sağlayan ek bir özelliktir.
Çerez Eşleştirme Desteği'nin işleyiş şekli
Google, bir reklam yerleştirirken katılımcı bir exchange'i algoritmik olarak seçer ve aşağıdaki yapıya sahip bir Çerez Eşleştirme Desteği etiketi yerleştirir:
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
Google'ın CMA eşleşme etiketi, exchange'in Çerez Eşleştirme URL'sinin bir piksel isteği almasına neden olur.
- Exchange'in Çerez Eşleştirme uç noktası isteği alır. Bu durumda, kullanıcı kimliğinin teklif verenlerinden biriyle eşleştirilmesinden kendi çerez eşleştirme 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.
- Teklif veren, kullanıcı kimliğini çerezleriyle eşleştirmek için exchange tarafından belirtilen tüm parametrelerle birlikte isteği alır.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_match_assist_diagram.png?authuser=7&hl=tr)
Kısıtlamalar
Yeni eşleşmeler için isteklerin sıklığını sınırla
Teklif verenler, Google tarafından barındırılan eşleşme tablosunda yeni bir girişe sahip kullanıcılar için Çerez Eşleştirme hizmetine yapılan arama sayısını sınırlandırmaktan sorumludur. Barındırılan eşleşme tablosundaki bir giriş 14 gün içinde süresi dolmuş olarak kabul edilebilir. Bu süreden sonra giriş yenilenebilir.
Tüm pixel match isteklerine yanıt ver
Piksel Eşleştirme iş akışını kullanan teklif verenlerin, gelen tüm Pixel Match isteklerine google_push
parametresini içeren bir yanıtla yanıt vermesi beklenir. Bu sayede Google, kullanımı izleyerek politikaları zorunlu kılabilir. Teklif verenin yanıt oranı %90'ın altına düşerse Google, hesabına gönderilen Pixel Match isteklerinin sayısını kısıtlar.
HTTPS uç noktalarını kullanma
Tüm Çerez Eşleştirme iş akışlarında kullanılan uç noktaların HTTPS kullanması zorunludur.
HTTPS üzerinden size gönderilen bir Pixel Match isteğine yanıt verirken HTTPS üzerinden Çerez Eşleştirme Hizmeti'ne yönlendirme yapmanız gerekir. Benzer şekilde, teklif verenlere yönlendirme yapan bir Çerez Eşleştirme Desteği 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ı izni belirtilmelidir. Bu tür istekler, iznin aşağıdaki yöntemlerden biri kullanılarak toplandığını belirtmek için gerekir:
- TCF 2 sürümü: Bu,
gdpr
vegdpr_consent
parametrelerini içerir. Ayrıntılar için Authorized Buyers IAB TCF 2.0 sürümü dokümanlarına bakın. process_consent
: Teklif verenin gerekli kullanıcı iznini aldığına dair beyan.
Örnekler
Aşağıdaki örnekler, belirli hedeflere ulaşmak için Çerez Eşleştirme hizmetinin nasıl kullanılacağını göstermektedir. Aksi belirtilmedikçe, hakkında işlem yapılan kullanıcının gizlilik kısıtlamalarının bulunduğu bir ABD eyaletinden olmadığı varsayılır.
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. Şö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 ayarlanırsa 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 aşağıdaki gibi görünebilir:
https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
Kullanıcının Google çerezi olmadığından çerez eşleştirme işlemi 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şleştirme iş akışıyla ilgili olası hata kodları hakkında daha fazla bilgi edinmek için yönlendirme URL'si parametrelerine bakın.
Tek bir kullanıcı listesine ekle
Kullanıcıyı belirtilen kimliğe sahip kullanıcı listesine eklemek için teklif verenin eşleşme etiketinde google_ula
parametresi 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. Daha fazla teslimat için Çerez Eşleştirme Hizmeti'ni çağırmayla ilgili kısıtlamaları inceleyin. İlgili eşleşme etiketi aşağıdaki gibi 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 şöyle olur:
https://ad.network.com/pixel?google_ula=12345,0
Genel bir hata varsa (örneğin, kullanıcı için 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
alırsınız. İlgili eşleşme etiketi parametresinden farklı olarak bu özellik, işlemin başarılı olduğunu belirtmek için zaman damgasını bir durum koduyla değiştirir. Örneğin, teklif veren hesabının belirtilen kullanıcı listesine erişimi olmadığı için istek başarısız olursa yönlendirme URL'si şöyle olur:
https://ad.network.com/pixel?google_ula=12345,2
Birden fazla kullanıcı listesine ekleme
Teklif verenler, eşleme etiketine birden fazla google_ula
parametresi ekleyerek bir kullanıcının birden fazla kullanıcı listesine eklenmesi gerektiğini belirtebilir. Pratikte bu, aşağıdaki gibi görünebilir:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />
Her bir kullanıcı listesi için işlemin durumu, yönlendirmedeki farklı google_ula
parametreleriyle 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örüyoruz.
Çerez Eşleştirme iş akışını adım adım inceleyin ve kullanıcı listesine ekleyin
Çerez eşleştirme gerçekleştirmek ve kullanıcıyı tek bir istekte kullanıcı listesine eklemek için teklif verenin eşleşme etiketinde google_cm
ve google_ula
bulunmalıdır:
<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 işlem 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 eşleşme tablosunda eşleşme depolama
Teklif veren, çerez verilerini Google tarafından barındırılan bir eşleşme tablosunda depolamak istiyorsa ve Google Kullanıcı Kimliği ile eşleşmeyi kendi eşleşme tablosunda depolamayı amaçlamıyorsa eşleşme etiketi google_hm
parametresini içermelidir. Buradaki değerin, web için güvenli bir base64 kodlu dize olması gerekir. 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ştirme 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 şöyle olur:
https://cookie-monster.com/pixel
Eşleşme 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. Teklif veren, bu kullanıcının gelecekteki gösterim sayısına yönelik teklif isteklerinde barındırılan eşleşme verilerini Google'ın GZT protokolü için BidRequest.hosted_match_data
veya Google'ın OpenRTB uygulaması için BidRequest.user.buyeruid
içinde alacaktır.
Teklif veren bunun yerine google_hm
değerinin base64 olarak 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
Yukarıdaki yönlendirme URL'si google_hm
değerini 2
içeriyor. Bu durum, değerin kodu çözülemeyeceği için işlemin başarısız olduğunu gösterir.
Teklif veren ve Google tarafından barındırılan eşleşme tabloları (kullanıcı listeleri içeren)
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 her iki tabloyla da tek bir eşleşme etiketinin eşleşmesini ve kullanıcıyı belirli bir kullanıcı listesine eklemesini istiyorsa eşleşme etiketinin google_cm
, google_hm
ve google_ula
parametrelerini içermesi gerekir. Teklif verenin çerez verileri Cookie number 1!
ise kodlanmış değer Q29va2llIG51bWJlciAxIQ==
olur. Bu değer, 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
Yönlendirmeyi aldığında teklif veren, google_gid
politikasında belirtilen Google kullanıcı kimliğini 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ı belirleyebilirler. Sonuç olarak, teklif verenin belirtilen kullanıcı listesi kimliğini hedeflemek üzere yapılandırdığı tüm Ön Hedefleme, artık teklif verenin kullanıcıdan gösterimler için teklif istekleri almasına neden olacaktır. Benzer şekilde, bu teklif isteklerinde teklif veren, barındırılan eşleşme verilerini Google'ın GZT protokolü için BidRequest.hosted_match_data
veya Google'ın OpenRTB uygulaması için BidRequest.user.buyeruid
içinde alır.