Çerez Eşleştirme, çerezlerinizi eşleştirmenizi sağlayan bir özelliktir. örneğin, web sitenize göz atan bir kullanıcının kimliği ve buna karşılık gelen özel Google User-ID'si oluşturabilir ve daha fazla dönüşüm elde etmenize daha etkili teklif seçenekleri sunar. Bu kılavuzda, Çerez'de kullanılan kavramlar açıklanmaktadır Eşleştirme, farklı Çerez Eşleştirme iş akışları ve tüm varyasyonlar belirli kullanım durumlarında ortaya çıkabilir.
Kavramlar
Çerez Eşleştirme nedir?
Alan adı sahipleri genellikle çerezlerin içeriğini, web'e göz atan kullanıcılar için Bu hizmetler, söz konusu alandaki kullanıcıları tanımlamak için kullanılır. İki olsa bile alan adı sahipleri, bu veri alışverişinde güvenlik modelini bir tanesinin diğeri tarafından ayarlanan çerezleri okumasını kısıtlayan internet tarayıcıları alan.
Dijital reklamcılık bağlamında Google, kullanıcıları çerezlerle tespit eder.
doubleclick.net
alanına ait olanlar ve teklif verenler
Gerçek Zamanlı Teklif Verme'ye katılan kullanıcılar, kendi alanlarına
Reklam göstermek istedikleri bazı kullanıcı gruplarını belirleme. Çerez Eşleştirme
Teklif verenin çerezlerini Google çerezleriyle eşleştirmesini ve böylece
teklif isteğinde gönderilen bir gösterimin aşağıdakilerden biriyle ilişkili olup olmadığını
kendilerine ait çerez verilerini veya bir
anahtarının şifrelenmiş bir biçimi olan teklif verene özgü
Teklif isteğinde doubleclick.net
çerez bulunuyor.
Bu kılavuzda açıklanan çerez eşleştirme hizmeti, Google Analytics 4'te oluşturulan ve teklif verenin çerezi ile Google Merchant Center'ın ve aynı zamanda kullanıcı listelerinin doldurulmasına olanak tanır.
Eşleşme tabloları
Eşleşme tablosu, bir alandaki kimliği veya diğer verileri başka bir tane. Teklif verenler, Çerez Eşleştirme Hizmeti'ni kullanarak kendi alanlarını doldurmak için eşleme tablolarını görüntülemek için kullanıcının belirli bir kullanıcıya ait çerezini kullanıcının Google User-ID veya Google tarafından barındırılan bir eşleşme tablosunu doldurmak için kullanılır. Eşleşme tabloları, teklif verenin teklif veren başvurusunun kullanıcıya ait çerez verilerine erişmesi için gereklidir gösterimin gösterildiği anlamına gelir.
Google tarafından barındırılan eşleşme tabloları
Daha kolay bakım, gecikme iyileştirmeleri ve kullanıyorsanız, Google'ın web sitenizi veya oyununuzu eşleşme tablosunu kullanın. Bu, web güvenli base64 kodlu bir dize belirtmenizi sağlar: Bundan sonra barındırılan eşleşme verileri olarak adlandırılacaktır. Bu veriler, Belirli bir kullanıcının Google Kullanıcı Kimliği. Eşleşme oluşturulduktan sonra, aşağıdaki şekillerde kullanılır:
Gerçek Zamanlı Teklif Verme: Gösterimler için sonraki teklif isteklerinde bir izleme etkinliği kullanıyorsanız, Google size, tüm kullanıcılarınızın Google Kullanıcı Kimliği ile eşleştirilir. Teklif uç noktanız yapılandırıldıysa Google'ın GZT protokolünü kullanmanız gerekir. Bunu, kodu çözülmüş bayt olarak
BidRequest.hosted_match_data
alanına girin. Google'ın OpenRTB'sinde işlemi,BidRequest.user.buyeruid
bunu döndürecektir dize olarak kullanılabilir.Kullanıcı Listeleri: Kullanıcı listeleri doldurulabilir kullanıcı kimlikleri veya barındırılan eşleşme verileriyle eşleştirme yapabilirsiniz.
- Ön hedefleme: Ön hedeflemenizi yalnızca teklif istekleri alacak şekilde yapılandırabilirsiniz. barındıran eşleşme verilerini içerir. Bu yöntem, alaka düzeyi daha düşük olanları gösterim elde edersiniz.
Kullanıcı listeleri
Kullanıcı listeleri, Gerçek Zamanlı Teklif Verme API'si ile oluşturulup yönetilebilir. Oluşturulduktan sonra bu listeleri Çerez Eşleştirme iş akışlarıyla doldurabilirsiniz aşağıda açıklandığı şekilde veya Toplu Yükleme Aracı Hizmeti üzerinden gönderebilirsiniz.
Başlarken
Çerez Eşleştirme özelliğini kullanmaya başlamak için Belirli iş akışlarını etkinleştirebilecek ve size yardımcı olabilecek Teknik Hesap Yöneticisi aşağıdakileri yapılandırın:
- Çerez Eşleştirme Ağ Kimliği (NID): Benzersiz bir şekilde tanımlayan bir dize kimliği Çerez Eşleştirme ve diğer ilgili işlemler için teklif veren hesabı.
- Çerez Eşleştirme URL'si: Bir uç noktanın kabul edecek olan temel URL'si ve gelen istekleri Çerez Eşleştirme iş akışlarının bir parçası olarak ele alma. Teklif verenler, şu amaçla makro bu URL'ye yerleştirebilir: Çerez Eşleştirme iş akışlarında kendisine geçirilen parametrelerin sıralamasını kontrol etme.
- Eşleşme Etiketi: teklif veren tarafından başlatılan Çerez Eşleştirme iş akışı Bu, reklamlarla birlikte yayınlanabilir, veya reklamların dışındaki web mülklerine yerleştirilemez.
- Çerez Eşleştirme Raporu URL'si (isteğe bağlı): Tek Yönlü Çerez Eşleştirme İş Akışı, bu isteğe bağlı URL'lere ilgili çerezin hata ayrıntılarıyla bilgilendirileceği bir uç nokta eşleşmesi bir HTTP 302 yönlendirmesi üzerinden başarısız olur. Varsayılan olarak yanıtlar çerez eşleştirme işleminde bir hata varsa bu URL'ye gönderilir, teklif verenler yönlendirmenin her zaman gönderilmesini isteyebilir.
- Cookie Match Assist URL: Çerez Eşleşmesi Destek URL'si: Çerez Eşleştirme Desteği iş akışı için Gelen isteklere yanıt vermesi amaçlanan uç noktanın temel URL'si.
- Cookie Match Assist Kotası: Çerez Eşleştirme Desteği iş akışı için Çerez Eşleştirme URL'lerinin her gün alabileceği maksimum istek sayısı tıklayın. Bunun amacı, CMA isteklerinin istekleriyle değiştirebilirsiniz.
Çerez eşleştirme makroları
Desteklenen Çerez Eşleştirme iş akışlarından herhangi birinde teklif verenin Çerez Eşleştirme URL'si genellikle garanti edilmeyen siparişler. Tutarlılık gerektiren entegrasyonlara sahip teklif verenler Çerez Eşleştirme URL'lerine makrolar yerleştirilerek garanti verir.
Desteklenen makrolar
Teklif verenler, isterlerse Çerez Eşleştirme URL'lerini bir veya
%%GOOGLE_<PARAM_NAME>%%
veya
%%GOOGLE_<PARAM_NAME>_PAIR%%
. Desteklenen makrolar ve
genişletilmiş değerler ş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
Teklif verenin,
https://user.bidder.com.cookies
ve bunların uygulanması için
Piksel Eşleştirme'ye ek olarak teklif veren tarafından tanımlanan önceden ayarlanmış parametreler
parametreleri şu sıradadır: google_push
,
google_gid
, google_cver
ve
google_error
. Teklif veren, bunu,
Çerez Eşleştirme URL'si hedefi:
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 bu istek genişletilir aşağıdaki gibi bir değer ekleyebilirsiniz:
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 kullanım alanlarına uygun olmalıdır.
Teklif Veren: İki Yönlü Çerez Eşleştirme
Çift Yönlü Çerez Eşleştirme, teklif veren tarafından başlatılan iş akışını ifade eder. Burada Kullanıcının tarayıcısına, etiketi 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 bir 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şturur. Yalnızca şu sonucu döndüren basit bir eşleşme etiketi: teklif verene gönderilen Google User-ID aşağıdaki gibi yapılandırılabilir:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />
Tamamlamak için eşleşme etiketine ekleyebileceğiniz ek parametreler vardır farklı kullanım alanları. Bu parametreler hakkında daha fazla bilgi edinmek için Etiket URL Parametrelerini Eşleştir.
2. Adım: Google, eşleşme verileri dahil yönlendirme ile yanıt verir
Eşleştirme etiketi, Google'ın Çerez Eşleştirme Hizmeti'nin
kullanıcının tarayıcısından gelen bir istek. Bu durumda bir HTTP 302
teklif verenin Çerez Eşleştirme URL'sine yönlendirme. Yönlendirme,
URL'de Google Kullanıcı Kimliği'ni ve sürüm numarasını belirten parametreler ve
teklif veren, istek başlıklarında çerezini de alır. İçinde
alıştırma olarak, 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
takip etmek için:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
google_gid
parametresi üzerinden iletilen Google Kullanıcı Kimliği:
doldurulmamış web güvenli base64 kodlu
dize. Eşleşme tablosu barındırmayı seçen teklif verenlerin
Çerez Eşleştirme Hizmeti tarafından döndürülen dizenin aynısını saklar. Sonraki
bu, BidRequest.google_user_id
ile belirtilen değerlere karşılık gelir.
veya Google’ın GZT protokolünde BidRequest.user.id
OpenRTB uygulaması.
google_cver
politikasında belirtilen sürüm,
Google Kullanıcı Kimliği'nin sürüm numarası. Belirli bir kullanıcının Google Kullanıcı Kimliği
nadiren değişir, bundan sonra ise artar.
Google, eşleşme isteğinizi işlerken bir hatayla karşılaşırsa
Bunun yerine google_error
parametresi belirtilir.
3. Adım: Teklif veren, yönlendirmeyi işler ve pikselle yanıt verir
Teklif veren, çerez eşleştirme URL'sine aşağıdakileri içeren bir yönlendirme alır: parametreleri ile Google Ads'in ikinci adımdır. Ayrıca, çerezini HTTP üzerinden de alırlar. başlıklar. İşlem başarılı olduysa teklif veren kendi eşleşme tablosunu barındırır çerezini yanıtta yer alan Google Kullanıcı Kimliği ile eşleştirebilir. Evet teklif verenlerin, Çerez Eşleştirme tarafından döndürülen dizenin aynısını depolamasını öneririz. Hizmet.
İşlem başarısız olursa teklif veren google_error
alır
parametresinin değeridir. Bu, farklı bir kampanyaya karşılık gelen sayısal bir değerdir
hata durumu anlamına gelir. Öğrenebilirsiniz
Olası hata değerleri hakkında daha fazla bilgiye buradan ulaşabilirsiniz.
Hata alırsanız aşağıdakileri yaparak söz konusu kullanıcıyla tekrar eşleştirmeyi deneyebilirsiniz:
yeni bir eşleşme etiketi yerleştirme.
Teklif veren her zaman 1x1 görünmez piksel resim yayınlayarak yanıt vermelidir veya
alternatif olarak HTTP 204
İçerik Yok yanıtı döndürür.
Çerez Eşleştirme iş akışı şeması
Bu iş akışı aşağıdaki şemada gösterilmektedir; burada istekler ve yanıtlar ok işaretiyle gösterilir ve yanıtlarla ilişkili veri öğeleri parantez içinde listelenir.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching.png?authuser=0000&hl=tr)
Eşleşme Etiketi URL Parametreleri
Parametre | Açıklama |
---|---|
google_nid |
Teklif veren hesabının ağ kimliği (NID). Bu kimlik alınabilir Teklif verenler aracılığıyla gösterir. |
google_cm |
Google'ın Çerez Eşleştirme Hizmeti'ne gerçekleştirmesi gerektiğini belirtir çerez eşleştirmeyi kullanabilirsiniz. Parametrenin değeri yok sayılır ve atlandı. |
google_sc |
Bu parametre kullanımdan kaldırıldı. Şunun için Google'ın çerezini ayarlar: kullanıcı daha iyi olur. Parametrenin değeri yok sayılır ve atlanır. Çerez yoksa parametrenin atlanması hataya neden olur gerekir. |
google_no_sc |
Bu parametre kullanımdan kaldırıldı. Bu durum, Google'ın Aşağıdaki durumlarda kullanıcı için çerez ayarlamaması gereken Çerez Eşleştirme Hizmeti bir tane mevcut değil. Parametrenin değeri yok sayılır ve atlandı. |
google_hm |
Teklif verenin Google tarafından barındırılan bir eşleşme tablosunda depolamak istediği veriler.
Değer, web için güvenli base64 kodlu bir dizedir (dolgu isteğe bağlıdır). Ham veri 40 olmalıdır
bayt veya daha küçük olmalıdır. Örneğin, |
google_redir |
Teklif verenin
Google'ın HTTP 302 yönlendirmesini
kullanabilirsiniz. Bu, Google'ın ön plana eklenen, aynı hizaya
teşvik eder. Bu,
google_hm veya google_cm ile. |
google_ula |
Kullanıcıyı mevcut bir kullanıcı listesine eklemek için kullanılan dize. Değer
beklenen biçim userlistid[,timestamp] :
Bu URL parametresi, kullanıcıyı birden çok listeler. |
gdpr |
İsteğin, verilerle ilgili GDPR kısıtlamalarına tabi olduğunu gösterir
bazı yolları da görmüştük. Daha fazla bilgi için bkz.
Aşağıdaki AB kullanıcı rızası şartları veya Çerez eşleştirme üzerindeki etkisi
uygunluk kapsamı
Authorized Buyers IAB TCF 2.0 sürümü belgeleri.
Örnek: |
gdpr_consent |
Son kullanıcı iznini temsil eden bir TC dizesi. Daha ayrıntılı bilgi için AB kullanıcı rızası koşullarını inceleyin veya TC dizesi nasıl aktarılır? Authorized Buyers IAB TCF 2.0 sürümü belgeleri. |
process_consent |
Teklif verenin,
Google'ın AB Kullanıcı Rızası Politikası.
Talep, AB Kullanıcı Rızası Politikası'na tabi değilse veya
istekte başka izin parametreleri mevcut mu?
( Örnek: |
Yukarıdaki parametrelere ek olarak, teklif verenler kendi parametrelerini belirtebilir.
parametresi, yönlendirme URL'sine parametre olarak eklenir. Teklif veren tarafından tanımlanan
google_
önekiyle adlandırılmış parametreler
ve korunmasını ve bunların gelecekte de geliştirilmesini sağlamak üzere
parametreleri garanti edilmez. Teklif veren tarafından tanımlanan bir eşleşme etiketi
parametreleri aşağıdaki gibi 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,
google_
ve teklif veren tarafından tanımlanan parametreler dahil olmak üzere teklif verenin hesabı
(eşleşme etiketinde belirtilenlere bağlı olarak) google_
yanıt parametreleri tanımlı:
Parametre | Açıklama |
---|---|
google_gid |
Google Kullanıcı Kimliği. İstekte google_cm belirtildiyse ve isteğin başarılı olup olmadığını ayarlayın. |
google_cver |
Çerez sürümü. İstekte google_cm belirtildiyse ve isteğin başarılı olup olmadığını ayarlayın. |
google_error |
Genel istek hatasını gösteren tam sayı değeri. Zaman
herhangi bir işlem yapılmadığını ve başka hiçbir işlem yapılmadığını
|
google_hm |
Yalnızca Google tarafından barındırılan eşleşme tablosuna yazma girişiminde gösterilir başarısız olur. Bu durumda, değeri aşağıdaki durum kodlarından biridir:
|
google_ula |
Kullanıcı listesine ekleme işleminin durumu (birden fazla Örnek:
|
Çerez Eşleştirme iş akışı örnek senaryoları
Aşağıdaki senaryolarda, bir reklamveren için çerez eşleştirmenin web sayfasına göz atan tipik bir kullanıcı.
1. Senaryo: Kullanıcı çerezlerini temizler ve bir siteye göz atar
Jale, tüm çerezlerin önbelleğini temizler. Daha sonra ExampleNews.com'un ana sayfasını ziyaret ederler.
Süreç şu şekilde işler:
- OrnekNews.com, Google'dan (Ad Manager) reklamlar oluşturur ve çağırır.
- Reklam birimi dinamik ayırma için uygun olduğundan Google, Gerçek Zamanlı Teklif Verme hizmeti aracılığıyla FinestDSP'ye ve diğer teklif verenlere istek gönderebilir.
- FinestDSP'nin teklif veren uygulaması, teklif isteğini alır ve işler. ve teklif yanıtını gönderir.
- Google, FinestDSP'nin yanıtı da dahil olmak üzere teklif verenlerden teklif yanıtları alır içeren bir reklam etiketidir.
- Açık artırmayı FinestDSP kazandı. Google, FinestDSP'nin reklam ve eşleştirme etiketini Jale.
- Eşleştirme etiketi, Google'ın Çerez Eşleştirme Hizmeti'ni çağırarak
google_nid
vegoogle_cm
parametreleri. - Çerez Eşleştirme Hizmeti, Jale'nin Google çerezini okur ve Jale'nin
FinestDSP'nin Çerez Eşleştirme URL'sine yönlendirme yapan bir
google_user_id
vegoogle_cver
parametreleri ayarlandı. - Jale'nin tarayıcısı, FinestDSP'nin Cookie Match URL'sine yönlendirmeyi yükler.
- FinestDSP'nin çerez eşleştirme uç noktası, yönlendirme isteğini işler,
dahil olmak üzere, Google tarafından ayarlanan URL parametrelerini ve
HTTP üstbilgileri. FinestDSP artık çerezinin eşlemesini
google_user_id
. - 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=0000&hl=tr)
2. Senaryo: Mevcut eşlemeye sahip kullanıcı
1. Senaryodan bir hafta sonra, Jale OrnekNews.com'u tekrar ziyaret eder. Jane'in hem teklif veren hem de Ad Manager çerezlerine sahipse çalışır.
- Web sayfası oluşturulur ve Google (Ad Manager) sayfada oluşturulur.
- Google, reklam açık artırması sırasında uygun teklif verenlere bir teklif isteği gönderir. FinestDSP dahil.
- FinestDSP, şunlar gibi sinyaller dahil teklif isteğini alır:
google_user_id
- FinestDSP, eşleşme tablosunda
google_user_id
değerini arar. ve Jale ile ilişkili bir hafta önce oluşturulan çerezi bulur. (1. Senaryo'da). - FinestDSP'nin teklif verme yöntemi, çerezle ilişkili bilgilere dayanarak mantık, gösterime bir teklif verir ve açık artırmayı kazanır.
- Jale, bilgilere dayalı olarak ilgi alanlarına özel olarak hazırlanmış bir reklam görebilir sahip olması gerekir.
Teklif veren tarafından başlatılan: Tek Yönlü Çerez Eşleştirme
Tek Yönlü Çerez Eşleştirme, İki Yönlü iş akışına benzer.
Ancak bir eşleşmenin yalnızca Google tarafından barındırılıp doldurulacağı şekilde değiştirilmesi
tablosunu oluşturalım. Bu özellik, teklif verenin barındırma izninin olmadığı durumlarda kullanılabilir
Google User-ID'leri kendi eşleşme tablosunda gösterir. Teklif verenler bu akışı kullanmak için
Google'ın eşleşme tablosunu barındırmasına izin vermelidir, artık belirtilemez
Google'ın Çerez Eşleştirme Hizmeti'ne yapılan isteklerde google_cm
ve
sonuç olarak kendi alanlarını doldurmak için google_gid
almaz.
eşleşme tablosunu kullanın. Google bir kullanıcı için eşleşme belirledikten sonra teklif verenler
çerez verilerini kullanarak bunları kullanıcı listelerine eklemelerine yardımcı olabilir. Benzer şekilde
bu kullanıcılar Google User-ID'yi hariç tutar, ancak barındırılan eşleşme verilerini içerir. CEVAP
revize edilmiş iş akışının basit bir örneği 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şturulur. Gizlilik kısıtlamaları olan bir ABD eyaletinde bulunmayan kullanıcılara yönelik iş akışından farklı olarak,
eşleştirme etiketi, kullanıcının tarayıcısını Çerezinize yönlendirmelidir.
Eşleşen URL. Örneğin,
https://ad.network.com/pixel
gibi görünecektir:
<img src="https://ad.network.com/pixel" />
Kullanıcının tarayıcısına yükleme sırasında, teklif verenin Çerez Eşleştirme URL'si. Bu istek, HTTP başlığında çerezini içerecek Bu değer sonraki adım için ayıklanır.
2. Adım: Google'ın Çerez Eşleştirme hizmetine yönlendirin
Teklif verenin çerez eşleştirme uç noktası, Google'ın Çerezine yönlendirmelidir
Eşleşen hizmet, şununla doldurulan google_hm
parametresi dahil:
web güvenli base64 kodlu çerez verileri. Yönlendirme URL'si
takip etmek için:
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 üstbilgilerindeki Google çerezine ek olarak.
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 Çerez yoksa
Teklif verenin hesabı için Eşleşme Raporu URL'si belirtildi: Google
varsayılan olarak 1x1 şeffaf piksel sunar ve iş akışı burada sona erer.
Bu kullanıcının sonraki teklif isteklerindeki gösterimleri, teklif verenin
için BidRequest.hosted_match_data
bölgesinde barındırılan eşleşme verileri
Protokol veya Google'ın OpenRTB protokolü için BidRequest.user.buyeruid
hakkında bilgi edindiniz. Teklif verenler, barındırılan eşleşme verilerini kullanarak kullanıcı listelerini de doldurabilir
belirtmişler.
Aksi takdirde, bir hata oluşursa Google teklif verenin
google_error
parametresinden yararlanın. Teklif verenin Çerez Eşleştirme Raporu URL'si
https://ad.network.com/report
olsaydı yönlendirme URL'si
örneğin:
<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şme Raporu URL'sine yönlendiriyor
Kullanıcının tarayıcısı teklif verenin Çerez Eşleşme Raporu URL'sine yönlendirir.
hata nedeni (varsa) dahil olmak üzere, Google'ın
google_error
parametresinden yararlanın. Hatayı yorumlama hakkında daha fazla bilgi edinmek için
parametre açıklamasına bakın.
6. Adım: Teklif veren 1x1 şeffaf piksel yayınlar
Teklif veren, kullanıcının emin olun.
Gizlilik kısıtlamaları bulunan ABD eyaletlerindeki kullanıcılar için çerez eşleştirme iş akışı şeması
ABD eyaletlerindeki gizlilik kısıtlamalarına sahip kullanıcılar için varsayılan iş akışı şemada gösterilmektedir aşağıda istekleri ve yanıtların bir okla gösterildiği ve öğeler parantez içinde listelenir.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching_ca.png?authuser=0000&hl=tr)
Teklif verenin Google'ın Çerez Eşleştirme hizmetine yönlendirmesi için URL parametreleri
Parametre | Açıklama |
---|---|
google_nid |
Teklif veren hesabının ağ kimliği (NID). Bu kimlik alınabilir Teklif verenler aracılığıyla gösterir. |
google_sc |
Bu parametre kullanımdan kaldırıldı. Şunun için Google'ın çerezini ayarlar: kullanıcı daha iyi olur. Parametrenin değeri yok sayılır ve atlanır. Çerez yoksa parametrenin atlanması hataya neden olur gerekir. |
google_no_sc |
Bu parametre kullanımdan kaldırıldı. Bu durum, Google'ın Aşağıdaki durumlarda kullanıcı için çerez ayarlamaması gereken Çerez Eşleştirme Hizmeti bir tane mevcut değil. Parametrenin değeri yok sayılır ve atlandı. |
google_hm |
Teklif verenin Google tarafından barındırılan bir eşleşmede depolamak istediği verileri içerir tablosunu oluşturalım. |
google_redir |
Google'ın HTTP 302 yönlendirmesi göndermesini istediğiniz kodlanmış URL. İlgili içeriği oluşturmak için kullanılan
belirtilen URL, google_error ile yönlendirmeleri alır
parametresini kullanabilirsiniz. |
google_ula |
Kullanıcıyı mevcut bir kullanıcı listesine eklemek için kullanılan dize. Değer
beklenen biçim userlistid[,timestamp] :
Bu URL parametresi, kullanıcıyı birden çok listeler. |
gdpr |
İsteğin, verilerle ilgili GDPR kısıtlamalarına tabi olduğunu gösterir
bazı yolları da görmüştük. Daha fazla bilgi için bkz.
Aşağıdaki AB kullanıcı rızası şartları veya Çerez eşleştirme üzerindeki etkisi
uygunluk kapsamı
Authorized Buyers IAB TCF 2.0 sürümü belgeleri.
Örnek: |
gdpr_consent |
Son kullanıcı iznini temsil eden bir TC dizesi. Daha ayrıntılı bilgi için AB kullanıcı rızası koşullarını inceleyin veya TC dizesi nasıl aktarılır? Authorized Buyers IAB TCF 2.0 sürümü belgeleri. |
process_consent |
Teklif verenin,
Google'ın AB Kullanıcı Rızası Politikası.
Talep, AB Kullanıcı Rızası Politikası'na tabi değilse veya
istekte başka izin parametreleri mevcut mu?
( Örnek: |
Teklif Veren'in Çerez Eşleştirme Raporu URL'sine yönlendirme yapan Google için URL Parametreleri
Parametre | Açıklama |
---|---|
google_error |
Genel istek hatasını gösteren tam sayı değeri. Zaman
herhangi bir işlem yapılmadığını ve başka hiçbir işlem yapılmadığını
|
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 Google'ın, bir Google User-ID'yi algoritmik olarak Gerçek Zamanlı Teklif Verme açık artırmasının kazananı dışında seçilen teklif veren. Reklam bir eşleşme etiketi yerleştirir. Bu etiket, kullanıcının tarayıcısını seçilen teklif verenin Çerez Eşleştirme URL'sinden şeffaf piksel. Bu işlem, eşleşme tablosunu belirli bir kullanıcıyla doldurmak için hem Google hem de teklif veren tarafından belirlenir. Aşağıda basit bir örneğini inceleyelim.
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 reklam alanının Google tarafından doldurulduğundan, yayıncıların
algoritmik olarak seçilen bir teklif verenden bir piksel ister. Piksel Eşleştirme
etiketi, teklif verenin Çerez Eşleştirme URL'sini
ek parametreler
teklif verenin eşleşme tablosunu doldurmak için
kullanabileceği öğelerdir. Çerez Eşleştirme URL'si için
https://ad.network.com/pixel
olarak belirtilirse
şöyle olur:
<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 gibi yapılandırılmış Google Çerez Eşleştirme Hizmeti'ne yönlendirmelisiniz:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
Yukarıdaki yönlendirme URL'sinin, burada kullanılan URL'nin
Teklif Veren Tarafından Başlatılan Çerez Eşleştirme İş Akışı için eşleme etiketi.
Pixel Eşleştirme'de google_cm
parametresi,
google_push
parametresi ve bu parametrenin değeri değerine eşit olmalıdır
Google tarafından sağlanan verilerdir. Teklif veren tarafından başlatılan
iş akışı, ek parametreler
ek kullanım alanlarını karşılamak için 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 her türlü eşleşmeyi işler sorgu parametreleri aracılığıyla ek işlemler istendi. Son olarak, Google 1x1 şeffaf pikselle değiştirin.
Piksel Eşleştirme iş akışı şeması
Bu iş akışı aşağıdaki şemada gösterilmektedir; burada istekler ve yanıtlar ok işaretiyle gösterilir ve yanıtlarla ilişkili veri öğeleri parantez içinde listelenir.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/pixel_matching.png?authuser=0000&hl=tr)
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 eyaletinde bulunmayan kullanıcılar için bu her zaman geçerli olur. Google'ın eşleşme etiketinde belirtilir. |
google_cver |
Çerez sürümü. Bu, Google'ın eşleşmesinde her zaman belirtilir kapanış etiketinin hemen öncesine yapıştırın. |
google_push |
Bu isteğin Pixel Eşleştirme iş akışını başlattığını belirtir. Değer, teklif verenin yönlendirme yanıtı. |
Teklif veren Piksel Eşleştirme yönlendirme parametreleri
Parametre | Açıklama |
---|---|
google_nid |
Teklif veren hesabının ağ kimliği (NID). Bu kimlik alınabilir Teklif verenler aracılığıyla gösterir. |
google_push |
Bu yönlendirmenin Piksel Eşleştirme işlemini tamamladığını gösterir iş akışını takip edin. Karşılık gelen Google eşleşme etiketindeki değer burada belirtilmektedir. |
google_hm |
Teklif verenin Google tarafından barındırılan bir eşleşmede depolamak istediği verileri içerir tablosunu oluşturalım. |
google_ula |
Kullanıcıyı mevcut bir kullanıcı listesine eklemek için kullanılan dize. Değer
beklenen biçim userlistid[,timestamp] :
Bu URL parametresi, kullanıcıyı birden çok listeler. |
Google Tarafından Başlatılan: Tek Yönlü Piksel Eşleştirme
Tek Yönlü Piksel Eşleştirme, Google'ın eşleştirme etiketinin Google Kullanıcısını belirten bir parametre kimliktir. Ancak Google tarafından barındırılan bir eşleşme tablosunu doldurmaya devam eder. Bu, kullanılabilir uygulamalarında Google User-ID'leri barındırmasına izin vermediği durumlarda kendi eşleşme tablosu. Düzeltilmiş iş akışının basit bir örneği adımlarına göz atın.
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
parametresinden yararlanın. 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. HTTP başlıklarında teklif verenin çerezi de dahil edilir.
3. Adım: Google'ın Çerez Eşleştirme Hizmeti'ne yönlendirin
Teklif verenin çerez eşleştirme uç noktası, Google'ın Çerezine yönlendirmelidir
Eşleşen hizmet, şununla doldurulan google_hm
parametresi dahil:
web güvenli base64 kodlu çerez verileri. Yönlendirme URL'si
takip etmek için:
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 üstbilgilerindeki Google çerezine ek olarak. İşlem
başarılı olursa, bu kullanıcının sonraki teklif isteklerindeki gösterimlerde
teklif verenin BidRequest.hosted_match_data
bölgesinde barındırılan eşleşme verileri:
veya Google'ın kullanımı için BidRequest.user.buyeruid
OpenRTB uygulaması. Teklif verenler, kullanıcı listelerini, barındırılan
eşleşme verilerini görebilirsiniz.
Son olarak Google, kullanıcının tarayıcısına 1x1 şeffaf piksel döndürür.
Çerez Eşleştirme Desteği
Open Bidding, exchange'lerin teklif veren tarafından başlatılan özelliğini kullanmasına olanak tanır ve Google tarafından başlatıldı çerez eşleştirme iş akışlarıyla eşleştirilir. Kurabiye Match Assist (CMA), exchange'ler için ek bir özelliktir ve exchange'ler sayesinde kendi teklif verenleriyle eşleşme tabloları oluşturmak.
Cookie Match Assist nasıl çalışır?
Google, reklam yerleştirirken katılımcıyı algoritmik olarak seçer. aşağıdaki özelliklere sahip bir Cookie Match Assist etiketi yerleştirir ve yapı:
<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 alır.
- Exchange'in Çerez Eşleştirme uç noktası isteği alır. Burada kendi çerez eşleştirme hizmeti, kullanıcı kimliğini biri olabilir. Aşağıdaki şemada, exchange'in çerez eşleştirmesi kullanıcının tarayıcısına, teklif verenin ziyaretçilerinden birine yönlendirme uç noktalar.
- Teklif veren, kullanıcı kimliğini çereziyle eşleştirmek için exchange'i kullanır.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_match_assist_diagram.png?authuser=0000&hl=tr)
Kısıtlamalar
Yeni eşleşmeler için istek sıklığı sınırı
Çereze yapılan çağrı sayısını sınırlandırmak teklif verenlerin sorumluluğundadır. Google tarafından barındırılan eşleşmede yeni bir girişi olan kullanıcılar için eşleştirme hizmeti tablosunu oluşturalım. Barındırılan eşleşme tablosundaki bir girişin süresi 14 gün sonra dolmuş olarak kabul edilebilir. Sonrasında yenilenebilir.
Tüm piksel eşleştirme isteklerine yanıt verme
Piksel Eşleştirme iş akışını kullanan teklif verenlerin
google_push
ifadesini içeren bir yanıtla gelen Pixel Match istekleri
parametresinden sonra bir değer girin. Bu sayede Google, kullanımı izleyerek politikaları uygulayabilir.
teklif verenin yanıt oranı %90'ın altına düşerse Google,
Kullanıcının hesabına gönderilen Pixel Match istekleri.
HTTPS uç noktalarını kullanma
Tüm Çerez Eşleştirme iş akışlarında kullanılan uç noktaların HTTPS'ye dokunun.
Size HTTPS üzerinden gönderilen bir Pixel Match isteğine yanıt verirken HTTPS üzerinden Çerez Eşleştirme Hizmeti'ne yönlendirme yapması gerekir. Aynı şekilde, Teklif verenlere yönlendirme yapan Cookie Match Assist uç noktası da HTTPS kullanmalıdır. Google'a HTTP üzerinden 2 dakikada bir defadan daha sık istek gönderiyorsanız hesabınıza gönderilen eşleşme isteklerinin sayısı kısıtlanır.
AB kullanıcı rızası şartları
Şuna tabi Çerez Eşleştirme istekleri: Google'ın AB Kullanıcısı Rıza Politikası'nda son kullanıcı izni belirtilmelidir. Bu tür talepler İznin aşağıdaki yöntemlerden biri kullanılarak toplandığını belirtmelidir:
- TCF 2 sürümü: Buna
gdpr
vegdpr_consent
dahildir parametreleridir. Ayrıntılı bilgi için Authorized Buyers IAB TCF 2.0 sürümü belgeleri. process_consent
: teklif verenin aldığı beyan kullanıcı izni almanız gerekir.
Örnekler
Aşağıdaki örnekler, Çerez Eşleştirme hizmetinin şu amaçlarla nasıl kullanılacağını göstermektedir: yardımcı olur. Aksi belirtilmedikçe, hakkında işlem yapılan kullanıcının Gizlilik kısıtlamaları bulunan ABD eyaleti.
Teklif veren tarafından barındırılan eşleşme tablosunu doldurma
Teklif veren, kendi eşleşmesini doldurmak için Çerez Eşleştirme iş akışını kullanabilir
yalnızca google_nid
ve google_cm
sağlayarak tablo oluşturabilirsiniz.
parametrelerini dahil etmesi gerekir. Bu, aşağıdaki gibi 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 gönderdiği
teklif verenin eşleşme etiketine verdiği yanıt aşağıdaki gibi 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 için yanıt şöyle olur:
https://ad.network.com/pixel?id=1&google_error=3
Hata kodu, hatanın temel nedenine bağlıdır. Öğrenmek için Çerez Eşleştirme iş akışına yönelik olası hata kodları hakkında daha fazla bilgi için yönlendirme URL'si parametreleri.
Tek kullanıcı listesine ekle
google_ula
parametresi, teklif verenin eşleşmesinde belirtilebilir
etiketini kullanın. Google veya
teklif veren tarafından barındırılan eşleşme tablosunda kullanıcı için yeni bir giriş olduğunda, teklif veren
google_nid
ve google_ula
içeren bir eşleşme etiketi
Parametre değerini
Çerez Eşleştirme iş akışı. Kısıtlamaları inceleyin.
. İlgili
eşleme etiketi şöyle görünebilir:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
Başarılı bir yanıt için: Bu durumda teklif verenin Çerez Eşleştirme URL'si
https://ad.network.com/pixel
, Google'ın yönlendirme URL'si şöyle olur:
https://ad.network.com/pixel?google_ula=12345,0
Genel bir hata varsa (örneğin, Google çerezi yoksa)
değer, yönlendirme URL'si
google_error
parametresi:
https://ad.network.com/pixel?google_error=3
Özellikle kullanıcının listeye eklenmesiyle ilgili bir hata varsa,
yönlendirmede google_ula
alacaksınız. Şunlardan farklı olarak:
karşılık gelen eşleşme etiketi parametresinde, zaman damgasını
kodu kullanarak işlemin başarılı olduğunu belirtir. Örneğin, istek başarısız olursa
Teklif veren hesabının belirtilen kullanıcı listesine erişimi olmadığından,
yönlendirme URL'si şöyle olur:
https://ad.network.com/pixel?google_ula=12345,2
Birden fazla kullanıcı listesine ekle
Teklif verenler, bir kullanıcının
eşleme etiketine birden çok google_ula
parametresi ekleme. İçinde
şöyle görünebilir:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />
İşlemin her bir kullanıcı listesi için durumu benzer şekilde
yönlendirmede ayrı google_ula
parametreleri:
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
Yukarıdaki yönlendirmede, işlemin kullanıcı için başarılı olduğunu görebiliriz
45678
kimliğine sahip liste, ancak 12345
kullanıcı listesi kimliği için başarısız oldu
çünkü teklif verenin erişim izni yoktu.
Çerez Eşleştirme iş akışını adım adım öğrenin ve kullanıcı listesine ekleyin
Çerez eşleştirme işlemi gerçekleştirmek ve kullanıcıyı tek bir
isteği için, teklif verenin eşleşme etiketinde google_cm
ve
google_ula
:
<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
. Bu, size
takip etmek için:
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 isterse
ve kendi eşleşmelerinde Google User ID ile eşleşmeyi depolamayı amaçlamayan
tablosunda google_hm
parametresini içermesi gerekir.
değeri web güvenli base64 kodlu bir dize olmalıdır. Kullanıcı,
teklif verenin kodlanmamış çerez verileri Cookie number 1!
, kodlanmış
değeri Q29va2llIG51bWJlciAxIQ==
olacaktır ve bu değer
şununla eşleşir:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
Başarılı bir yanıt için: Bu durumda teklif verenin Çerez Eşleştirme URL'si
https://cookie-monster.com/pixel
, Google'ın yönlendirme URL'si
şöyle olmalıdır:
https://cookie-monster.com/pixel
google_gid
parametresi yönlendirmede değildir çünkü
eşleşme etiketi google_cm
içermiyor ve google_hm
başarılı yanıtlara dahil edilmedi. Gelecekteki gösterimler için teklif isteklerinde
teklif veren, barındırılan eşleşme verilerini şurada alır:
Google'ın GZT protokolü için BidRequest.hosted_match_data
veya
Google'ın OpenRTB uygulaması için BidRequest.user.buyeruid
.
Teklif veren bunun yerine
google_hm
, base64 olarak kodlanmadı; örneğin
chocolate_chunk!
: Yönlendirme URL'si
takip etmek için:
https://cookie-monster.com/pixel?google_hm=2
Yukarıdaki yönlendirme URL'si şunun bir google_hm
değeri içerir:
2
. Bu, değerin
hiçbir zaman çözülmez.
Teklif veren ve Google tarafından barındırılan eşleşme tabloları ve kullanıcı listeleri
Teklif veren, Google tarafından barındırılan bir kullanıcıya ek olarak kendi kullanım listesini de barındırıyorsa
listesi için tek bir eşleşme etiketinin her iki tabloyla eşleşmesini ve kullanıcının
belirtilen bir kullanıcı listesinin eşleştirme etiketi google_cm
,
google_hm
ve google_ula
parametreleri. Teklif verenin
çerez verileri Cookie number 1!
ise, kodlanmış değer
Q29va2llIG51bWJlciAxIQ==
gibi bir eşleşme etiketi oluşturulur.
takip etmek için:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
Başarılı bir yanıt için: Bu durumda teklif verenin Çerez Eşleştirme URL'si
https://cookie-monster.com/pixel
, 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önlendirme alındığında belirtilen Google Kullanıcı Kimliğiyle eşleşebilir
google_gid
çerez verileri, eşleşme tablosundaki çerez verileriyle eşleştirilir. İçinde
Google tarafından barındırılan eşleşme tablosunun ve kullanıcı listesinin
başarılı olduğunu gösterir. Sonuç olarak, teklif verene yönelik tüm ön hedeflemeler
belirtilen kullanıcı listesi kimliğini hedefleyecek şekilde yapılandırılanlar artık teklif verenin
kullanıcıdan gösterimler için teklif istekleri almak Benzer şekilde, bu tekliflerde
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
.