אותות מאובטחים הם נתונים מוצפנים שנאספים במכשיר הלקוח ומשותפים עם מגישי הצעות מחיר נבחרים. במדריך הזה מוסבר איך לאסוף ולשלוח אותות מאובטחים אל Google Ad Manager באמצעות IMA SDK.
כדי להשתמש ב-Secure Signals API נדרשת גרסה 3.29.0 ואילך של IMA SDK ל-Android.
כדי לבחור אותות ומשתתפים במכרז ולהפעיל שיתוף של אותות מאובטחים, אפשר לעיין במאמר בנושא שיתוף אותות מאובטחים עם משתתפים במכרז.
שימוש בספק אותות של צד שלישי
כדי להשתמש באותות מאובטחים, צריך לפרוס מחלקה של מתאם לאיסוף אותות באפליקציה כדי לאסוף אותות, לקודד אותם ולהעביר אותם אל IMA SDK.
פועלים לפי ההוראות של ספק הצד השלישי כדי להגדיר אצלו חשבון, מוסיפים תלות בגרסה, ומגדירים באפליקציה את המתאם של האותות המאובטחים שלו.
IMA SDK ל-Android מאתחל באופן אוטומטי כל מתאם של אותות מאובטחים, בלי שצריך לבצע שינויים נוספים בקוד.
דוגמה להוספת מתאם של אותות מאובטחים לפרויקט:
שליחת נתונים בהתאמה אישית
בנוסף לשימוש בספק אותות מצד שלישי, אפשר גם לאסוף, לקודד ולשלוח אותות עם נתונים בהתאמה אישית. כדי לשלוח אותות מאובטחים עם נתונים מותאמים אישית, צריך להפעיל אותות מותאמים אישית ב-Ad Manager.
לכל בקשה להצגת מודעה, יוצרים אובייקט SecureSignals שמכיל את הנתונים המותאמים אישית המקודדים כמחרוזת. לאחר מכן מוסיפים את אובייקט SecureSignals לבקשת הצגת המודעה על ידי קריאה ל-method adsRequest.setSecureSignals():
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);
}
...