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

bookmark_border Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Teknik karar vericileri hedefleyen, İliş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ülemesinin satın alma gibi bir dönüşüme ne zaman yol açtığını ölçmesine olanak tanır. Bu API, işletme ihtiyaçlarınıza bağlı olarak istemci tarafı ve sunucu tarafı entegrasyonlarının bir kombinasyonunu kullanır.

Devam etmeden önce İlişkilendirme raporlarına genel bakış başlıklı makaleyi okuyun. 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. Tanıdık olmayan terimlerle karşılaşırsanız Özel Korumalı Alan terimleri sözlüğüne göz atın.

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

Aşağıdaki durumlarda bu makaleyi okumanız gerekir:

• Reklam teknolojisi uzmanı veya reklamverenin teknik karar vericisiyseniz. Operasyon, DevOps, veri bilimi, BT, pazarlama veya teknik uygulama kararları aldığınız başka bir rolde çalışıyor olabilirsiniz. API'lerin gizliliği korumaya yönelik ölçümde nasıl çalıştığını merak ediyorsunuz.
• Bu API ve Toplama Hizmeti ortamıyla deneyler oluşturacak bir teknik uygulayıcısınız (geliştirici, sistem operatörü, sistem mimarı veya veri bilimcisi gibi).

Bu makalede, Attribution Reporting API için hizmetlerin işleyiş şekliyle ilgili üst düzey bir uçtan uca açıklama bulabilirsiniz. Teknik uzmansanız yerel olarak bu API ile 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. İhtiyacınız olanları belirlemek için öncelikle:

• Tasarımla ilgili kararlar verme. Toplamak istediğiniz bilgileri tanımlayın, belirli bir kampanyadan hangi dönüşümleri beklediğinizi belirleyin ve hangi rapor türünün toplanacağını kararlaştırın. Nihai çıkış, iki rapor türünden biri veya her ikisidir: etkinlik düzeyinde raporlar ve özet raporlar.

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

• Web sitesi ile tarayıcı arasındaki iletişim. Çerez tabanlı sistemlerde, dönüşümler ve reklam etkileşimleri ile ilgili bilgiler, sizin veya bir analiz hizmetinin bu etkinlikleri daha sonra birleştirmesine olanak tanıyan bir tanımlayıcıya eklenir. Bu API ile tarayıcı, analiz için yayınlanmadan önce talimatlarınıza göre dönüşümleri reklam tıklamalarıyla/görüntülemeleriyle ilişkilendirir. Bu nedenle, reklam oluşturma kodunuz ve dönüşüm izlemeniz:
  • Tarayıcıya hangi dönüşümlerin hangi reklam tıklamalarıyla veya gösterimleriyle ilişkilendirileceğini bildirin.
  • Nihai 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 gelen çıkış, iki olası rapordan biri olabilir: etkinlik düzeyinde raporlar ve toplanabilir raporlar (şifrelenmiş olup özet raporlar oluşturmak için kullanılır).

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

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

Tasarımla ilgili kararlar

İlişkilendirme raporlamasının 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şletmenizle ilgili analizler sunar.

Çıkış raporu şunlar olabilir:

