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.
Güvenli sinyaller API'si, Android için IMA SDK'sının 3.29.0 veya sonraki bir sürümünü gerektirir.
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 uygulamanızda sinyal toplamak, kodlamak ve IMA SDK'sına iletmek amacıyla bir sinyal toplayıcı adaptör sınıfı dağıtmanız gerekir.
Üçüncü taraf sağlayıcınızın talimatlarını uygulayarak onlarla hesap oluşturun, derleme bağımlılıkları ekleyin ve uygulamanızda güvenli sinyal bağdaştırıcısını ayarlayın.
Android için IMA SDK'sı, kodunuzda herhangi bir ek değişiklik yapmadan her güvenli sinyal bağdaştırıcısını otomatik olarak başlatır.
Projenize nasıl güvenli sinyal bağdaştırıcısı ekleyeceğinize dair bir örnek aşağıda verilmiştir:
Ö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.
Her reklam isteği için kodlanmış özel verilerinizi dize olarak içeren bir SecureSignals nesnesi oluşturun. Ardından, adsRequest.setSecureSignals() işlevini çağırarak SecureSignals nesnesini reklam isteğinize ekleyin.
Aşağıda bir Java örneği verilmiştir:
app/src/main/java/com/example/project name/MainActivity.java
...
private void requestAds(String adTagUrl) {
// Create the ads request.
AdsRequest request = sdkFactory.createAdsRequest();
request.setAdTagUrl(adTagUrl);
request.setContentProgressProvider(
() -> {
if (videoPlayer.getDuration() <= 0) {
return VideoProgressUpdate.VIDEO_TIME_NOT_READY;
}
return new VideoProgressUpdate(
videoPlayer.getCurrentPosition(), videoPlayer.getDuration());
});
SecureSignals signal = SecureSignals.create("My encoded signal string");
request.setSecureSignals(signal);
// Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.
adsLoader.requestAds(request);
}
...