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

İlişkilendirme Raporlamasını kullanmaya başlayın

Kurulum ve hızlı genel bakış dahil olmak üzere nereden başlayacağınızı öğrenin.

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, birleştirilebilir veya özet raporlardan daha az kurulum gerektirdiğinden iyi bir başlangıç noktası olabilir. Özet raporlar, Toplama Hizmeti ile entegrasyon gerektirir; etkinlik düzeyindeki raporlar için bu gerekli değildir.

Raporlamayı hem etkinlik düzeyinde hem de özet raporlar için ayarlayabilirsiniz. Bunlar birbirini tamamlar.

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 etkinlik düzeyinde hem de toplanabilir rapor oluşturulabileceğini unutmayın. Demo bu süreçte size yol gösterir.

Etkinlik düzeyinde rapor oluşturma

Etkinlik düzeyinde raporlar oluşturmak için izlemeniz gereken minimum adımlar şunlardır:

Kaynak kaydetme. Talimatlar için İlişkilendirme kaynaklarını kaydetme bölümüne bakın. Tıklamalar ve görüntülemeler için adımların farklı olduğunu unutmayın.
Tetikleyici kaydedin. Talimatlar için İlişkilendirme tetikleyicilerini kaydetme konusuna bakın.
Aşağıdaki URL'yi kullanarak 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 kodu inceleyin. .well-known hakkında daha fazla bilgiyi burada bulabilirsiniz.

Etkinlik düzeyindeki raporlar hakkında daha fazla bilgiyi burada bulabilirsiniz.

Özet rapor oluşturma

Özet raporlar oluşturmak için aşağıdaki üst düzey adımları izleyin:

Kaynak kaydetme. Talimatlar için İlişkilendirme kaynaklarını kaydetme bölümüne bakın. Tıklamalar ve görüntülemeler için adımların farklı olduğunu unutmayın. Ek ayrıntıları İlişkilendirme kaynağı kaydı bölümünde bulabilirsiniz.
Tetikleyici kaydedin. Talimatlar için İlişkilendirme tetikleyicilerini kaydetme konusuna bakın.
Birleştirilebilir raporlar için aşağıdaki URL'yi kullanarak 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 kodu inceleyin. .well-known hakkında daha fazla bilgiyi burada bulabilirsiniz.
Raporları toplu olarak gönderin ve Toplama Hizmeti tarafından daha fazla işlenmek üzere özet raporlar üretecek şekilde gönderin. Toplu halde toplanabilir raporlara bakın.

Özet raporlar hakkında daha ayrıntılı bilgiyi burada bulabilirsiniz.

Hata ayıklama raporlarının nasıl oluşturulacağını İlişkilendirme raporlaması için hata ayıklama serisinde öğrenebilirsiniz.

Özet raporlarıyla ilgili ek kavramlar

Aşağıdaki kavramlar, buradaki uygulama adımlarını anlamanın yanı sıra özet raporlama stratejinizi planlamanıza yardımcı olacaktır:

İsteğe bağlı adımlar

Filtre oluşturma (isteğe bağlı):
1. Filtreleri kullanarak özel kurallar tanımlama başlıklı makaledeki talimatları uygulayın.
2. Açıklama aracının tetikleyiciler bölümünde, birleştirilebilir raporlar için filtrelere özel ayrıntıları inceleyin.

Özellik algılamayı unutmayın

API'yi kullanmadan önce bir Permissions-Policy kullanarak sayfada engellenip engellenmediğini tespit edin. Bunun 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 denetimi "doğru" değerini döndürürse kontrolün çalıştırıldığı bağlamda (sayfa) API'ye izin verilir.

Bu kontrolün tek başına API'nin ilgili 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 ayarları olabilir. Kullanıcı gizliliğini korumak amacıyla bunu programatik olarak kontrol etmenin bir yolu yoktur.