Haziran 2022'deki İlişkilendirme Raporlama güncellemeleri

İ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:

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

Başlık resmi, Unsplash'teki Diana Polekhina'dan alınmıştır.