Güvenli sinyaller, istemci cihazda toplanan ve belirli teklif verenlerle paylaşılan kodlanmış verilerdir. Bu kılavuzda, IMA SDK'sını kullanarak Google Ad Manager'a güvenli sinyallerin nasıl toplanıp gönderileceği gösterilmektedir.
Güvenli sinyaller API'si için Android'de IMA SDK'nın 3.29.0 veya sonraki bir sürümü gerekir.
Sinyalleri ve teklif verenleri seçip 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 bir sinyal toplayıcı adaptör sınıfı dağıtmanız gerekir böylece sinyaller toplanır, kodlanır ve IMA SDK'ya iletilir.
Üçüncü taraf sağlayıcınızın talimatlarını uygulayarak sağlayıcıda hesap oluşturun, derleme bağımlılıkları ekleyin, ve uygulamada güvenli sinyal bağdaştırıcısını ayarlayın.
Android için IMA SDK, kodunuzda herhangi bir ek değişiklik yapmadan her güvenli sinyal bağdaştırıcısını otomatik olarak başlatır.
Aşağıda, projenize güvenli sinyal bağdaştırıcısı ekleme örneği verilmiştir:
Ö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.
Her reklam isteği için, kodlanmış özel verilerinizi dize olarak içeren bir SecureSignals nesnesi oluşturun. Ardından, SecureSignals yöntemini çağırarak adsRequest.setSecureSignals() nesnesini reklam isteğinize ekleyin:
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);
}
...