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

Bu kılavuzda, Attribution Reporting API'yi kullanan hem etkinlik düzeyindeki hem de özet ilişkilendirme raporları için genel bakış ve kurulum talimatları sağlanmaktadır.

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

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

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

  • Referans ve sorun giderme bilgilerini bulma

Rapor türü seçme

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

  • Etkinlik düzeyindeki raporlar: Belirli bir reklam tıklamasını veya görüntülemesini (kaynak) ilgili dönüşüm verileriyle (tetikleyici) bağlayan 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. Bunlar, kampanya erişimini ölçme gibi bağımsız etkinlik ilişkilendirmesinin önemli olduğu kullanım alanları için idealdir.

  • Özet raporlar: Toplu kullanıcı verileri sunar ve ek gürültü içeren daha ayrıntılı dönüşüm bilgileri içerebilir. Hem İlişkilendirme Raporlama API'si hem de Özel Toplama API'si kullanılarak toplu raporlardan oluşturulurlar ve etkinlik düzeyindeki raporlardan daha zengin bir veri modeli sunarlar. Özet raporlar, özellikle dönüşüm değerlerini hesaplama veya kullanıcı segmentleri genelinde kampanya performansını analiz etme gibi toplu analizler gerektiren senaryolar için kullanışlıdır.

Uygulamaya genel bakış

Aşağıdaki bölümlerde, her rapor türünün oluşturulmasına yönelik üst düzey adımlar özetlenmiştir. Ayrıca, tüm sürecin adım adım açıklamalı bir kılavuzu için Attribution Reporting API Demo'yu da takip edebilirsiniz.

Ön koşul: Kaynakları, tetikleyicileri kaydedip rapor alabilmek için sitelerinizin SSL/TLS sertifikalarına (HTTPS) sahip olması gerekir.

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: Bir reklam tıklamasını veya görüntülemesini 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 kaynağa bağlar. Talimatlar için İlişkilendirme tetikleyicilerini kaydetme başlıklı makaleyi inceleyin.

  3. Raporlama uç noktası ayarlama: Etkinlik düzeyinde rapor almak için sunucunuzda bir uç nokta oluşturun. Uç nokta URL'si şu biçimi izlemelidir: {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution. POST yönteminin ö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 fazla bilgi edinmek için Etkinlik düzeyindeki raporlarla ilgili açıklama başlıklı makaleyi inceleyin.

Özet rapor oluşturma

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

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

  3. Raporlama bitiş noktası oluşturma: Toplu raporlar almak için bir bitiş noktası oluşturun. URL şu şekilde olmalıdır: {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution. POST yöntemi örneği için adtech.js, .well-known hakkında bilgi için Wikipedia'ya bakın.

  4. Raporları gruplandırıp gönderme: Toplu raporları gruplandırıp işlenmek üzere Toplama Hizmeti'ne gönderin. Toplama Hizmeti daha sonra özet raporlar oluşturur. Daha fazla bilgi için Gruplandırma stratejileri başlıklı makaleyi inceleyin.

Özet raporlar hakkında daha fazla bilgi için Toplanabilir raporlarla ilgili açıklama 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 oluşturabilirsiniz.

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

Filtrelemeyi ayarlamak için Filtreleri kullanarak özel kurallar tanımlama başlıklı makaleyi inceleyin. Toplanabilir raporlara özgü ayrıntılar için İlişkilendirme tetikleyicisi kaydı başlıklı makalenin Tetikleyiciler bölümüne bakın.

API'nin etkinleştirildiğini doğrulama

API'yi kullanmadan önce aşağıdaki kodu kullanarak etkinleştirilip etkinleştirilmediğini kontrol edin:

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

Bu kontrol, API'ye geçerli bağlamda izin verilip verilmediğini gösterir. Ancak kullanıcının tarayıcı ayarları veya diğer faktörler API'nin kullanılmasını engellemeye devam edebilir. Gizlilik nedeniyle, API kullanılabilirliğini kesin olarak doğrulamanın programatik bir yolu yoktur.

Sonraki adımlar

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

Uygulama

Arka plan ve kavramlar

Demolar ve araçlar

Planlama