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

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

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 raporlar ise entegrasyonu gerektirmez.

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 etkinlik düzeyinde hem de toplu hale getirilebilir bir rapor oluşturulabileceğini unutmayın. Demo süreç boyunca 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.
Toplanabilir raporlar için şu URL ile 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ı):
1. Filtreleri kullanarak özel kurallar tanımlama sayfasındaki talimatları uygulayın.
2. Açıklayıcı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 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.

Bu kontrolün tek başına API'nin söz konusu sayfada kullanılabildiğini garanti etmediğini unutmayın. Kullanıcı, tarayıcı ayarlarını kullanarak API'yı 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.