İlişkilendirme Raporlama teklifi, Chrome 104 sürümü için değişiyor. Yeni API mekanizmaları, işlevleri ve toplama hizmetine yönelik güncellemeler var.
Bu güncellemeler kimin için?
Bu güncellemeler, aşağıdaki durumlarda size özeldir:
- API'yi zaten biliyorsunuz. Örneğin, WICG deposundaki tartışmaları gözlemliyor veya bu tartışmalara katılıyor ve API'de yapılan değişiklikleri anlamak istiyorsanız API'ye aşinasınızdır.
- Attribution Reporting API'yi bir demoda kullanıyorsunuz veya kaynak denemesinde test etmeyi planlıyorsunuz.
Bu API'yi kullanmaya yeni başladıysanız ve/veya henüz denemediyseniz doğrudan API'ye giriş bölümüne gidin.
Attribution Reporting API güncellemeleri
İlişkilendirme Raporlama demosu, Attribution Reporting istemci tarafı API'sinde yapılan en son değişiklikleri yansıtacak şekilde güncellendi.
Çoğu değişiklik için herhangi bir işlem yapılması gerekmez. Uygulamanız için güncelleme gerektirenler aşağıda vurgulanmıştır.
(İşlem gerekli) Kayıt için birleştirilmiş üstbilgiler
Başlıklar birleştirildi. Artık kaynaklar için yalnızca bir üstbilgi, tetikleyiciler için de JSON biçiminde biçimlendirilmiş bir üstbilgi bulunmaktadır.
- İlişkilendirme kaynaklarını kaydetmek için kayıt isteklerine
Attribution-Reporting-Register-Source
başlığıyla yanıt verebilirsiniz. - Tetikleyici kaydını tamamlamak için
Attribution-Reporting-Register-Trigger
başlığını ayarlayın.
Bu değişiklik için işlem yapılması gerekiyor. Daha fazla bilgi için API geliştirici kılavuzuna bakın.
(İşlem gerekli) toplama anahtarları artık bir sözlük
Atıf kaynaklarını kaydetmek için aggregation_keys
kullanmaya devam edin ancak artık liste yerine JSON sözlüğü olarak depolanıyor.
Örneğin:
"aggregation_keys": {
// Generate a "0x159" key piece for the key named "campaignCounts".
"campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)
// Generates a "0x5" key piece (low order bits of the key) for
// the key named "geoValue".
"geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
}
Bu değişiklik için işlem yapılması gerekiyor. Daha fazla bilgi için API el kitabına bakın.
Rapor oluşturma
Yalnızca özet raporlar halinde birleştirilebilen toplanabilir raporlar oluşturmayı tercih edebilirsiniz. Filtreleriniz herhangi bir etkinlik tetikleyicisiyle eşleşmezse etkinlik düzeyinde raporlar oluşturulmaz.
Birleştirilmiş hata ayıklama anahtarı ayarı
Hata ayıklama anahtarı artık ayrı başlıklar yerine kaynak ve tetikleyici üst bilgilerinde ayarlanmış olmalıdır. Raporlarda hata ayıklama hakkında daha fazla bilgi
İlişkilendirme kaynaklarını kaydetme
Komut dosyası etiketleri, artık <img>
etiketi desteğine benzer şekilde, ilişkilendirme kaynaklarını kaydetmek için kullanılabilir.
Daha fazla API güncellemesi
Yapılan ve API el kitabında belirtilen diğer değişiklikler arasında şunlar yer almaktadır:
- Kaynaklar, JavaScript istek API'leriyle kaydedilebilir.
window.registerSource
kaldırıldı.- Artık kaynakları kaydederken
attributionsrc
için bir değer eklemek isteğe bağlıdır. - Gelen kaynak kayıt isteklerine
Attribution-Reporting-Eligible
üstbilgisi eklendi. encodeURIComponent
ile ilgili küçük bir değişiklik yapıldı.- Gizlilik bütçe anahtarı, toplanabilir raporlardaki
shared_info
alanından kaldırılmıştır.
Toplama Hizmeti için destek
Chrome 104'te, birleştirilebilir raporlardaki bazı bilgilerin biçimini güncellemeyi amaçlıyoruz. Şu anda Toplama Hizmeti'nde bu değişiklik için destek oluşturuyoruz. Değişiklikler gönderildikten sonra bu belge ve değişiklik günlüğü güncellenir.
Özet raporlar oluşturmaya yönelik pratik ipuçları ve stratejiler içeren bir doküman topladık. Aşağıdakiler de dahil olmak üzere çok sayıda analiz mevcuttur:
- Özet rapor oluşturmada gürültüye genel bakış
- Boyut, anahtar ve değerlerin ayrıntılı açıklaması
- Anahtar yapı haritası dahil olmak üzere kullanımdaki toplama anahtarları
- Uygulamadaki birleştirilebilir değerler ve katkı bütçesinin etkileri
- Epsilon deneyleri kılavuzu
Güncellemeler hakkında daha fazla bilgi
- API hakkında bilmeniz gerekenler başlıklı makaleyi inceleyin.
- İlişkilendirme Raporları ile Deneme: Özet raporlar için strateji ve ipuçları başlıklı makaleyi okuyun.
Başlık resmi, Unsplash'teki Diana Polekhina'dan alınmıştır.