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

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

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

כדי להשתמש ב-API של אותות מאובטחים, נדרשת גרסה 3.29.0 ומעלה של IMA SDK ל-Android.

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

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

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

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

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