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

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

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

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

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

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

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