Özel Korumalı Alan reklamlarının alaka düzeyini ve ölçüm API'lerini test etme

Özel Korumalı Alan, siteler arası izlemeye gerek olmadan reklamcılık kullanım alanlarını mümkün kılmak için çeşitli teklifler içerir. Kaynak denemeleri, geliştiricilere gerçek zamanlı testler aracılığıyla yeni web teknolojilerini değerlendirme ve geri bildirim sağlama fırsatı sunar. Önceki kaynak denemelerinde siteler bağımsız API'lerle karşılaştırma yapabiliyordu. Topics, FLEDGE ve Attribution Reporting API'ler için sitelerin, uçtan uca reklam yaşam döngüsünün ilk sürümünü oluşturan API'ler genelinde birleştirilmiş denemeler çalıştırmasına olanak tanıyan bir tek kaynak denemesi sunuyoruz. API'ler, Chrome 101 Beta ve sonraki sürümlerde test etmek için kullanılabilir. Chrome 101 Beta sürümünde, yapılandırma seçenekleri üzerinde iterasyonlar yapmaya devam ettikçe kullanıcı denetimlerinde güncellemeler de yapılmaktadır.

Geliştirici olarak Topics, FLEDGE ve Attribution Reporting API'lerde test yapmanıza olanak tanıyan bu tek kaynak denemesine kaydolabilirsiniz. Bu kılavuz, API'lere erişmek için yapılandırma adımlarında sizi yönlendirir, yapılandırmanızı nasıl doğrulayacağınızı açıklar ve API'lerle ilgili testler için ek kaynaklar sağlar.

Kaynak denemesinde neler var?

Bu kaynak denemesinin amacı, birden çok site üzerinde reklam yaşam döngüsü boyunca anlamlı testler yapılmasını sağlamaktır. Kaynak denemesi, bu yolculuğu kapsamak için şunları içerir:

  • document.browsingTopics() aracılığıyla bir tarayıcının konularını gözlemlemek ve bunlara erişmek için konular.
  • FLEDGE: Bu gruplar ve diğer sinyallere göre reklam teklifi ve seçimiyle birlikte tarayıcının ilgi alanı gruplarını yönetmek için.
  • FLEDGE reklam açık artırmasının kazananının opak URL'sini oluşturmak için çitlenmiş çerçeveler.
  • Reklam yaşam döngüsü boyunca performansı ölçmek ve raporlamak için İlişkilendirme Raporları.
    • İlişkilendirme Raporlarının bir parçası olarak, birleştirilebilir raporların bir toplama hizmeti tarafından işlenip toplanması gerekir. Yakında yerel ve kaynak denemesi testleri için ek araç ve kılavuzlar yayınlayacağız.
    • İlişkilendirme Raporlama'nın önceki kaynak denemelerine katıldıysanız en son API değişikliklerine göre satır içi 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 teste olanak tanısa da ihtiyaçlarınıza en uygun olanı seçip uygulayacağınız özellikleri seçebilirsiniz.

Geliştiriciler kaynak denemesine nasıl kaydolabilir?

Ö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ünde <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 denemesinde bulunan bazı işlevler, üst düzey sitede üçüncü taraf olarak hizmet sağladığınızda olduğu gibi siteler arası bağlamlarda kullanılmak üzere tasarlanmıştır. Kaynak denemenizi bu ek bağlamlar için etkinleştirmeniz gerekiyorsa "Üçüncü taraf eşleştirme" seçeneğini belirlediğinizden emin olun. Üçüncü taraf JavaScript'ten kaynak denemesini etkinleştirmek için komut dosyanızdan üst düzey sayfaya (kendi içeriği değil, birinci taraf sayfası) <meta> etiketini 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);

Daha fazla bilgi edinmek için Chrome'un kaynak denemelerini kullanmaya başlama rehberini inceleyebilirsiniz.

Geliştiriciler yerel olarak nasıl test yapar?

Topics, FLEDGE ve İlişkilendirme Raporları için hazırlanan bağımsız geliştirici belgelerinde, her API için yerel geliştirici testiyle ilgili özel yol gösterici bilgiler sağlanmaktadır. API'ler varsayılan olarak açık değildir ve test için işaretlerle etkinleştirilmeleri gerekir.

Test amacıyla API'leri etkinleştirmek için:

  • Chrome 101 Beta veya sonraki bir sürümü kullanın.
    • FLEDGE için masaüstü Chrome gerekir.
    • API'ler, Chrome'un iOS sürümlerinde kullanılamaz.
  • chrome://flags/#privacy-sandbox-ads-apis işaretini kullanarak API'leri etkinleştirin.
    • Bu işaret, daha kolay test için API'leri açık olmaya zorlar. Ek ayarlarının API'leri yine de devre dışı bırakabileceği uygun bir kaynak deneme kullanıcısını çoğaltmak isterseniz Chrome'u CLI işaretlerini kullanarak başlatmalısınız: --enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs.
    • Her API'nin daha ayrıntılı yapılandırmalar için daha fazla ek işareti olabilir. Ayrıntılar için bağımsız kılavuzları inceleyin.
    • Ek işaretler bu işaretle çakışabilir. Bu nedenle, sorunla karşılaşırsanız yalnızca bu işareti ayarlamayı düşünün.
  • Chrome Ayarları'nda Özel Korumalı Alan denemelerini etkinleştirin: Ayarlar > Güvenlik ve gizlilik > Özel Korumalı Alan. Buna chrome://settings/adPrivacy adresinden de erişebilirsiniz.
  • Chrome Ayarları'nda üçüncü taraf çerezlerini etkinleştirin: Ayarlar > Güvenlik ve gizlilik. Çerezler ve diğer site verileri seçeneğini "Tüm çerezlere izin ver" veya "Gizli modda üçüncü taraf çerezlerini engelle" olarak ayarlayın. Bu uygulamaya chrome://settings/cookies adresinden de erişebilirsiniz.
  • Standart bir göz atma oturumunda olmak. Gizli modu kullanmayın.

