Geliştiricilerin Chrome ve Android'de Özel Korumalı Alan alaka düzeyi ve ölçüm API'lerine erişebilmesi için Özel Korumalı Alan'a kaydolması gerekir. Buna Attribution Reporting, Protected Audience, Topics, Private Aggregation ve Shared Storage dahildir. Geliştirici kaydı, bu API'leri çağıran kuruluşları doğrular ve API'leri düzgün şekilde yapılandırmak ve kullanmak için gereken verileri toplar. Kaydolma, veri toplayan kişilerle ilgili koruma ve şeffaflık konusunda ek bir katman sağlar. Ayrıca, API'leri kullanarak gerekli olmayan verileri toplama girişimlerini azaltır. Denetlenebilir şeffaflık sağlamak için şirketin kayıt bilgileri herkese açık hale getirilir. Şirketler, kayıt sürecini tamamlamak için en az beş hafta planlamalıdır. Buna, konsol gönderimiyle ilgili beklenmedik sorunları veya ortaya çıkabilecek diğer sorunları giderme süresi de dahildir. Bu süre, şirketlerin formu göndermeden önce dahili hazırlık için ihtiyaç duyabileceği ek süreyi içermez.
Başlamadan önce
Kaydı başlatmadan önce Privacy Sandbox Console'u kullanarak bir hesap oluşturun. Hesap oluşturma hakkında daha fazla bilgi edinin.
Kaydolma
Kaydolmak için geliştiricilerin Özel Korumalı Alan Console'u kullanması gerekir. Aşağıdaki bilgileri sağlamanız gerekir:
- İşletmenizle ilgili bilgiler
- Buna, iletişim için e-posta adresi ve gizlilik politikalarınızın bağlantıları dahildir.
- Kullanmayı planladığınız API'ler ve hizmetler
- Bazı hizmetler için ek bilgi (ör. Cloud sağlayıcınızla ilgili ayrıntılar) gerekir.
- Kaydetmek istediğiniz SDK'ların sitesi veya adı
- API'leri buradan çağırabilirsiniz.
- API'leri kullanımınızla ilgili onaylar
- Bir siteyi kaydettiriyorsanız sunucunuza bir onay dosyası yüklemeniz gerekir.
Sitenizi, Android SDK'nızı veya Android uygulamanızı kaydetme
Kaydolma sırasında, API'leri çağırmak için kullanacağınız bir site veya SDK (ya da her ikisi) sağlamanız gerekir.
Kaydolma şekliniz, Özel Korumalı Alan API'lerinin nasıl çağrıldığına bağlıdır:
- Web geliştiriciyseniz ve siteniz Özel Korumalı Alan API'lerini doğrudan çağırıyorsa kaydolurken sitenizi sağlamanız gerekir.
- Android SDK geliştiricisiyseniz kaydolurken SDK adınızı belirtin. SDK'nız Attribution Reporting, Protected Audience veya her iki API'yi de kullanıyorsa kaydolurken sitenizi de belirtin. SDK'nızı kullanan uygulamaların, kendi kodlarından doğrudan Privacy Sandbox API'lerini çağırmadıkları sürece ayrı ayrı kaydolmaları gerekmez. Android'de Attribution Reporting API'leri hemen büyük ölçekte test ediyorsanız kullandığınız tüm kaynakları sağlamanız gerekir.
- Uygulama geliştiriciyseniz ve uygulamanız doğrudan Attribution Reporting, Protected Audience veya her iki API'yi de çağırıyorsa kayıt sırasında sitenizi sağlamanız gerekir.
- Uygulama geliştiriciyseniz ve reklam işlevinizi tamamen bir SDK'ya devrediyorsanız kayıt sürecinden geçmeniz gerekmez.
Özel Korumalı Alan API'lerini çağıran her site veya SDK'nın benzersiz bir kaydı olması ve ayrı ayrı tasdik etmesi gerekir. Özel Korumalı Alan API'lerini doğrudan çağıran uygulamalar tek bir kayda dahil edilebilir. Birden fazla API çağırmayı planlıyorsanız kayıt işlemi sırasında her birini belirtin. Not: Kaydolduğunuz site, Android'de Konular'ın kullanımı için şifreleme anahtarlarını ve Android'de Protected Audience'ın kullanımı için imzalama anahtarını almak üzere kullanılacak sitedir. Android'deki Konular için şifreleme uç noktası hakkında daha fazla bilgi ve Protected Audience için imzalama anahtarları hakkında daha fazla bilgi.
Kaydolma bilgilerini güncelleme
Kaydınız tamamlandıktan sonra kayıt ayrıntılarınızı konsol üzerinden güncelleyebilirsiniz. Değişiklikleriniz incelenirken mevcut kaydınız etkin kalır.
Aşağıdaki bilgilerden herhangi biri değişirse onay dosyanızın yeni bir sürümünü yeniden yüklemeniz gerekir:
- Gizlilik politikası bağlantıları
- Site bilgileri
- Seçilen API'ler
Kayıt durumları
Kaydınızı gönderdikten sonra görebileceğiniz ilerleme aşamaları şunlardır:
- Yorum
- Kaydınızı inceliyoruz. Herhangi bir işlem yapmanız gerekmez.
- Onay dosyasını ayarlama
- Kaydınız onaylandı. Siteler için onay dosyası 30 gün içinde oluşturulmalıdır.
- Kayıt tamamlandı
- Başarıyla kaydoldunuz ve onay dosyanızı oluşturdunuz (gerekliyse). Başka bir işlem yapılmasına gerek yoktur.
- Onay dosyalarıyla ilgili hatalar
- Onay dosyası yanlış yerde
- 30 günlük süre içinde, sitenize ait onay dosyanızı bulamadık.
- Kayıt askıya alındı
- Onay dosyası, ilk 30 günlük süre içinde doğru şekilde ayarlanmamış veya daha önce başarılı bir kayıt işleminden sonra artık bulunamıyor. Daha fazla bilgi için lütfen privacy-sandbox-enrollment@google.com adresiyle iletişime geçin.
- Onay dosyası yanlış yerde
Kayıt zaman çizelgesi
Kaydınız gönderildikten sonra başvurunuz incelenir ve işleme alınır. İnceleme tamamlandıktan sonra konsolda bir onay görürsünüz ve kurulum için onay dosyanıza erişebilirsiniz. Dosya, kayıt onayı verildikten sonraki 30 gün içinde kayıtlı olduğu sitedeki /.well-known yolundan herkese açık olarak erişilebilir olmalıdır.
Android geliştiriciler, uygulamaların ayrıntılı erişim denetimi ayarlayabilmesi için kayıt kimliğini uygulama geliştiricilere sağlayabilir. Daha fazla bilgi için Android'in API'ye özel reklam hizmetlerini yapılandırma dokümanlarına bakın.
Not: İlk gönderiminizde doğru bilgileri girmeniz ve Google teknik destek ekibinin sorularına zamanında yanıt vermeniz sürecin hızlanmasına yardımcı olur.
Farklı geliştirme ortamları için kayıt
Hazırlık, beta, QA ve test ortamlarınız, üretim ortamınızla aynı siteyi kullanıyorsa otomatik olarak kaydedilir. Kaydolmadan yerel olarak test yapabilirsiniz. Yerel test için Chrome 116'dan itibaren Chrome flag'i ve CLI anahtarıyla geliştirici geçersiz kılmaları sunuyoruz:
- İşaret:
chrome://flags/#privacy-sandbox-enrollment-overrides - CLI:
--privacy-sandbox-enrollment-overrides=https://example.com,https://example.co.uk,...
Sınırlamalar
Kuruluşunuzun kayıt yapısını belirlerken aşağıdaki geliştirici kaydı sınırlamalarını göz önünde bulundurun:
- Bir site yalnızca bir kayda bağlanabilir.
- Bir kayıtta yalnızca bir site bulunur.
- SDK'ya özgü sınırlamalar:
- Bir kayıtta birden fazla SDK olabilir.
- Belirli bir SDK yalnızca bir kayda bağlanabilir.
- Ek kayıtlar yapılabilir ancak bu kayıtlar, açıkça belirlenmiş ve herkese açık olarak doğrulanabilen bağımsız ürünler veya iş kolları için olmalıdır (ör. belirli ürünü açıklayan herkese açık bir web sitesi olmalıdır). Aynı ürün için birden fazla kayıt olamaz. Onaylar, her kayıt için ayrı ayrı geçerlidir.
- Site kapsamlı kayıtla, aynı site oldukları sürece tek bir kayıt sınırsız kaynağı kapsayabilir. Ancak kaynak başına bir raporlama kaynağı hız sınırı (Chrome, Android), genellikle yayıncı başına bir kaynakla sınırlı olduğunuz anlamına gelir.
Tek bir varlık için birden fazla kayıt
Birden fazla benzersiz ürüne sahip daha karmaşık işletmeler, birden fazla kayda başvurabilir. Örneğin, şirketinizin bir SSP ve bir DSP iş kolu varsa birden fazla kayda uygun olabilirsiniz.
Her ürünün, API'leri çağırmak için ayrı siteleri olmalıdır. Kaydetmek istediğiniz her ürün için herkese açık bir temsil sağlamanız gerekir (örneğin, ürünü açıklayan herkese açık bir web sitesinin bağlantısı).
Birden fazla site veya SDK kaydetmek istiyorsanız konsol gezinmesindeki "Kayıtlar" sekmesine gidin. İlk kaydınız onaylandıktan sonra "Kaydolma isteğinde bulun"u seçerek daha fazla kayıt isteğinde bulunabilirsiniz. Başvuru gönderildikten sonra incelenir. İnceleme süreci tamamlandığında e-posta ile bilgilendirilirsiniz ve durum konsolda gösterilir.
İlişkilendirme Raporları ile yönlendirme
A sitesinin kayıtlı olmadığı ancak B sitesinin kayıtlı olduğu bir senaryo düşünün. ARA, kayıtlı olmasanız bile yönlendirmeler için URL'lere ping gönderir. Bu nedenle, siteA.com adresinden siteB.com adresine yönlendirme çalışır. Ancak kaynaklar ve tetikleyiciler yalnızca kayıtlı reklam teknolojilerinden kaydedilir.
Aggregation Service'e kaydolma
Aggregation Service kaydı, konsol kayıt sürecinin bir parçasıdır. Her Toplama Hizmeti kaydı, Toplama Hizmeti'nin dağıtılacağı AWS hesap kimliğini veya Google Cloud hizmet hesabını içermelidir. Reklam teknolojileri, çeşitli test, operasyonel ve maliyet verimliliği ihtiyaçları için birden fazla siteyi tek bir hesaba veya birden fazla hesabı tek bir siteye bağlama esnekliğine sahiptir.
Onay dosyanızı yükleyin
Kaydolup doğrulama sürecini tamamladıktan sonra konsolda tasdik dosyanıza erişebilirsiniz. Onay dosyasını aldıktan sonra, onay dosyası yerleştirme işlemini tamamlamak için 30 günlük bir uygulama süreniz olur. Bu süre zarfında 30 gün boyunca API'leri çağırmaya devam edebilirsiniz. Ancak 30 günlük uygulama süresi boyunca onay diline uyamayacaksanız kaydolmamanız beklenir.
Kaydı tamamlamak için dosyayı, kayıtlı sitedeki herkese açık .well-known yolundan erişilebilir hale getirin. Örneğin, https://example.com için kayıt yapıyorsanız onay dosyasını https://example.com/.well-known/privacy-sandbox-attestations.json konumuna yerleştirin. Onay dosyasını sunmak için yalnızca kayıtlı sitenizin alt alan adlarına yönlendiren HTTP yönlendirmelerini de kullanabilirsiniz.
Onaylara uymalı ve kayıt süresi boyunca onay dosyasını saklamalısınız. Onay dosyaları düzenli olarak doğrulanır ve dosyaların uzun süre yerinde tutulmaması, dosya geri yüklenene kadar API çağrılarının başarısız olmasına neden olur.
Unutmayın:
- Özel Korumalı Alan, kayıtlı reklam teknolojilerinden onay dosyasını getirir. Bu iş, dosyayı saatte en fazla bir kez getirir. API çağrıları, onay dosyası için getirme isteğini tetiklemez.
- Amaç, onay dosyasının herkese açık olmasıdır. Reklam teknolojisi, araştırmacılar, düzenleyiciler ve kullanıcılar (Privacy Sandbox altyapısından gelen getirme istekleri hariç) dahil olmak üzere harici taraflardan bazı getirme istekleri almayı beklemelidir. Reklam teknolojisi sağlayıcılar, Google'a sundukları dosyanın aynısını bu kullanıcılara da sunmalıdır.
Android'deki Topics onayları için uygulama ve SDK geliştiricilerin, konsoldaki kayıt formunda onayı kabul etmesi gerekir. Diğer Özel Korumalı Alan API'lerini kullanmadıkları sürece sunucularına onay dosyası yerleştirmeleri gerekmez.
Daha fazla API eklemek için onay güncelleme
Daha sonraki bir tarihte kaydınıza başka API'ler eklemeye karar verirseniz kaydınızı güncellemeniz gerekir. Bu sürecin bir parçası olarak, yeni API'leri çağırmadan önce sitenizdeki .well-known yolundan kullanılabilir hale getirilmesi gereken güncellenmiş bir onay dosyası alacaksınız.
Onay dosyasının en son sürümüne güncelleme
Kayıtlı tüm şirketlerin, Google'dan aldıkları tasdik dosyasının en son sürümüne güncelleme yapması gerekir.
Onay dosyalarının geçerliliği belirli bir süre sonra sona ermez. Onay çerçevesi geliştikçe (ör. API'ye özel yeni onaylar eklendikçe) zaman zaman yeni veya güncellenmiş onay dosyaları sağlanabilir.
Onay doğrulama hataları
Erişim yalnızca onay dosyasını kontrol eden sunucu dosyayı tekrar tekrar doğrulayamazsa kesilir. Tek bir hata veya yayın sorunu, erişimin askıya alınmasına neden olmaz.
Daha fazla bilgi için GitHub'daki onaylar sayfasına göz atın.
Android geliştirici verileri
Android'de Privacy Sandbox API'lerini kullanmak isteyen tüzel kişiler, kayıt kimliklerine konsol kullanıcı arayüzü üzerinden erişebilir. Bu kimlikler, uygulamanın AdServices yapılandırmasına dahil edilebilir. Bu sayede uygulama geliştiriciler, uygulamalarının veya SDK'larının etkileşimde bulunduğu reklam teknolojileri üzerinde ayrıntılı kontrol sahibi olabilir.