İlişkilendirme Raporlaması: Sisteme genel bakış

Teknik karar alıcıları hedefleyen, ilişkilendirme raporlaması için bağlı hizmetlere genel bakış.

Attribution Reporting API, reklam teknolojilerinin ve reklamverenlerin bir reklam tıklamasının veya görüntülemenin ne zaman satın alma gibi bir dönüşüme yol açtığını ölçmelerine olanak tanır. Bu API, iş ihtiyaçlarınıza bağlı olarak istemci tarafı ve sunucu tarafı entegrasyonlarının bir kombinasyonunu kullanır.

Devam etmeden önce ilişkilendirme raporlamasına genel bakış başlıklı makaleyi okuduğunuzdan emin olun. Bu, API'nin amacını ve farklı çıkış raporlarının (etkinlik düzeyinde rapor ve özet raporlar) akışını anlamanıza yardımcı olur. Bilmediğiniz terimlerle karşılaşırsanız Özel Korumalı Alan sözlüğüne bakın.

Bu belge kimler için hazırlanmıştır?

Aşağıdaki durumlarda bu belgeyi okumalısınız:

• Bir reklam teknolojisi şirketi veya reklamverenin teknik karar vericisi olmanız gerekir. Operasyon, DevOps, veri bilimi, BT, pazarlama veya teknik uygulama kararları aldığınız başka bir rolde çalışıyor olabilirsiniz. API'lerin gizliliği koruyan ölçüm için nasıl çalıştığını merak ediyorsunuz.
• Bu API ve Aggregation Service ortamıyla denemeler yapacak bir teknik uygulayıcı (ör. geliştirici, sistem operatörü, sistem mimarı veya veri bilimcisi) olmanız gerekir.

Bu belgede, Attribution Reporting API'nin hizmetlerinin işleyiş şekliyle ilgili genel ve uçtan uca bir açıklama bulacaksınız. Teknik uygulayıcıysanız bu API ile yerel olarak denemeler yapabilirsiniz.

Genel Bakış

Attribution Reporting API, belirli kurulum, istemci tarafı yapılandırmaları ve sunucu dağıtımları gerektiren birçok hizmetten oluşur. Neye ihtiyacınız olduğunu belirlemek için öncelikle:

• Tasarım kararları verme. Toplamak istediğiniz bilgileri tanımlayın, herhangi bir kampanyadan beklediğiniz dönüşümleri belirleyin ve hangi rapor türünün toplanacağını belirleyin. Son çıktı, iki rapor türünden biri veya her ikisidir: etkinlik düzeyinde raporlar ve özet raporlar.

Raporlamayı desteklemek için her zaman birlikte çalışan iki (bazen üç) bileşen vardır:

• Web sitesi ile tarayıcı arasındaki iletişim. Çerez tabanlı sistemlerde, dönüşümler ve reklam etkileşimleriyle ilgili bilgiler, daha sonra bu etkinliklere katılmanıza veya bir analiz hizmetinin katılmasına olanak tanıyan bir tanımlayıcıya eklenir. Bu API ile tarayıcı, analiz için sunulmadan önce dönüşümleri talimatlarınıza göre reklam tıklamaları/görüntülemeleriyle ilişkilendirir. Bu nedenle, reklam oluşturma kodunuz ve dönüşüm izleme aşağıdaki koşulları karşılamalıdır:
  • Tarayıcıya hangi dönüşümlerin hangi reklam tıklamaları veya gösterimleriyle ilişkilendirilmesi gerektiğini söyleyin.
  • Son raporlara dahil edilecek diğer verileri işaretleyin.
• Veri toplama. Kullanıcıların tarayıcılarında oluşturulan raporları almak için bir toplayıcı bitiş noktasına ihtiyacınız vardır. Tarayıcılardan alınan çıkış, iki olası rapordan biri olabilir: etkinlik düzeyinde raporlar ve özet raporlar oluşturmak için kullanılan, şifrelenmiş toplu raporlar.

Toplanabilir raporlar topladıysanız üçüncü bir bileşene ihtiyacınız olacaktır:

