Wait for SDK config (Init sync)

🚧

SDK 4.2.0 or later

If you are using Taboola iOS SDK 4.2.0 or later, you must enable Init Sync for your integration to operate correctly.

Overview

Init Sync ensures the Taboola SDK fetches its remote configuration before making the first content request. This guarantees that server-side settings — including placement tuning, kill switches, and feature flags — are active from the very first impression.

First steps

Complete the First Steps, then continue below.

Enable Init Sync

Add your Publisher ID to your app's Info.plist:

Init Sync is enabled automatically when a Publisher ID is present in your Info.plist.

<key>TaboolaSdkPublisherName</key>
<string>publisher-id</string>

Replace publisher-id with the Publisher ID provided by Taboola.

📘

Opting out

If you need to disable Init Sync while still providing a Publisher ID, add the following entry to your Info.plist:

XML

<key>TaboolaSdkWaitForConfig</key>
<false/>

Log Level

You can set the initial log level via Info.plist so that SDK log messages use the desired print level from the very start — before [Taboola setLogLevel:] is called. This is helpful for debugging the Init Sync flow itself.

<key>TaboolaSdkLogLevel</key>
<integer>1</integer>

📘

This is optional. If omitted, the SDK defaults to Verbose. You can still change the log level at any time using [Taboola setLogLevel:].

Reference

📘

Extra properties

If you set extra properties at the global, page, or unit level, they are queued automatically and applied in the correct order once the configuration is ready. No changes to your existing extra properties calls are needed.