Özel Korumalı Alan, siteler arası izlemeye gerek kalmadan reklamcılık kullanım alanlarını etkinleştirmeye yönelik bir dizi teklif içerir. Kaynak denemeleri, geliştiricilere gerçek dünyada test yaparak yeni web teknolojilerini değerlendirme ve geri bildirim sağlama fırsatı sunar. Önceki kaynak denemelerinde siteler ayrı API'lerle test yapabiliyordu. Topics, FLEDGE ve Attribution Reporting API'ler için, uçtan uca reklam yaşam döngüsünün ilk sürümünü oluşturan API'ler genelinde sitelerin birleşik denemeler çalıştırmasına olanak tanıyan bir tek kaynak denemesi sunuyoruz. API'ler Chrome 101 Beta ve sonraki sürümlerde test edilebilir. Yapılandırma seçeneklerinde iterasyon yapmaya devam ederken Chrome 101 Beta sürümünde kullanıcı kontrollerinde de güncellemeler yapıldı.
Geliştirici olarak Topics, FLEDGE ve Attribution Reporting API'lerini test etmenize olanak tanıyacak bu tek kaynaklı deneme sürümüne kaydolabilirsiniz. Bu kılavuzda, API'lere erişmek için yapılandırma adımlarında size yol gösterilir, yapılandırmanızın nasıl doğrulanacağı açıklanır ve API'lerle ilgili testler için daha fazla kaynak sağlanır.
Kaynak denemesinde neler bulunur?
Bu kaynak denemesinin amacı, birden fazla sitede reklam yaşam döngüsü boyunca anlamlı testlere olanak tanımaktır. Bu yolculuğu kapsayan kaynak denemesi şunları içerir:
document.browsingTopics()üzerinden bir tarayıcının konularını gözlemlemek ve bunlara erişmek için Topics.- Tarayıcı ilgi alanı gruplarını ve bu gruplara ve diğer sinyallere dayalı reklam teklifli sistemini ve seçimini yönetmek için FLEDGE.
- Bu kaynak denemesinde FLEDGE, masaüstünde kullanılabilir ve önerilen tüm işlevlerin belirli bir alt kümesini içerir. Daha fazla bilgi için FLEDGE kaynak denemesi ayrıntılarını okuyun.
- FLEDGE reklam açık artırması kazananının saydam olmayan URL'sini oluşturmak için çitli kareler.
- Reklam yaşam döngüsü boyunca performansı ölçmek ve raporlamak için İlişkilendirme Raporları
- İlişkilendirme raporları kapsamında, özet raporlar oluşturmak için birleştirilebilir raporların bir toplama hizmeti tarafından işlenmesi ve toplanması gerekir. Yakında yerel ve kaynak deneme testleri için ek araçlar ve kılavuzlar yayınlayacağız.
- İlişkilendirme raporlaması için önceki kaynak denemelerine katıldıysanız en son API değişikliklerine uygun şekilde güncelleme yapmanız gerektiğini unutmayın. Ayrıntılar için taşıma kılavuzuna bakın.
Bu kurulum, tüm bu API'lerde birleşik test yapılmasına olanak tanır. Ancak, ihtiyaçlarınıza uygun olarak hangi özelliklerin uygulanacağını seçebilirsiniz.
Geliştiriciler kaynak denemesine nasıl kaydolur?
Özel Korumalı Alan Alaka düzeyi ve Ölçümü denemesine kaydolun. Aşağıdaki HTML etiketleriyle, API kodunu çalıştırmak istediğiniz her sayfada bir deneme jetonu sağlayın:
- Üst düzey sayfanın
<head>bölümündeki<meta>etiketi:<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE"> - Üst düzey sayfa yanıtındaki HTTP üst bilgisi:
Origin-Trial: TOKEN_GOES_HERE
Kaynak deneme sürümünde bulunan bazı işlevler, üst düzey sitede üçüncü taraf olarak hizmet sunduğunuz gibi siteler arası bağlamlarda kullanılmak üzere tasarlanmıştır. Bu ek bağlamlar için kaynak deneme sürümünüzü etkinleştirmeniz gerekiyorsa "Üçüncü taraf eşleştirme" seçeneğini belirlediğinizden emin olun. Üçüncü taraf JavaScript'inden kaynak deneme sürümünü etkinleştirmek için komut dosyanızdan <meta> etiketini üst düzey sayfaya (yani kendi içeriğiniz değil, birinci taraf sayfaya) ekleyin. Örneğin:
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);
Chrome'un kaynak denemelerini kullanmaya başlama kılavuzundan daha fazla bilgi edinin.
Geliştiriciler yerel olarak nasıl test yapar?
Topics, FLEDGE ve Attribution Reporting ile ilgili geliştirici belgeleri, her API için yerel geliştirici testi hakkında özel yönergeler sağlar. API'ler varsayılan olarak etkin değildir ve test için işaretlerle etkinleştirilmelidir.
API'leri test için etkinleştirmek üzere:
- Chrome 101 Beta veya sonraki bir sürümü kullanın.
- FLEDGE için masaüstü Chrome gereklidir.
- API'ler Chrome'un iOS sürümlerinde kullanılamaz.
chrome://flags/#privacy-sandbox-ads-apisişaretçisini kullanarak API'leri etkinleştirin.- Bu işaret, daha kolay test için API'leri etkinleştirir. Ek ayarlarının API'leri devre dışı bırakabileceği uygun bir kaynak deneme kullanıcısını kopyalamak istiyorsanız Chrome'u CLI işaretlerini kullanarak başlatmanız gerekir:
--enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs. * Ayrı API'lerde daha ayrıntılı yapılandırma için daha fazla ek işaret bulunabilir. Ayrıntılar için ilgili kılavuzları inceleyin. - Ek işaretler bu işaretle çakışabilir. Bu nedenle, sorunla karşılaşırsanız yalnızca bu işareti ayarlayın.
- Bu işaret, daha kolay test için API'leri etkinleştirir. Ek ayarlarının API'leri devre dışı bırakabileceği uygun bir kaynak deneme kullanıcısını kopyalamak istiyorsanız Chrome'u CLI işaretlerini kullanarak başlatmanız gerekir:
- Chrome Ayarları'nda Privacy Sandbox denemelerini etkinleştirin: Ayarlar >Güvenlik ve gizlilik > Privacy Sandbox. Bu sayfaya
chrome://settings/adPrivacyadresinden de erişebilirsiniz. - Chrome Ayarları'nda üçüncü taraf çerezlerini etkinleştirin: Ayarlar > Güvenlik ve gizlilik. Çerezler ve diğer site verileri'ni "Tüm çerezlere izin ver" veya "Gizli modda üçüncü taraf çerezlerini engelle" olarak ayarlayın. Bu sayfaya
chrome://settings/cookiesadresinden de erişebilirsiniz. - Standart bir tarama oturumunda olmanız gerekir. Gizli modu kullanmayın.
Geliştiriciler, kaynak deneme sürümünün doğru şekilde yapılandırılıp yapılandırılmadığını nasıl kontrol eder?
Chrome'un kaynak denemeleriyle ilgili sorunları giderme başlıklı makalede, kaynak denemesi yapılandırmanızı doğrulamak için ayrıntılı bir yapılacaklar listesi sağlanmaktadır.
Geliştirici Araçları, bir kaynak deneme sürümünün durumunu Çerçeveler altındaki Uygulamalar sekmesinde gösterir.
Kaynak deneme sürümü, aşağıda ayrıntılı olarak açıklandığı gibi yalnızca uygun kullanıcılara etkin olarak gösterilir. Ancak kendi üretim sitenizle test etmek için geliştirici işaretlerini de kullanabilirsiniz.
Hangi kullanıcılar kaynak denemesine uygundur?
Kaynak denemelerinin tasarımı gereği yalnızca genel Chrome trafiğinin küçük bir kısmında çalıştırılması amaçlanmıştır. Bu nedenle, sitenizde kaynak denemesini etkinleştirmiş olsanız bile kullanıcıda API'nin etkin olmayabileceğini her zaman varsaymalısınız. Kaynak denemedeki etkin deneme grubu, kullanıcıların düşük bir oranıyla başlar ve deneme ilerledikçe muhtemelen artar. Denemedeki Chrome kullanıcılarının yüzdesinin, sitenizdeki etkin kullanıcıların yüzdesiyle eşleşmeyebileceğini unutmayın.
Ancak siteler arasında birleşik test yapılmasına izin vermek için bu uygun kullanıcı grubu çoğunlukla tutarlı kalmalıdır. Örneğin, bir kullanıcı, katılımcı bir yayıncı sitesinde reklam görüntülerken kaynak denemesi için uygunsa aynı kullanıcı, katılımcı bir reklamveren sitesinde dönüşüm gerçekleştirdiğinde de uygun olmalıdır.
Kullanıcıların uygun olabilmesi için:
- Chrome 101 Beta veya sonraki bir sürümü kullanıyor olmalısınız.
- FLEDGE için masaüstü Chrome gereklidir.
- Chrome'un iOS sürümlerinde kaynak denemeleri kullanılamaz.
- Etkin kaynak deneme süresi boyunca geziniyor olmalıdır.
- Ayarlar > Güvenlik ve gizlilik > Özel Korumalı Alan'a giderek Özel Korumalı Alan denemelerini etkinleştirin.
chrome://settings/adPrivacyüzerinden de erişebilirsiniz. - Ayarlar > Güvenlik ve gizlilik > Çerezler ve diğer site verileri bölümünde üçüncü taraf çerezlerinin etkinleştirildiğinden emin olun. Bu bölümde "Tüm çerezlere izin ver" veya "Gizli modda üçüncü taraf çerezlerini engelle" ayarlarından birini seçebilirsiniz. Bu bölüme
chrome://settings/cookiessimgesinden de erişebilirsiniz. - Standart bir tarama oturumunda olmalı ve Gizli modda olmamalıdır.
- Chrome'daki etkin deneme grubunda yer almalıdır.
Geliştirici özelliği, API desteğini nasıl algılamalıdır?
Her web platformu özelliğinde olduğu gibi, özelliği kullanmadan önce özelliğin desteklendiğinden emin olmanız gerekir.
Konular
"browsing-topics" için document ve İzinler Politikası'nda browsingTopics() işlevini kontrol edin.
if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
// Topics enabled
}
FLEDGE
Bir reklam ilgi alanı grubuna katılmak istiyorsanız navigator işlevini ve "join-ad-interest-group" için izin politikasını kontrol edin.joinAdInterestGroup
if ('joinAdInterestGroup' in navigator && document.featurePolicy.allowsFeature('join-ad-interest-group')) {
// FLEDGE interest group enabled
}
Açık artırma yapmak istiyorsanız navigator içinde runAdAuction işlevini ve "run-ad-auction" için izin politikasını kontrol edin.
if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
// FLEDGE auction enabled
}
İlişkilendirme Raporları
window öğesini window içinde ve "attribution-reporting" için İzinler Politikası'nda kontrol edin.attributionReporting
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting API enabled
}
Geliştiriciler nereden geri bildirimde bulunabilir ve destek alabilir?
Geri bildirime genel bakış sayfasında, Özel Korumalı Alan'ın farklı yönleriyle ilgili geri bildirim gönderme yöntemleri ayrıntılı olarak açıklanmaktadır. Topics, FLEDGE ve Attribution Reporting için her API'nin ayrı bağlantılarını sağlayan özel bölümler vardır.
Ayrıca, önemli haberlerin özetini sunan Özel Korumalı Alan'daki Gelişmeler serisinde düzenli olarak güncellemeler paylaşıyoruz.