İ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

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:

  1. 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.

  2. Tetikleyici kaydedin. Talimatlar için İlişkilendirme tetikleyicilerini kaydetme bölümüne bakın.

  3. Ş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:

  1. 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.

  2. Tetikleyici kaydedin. Talimatlar için İlişkilendirme tetikleyicilerini kaydetme bölümüne bakın.

  3. Ş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.

  4. Ö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

  1. 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.

Sonraki adımlar

Uygulamaya başlamaya hazırsanız şu belgelere göz atın:

Kurulum

Arka plan

Demolar ve araçlar

Planlama

Hâlâ planlama aşamasındaysanız şu belgelere göz atın: