תחילת העבודה עם אותות מאובטחים

בחירת פלטפורמה: HTML5 Android iOS tvOS

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

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

כדי לבחור אותות ומגישי הצעות מחיר ולהפעיל שיתוף של אותות מאובטחים, אפשר לעיין במאמר בנושא שיתוף אותות מאובטחים עם מגישי הצעות מחיר.

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

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

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

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

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

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

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

לכל בקשה להצגת מודעה, מבצעים את הפעולות הבאות:

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

private void setSecureSignals(AdsRequest adsRequest, String secureSignalsString) {
  SecureSignals signal = SecureSignals.create(secureSignalsString);
  adsRequest.setSecureSignals(signal);
}