Güvenli sinyaller

Güvenli sinyaller, istemci cihazda toplanan ve belirli teklif verenlerle paylaşılan kodlanmış verilerdir. Bu kılavuzda, IMA SDK'sını kullanarak güvenli sinyalleri nasıl toplayacağınız ve Google Ad Manager'a nasıl göndereceğiniz gösterilmektedir.

Sinyalleri ve teklif verenleri seçmek ve güvenli sinyal paylaşımını etkinleştirmek için Güvenli sinyalleri teklif verenlerle paylaşma başlıklı makaleyi inceleyin.

Üçüncü taraf sinyal sağlayıcı kullanma

Güvenli sinyalleri kullanmak için sinyalleri toplamak, kodlamak ve IMA SDK'ya iletmek amacıyla sitenizde bir sinyal toplayıcı komut dosyası dağıtmanız gerekir.

Güvenli sinyal komut dosyalarını otomatik veya manuel olarak dağıtırsınız.

Otomatik olarak dağıtın

Ad Manager'da sinyal sağlayıcıları seçerken, seçtiğiniz sinyal sağlayıcılara bağlı olarak Google'dan sizin adınıza sinyal toplama komut dosyasını dağıtmasını isteme seçeneğini görebilirsiniz. Bu seçeneği belirlerseniz ve sitenizde Google yayıncı etiketleri varsa seçtiğiniz sinyal toplayıcı komut dosyaları otomatik olarak yüklenir.

Ad Manager kullanıcı arayüzünde göreceğinize dair bir örnek aşağıda verilmiştir:

Sitenizin index.html dosyasında göreceğinize dair bir örnek aşağıda verilmiştir:

...
<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<!-- Load gpt.js, which autoloads all signal provider scripts configured to be deployed by Google. -->
<script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<script src="ads.js"></script>
...

Manuel olarak dağıtma

Ad Manager'da Google'dan sinyal toplama komut dosyasını sizin adınıza dağıtmasını isteyin seçeneğini görmüyorsanız veya bu seçeneği etkinleştirmediyseniz güvenli sinyal sağlayıcınızdan bir komut dosyası bağlantısı almanız ve bunu projenize manuel olarak eklemeniz gerekir.

Ad Manager kullanıcı arayüzünde göreceğinize dair bir örnek aşağıda verilmiştir:

Sitenizin index.html dosyasında göreceğinize dair bir örnek aşağıda verilmiştir:

...
<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<!-- Load signal provider scripts manually, using the unique instructions given by each signal provider. -->
<script src="//cdn.provider1.com/files/a/e/5/4/7/signalCollector.js"></script>
<script src="//provider2.co.uk/ads/signalcollector/script.min.js"></script>
<script src="/local/path/to/third_party_signal_provider_3.js"></script>
<script src="ads.js"></script>
...

Özel veriler gönderme

Üçüncü taraf sinyal sağlayıcı kullanmanın yanı sıra özel veri içeren sinyaller de toplayabilir, kodlayabilir ve gönderebilirsiniz. Özel veri içeren güvenli sinyaller gönderebilmek için Ad Manager'da özel sinyalleri etkinleştirmeniz gerekir.

HTML5 projeleri için gereken adımlar şunlardır:

  1. networkCode ve collectorFunction özelliklerine sahip bir nesne oluşturun.
  2. networkCode mülkünü ağ kodunuzla doldurun.
  3. collectorFunction mülkünü, kodlanmış sinyallerinize çözüm bulan bir promise döndüren bir işlevle doldurun.

IMA SDK'sının kodlanmış sinyallerinizi alıp iletmek için nesneye erişebilmesi amacıyla, adsLoader'unuzu oluşturmadan önce nesneyi googletag.secureSignalProviders dizisine gönderin.

Aşağıda bir JavaScript örneği verilmiştir:

ads.js

...
console.log("initializing IMA");
adContainer = document.getElementById('ad-container');
adDisplayContainer = new google.ima.AdDisplayContainer(adContainer, videoElement);

const NETWORK_CODE = '12345678901';
const signalCollector = () => {
 return new Promise((resolve, reject) => {
   resolve("My encoded signal string");
 });
}
if (!googletag) googletag = {};
if (!googletag.secureSignalProviders) googletag.secureSignalProviders = [];
googletag.secureSignalProviders.push({
 networkCode: NETWORK_CODE,
 collectorFunction: signalCollector
});

adsLoader = new google.ima.AdsLoader(adDisplayContainer);
...