שילוב של מתאמים של אותות מאובטחים

הפלטפורמה: HTML5 Android iOS tvOS

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

ממשק ה-API של אותות מאובטחים דורש גרסה 4.8.2 ומעלה של IMA SDK ל-tvOS.

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

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

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

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

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

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

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

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

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

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

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