• Özet rapor oluşturma. Toplanabilir raporları toplu işleyin ve özet rapor oluşturmak için raporları işlemek üzere Toplama Hizmeti'ni kullanın.

Tasarım kararları

Attribution Reporting'in temel ilkelerinden biri erken tasarım kararlarıdır. Hangi kategorilerde hangi verilerin toplanacağına ve bu verilerin ne sıklıkta işleneceğine siz karar verirsiniz. Çıkış raporları, kampanyalarınız veya işletmeniz hakkında analizler sağlar.

Çıkış raporu şu şekilde olabilir:

• Etkinlik düzeyindeki raporlar, belirli bir reklam tıklamasını veya görüntülemeyi (reklam tarafında) dönüşüm tarafındaki verilerle ilişkilendirir. Kullanıcı kimliğinin siteler arasında birleştirilmesini sınırlayarak kullanıcı gizliliğini korumak için dönüşüm tarafı verileri çok sınırlıdır ve veriler gürültülüdür (yani, vakaların küçük bir yüzdesinde gerçek raporlar yerine rastgele veriler gönderilir).
• Özet raporlar, reklam tarafında belirli bir etkinliğe bağlı değildir. Bu raporlar, daha ayrıntılı dönüşüm verileri sunar ve tıklama ile görüntüleme verilerini dönüşüm verileriyle birleştirme konusunda daha fazla esneklik sağlar.

Rapor seçiminiz, hangi verileri toplamanız gerektiğini belirler.

Son çıktıyı, karar vermek için kullandığınız araçların girişi olarak da düşünebilirsiniz. Örneğin, toplam harcama değerine kaç dönüşümün yol açtığını belirlemek için özet raporlar oluşturursanız bu, ekibinizin daha yüksek bir toplam harcama oluşturmak için bir sonraki reklam kampanyanızın neyi hedeflemesi gerektiğine karar vermesine yardımcı olabilir.

Ölçmek istediğinize karar verdikten sonra Attribution Reporting API için istemci tarafını ayarlayabilirsiniz.

Web sitesi ile tarayıcı arasındaki iletişim

İlişkilendirme etkinliği akışı

Reklam gösteren bir yayıncı sitesi olduğunu düşünün. Her reklamveren veya reklam teknolojisi sağlayıcı, reklamlarıyla ilgili etkileşimler hakkında bilgi edinmek ve dönüşümleri doğru reklamla ilişkilendirmek ister. Raporlar (hem etkinlik düzeyinde hem de toplanabilir) şu şekilde oluşturulur:

1. Yayıncı sitesinde, bir reklam öğesi (<a> veya <img> etiketi) özel bir attributionsrc özelliğiyle yapılandırılır. Değeri bir URL'dir (ör. https://adtech.example/register-source/ad_id=...).

   Tıklandığında bir kaynağı kaydedecek bağlantı örneğini aşağıda bulabilirsiniz:

   <a href="https://shoes.example/landing"
     attributionsrc="http://adtech.example/register-source?..."
     target="_blank">
   Click me</a>
   

   Görüntülendiğinde kaynağın kaydedilmesine neden olacak bir resim örneğini aşağıda bulabilirsiniz:

   <img href="https://advertiser.example/landing"
     attributionsrc="https://adtech.example/register-source?..."/>
   

   Alternatif olarak, HTML öğeleri yerine JavaScript çağrıları kullanılabilir.

   window.open() kullanan bir JavaScript örneğini aşağıda bulabilirsiniz. Özel karakterlerle ilgili sorunları önlemek için URL'nin URL kodlamalı olduğunu unutmayın.

   const encodedUrl = encodeURIComponent(
     'https://adtech.example/attribution_source?ad_id=...');
   window.open(
     "https://shoes.example/landing",
     "_blank",
     `attributionsrc=${encodedUrl}`);
   

2. Kullanıcı reklamı tıkladığında veya görüntülediğinde tarayıcı, attributionsrc'ye (genellikle bir reklamveren veya reklam teknolojisi sağlayıcı uç noktası) bir GET isteği gönderir.

