Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

İlişkilendirme Raporları için bağlı hizmetlere üst düzey genel bakış. Teknik karar mercileri hedeflenir.

Attribution Reporting API, reklam teknolojilerin ve reklamverenlerin Reklam tıklaması veya görüntülemenin, satın alma gibi bir dönüşümle sonuçlanması. Bu API, bağlı olarak işletme hedeflerinize bağlı olarak istemci taraflı ve sunucu tarafı entegrasyonlarının bir birleşimini işleyeceğiz.

Devam etmeden önce İlişkilendirme Raporlarına genel bakış Bu, API'nin amacını ve farklı çıkış raporlarının akışını anlamanıza yardımcı olur (etkinlik düzeyinde rapor ve özet raporları arasında). Tanımadığınız terimlerle karşılaşırsanız lütfen Özel Korumalı Alan sözlüğü.

Bu makale kimler için hazırlandı?

Bu makaleyi aşağıdaki durumlarda okumalısınız:

Bir reklam teknolojisi veya reklamverenin teknik karar mercii olmanız gerekir. Çalışabilirsiniz pazarlama departmanı gibi alanlarda teknik uygulama kararları alabilirsiniz. API'lerin gizliliği korumaya yönelik ölçümlerde nasıl çalıştığını merak ediyorsunuz.
Teknik pratisyen uzman (ör. geliştirici, sistem operatörü, sistem mimarı veya veri bilimci) diyebiliriz. kullanıma sunuyoruz.

Bu makalede, bir projeyi çok daha verimli ve verimli bir şekilde yönetmek için hizmetleri Attribution Reporting API için nasıl çalışır? Teknik bir iş bir uzmansanız bu API ile deneme yerel olarak.

Genel Bakış

Attribution Reporting API, hangi birçok hizmetten oluşur? istemci taraflı yapılandırmalar ve sunucu dağıtımlarını kapsar. Neyin ne zaman İlk olarak:

Tasarımla ilgili kararlar alma. Hangi bilgileri toplamak istediğinizi belirleyin, belirli bir kampanyadan hangi dönüşümleri beklediğinizi belirleyin ve hangi rapor türünü toplayacağınızı belirleyin. Nihai çıktı, şu iki rapor türünden biri ya da her ikisidir: etkinlik düzeyinde raporlar ve özet raporlar.

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

Web sitesinden tarayıcıya iletişim. İçinde dönüşüm ve reklam etkileşimlerine dair bilgilerin, sizin veya bir analiz hizmetinin katılabilmenizi sağlayan bir tanımlayıcıya ekli bu etkinlikleri daha sonra takip edebilirsiniz. Bu API sayesinde tarayıcı, dönüşümleri için yayınlanmadan önce, talimatlarınıza göre reklam tıklamaları/görüntülemeleri analiz. Bu nedenle, reklam oluşturma kodunuz ve dönüşüm izlemeniz:
- Tarayıcıya hangi dönüşümlerin hangi reklamla ilişkilendirilmesi gerektiğini bildirin tıklama sayısı veya gösterim sayısı.
- Nihai raporlara dahil edilecek diğer verileri de bildirin.
Veri toplama. Aşağıdaki işlemler için toplayıcı uç noktasına ihtiyacınız olacaktır: kullanıcıların elde ettiği raporları izin verir. Tarayıcılardan alınan çıkış iki olası rapordan biri olabilir: etkinlik düzeyindeki raporlar ve toplanabilir raporlar (şifrelenmiş raporlar ve özet raporları oluşturmak için kullanılan) raporlar.

Birleştirilebilir raporlar topladıysanız üçüncü bir bileşene ihtiyacınız olur:

Özet rapor oluşturma. Toplu ve raporları işlemek için Toplama Hizmeti'ni kullanma kullanarak özet rapor oluşturabilirsiniz.

Tasarımla ilgili kararlar

İlişkilendirme Raporlarının temel ilkelerinden biri, erken tasarım kararlarıdır. Siz karar verin hangi kategorilerde hangi verilerin toplanacağını ve bu verilerin ne sıklıkta işleneceğini dışı verilerdir. Çıktı raporları, kampanyalarınız veya işletmenizle ilgili analizler sağlar.

Çıkış raporu şöyle 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 (bu, durumların küçük bir yüzdesi için gerçek raporlar yerine rastgele veriler gönderilir).
Özet raporlar, reklam tarafındaki 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ştirmek için esneklik sunar.

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

Nihai çıktıyı aynı zamanda proje yaşam döngüsü boyunca kullandığınız kararlar alabilir. Örneğin, projenizin her bir çok sayıda dönüşümün gerçekleşmesini sağlayan toplam harcama değeri, toplam harcama miktarını artırmak için bir sonraki reklam kampanyanızın hedeflemesi gereken tutarı girin.

