אותות מאובטחים הם נתונים מוצפנים שנאספים במכשיר הלקוח ומשותפים עם מגישי הצעות מחיר נבחרים. במדריך הזה מוסבר איך לאסוף ולשלוח אותות מאובטחים אל Google Ad Manager באמצעות IMA SDK.
כדי להשתמש ב-Secure Signals API נדרשת גרסה 3.29.0 ואילך של IMA SDK ל-Android.
כדי לבחור אותות ומשתתפים במכרז ולהפעיל שיתוף של אותות מאובטחים, אפשר לעיין במאמר בנושא שיתוף אותות מאובטחים עם משתתפים במכרז.
שימוש בספק אותות של צד שלישי
כדי להשתמש באותות מאובטחים, צריך לפרוס מחלקה של מתאם לאיסוף אותות באפליקציה כדי לאסוף אותות, לקודד אותם ולהעביר אותם אל IMA SDK.
פועלים לפי ההוראות של ספק הצד השלישי כדי להגדיר אצלו חשבון, מוסיפים תלות בגרסה, ומגדירים באפליקציה את המתאם של האותות המאובטחים שלו.
IMA SDK ל-Android מאתחל באופן אוטומטי כל מתאם של אותות מאובטחים, בלי שצריך לבצע שינויים נוספים בקוד.
דוגמה להוספת מתאם של אותות מאובטחים לפרויקט:
שליחת נתונים בהתאמה אישית
בנוסף לשימוש בספק אותות מצד שלישי, אפשר גם לאסוף, לקודד ולשלוח אותות עם נתונים בהתאמה אישית. כדי לשלוח אותות מאובטחים עם נתונים מותאמים אישית, צריך להפעיל אותות מותאמים אישית ב-Ad Manager.
לכל בקשה להזרמת נתונים, מבצעים את הפעולות הבאות:
- יוצרים אובייקט
SecureSignalsשמכיל את הנתונים המותאמים אישית המקודדים כמחרוזת. - מוסיפים את האובייקט
SecureSignalsלבקשת הסטרימינג באמצעות קריאה לשיטהstreamRequest.setSecureSignals():
app/src/main/java/com/example/project name/SampleAdsWrapper.java
public void requestAndPlayAds() {
adsLoader.addAdErrorListener(this);
adsLoader.addAdsLoadedListener(this);
StreamRequest request = buildStreamRequest();
SecureSignals signal = SecureSignals.create("My encoded signal string");
request.setSecureSignals(signal);
request.setFormat(StreamFormat.HLS);
adsLoader.requestStream(request);
}