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

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

כדי להשתמש ב-API של אותות מאובטחים, צריך גרסה 3.18.1 ואילך של IMA SDK ל-iOS.

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

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

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

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

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

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

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

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

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

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

Objective-C

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

Swift

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