Ölçüm Sağlayıcıları İçin Korunan Kitle (eski adıyla FLEDGE) Entegrasyon Rehberi

Chrome, Özel Korumalı Alan'ın bir parçası olarak Korunan Kitle API: Tarayıcı içi bir API Reklamverenlerin ve reklam teknolojisi şirketlerinin ilgi alanı grubunu hedefleyen reklamlar göstermesine olanak tanıyan üçüncü taraf çerezlerine dayanmadan, kullanıcıları siteler arası çerezlere karşı korurken izleyebilirsiniz.

Protected Audience API'de açık artırmayı bir yeniden pazarlama reklamı kazandığında, Reklamın URL'si Fenceeded Çerçeve oluşturma. Sınırla çevrili çerçeve, yerleştirilmiş içerik için önerilen bir HTML öğesidir. iframe'e benzer. iframe'lerden farklı olarak, sınırlanmış bir çerçeve iletişimi kısıtlar olmadan, çerçevenin siteler arası verilere erişmesine olanak tanımak için yerleştirme bağlamıyla birlikte yerleştirme bağlamıyla paylaşabilirsiniz. Daha ayrıntılı bilgi için Çitli Çerçevelerin kullanım alanları bölümündeki talimatları uygulayın.

Görüntülü Reklam ve Video 360, ölçüm için makrolar gösterim ve tıklama izleme için kullanılacak sağlayıcıdır. Bunların yalnızca küçük bir alt kümesi makrolar, içeriğe dayalı eksiklik nedeniyle reklam öğesi oluşturma kapsamında değiştirilebilir sinyallerine geçiş yapalım. Örneğin, ${PUBLISHER_ID} değişiklik olmadan bozulur izin verir.

Bu kılavuz, Google Analytics 4'ü takip eden etkinliklerini Görüntülü Reklam Ağı ve Video 360.

Kayıt

Ağustos 2023'ten itibaren ölçüm sağlayıcılarının bu adımları uygulaması gerekebilir. Protected uygulamasında Fenced Frame Reporting API'leri kullanmak üzere kendilerini kaydettirmek için aşağıdaki bağlantıyı kullanabilirsiniz: Kitle API'si.

Bu taleplerin nasıl ve kimin tarafından kaydolun

Entegrasyon

Ölçüm sağlayıcısı gösterim etiketleri

Kurulum talimatları:

Komut dosyası etiketleri Örnek 
<script src='https://tracking.com/a.js'>xxx</script>
 Sorumluluk: Ölçüm sağlayıcılarının, kullanılacak komut dosyası etiketlerini güncellemeleri Gösterim izleme için reportEvent API (kılavuzu inceleyin bölümüne bakın).
Img etiketleri Örnek 
<img src='https://tracking.com/'>
 Sorumluluk: Görüntülü Reklam Ağı ve Kullanılacak img src etiketlerini güncellemek için Video 360 Gösterim izleme için reportEvent API.

reportEvent API'sı

API'nin şu amaçlarla kullanılması teklif edildi: yalnızca oluşturma sonrası izleme için geçerlidir. Bu API iki bölümden oluşur: registerAdMacro ve reportEvent.

  • Görüntülü Reklam ve Video 360, reportWin içinde registerAdMacro işlevine sahiptir. İlgili içeriği oluşturmak için kullanılan işlevi, makro anahtar/değer çiftlerini çağrısı oluşturuluyor.
  • Etiket türüne bağlı olarak, Görüntülü Reklam Ağı ve Video 360 veya ölçüm sağlayıcılarının sahibi reportEvent API kullanmak için 3PAT etiketlerinde yapılan değişiklikler.

reportEvent yalnızca 1 giriş ("destinationURL") alıyor. Bu giriş, ölçüm sağlayıcı sunucularına gönderilir. Bu uzantıda listelenen tüm makroları içerebilir: Görüntülü Reklam ve Video 360 Yardımı Merkezi. Örneğin:

window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

Chrome işlevde URL ping'ini tetiklediğinde, önceden tanımlanmış makrolarını kullanıp bunları bir HTTP GET isteği göndermeden önce https://adtech.example

Komut dosyası etiketlerini güncelleme adımları

Mevcut reklam öğesi etiketlerinde herhangi bir değişiklik yapılmayacaktır. Görüntülü Reklam ve Video 360 sabit görüntüsü Ölçüm sağlayıcı etiketlerini reklam öğesinin bir parçası olarak değişiklik yapmadan oluşturur yük. Ölçüm sağlayıcılar, Protected'den gösterim ping'leri aldığında Audience API bağlamı, gösterim için aşağıdaki adımları uygulamalıdır izleme:

  1. Gösterim ping'lerini kabul etmek için bir ölçüm sağlayıcısı gösterim URL'si hazırlayın. Örneğin:

    https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123

  2. Korumalı'dan bir komut dosyasına yanıt verirken reportEvent JS ekle Kitle API'si. Örneğin:

    window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

  3. Şunda yapılandırılmış gösterim URL'sinden ping'ler alındığında gösterimleri günlüğe kaydet: 1. adım.

Ölçüm sağlayıcısı tıklama etiketleri

Mevcut ölçüm sağlayıcısı tıklama etiketi, Protected Audience gösterimleri için çalışmaya devam eder. Görüntülü Reklam ve Video 360, Fenced Frames Ads Reporting API'nin Tıklamaları kaydetmek için reserved.top_navigation işaretçisi vardır ve tüm ölçüm sağlayıcısı tıklama izleyicileri yönlendirmez. Daha ayrıntılı bilgi için Fenced Frame Reklam Raporları için Chrome dokümanları API.