¶ DigitekaSDK
Digiteka allows you to integrate a single SDK into your app, and serve "outstream" video or display ads. Sample app includes DigitekaSDK.xcframework and is showing integration example.
¶ Run the demo app
Clone this repository, open it with Xcode, and run project.
¶ Prerequisites
There are some prerequisites before installing the SDK.
- Use Xcode 12.0 or higher.
- Your app targets iOS 12.0 or higher.
¶ Install
DigitekaSDK is distributed through Swift Package Manager.
To integrate the SDK into your Xcode project using SPM, specify package repository url :
https://github.com/digiteka/outstream-ios-sdk
¶ Configuration
¶ App Transport Security
Your Info.plist should contains these keys:
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
<key>NSAllowsArbitraryLoadsForMedia</key>
<true/>
<key>NSAllowsArbitraryLoadsInWebContent</key>
<true/>
</dict>
¶ App Tracking Transparency & IDFA
Starting with iOS 14, your application will have to ask for consent before tracking the user.
You can find more information about this integration in Apple's documentation
¶ Integration
¶ Initialize the SDK
- Import the DigitekaSDK header
import DigitekaSDK
- Create DTKConfig
let dtkConfig = DTKConfig(
baseUrl: "<Your baseUrl>",
mdtk: "<Your mdtk>")
- Initialize the SDK with DTKConfig
Digiteka.getInstance().initialize(dtkConfig)
¶ Initialize the OutstreamView
- In your ViewController instanciate a
OutstreamViewor specify this custom class to your xib or storyboard file, and connect it with@IBOutlet
@IBOutlet weak var outstreamView: OutstreamView!
- Initialize your
OutstreamViewwith theOutstreamViewConfigand a delegate (optional):
let outstreamViewConfig = OutstreamViewConfig(
urlReferer: "<Your url referer>",
zone: <Your zone>,
adUnit: "<Your adUnit (Optional)>")
outstreamView.initialize(config: outstreamViewConfig, delegate: self)
- Add delegate functions (optional):
extension <Your ViewController class>: OutstreamViewDelegate {
func didUpdateHeight(_ ad: OutstreamView, height: CGFloat) {
//Called when the height of the ad has changed
}
func onClose(_ ad: OutstreamView) {
//Called when the ad closed
}
func didReceiveAd(_ ad: OutstreamView) {
//Called when you get an ad
}
}
¶ Load an ad
The ad is loaded with load() method.
outstreamView.load()