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

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

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

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

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

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

כדי להשתמש באותות מאובטחים, צריך לפרוס באפליקציה מחלקת מתאם לאיסוף אותות, שתאסוף את האותות, תקודד אותם ותעביר אותם ל-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);
}