WittyFeed SDK API is now
OneFeed iOS SDK, New v1.2.0 made live on 28 Dec' 2018
OneFeed brings you new revolutionary way to monetize your App Business. OneFeed provides engaging content from top publishers in your app, and through the OneFeed Dashboard you can track your earning with the content consumption.
OneFeed is World's Top Paying Network
OneFeed SDK has its core competency at its personalised feed recommendation algorithms and lightweight architecture.
- OneFeed ready-to-deploy feed layout
- Notification service
Browse through the example app in this repository to see how the OneFeed SDK can be implemented in different types of apps.
- Minimum Deployment Target ~> 9.0
- Devices ~> iPhone
pod 'OneFeed-iOS-SDK', :git => 'https://github.com/vatsanatech/OneFeed-iOS-SDK', :tag => ‘1.2.0’- Confirm for the following dependencies in your Podfile
Alamofire (4.6.0)
SwiftyJSON (4.0.0)
Kingfisher (4.6.1)
Firebase/Core (4.8.2) // for notification service only
Firebase/Messaging (4.8.2) // for notification service only
SwiftKeychainWrapper // for unique device
We encourage developers to always check for latest SDK version and refer to its updated documentation to use it.
* Add this code in your AppDelegate.swift
var appId: String = "YOUR APP ID"
var apiKey: String = "YOUR API KEY"
class MainViewController: UIViewController {
let APP_ID = "<YOUR_APP_ID>" //App id provided by WF
let API_KEY = "<YOUR_API_KEY>" //App access key provided by WF
let FCM_TOKEN = "" // FCM TOKEN of the user
let delegate = UIApplication.shared.delegate as! AppDelegate
override func viewDidLoad() {
super.viewDidLoad()
if let temp = InstanceID.instanceID().token(){
FCM_TOKEN = temp
}
// ====================
// SDK WORK STARTS HERE
// ====================
APP_ID = delegate.appId
API_KEY = delegate.apiKey
//
// OPTIONAL to provide basic user_meta.
// By providing user_meta your app can receive targeted content which has an higher CPM then regular content.
//
var user_meta: [String:String] = [:]
//
// WittyFeedSDKGender has following options = "M" for Male, "F" for Female, "O" for Other, "N" for None
//
user_meta["client_gender"] = "NONE"
//
// User Interests.
// String with a max_length = 100
//
user_meta["client_interests"] = "love, funny, sad, politics, food, technology, DIY, friendship, hollywood, bollywood, NSFW"
//
// below code is only ***required*** for Initializing Wittyfeed iOS SDK API, -- providing 'user_meta' is optional --
//
WittyFeedSDKSingleton.instance.wittyFeed_sdk_api_client = WittyFeedSDKApiClient(apikey: API_KEY, appid: APP_ID, fcmtoken: FCM_TOKEN, usermeta: user_meta)
WittyFeedSDKSingleton.instance.wittyFeed_sdk_main = WittyFeedSDKMain(wittyFeedSDKApiClient: WittyFeedSDKSingleton.instance.wittyFeed_sdk_api_client)
//
// set the closure method that works as a callback function when SDK initialzes successfully
//
WittyFeedSDKSingleton.instance.wittyFeed_sdk_main.set_sdk_init_main_callback { (status) in
if(status == "success"){
//
// Do necessary actions here after initializing OneFeed-SDK
//
print("WittyFeed SDK did Initalized Successfully")
} else {
//
// If SDK initialization failes
//
print("SDK init error")
}
}
//
// initializing SDK here (mandatory)
//
WittyFeedSDKSingleton.instance.wittyFeed_sdk_main.init_wittyfeed_sdk()
// ==================
// SDK WORK ENDS HERE
// ==================
}
}Only after SDK initialization in step 1.3,
To utilize and open waterfall feed from SDK, push/present the WittyFeedSDKWaterfallCollectionVC ViewController by -
// ========================
// ==Code to open OneFeed==
// ========================
let onefeed_vc = WittyFeedSDKSingleton.instance.wittyFeed_sdk_main.get_onefeed_view_controller()
self.navigationController?.pushViewController(onefeed_vc, animated: true)
// ============================
// ==Code to open OneFeed End==
// ============================Step 1: In dashboard(https://onefeed.ai), Go to your added app section and Make a card according to your requirements and note the card id.
Step 2: Set this tag in your View (Tag is mandatory):
UIImageView.tag = 1001 //for Story Image
UIView.tag = 1002 //for Opacity adjust UIView
UILabel.tag = 1003 //for Story Title
UILabel.tag = 1004 //for Category NameStep 3: Add this code in your UIViewController class (First time initialize your card):
WittyFeedSDKSingleton.instance.wittyFeed_sdk_main.init_native_card(cardId: "YOUR CARD ID")Step 4: Add this code in your UITableView/UICollectionView class:
func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
let feedNativeCard = OneFeedNativeCard()
//Repeating card view
let cell = tableView.dequeueReusableCell(withIdentifier: "NativeCardCell", for: indexPath) as! NativeCardCell
let categoryType = feedNativeCard.showCard(cardId: "YOUR CARD ID", view: cell.userView , isVerticalImage: true, reference: "test", index: indexPath.row, views: self)
print(categoryType)
return cell
}In your AppDelegate, update your userNotificationCenter (willPresent..) and userNotificationCenter (didRecieve..) with the code below
// Firebase notification received
@available(iOS 10.0, *)
func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (_ options: UNNotificationPresentationOptions) -> Void) {
// =====================================
// SDK WORK FOR NOTIFICATION STARTS HERE
// =====================================
completionHandler([.alert, .badge, .sound])
// ===================================
// SDK WORK FOR NOTIFICATION ENDS HERE
// ===================================
return
}
@available(iOS 10.0, *)
func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
// if you set a member variable in didReceiveRemoteNotification, you will know if this is from closed or background
// print("Handle push from background or closed\(response.notification.request.content.userInfo)")
print("Handle push from background or closed")
// =====================================
// SDK WORK FOR NOTIFICATION STARTS HERE
// =====================================
//
// Parse the data payload in cloud message into an dictionary, we will this dictionary forward into WittyFeedSDK
//
let payload_data_dict = response.notification.request.content.userInfo as NSDictionary
//
// Create an object of WittyFeedSDKNotificationManager to handle the notifications from Engage9 only
// it will not interfere or disrupt your notifications
//
let fcm_token = InstanceID.instanceID().token()
let notiff_manager = WittyFeedSDKNotificationManager(dict: payload_data_dict, fcm_token: fcm_token!, window: self.window!)
notiff_manager.safariDelegate = self as SFSafariViewControllerDelegate
notiff_manager.handleNotification()
// ===================================
// SDK WORK FOR NOTIFICATION ENDS HERE
// ===================================
return
}
}
// when firebase token updates in host app
func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String) {
print("Token:- \(fcmToken)")
// =====================================
// SDK WORK FOR NOTIFICATION STARTS HERE
// =====================================
if(WittyFeedSDKSingleton.instance.wittyFeed_sdk_main != nil){
WittyFeedSDKSingleton.instance.wittyFeed_sdk_main.update_fcm_token(new_fcm_token: fcmToken)
} else {
let witty_sdk_main = WittyFeedSDKMain(wittyFeedSDKApiClient: WittyFeedSDKApiClient(apikey: "", appid: "", fcmtoken: fcmToken) )
witty_sdk_main.update_fcm_token(new_fcm_token: fcmToken)
}
// ===================================
// SDK WORK FOR NOTIFICATION ENDS HERE
// ===================================
}For Sample Notifications, hit this Get Request URL along with
YOUR FCM TOKENas a URL encoded Parameter http://54.174.201.35/other/get_ios_sdk_sample_notification/?fcm_token=<YOUR_FCM_TOKEN> You will need to create/update Apple Push Notifications Certifiates for notification testing
This repository includes an example iOS app which uses all the features of OneFeed-iOS-SDK documented above.
Install the Example App in your iPhone to test notification.
You will need to create/update Apple Push Notifications Certifiates for notification testing.
This program is licensed under the Vatsana Technologies Pvt. Ltd. SDK License Agreement (the “License Agreement”). By copying, using or redistributing this program, you agree to the terms of the License Agreement. The full text of the license agreement can be found at . Copyright 2017 Vatsana Technologies Pvt. Ltd. All rights reserved.