SDK Reference

Mandatory

Sets the publisher ID

Mandatory

Sets the widget UI mode (template)

Mandatory

Sets the widget placement code (for reporting and configuration purposes)

Mandatory

Sets the canonical URL for the page on which the widget is displayed

Optional

Sets the page ID of the page on which the widget is displayed (default to auto generate from the URL)

Optional

Attaches a TaboolaViewDelegate to the TaboolaView. Allows intercepting clicks.

Optional

Taboola in-app web-browser will be used to present selected content if this viewController is provided. If not provided, clicks will be opened in Safari.

Optional

Controls whether to show or hide the action buttons on the in-app browser. Default is "yes"

Optional

Sets the background color for the in-app browser. Default is #f5f6f4

Optional

Sets the color for the in-app browser title text. Default is #007cff

Optional

When enabled, TaboolaView automatically resizes its height after rendering the widget. Default is "yes".

Optional

Mediation provider.

Optional

Default is "false".
When set to "true", TaboolaView is forced to use UIWebView as the widget container instead of WKWebView, even when WKWebView is available (iOS 8 and above). Before using this feature, consult Taboola support or your Taboola account manager.

@property(nonatomic, readwrite) NSString *optionalWidgetStyle

Optional

Forces CSS rules over the TaboolaWidget online HTML template. The method expects an in-line CSS rule string that is added to a <div> element within the WKWebView containing the Widget/Feed

@property(nonatomic, readwrite) NSString *unifiedId

Optional

An opaque, anonymized and unique identifier of the user in the publisher’s eco-system. This identifier should be identical across applications and devices (e.g. hashed e-mail, or login).

Optional

Enables setting additional page commands to the Taboola widget, as used in the Taboola JavaScript API. @param pCommands list of commands

Optional

Enables setting additional mode commands to the Taboola widget, as used in the Taboola JavaScript API. @param pCommands list of commands.

Optional

Adding an option to pass an agreed enum that represents the publisher user type category (“subscriber”, “registered”, “guest”, “other”)

Optional

Hiding the iOS webview scrolling bars from showing when using Feed. The default value is false

Optional

This method is used to set specific key-value pairs to adjust the Taboola via Native behaviour.

• "darkMode" - flags if the publisher is using dark mode theme. Please contact your account/solution manager before using this flag

After initializing the TaboolaView, call this method to fetch the recommendations

Resets the TaboolaView - All contents and pushed commands are cleared. New commands must be pushed before fetching data again.

Refreshes the recommendations displayed on the TaboolaView.

This returns a singleton instance of the SDK.

This registers webView within the Taboola JS SDK. It unregisters an already registered webView from Taboola JS SDK. It is required to load or reload the page after unregistering the webview.

• Note: **When the webView is no longer needed it must be unregistered using `- (void)unregisterWebView:(UIView) webView`.
• *IMPORTANT:** webView must be either of class WKWebView or UIWebView.

This unregisters an already registered webView from Taboola JS SDK. It is required to reload/load the page after unregistering the webview.

This method is used to set specific key-value pairs to adjust the TaboolaJS behaviour.

"darkMode" - flags if the publisher is using dark mode theme.

This sets the log level for the SDK. LogLevel enum defines the importance levels. You can find LogLevel enum in the TaboolaLogger.h file, for example LogLevelError.
This Gets the current log level used by the SDK.
Default: LogLevelError.

This returns, NSSet*.The set of all currently registered webViews.

The TaboolaJSDelegate is used to intercept recommendation clicks, block default click handling for organic items and get notifications about render success or failure.

Optional

This method is called on every click on the Placement and returns a Boolean.
Returning false aborts the default behavior, the app displays the recommendation content on its own (for example, using an in-app browser).

• *IMPORTANT:** This aborts only for organic items.
  Returning true enables the app to implement a click-through and continue to the default behavior.

Optional

This method is called on every successful load of Placement.

Optional

This method is called on every successful load of Placement.

Optional

As TaboolaJS intervenes in the webview’s delegate logic, TaboolaJS implements a default for some of methods. Set webView delegate before registering the webView in TaboolaJS: UIWebView: webView.delegate = self.

Optional

As TaboolaJS intervenes in the webview’s delegate logic, TaboolaJS implements a default for some of methods.
Set webView delegate before registering the webView in TaboolaJS: WKWebView: webview.navigationDelegate = self.

Optional

Default return value: TRUE

Optional

Default return value:
decisionHandler(WKNavigationActionPolicyAllow);

Optional

Default return value:
decisionHandler(WKNavigationResponsePolicyAllow);

Optional

Default return value:
completionHandler(NSURLSessionAuthChallengeRejectProtectionSpace, nil);