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

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

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

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

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

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

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

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

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

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

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

לכל בקשת מודעה, יוצרים אובייקט IMASecureSignals שמכיל את הנתונים המותאמים אישית המקודדים כמחרוזת. לאחר מכן, מוסיפים את האובייקט IMASecureSignals לבקשת המודעה באמצעות קריאה למאפיין IMAAdsRequest.secureSignals.

הנה דוגמאות ב-Objective-C וב-Swift:

Objective-CSwift

BasicExample/ViewController.m

...
- (void)requestAds {
  // Create an ad display container for ad rendering.
  IMAAdDisplayContainer *adDisplayContainer =
      [[IMAAdDisplayContainer alloc] initWithAdContainer:self.videoView
                                          viewController:self
                                          companionSlots:nil];
  // Create an ad request with our ad tag, display container, and optional user context.
  IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:kTestAppAdTagUrl
                                                adDisplayContainer:adDisplayContainer
                                                   contentPlayhead:self.contentPlayhead
                                                       userContext:nil];
  
  IMASecureSignals *signals =
      [[IMASecureSignals alloc] initWithCustomData:@"My encoded signal string"];
  request.secureSignals = signals;
  
  [self.adsLoader requestAdsWithRequest:request];
}
...

BasicExample/ViewController.swift

...
private func requestAds() {
  // Create ad display container for ad rendering.
  let adDisplayContainer = IMAAdDisplayContainer(
    adContainer: videoView, viewController: self, companionSlots: nil)
  // Create an ad request with our ad tag, display container, and optional user context.
  let request = IMAAdsRequest(
    adTagUrl: ViewController.testAppAdTagURL,
    adDisplayContainer: adDisplayContainer,
    contentPlayhead: contentPlayhead,
    userContext: nil)
  
  let signals = IMASecureSignals(customData: "My encoded signal string")
  request.secureSignals = signals
  
  adsLoader.requestAds(with: request)
}
...