3. Bu isteği alan reklamveren veya reklam teknolojisi sağlayıcı, tarayıcıya reklamla etkileşimler için kaynak etkinlikleri kaydetmesi talimatını vermeye karar verir. Böylece dönüşümler daha sonra bu reklamla ilişkilendirilebilir. Bunu yapmak için reklamveren veya reklam teknolojisi sağlayıcı, yanıtına özel bir HTTP üstbilgisi ekler. Bu başlığa, kaynak etkinlik (reklam tıklaması veya görüntüleme) hakkında bilgi sağlayan özel veriler ekler. Bu reklam için bir dönüşüm gerçekleşirse bu özel veriler sonuç olarak ilişkilendirme raporunda gösterilir.

   

4. Daha sonra kullanıcı, reklamverenin sitesini ziyaret eder.

5. Reklamverenin sitesindeki her alakalı sayfada (ör. satın alma onayı sayfası veya ürün sayfası) bir dönüşüm pikseli (<img> öğesi) ya da JavaScript çağrısı, https://adtech.example/conversion?param1=...&param2=... için istekte bulunur.

6. Bu URL'deki hizmet (genellikle reklamveren veya reklam teknolojisi sağlayıcı) isteği alır. Bu durumu dönüşüm olarak sınıflandırmaya karar verir. Bu nedenle, tarayıcıya dönüşüm kaydetmesi (yani ilişkilendirmeyi tetiklemesi) talimatını vermesi gerekir. Bunu yapmak için reklamveren veya reklam teknolojisi sağlayıcı, piksel isteğine verdiği yanıta dönüşümle ilgili özel verileri içeren özel bir HTTP başlığı ekler.

7. Kullanıcının yerel cihazındaki tarayıcı bu yanıtı alır ve dönüşüm verilerini orijinal kaynak etkinliğiyle (reklam tıklaması veya görüntüleme) eşleştirir.

8. Tarayıcı, attributionsrc adresine gönderilecek bir rapor planlar. Bu rapor şunları içerir:

   1. Reklam teknolojisi sağlayıcısının veya reklamverenin 3. adımda kaynak etkinliğe eklediği özel ilişkilendirme yapılandırma verileri.
   2. 6. adımda özel dönüşüm veri kümesi.

   

9. Daha sonra tarayıcı, raporları attributionsrc içinde tanımlanan uç noktaya biraz gecikme ve ilgisiz noktalar içerecek şekilde gönderir. Toplanabilir raporlar şifrelenirken etkinlik düzeyindeki raporlar şifrelenmez.

İlişkilendirme tetikleyicileri (reklamverenin web sitesi)

İlişkilendirme tetikleyici, tarayıcıya dönüşümleri yakalamasını söyleyen etkinliktir.

Satın alma işlemleri gibi reklamveren için en önemli olan dönüşümleri yakalamanızı öneririz. Özet raporlarda birden fazla dönüşüm türü ve meta veri yakalanabilir.

Bu, toplu sonuçların bu etkinlikler için ayrıntılı ve doğru olmasını sağlar.

Kaynakları tetikleyicilerle eşleştirme

Bir tarayıcı, ilişkilendirme tetikleyici yanıtı aldığında ilişkilendirme tetikleyicinin kaynağı ve bu sayfa URL'sinin eTLD+1 ile eşleşen bir kaynak bulmak için yerel depolamaya erişir.

Örneğin, tarayıcı adtech.example tarafından shoes.example/shoes123 üzerinde bir ilişkilendirme tetikleyicisi aldığında, yerel depolamada hem adtech.example hem de shoes.example ile eşleşen bir kaynak arar.

Bir tetikleyicinin belirli bir kaynakla ne zaman eşleşeceğini belirlemek için filtreler (veya özel kurallar) ayarlanabilir. Örneğin, yalnızca belirli bir ürün kategorisindeki dönüşümleri sayacak ve diğer tüm kategorileri yok sayacak bir filtre ayarlayın. Filtreler ve önceliklendirme modelleri, daha gelişmiş ilişkilendirme raporlamasına olanak tanır.

Yerel depolama alanında birden fazla ilişkilendirme kaynağı bulunursa tarayıcı, en son depolananı seçer. İlişkilendirme kaynaklarına öncelik atandığı bazı durumlarda tarayıcı, en yüksek önceliğe sahip kaynağı seçer.