Neyi ölçmek istediğinize karar verdikten sonra ilişkilendirmesine yardımcı olur.

Web sitesinden tarayıcıya iletişim

Yayıncının web sitesindeki ilişkilendirme kaynakları, reklamverenin web sitesindeki tetikleyicilere bağlanır.

İlişkilendirme etkinlik akışı

Reklam gösteren bir yayıncı sitesi düşünün. Her reklamveren veya reklam teknolojisi sağlayıcı, reklamlarıyla kurulan 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 gibi oluşturulur:

Yayıncı sitesinde, attributionsrc özel özelliğiyle bir reklam öğesi (<a> veya <img> etiketi) yapılandırılmıştır. Bu alanın değeri bir URL'dir (örneğin, https://adtech.example/register-source/ad_id=...).

Tıklandığında bir kaynağı kaydedecek bağlantının örneğini burada 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 kaynak kaydına 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ı kullanılabilir.

Aşağıda, window.open() kullanan bir JavaScript örneği verilmiştir. Ö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});
```

Kullanıcı reklamı tıkladığında veya görüntülediğinde tarayıcı attributionsrc adresine bir GET isteği gönderir. Bu istek genellikle bir reklamveren ya da reklam teknolojisi sağlayıcı uç noktasıdır.
Reklamveren veya reklam teknolojisi sağlayıcı, bu isteği aldıktan sonra tarayıcıya reklamla etkileşimler için kaynak etkinlikleri kaydetmesi ve dönüşümlerin daha sonra bu reklamla ilişkilendirilebilmesi için talimat vermeye karar verir. Bunu yapmak için reklamveren veya reklam teknolojisi sağlayıcı, yanıtına özel bir HTTP başlığı ekler. Bu başlıktaki özel verilere, kaynak etkinlik (reklam tıklaması veya görüntüleme) hakkında bilgi sağlayan özel veriler ekler. Bu reklam için dönüşüm gerçekleşirse söz konusu özel veriler ilişkilendirme raporunda gösterilir.
Daha sonra, kullanıcı reklamverenin sitesini ziyaret eder.
Reklamverene ait sitenin ilgili her bir 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=... için istekte bulunur.
Bu URL'deki hizmet (genellikle reklamveren veya reklam teknolojisi sağlayıcı) isteği alır. Bunu bir dönüşüm olarak kategorize etmeye karar verdiğinden, tarayıcıya bir dönüşüm kaydetmesi, yani ilişkilendirmeyi tetiklemesi için 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.
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şleştirme bölümünden daha fazla bilgi edinebilirsiniz.
Tarayıcı, attributionsrc adresine gönderilecek bir rapor planlar. Bu rapor şunları içerir:
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.
Daha sonra tarayıcı, raporları attributionsrc içinde tanımlanan uç noktaya bir gecikme ve gürültüyle gönderir. Toplanabilir raporlar şifrelenir, ancak 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.

Başarılı bir raporlama için en önemli dönüşümleri (satın almalar gibi). Birden çok dönüşüm türü ve meta veri özet olarak kaydedebilirsiniz.

Böylece, söz konusu etkinliklerle ilgili toplu sonuçların ayrıntılı ve doğru olması sağlanır.

Kaynakları tetikleyicilerle eşleştir

Tarayıcı, ilişkilendirme tetikleyicisi yanıtı aldığında her iki ilişkilendirme tetikleyicisinin de değeri ile eşleşen bir kaynak bulmak için yerel depolama alanını kaynak ve sayfa URL'sinin eTLD+1'dir.

Örneğin tarayıcı, shoes.example/shoes123 üzerinde adtech.example ise, tarayıcı şurada kaynak arar: hem adtech.example hem de shoes.example ile eşleşen yerel depolama alanı.

Bir tetikleyicinin ne zaman eşleşeceğini belirlemek için filtreler (veya özel kurallar) ayarlanabilir ekleyebilirsiniz. Örneğin, yalnızca bir kampanyaya ait dönüşümleri sayacak bir filtre belirli bir ürün kategorisini seçebilir ve diğer tüm kategorileri göz ardı edebilirsiniz. Filtreler ve Önceliklendirme modelleri, daha gelişmiş ilişkilendirme raporlaması sağlar.

Yerel depolama alanında birden fazla ilişkilendirme kaynağı bulunursa tarayıcı en son depolanan bildirimi gösterir. İlişkilendirmenin kaynaklandığı bir öncelik atandığında, tarayıcı en yüksek önceliğe sahip kaynağı seçer öncelik sırasına koyabilirsiniz.

Veri toplama

Karşılık gelen kaynakla eşleşen ilişkilendirme tetikleyicisi birlikte şu şekilde gönderilir: Tarayıcı tarafından, reklam teknolojisine ait bir sunucudaki raporlama uç noktasına gönderilen bir rapor (Bazen koleksiyon uç noktası veya toplama hizmeti olarak da adlandırılır). Bu raporlar, etkinlik düzeyinde raporlar veya toplu raporlar olabilir.

Birleştirilebilir raporlar özet raporlar oluşturmak için kullanılır. Toplanabilir rapor, reklamdan (yayıncının sitesinde) ve dönüşüm verilerinden (yayıncının sitesinden reklamverenin sitesi) web'de tarayıcı tarafından oluşturulan ve şifrelenir. toplamadan önce kullandığı tüm cihazlardır.

Etkinlik düzeyindeki raporlar 2 ila 30 gün gecikmelidir. Birleştirilebilir raporlar bir saat içinde rastgele bir gecikmeyle gönderilir ve etkinliklerin, katkı bütçesini nasıl kullanacağınızı belirleyin. Bu tercihler gizliliği korur ve bireysel kullanıcı işlemlerinin kötüye kullanılmasını önler.

Yalnızca etkinlik düzeyindeki raporlarla ilgileniyorsanız, bu bu kadar. Ancak, özet raporlar oluşturmak istiyorsanız toplanabilir raporları ek bir hizmetle işlemeniz gerekiyor.

Özet rapor oluşturma

Özet raporları oluşturmak için Toplama Hizmeti (reklam teknolojisi tarafından işletilir) tarafından işletilebilir. Toplama Hizmet, kullanıcı gizliliğini korumak için gürültü ekler ve nihai özet raporu sunar.

Toplanabilir raporlar toplanır, toplu hale getirilir ve reklam teknolojisi ortamına gönderilir. — Bu şema, eş zamanlı olmayan akışı verilerin toplu hale getirilmesini, bunların toplu hale getirilmesini ve veri toplama işini bir araya getirir.

Toplanan birleştirilebilir raporlar toplu hâle getirildikten sonra grup işlenir. toplama hizmeti sunar. CEVAP koordinatör Şifre çözme anahtarlarını yalnızca Toplamanın onaylanmış sürümlerine verir Hizmet. Ardından Toplama Hizmeti verilerin şifresini çözer ve ve sonuçları özet rapor olarak döndürmeden önce gürültü ekleyebilir.

Toplu olarak toplanabilir raporlar

Birleştirilebilir raporlar işlenmeden önce toplu hale getirilmelidir. Bir grup stratejik olarak gruplandırılmış, birleştirilebilir raporlardan oluşur. Stratejiniz, en çok belirli bir dönemi yansıtıyor olabilir (örneğin, günlük veya haftalık). Bu işlemi, raporlama uç noktanız olarak işlev gören aynı sunucuda gerçekleşebilir.

Gruplar, sinyal-gürültü oranının yüksek olmasını sağlamak için çok sayıda rapor içermelidir.

Daha uzun dönemler daha az parazitli sonuçlar sağlar. — 1 gün ve 1 hafta beklemeyi karşılaştırın. 1 saat içinde daha küçük bir özet değeri elde edecek ve muhtemelen daha parazitli sonuçlar elde edebileceksiniz. Bir gün içinde daha büyük bir özet değeriniz olur. Bu nedenle, daha az gürültü olabilir.

Belirli etkinlikleri yakalamanızı sağlamak için toplu dönemler herhangi bir zamanda değişebilir. (ör. yıllık indirim gibi) daha yüksek hacim beklediğiniz durumlardan yararlanın. Toplu işleme süresi ilişkilendirme kaynaklarını veya tetikleyicilerini değiştirmenize gerek kalmadan değiştirilebilir.

Aggregation Service

Toplama Hizmeti, özet rapor oluşturabilirsiniz. Toplanabilir raporlar şifrelenir ve yalnızca güvenilir bir yürütme ortamında çalışan Toplama Hizmeti tarafından okunur (TEE) tuşlarına basın.

Toplama Hizmeti, koordinatörden şifre çözme anahtarları ister şifreleme ve birleştirme çözümüdür. Şifresi çözülüp toplandıktan sonra sonuçlar ve gizliliği korumak amacıyla bu veriler gürültüden çıkarılır ve özet rapor olarak döndürülür.

Uzmanlar, toplu haldeki verilere erişmek için Toplama Hizmeti'ni yerel olarak test edin. Alternatif olarak, AWS'de Nitro Enclaves ile şifrelenmiş raporlarla test edebilirsiniz.

Sırada ne var?

Sizinle konuşmalar yaparak bu API'yi geliştirdiğimizden emin olmak istiyoruz. işe yarar.

API'yi tartışın

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

API ile denemeler yapma

Deneme yapabilir ve katılabilirsiniz hakkında konuştuk.