• Etkinlik düzeyindeki raporlar, belirli bir reklam tıklamasını veya görüntülemesini (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, küçük bir yüzdelik oranda 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 ve tıklama ve görüntüleme verilerini dönüşüm verileriyle birleştirme esnekliği sunar.

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

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

Neleri ö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 düşünün. Her reklamveren veya reklam teknolojisi sağlayıcı, reklamlarıyla etkileşimler hakkında bilgi edinmek ve dönüşümleri doğru reklamla ilişkilendirmek ister. Raporlar (hem etkinlik düzeyinde hem de toplanabilir) aşağıdaki ş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>
   

   Aşağıda, görüntülendiğinde bir kaynağın kaydedilmesine neden olacak bir resim örneği verilmiştir:

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

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

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

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

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

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

   

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

4. Reklamverenin sitesinin alakalı her sayfasında (ö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=... adresine istek gönderir.

5. Bu URL'deki hizmet (genellikle reklamveren veya reklam teknolojisi sağlayıcısı) isteği alır. Bunu bir dönüşüm olarak sınıflandırmaya karar verir. Bu nedenle, tarayıcıya bir dönüşüm kaydetmesi, yani ilişkilendirmeyi tetiklemesi talimatı 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 veriler içeren özel bir HTTP başlığı ekler.

6. Kullanıcının yerel cihazındaki tarayıcı bu yanıtı alır ve dönüşüm verilerini orijinal kaynak etkinlikle (reklam tıklaması veya görüntüleme) eşleştirir. Kaynakları tetikleyicilerle eşleme başlıklı makalede daha fazla bilgi edinin.

7. Tarayıcı, attributionsrc adresine gönderilecek bir rapor planlar. Bu raporda şunlar yer alır:

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

   

8. 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 tetikleyicisi, tarayıcıya dönüşümleri yakalamasını söyleyen etkinliktir.

Reklamveren için en önemli dönüşümleri (ör. satın alma işlemleri) yakalamanızı öneririz. Özet raporlarda birden fazla dönüşüm türü ve meta veri yakalanabilir.

Bu sayede, toplu sonuçlar bu etkinlikler için ayrıntılı ve doğru olur.

Kaynakları tetikleyicilerle eşleştirme

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

Örneğin, tarayıcı shoes.example/shoes123 tarihinde adtech.example kaynağından bir ilişkilendirme tetikleyici aldığında yerel depolama alanında hem adtech.example hem de shoes.example ile eşleşen bir kaynak arar.

Bir tetikleyicinin ne zaman belirli bir kaynakla 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 raporları oluşturmanıza olanak tanır.

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

Veri toplama

İlgili bir kaynakla eşleşen bir ilişkilendirme tetikleyicisi, tarayıcı tarafından reklam teknolojisinin sahip olduğu bir sunucudaki 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 sitesinden) toplanan verilerin ve reklam teknolojisi tarafından toplanmadan önce kullanıcının cihazındaki tarayıcı tarafından oluşturulup şifrelenen dönüşüm verilerinin bir birleşimidir.

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 seçenekler gizliliği korur ve kullanıcıların işlemlerinin kötüye kullanılmasını önler.

Yalnızca etkinlik düzeyindeki raporlarla ilgileniyorsanız ihtiyacınız olan son altyapı budur. Ancak özet raporlar oluşturmak istiyorsanız birleştirilebilir raporları ek bir hizmetle işlemeniz gerekir.

Özet rapor oluşturma

Özet raporlar oluşturmak için toplu raporları işlemek üzere Toplama Hizmeti'ni (reklam teknolojisi tarafından işletilir) kullanırsınız. Toplama Hizmeti, kullanıcı gizliliğini korumak için gürültü ekler ve nihai özet raporunu döndürür.

Toplu olarak toplanabilir raporlar

Toplanabilir raporlar işlenmeden önce gruplandırılmalıdır. Grup, stratejik olarak gruplandırılmış birleştirilebilir raporlardan oluşur. Stratejiniz büyük olasılıkla belirli bir dönemi (ör. günlük veya haftalık) yansıtı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.

Yıllık indirim gibi daha yüksek hacme sahip olmasını beklediğiniz belirli etkinlikleri yakalayabilmeniz için toplu dönemler istediğiniz zaman değiştirilebilir. Gruplandırma dönemi, ilişkilendirme kaynaklarını veya tetikleyicileri değiştirmeye gerek kalmadan değiştirilebilir.

Aggregation Service

Özet rapor oluşturmak için birleştirilebilir raporları işlemekten Toplama Hizmeti sorumludur. Toplanabilir raporlar şifrelenir ve yalnızca güvenilir bir 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ülen ve toplanan sonuçlar, gizliliği korumak için gürültü eklenerek özet rapor olarak döndürülür.

Uygulamacılar, Toplama Hizmeti'ni yerel olarak test etmek için birleştirilebilir açık metin raporlar oluşturabilir. Dilerseniz Nitro Enclaves ile AWS'de şifrelenmiş raporlarla test edebilirsiniz.

Sırada ne var?

Herkes için yararlı bir API oluşturmak amacıyla sizinle iletişime geçmek istiyoruz.

API'yi 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 sohbete deneme yaparak ve katılarak katkıda bulunabilirsiniz.