Veri toplama

Birlikte, ilgili bir kaynakla eşleşen bir ilişkilendirme tetikleyicisi, tarayıcı tarafından bir reklam teknolojisine ait sunucudaki bir raporlama uç noktasına (bazen toplama uç noktası veya toplama hizmeti olarak da adlandırılır) rapor olarak gönderilir. Bu raporlar, etkinlik düzeyinde raporlar veya toplu hale getirilebilir raporlar olabilir.

Özet raporlar oluşturmak için toplanabilir raporlar kullanılır. Toplanabilir rapor, reklamdan (yayıncının sitesinde) toplanan veriler ile dönüşüm verilerinin (reklamverenin sitesinden) birleşimidir. Bu rapor, reklam teknolojisi tarafından toplanmadan önce kullanıcının cihazındaki tarayıcı tarafından oluşturulur ve şifrelenir.

Etkinlik düzeyindeki raporlar 2 ila 30 gün gecikmeli olarak yayınlanır. Toplanabilir raporlar bir saat içinde rastgele bir gecikmeyle gönderilir ve etkinlikler katkı bütçesine uygun olmalıdır. Bu tercihler gizliliği korur ve herhangi bir kullanıcının işlemlerinin kötüye kullanılmasını önler.

Yalnızca etkinlik düzeyindeki raporlarla ilgileniyorsanız bu, ihtiyacınız olan son altyapı parçasıdır. Ancak özet raporlar oluşturmak istiyorsanız toplanabilir raporları ek bir hizmetle işlemeniz gerekir.

Özet rapor oluşturma

Özet raporlar oluşturmak için toplama hizmetini kullanarak toplanabilir raporları işlersiniz. Toplama hizmeti, reklam teknolojisi tarafından işletilir. Toplama Hizmeti, kullanıcı gizliliğini korumak için gürültü ekler ve nihai özet raporu oluşturur.

Toplu toplu raporlar

Toplanabilir raporların işlenebilmesi için gruplandırılması gerekir. Toplu iş, stratejik olarak gruplandırılmış toplu raporlardan oluşur. Stratejiniz büyük olasılıkla belirli bir zaman aralığını (ör. günlük veya haftalık) yansıtacaktır. Bu işlem, raporlama uç noktanız olarak işlev gören aynı sunucuda gerçekleşebilir.

Sinyal-gürültü oranının yüksek olması için gruplar çok sayıda rapor içermelidir.

Toplu işlem dönemleri, daha yüksek hacim beklediğiniz belirli etkinlikleri (ör. yıllık indirim) yakalayabilmeniz için istediğiniz zaman değiştirilebilir. Toplu işleme dönemi, ilişkilendirme kaynaklarını veya tetikleyicileri değiştirmeye gerek kalmadan değiştirilebilir.

Aggregation Service

Toplama Hizmeti, özet rapor oluşturmak için birleştirilebilir raporları işlemekle sorumludur. Toplanabilir raporlar şifrelenir ve yalnızca güvenilir yürütme ortamında (TEE) çalışan Toplama Hizmeti tarafından okunabilir.

Toplama hizmeti, verilerin şifresini çözmek ve toplamak için koordinatörden şifre çözme anahtarları ister. Şifresi çözülüp toplandıktan sonra sonuçlar, gizliliği korumak için gürültü eklenerek özet rapor olarak döndürülür.

Uygulayıcılar, toplama hizmetini yerel olarak test etmek için toplanabilir net metin raporları oluşturabilir. Alternatif olarak, Nitro Enclaves ile AWS'de şifrelenmiş raporlarla test yapabilirsiniz.

Sırada ne var?

Herkes için uygun bir API oluşturduğumuzdan emin olmak amacıyla sizinle görüşmek istiyoruz.

API hakkında tartışma

Diğer Özel Korumalı Alan API'leri gibi bu API de belgelenmiş ve herkese açık olarak tartışılmıştır.

API ile deneme yapma

Attribution Reporting API ile ilgili denemeler yapabilir ve sohbete katılabilirsiniz.