Kurulum ve hızlı genel bakış da dahil olmak üzere nereden başlayacağınızı buradan öğrenebilirsiniz.
Bir rapor türü seçin
Attribution Reporting API'yi kullanarak iki tür rapor oluşturabilirsiniz: etkinlik düzeyinde ve özet raporlar. Etkinlik düzeyindeki raporlar, toplanabilir veya özet raporlardan daha az kurulum gerektirdiğinden başlamak için iyi bir yer olabilir. Özet raporlar Toplama Hizmeti ile entegrasyon gerektirir; etkinlik düzeyindeki raporlarda bu yoktur.
Raporlamayı hem etkinlik düzeyinde hem de özet raporlar için ayarlayabilirsiniz. Bunlar tamamlayıcıdır.
Etkinlik düzeyindeki raporlar
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. Siteler arasında kullanıcı kimliğinin birleştirilmesini sınırlandırarak kullanıcı gizliliğini korumak için dönüşüm tarafı verileri son derece sınırlıdır ve veriler gürültülüdür.
Özet raporlar
Özet rapor, Attribution Reporting API ve Private Aggregation API rapor türüdür. Özet raporu, birleştirilmiş kullanıcı verilerini içerir ve gürültü eklenmiş ayrıntılı dönüşüm verileri içerebilir. Özet raporlar, toplu raporlardan oluşur.
Uygulama
Aşağıdaki adımları deneyerek başlayabilirsiniz.
Belirli bir etkinlik kaynağı için hem bir etkinlik kaynağı oluşturmanın hem de etkinlik düzeyinde ve toplu bir rapordan oluşur. İlgili içeriği oluşturmak için kullanılan demo bu süreçte size yol gösterir.
Etkinlik düzeyinde rapor oluşturma
Etkinlik düzeyinde raporlar oluşturmak için uygulanması gereken minimum adımlar şunlardır:
Kaynak kaydedin. Talimatlar için İlişkilendirme kaynaklarını kaydetme bölümüne bakın. Adımların tıklamalar ve görüntülemeler için farklı olduğunu unutmayın.
Tetikleyici kaydedin. Talimatlar için İlişkilendirme tetikleyicilerini kaydetme bölümüne bakın.
Şu URL ile bir uç nokta oluşturun:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
.
.POST
yöntemini görmek için adtech.js'deki örnek koda ve.well-known
hakkında daha fazla bilgi için Wikipedia'ya bakın.
Daha fazla ayrıntıyı etkinlik düzeyindeki rapor açıklayıcıda bulabilirsiniz.
Özet rapor oluşturma
Özet raporlar oluşturmak için aşağıdaki üst düzey adımları uygulayın:
Kaynak kaydedin. Talimatlar için İlişkilendirme kaynaklarını kaydetme bölümüne bakın. Adımların tıklamalar ve görüntülemeler için farklı olduğunu unutmayın. Daha fazla ayrıntıyı İlişkilendirme kaynak kaydı bölümünde bulabilirsiniz.
Tetikleyici kaydedin. Talimatlar için İlişkilendirme tetikleyicilerini kaydetme bölümüne bakın.
Şu URL ile toplanabilir raporlar için bir uç nokta oluşturun:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
.
.POST
yöntemini görmek için adtech.js'deki örnek koda ve.well-known
hakkında daha fazla bilgi için Wikipedia'ya bakın.Özet raporlar oluşturan Toplama Hizmeti tarafından daha ayrıntılı işlenmek üzere raporları toplu olarak gönderebilir ve gönderebilirsiniz. Toplu toplanabilir raporlar başlıklı makaleyi inceleyin.
Daha fazla bilgiyi toplanabilir rapor açıklayıcısında bulabilirsiniz.
Hata ayıklama raporlarını nasıl oluşturacağınızı İlişkilendirme raporu hata ayıklama serisinde öğrenebilirsiniz.
Özet raporlarda ek kavramlar
Buradaki uygulama adımlarını anlamanın yanı sıra aşağıdaki kavramlar, özet raporlama stratejinizi planlamanıza yardımcı olacaktır:
İsteğe bağlı adımlar
- Filtre oluşturun (isteğe bağlı):
- Şu adresteki talimatları uygulayın: Filtreleri kullanarak özel kurallar tanımlayın.
- Google Analytics 4'teki birleştirilebilir raporlar için filtrelere özel ayrıntıları inceleyin tetikleyiciler bölümünü .
Özellik algılamayı unutmayın
API'yi kullanmadan önce, bir izin politikası kullanarak sayfada engellenip engellenmediğini tespit edin. Bu işlemi yapmak için aşağıdaki kodu çalıştırın:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
Bu özellik algılama kontrolü "doğru" döndürürse kontrolün gerçekleştirildiği bağlamda (sayfada) API'ye izin verilir.
Tek başına bu kontrolün, API'nin söz konusu sayfada kullanılabilir olduğunu garanti etmediğini unutmayın; kullanıcı, tarayıcı ayarlarını kullanarak API'yi devre dışı bırakmış olabilir veya API'nin kullanılmasını engelleyen başka ayarlara sahip olabilir. Kullanıcı gizliliğini korumak için bunu programatik olarak kontrol etmenin bir yolu yoktur.
Sonraki adımlar
Uygulamaya başlamaya hazırsanız şu belgelere göz atın:
Kurulum
- İlişkilendirme kaynağı kaydetme
- İlişkilendirme tetikleyicisi kaydetme
- Belirli tıklamalara, görüntülemelere veya dönüşümlere öncelik verme
- İlişkilendirme raporlarında hata ayıklama
- Toplama anahtarları
Arka plan
- Etkinlik düzeyindeki raporlarla İlişkilendirme Raporları
- Birleştirilebilir Raporlarla İlişkilendirme Raporları
- Toplama Raporlama verileriyle ilgili kısıtlamalar
- Gürültüyü anlama
- Gürültüyle çalışma
Demolar ve araçlar
Planlama
Hâlâ planlama aşamasındaysanız şu belgelere göz atın: