İlişkilendirme raporlarını kullanmaya başlama

Bu kılavuzda, Attribution Reporting API kullanılarak oluşturulan hem etkinlik düzeyinde hem de özet ilişkilendirme raporlarına ilişkin genel bakış ve kurulum talimatları yer almaktadır.

Başlangıç olarak şunları öğreneceksiniz:

  • Attribution Reporting API rapor türleri arasındaki farklar

  • API uygulama ve rapor oluşturma adımlarını tamamlama

  • Referans ve sorun giderme bilgilerini bulma

Rapor türü seçme

Attribution Reporting API, reklam kampanyası performansını farklı ayrıntı ve gizlilik düzeylerinde etkili bir şekilde ölçmek için iki farklı rapor türü sunar:

  • Etkinlik düzeyindeki raporlar: Belirli bir reklam tıklamasını veya görüntülemeyi (kaynak) karşılık gelen dönüşüm verileriyle (tetikleyici) ilişkilendiren ayrıntılı veriler sağlar. Etkinlik düzeyindeki raporlar, dönüşüm verilerinin miktarını sınırlar ve raporlara gürültü ekler. Kampanya erişimini ölçme gibi, bağımsız etkinlik ilişkilendirmesinin önemli olduğu kullanım alanları için idealdir.

  • Özet raporlar: Toplanmış kullanıcı verileri sunar ve eklenen gürültüyle birlikte daha ayrıntılı dönüşüm bilgileri içerebilir. Hem Attribution Reporting API hem de Private Aggregation API kullanılarak oluşturulan toplu raporlar, etkinlik düzeyindeki raporlara kıyasla daha zengin bir veri modeli sunar. Özet raporlar, özellikle dönüşüm değerlerini hesaplama veya kampanya performansını kullanıcı segmentleri genelinde analiz etme gibi toplu analizler gerektiren senaryolarda kullanışlıdır.

Uygulamaya genel bakış

Aşağıdaki bölümlerde, her rapor türünü oluşturmayla ilgili üst düzey adımlar özetlenmektedir. Tüm sürecin adım adım açıklamalı kılavuzu için Attribution Reporting API Demosu'nu da inceleyebilirsiniz.

Ön koşul: Kaynakları ve tetikleyicileri kaydedip rapor alabilmeniz için sitelerinizde SSL/TLS sertifikaları (HTTPS) bulunmalıdır.

Etkinlik düzeyinde rapor oluşturma

Aşağıdaki adımlarda, etkinlik düzeyinde raporların nasıl oluşturulacağı açıklanmaktadır:

  1. Kaynak kaydetme: Reklam tıklaması veya görüntülemeyi ilişkilendirme bilgileriyle ilişkilendirir. Ayrıntılı talimatlar için İlişkilendirme kaynaklarını kaydetme ve İlişkilendirme kaynağı kaydı başlıklı makaleleri inceleyin. Kayıt işleminin tıklamalar ve görüntülemeler için biraz farklı olduğunu unutmayın.

  2. Tetikleyici kaydetme: Bir dönüşüm etkinliğini kaydeder ve daha önce kaydedilmiş bir kaynakla ilişkilendirir. Talimatlar için İlişkilendirme tetikleyicilerini kaydetme başlıklı makaleyi inceleyin.

  3. Raporlama uç noktası ayarlama: Etkinlik düzeyindeki raporları almak için sunucunuzda bir uç nokta oluşturun. Uç nokta URL'si şu biçimde olmalıdır: {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution. POST yönteminin bir örneği için adtech.js bölümündeki örnek koda bakın. .well-known hakkında daha fazla bilgi için Wikipedia'ya göz atın.

Etkinlik düzeyindeki raporlar hakkında daha ayrıntılı bilgi için Etkinlik düzeyinde rapor açıklayıcısı başlıklı makaleyi inceleyin.

Özet rapor oluşturma

  1. Kaynak kaydetme: Etkinlik düzeyindeki raporlarla aynıdır. Ayrıntılı bilgi için İlişkilendirme kaynaklarını kaydetme ve İlişkilendirme kaynağı kaydı başlıklı makaleleri inceleyin.

  2. Tetikleyici kaydetme: Etkinlik düzeyindeki raporlarla aynıdır. İlişkilendirme tetikleyicilerini kaydetme başlıklı makaleyi inceleyin.

  3. Raporlama uç noktası oluşturun: Toplu raporları almak için bir uç nokta oluşturun. URL şu olmalıdır: {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution. POST yöntemi örneği için adtech.js, .well-known bilgileri için Vikipedi'ye bakın.

  4. Raporları gruplandırıp gönderme: Toplu raporları gruplandırın ve işlenmek üzere Toplama Hizmeti'ne gönderin. Ardından Aggregation Service, özet raporlar oluşturur. Daha fazla bilgi için Toplu işleme stratejileri başlıklı makaleyi inceleyin.

Özet raporlar hakkında daha ayrıntılı bilgi için Toplanabilir rapor açıklayıcısı başlıklı makaleyi inceleyin.

Uygulama adımlarına ek olarak, aşağıdaki konular özet raporlama stratejinizi planlamanıza yardımcı olacaktır:

Filtre oluşturma (isteğe bağlı)

Aldığınız ilişkilendirme verileri üzerinde daha ayrıntılı kontrol sahibi olmak için filtreler ayarlayabilirsiniz.

Filtreleme, analiziniz için belirli veri alt kümelerini izole ederek gürültüyü azaltan, hassas bir veri analizi sağlar. Ayrıca, daha hassas ölçüm için belirli reklam kampanyalarının ve dönüşüm etkinliklerinin performansını izlemeye yardımcı olur.

Filtreleme ayarlamak için Filtreleri kullanarak özel kurallar tanımlama başlıklı makaleyi ve toplanabilir raporlarla ilgili ayrıntılar için İlişkilendirme tetikleyici kaydı bölümündeki tetikleyiciler kısmını inceleyin.

API'nin etkinleştirildiğini doğrulama

API'yi kullanmadan önce aşağıdaki kodu kullanarak etkin olup olmadığını kontrol edin:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

Bu kontrol, API'nin geçerli bağlamda kullanılmasına izin verilip verilmediğini gösterir. Ancak kullanıcı tarayıcı ayarları veya diğer faktörler, API'nin kullanılmasını yine de engelleyebilir. Gizlilikle ilgili hususlar nedeniyle, API'nin kullanılabilirliğini kesin olarak onaylamanın programatik bir yolu yoktur.

Sonraki adımlar

Aşağıdaki bölümlerde, ilişkilendirme raporlamasına başlama hakkında daha fazla bilgi verilmektedir.

Uygulama

Arka plan ve kavramlar

Demolar ve araçlar

Planlama