Güvenli sinyal bağdaştırıcılarını entegre etme

Güvenli sinyaller, istemci cihazda toplanan ve belirli teklif verenlerle paylaşılan kodlanmış verilerdir. Bu kılavuzda, IMA SDK'yı kullanarak Google Ad Manager'a güvenli sinyallerin nasıl toplanıp gönderileceği gösterilmektedir.

Sinyalleri ve teklif verenleri seçmek, 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 sitenizde bir sinyal toplayıcı komut dosyası dağıtmanız gerekir. Bu komut dosyası, sinyalleri toplar, kodlar ve IMA SDK'ya iletir.

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

Otomatik olarak dağıtma

Ad Manager'da sinyal sağlayıcıları seçerken, seçtiğiniz sinyal sağlayıcılara bağlı olarak Google'dan sinyal toplama komut dosyasını sizin adınıza 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örebileceğiniz bir örneği aşağıda bulabilirsiniz:

Aşağıda, sitenizin index.html dosyasında görebileceğiniz bir örnek 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ı iste seçeneğini görmüyorsanız veya bu seçeneği etkinleştirmezseniz 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örebileceğiniz bir örneği aşağıda bulabilirsiniz:

Aşağıda, sitenizin index.html dosyasında görebileceğiniz bir örnek 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 verileri gönderme

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

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

  1. Şu özelliklere sahip bir nesne oluşturun: networkCode ve collectorFunction.
  2. networkCode özelliğini ağ kodunuzla doldurun.
  3. collectorFunction özelliğini, kodlanmış sinyallerinizle çözümlenen bir söz döndüren bir işlevle doldurun.

IMA SDK'nın kodlanmış sinyallerinizi alıp iletmek için erişebilmesi amacıyla, adsLoader öğenizi 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);
...