Geliştiriciler kaynak denemesinin doğru yapılandırılıp yapılandırılmadığını nasıl kontrol eder?

Chrome'un kaynak denemelerinde sorun giderme, kaynak deneme sürümünüzü doğrulamak için ayrıntılı bir kontrol listesi sağlar.

Uygulamalar altında kaynak deneme durumunu gösteren Geliştirici Araçları

Geliştirici Araçları, Çerçeveler altındaki Uygulamalar sekmesinde bir kaynak denemesinin durumunu gösterir.

Kaynak denemesi yalnızca aşağıda açıklandığı şekilde uygun kullanıcılar için etkin olarak görünse de kendi üretim sitenizle karşılaştırma yapmak için geliştirici işaretlerini de kullanabilirsiniz.

Hangi kullanıcılar kaynak denemesi için uygundur?

Tasarım gereği, kaynak denemelerinin toplam Chrome trafiğinin yalnızca küçük bir kısmında çalışması amaçlanmıştır. Bu nedenle, sitenizde kaynak denemesini etkinleştirseniz bile kullanıcının API'yi etkin olmayabileceğini her zaman varsaymanız gerekir. Kaynak denemesindeki etkin deneme grubu, düşük bir kullanıcı oranıyla başlayacak ve deneme ilerledikçe büyük olasılıkla hız kazanacaktır. 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ılabilmesi için bu uygun kullanıcı kümesinin büyük ölçüde tutarlı olması gerekir. Örneğin, katılımcı bir yayıncı sitesinde reklam görüntüleyen bir kullanıcı kaynak denemesi için uygunsa, bu kullanıcı katılımcı bir reklamveren sitesinde dönüşüm gerçekleştirirken de uygun olmalıdır.

Bir kullanıcının uygun olması için:

  • Chrome 101 Beta veya daha yeni bir sürüm kullanıyor olmanız gerekir.
    • FLEDGE için masaüstü Chrome gerekir.
    • Chrome'un iOS sürümlerinde kaynak denemesi yoktur.
  • Etkin kaynak deneme süresinde tarama yapıyor olmalıdır.
  • Ayarlar > Güvenlik ve gizlilik > Özel Korumalı Alan'a giderek Özel Korumalı Alan denemelerini etkinleştirmeniz gerekir. Bu Korumalı Alan'a chrome://settings/adPrivacy üzerinden de erişebilirsiniz.
  • Ayarlar > Güvenlik ve gizlilik > Çerezler ve diğer site verileri seçeneğinde, chrome://settings/cookies üzerinden erişilebilen ve "Tüm çerezlere izin ver" veya "Gizli modda üçüncü taraf çerezlerini engelle" olarak ayarlanmış üçüncü taraf çerezlerini etkinleştirmiş olmanız gerekir.
  • Gizli modda değil standart tarama oturumunda olmak.
  • Chrome'da etkin deneme grubu içinde olmalıdır.

Geliştiriciler API desteğini nasıl algılamalıdır?

Herhangi bir web platformu özelliğinde olduğu gibi, bu özelliği kullanmadan önce özellik için destek olup olmadığını belirlemeniz gerekir.

Konular

"browsing-topics" için document içindeki browsingTopics() işlevini ve İzin Politikası'ndaki](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeaturefeature) özelliğine bakın.

if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
  // Topics enabled
}

FLEDGE

Bir reklam ilgi alanı grubuna katılmak istiyorsanız navigator içindeki joinAdInterestGroup işlevini ve "join-ad-interest-group" için İzin Politikası'nı kontrol edin.

if ('joinAdInterestGroup' in navigator && document.featurePolicy.allowsFeature('join-ad-interest-group')) {
  // FLEDGE interest group enabled
}

Açık artırma yürütmek istiyorsanız navigator içindeki 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 içindeki attributionReporting nesnesini ve "attribution-reporting" için İzin Politikası'nı kontrol edin.

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 vermek için kullanabileceğiniz çeşitli yollar ayrıntılı şekilde anlatılmıştır. Topics, FLEDGE ve İlişkilendirme Raporlama, her API için ayrı bağlantılar sağlayan özel bölümler içerir.

Ayrıca, önemli haberlerin özetini içeren Özel Korumalı Alan serisinde İlerleme durumu hakkında düzenli olarak güncellemeler yayınlıyoruz.