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 raporlarda bu yoktur.

Raporlamayı hem etkinlik düzeyinde hem de özet raporlar için ayarlayabilirsiniz. Bunlar tamamlayıcıdır.

Etkinlik düzeyindeki raporlar

事件级报告：将（广告端）的特定广告点击或观看与转化端数据相关联。为了通过限制跨网站联接用户身份来保护用户隐私，转化端数据非常有限，并且数据非常嘈杂。

Özet raporlar

摘要报告是一种 Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据，并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比，摘要报告具有更大的灵活性和数据模型，尤其是对于某些应用场景（例如转化价值）。

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ı):
1. Şu adresteki talimatları uygulayın: Filtreleri kullanarak özel kurallar tanımlayın.
2. 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.