אותות מאובטחים

אותות מאובטחים הם נתונים מוצפנים שנאספים במכשיר הלקוח ומשותפים עם בידינגרים נבחרים. במדריך הזה מוסבר איך לאסוף ולשלוח אותות מאובטחים אל Google Ad Manager באמצעות IMA SDK.

כדי להשתמש ב-Secure Signals API, נדרשת גרסת 3.29.0 ואילך של IMA SDK ל-Android.

במאמר שיתוף אותות מאובטחים עם בידינגרים מוסבר איך לבחור אותות ובידינגרים ולהפעיל שיתוף של אותות מאובטחים.

שימוש בספק אותות של צד שלישי

כדי להשתמש באותות מאובטחים, צריך לפרוס באפליקציה שלכם סוג מתאם של אספן אותות כדי לאסוף אותות, לקודד אותם ולהעביר אותם ל-IMA SDK.

פועלים לפי ההוראות של ספק הצד השלישי כדי להגדיר חשבון אצלו, מוסיפים יחסי תלות ל-build ומגדירים את מתאם האותות המאובטח שלו באפליקציה.

IMA SDK ל-Android מאתחלל באופן אוטומטי כל מתאם של אותות מאובטחים, בלי שצריך לבצע שינויים נוספים בקוד.

דוגמה לאופן שבו אפשר להוסיף מתאם אותות מאובטח לפרויקט:

שליחת נתונים בהתאמה אישית

הערה: התכונה 'אותות מאובטחים עם נתונים מותאמים אישית' היא תכונה מוגבלת בגרסת בטא, ויכול להיות שהיא לא תהיה זמינה ברשת שלכם. כדי לבקש גישה לתכונה הזו, צריך לפנות למנהל החשבון.

בנוסף לשימוש בספק אותות של צד שלישי, אפשר גם לאסוף, לקודד ולשלוח אותות עם נתונים מותאמים אישית. כדי שתוכלו לשלוח אותות מאובטחים עם נתונים מותאמים אישית, עליכם להפעיל אותות מותאמים אישית ב-Ad Manager.

לכל בקשת מודעה, יוצרים אובייקט SecureSignals שמכיל את הנתונים המותאמים אישית המקודדים, כמחרוזת. לאחר מכן, מוסיפים את האובייקט SecureSignals לבקשת המודעה באמצעות קריאה ל-adsRequest.setSecureSignals().

דוגמה ב-Java:

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);
}
...