{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Yieldlove SDK for React Native","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"style":{"value":"none"}},"macroMetadata":{"macroId":{"value":"d8c8089d-407d-4b10-8778-e44fcf090d40"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"b5412077-ad1e-4d6a-99f1-da5d2ccb2e6e"}},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"Starting from ","type":"text"},{"text":"Version 3","type":"text","marks":[{"type":"strong"}]},{"text":", all libraries will share the ","type":"text"},{"text":"same version number","type":"text","marks":[{"type":"strong"}]},{"text":" to prevent mismatches and reduce confusion.","type":"text"}]},{"type":"paragraph","content":[{"text":"Additionally, the SDK configuration has been updated. Please verify that all configurations are correctly set in your project.","type":"text"}]},{"type":"paragraph","content":[{"text":"Ensure you are using the ","type":"text"},{"text":"correct version","type":"text","marks":[{"type":"strong"}]},{"text":" for all dependencies.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Release Note(v3.0.0)","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"New Feature:","type":"text","marks":[{"type":"strong"}]},{"text":" ID5","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Updated","type":"text","marks":[{"type":"strong"}]},{"text":" Minimum target platform","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"iOS: 15","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Android: 24","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Updated","type":"text","marks":[{"type":"strong"}]},{"text":" Gravite SDK version:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"iOS: 3.12.0","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Android: 3.12.5","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Updated","type":"text","marks":[{"type":"strong"}]},{"text":" Kotelin version is 2.0","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fixed","type":"text","marks":[{"type":"strong"}]},{"text":" an issue where the banner size from Gravite was not being set correctly.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Fixed","type":"text","marks":[{"type":"strong"}]},{"text":" an issue where the zone was excluded in the placement name for Gravite","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Installation","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Using ","type":"text"},{"text":"npm","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"$ npm install react-native-yieldlove --save","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Using ","type":"text"},{"text":"yarn","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"$ yarn add react-native-yieldlove","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Set-Up","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"If you don't want use Cocoapods, you can always ","type":"text"},{"text":"link the library manually","type":"text","marks":[{"type":"link","attrs":{"href":"https://reactnative.dev/docs/linking-libraries-ios"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Android","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Add our ad-integration SDK into your app's ","type":"text"},{"text":"build.gradle","type":"text","marks":[{"type":"code"}]},{"text":" file:","type":"text"}]},{"type":"codeBlock","content":[{"text":"allprojects {\n repositories {\n maven { \n url 'https://slabs-yieldlove-ad-integration.s3.eu-central-1.amazonaws.com/android' \n content {\n includeGroup(\"com.yieldlove.adIntegration\")\n }\n }\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"iOS","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The package is ","type":"text"},{"text":"automatically linked","type":"text","marks":[{"type":"link","attrs":{"href":"https://github.com/react-native-community/cli/blob/master/docs/autolinking.md"}}]},{"text":" when building the app. All you need to do is:","type":"text"}]},{"type":"paragraph","content":[{"text":"$ cd ios && pod install","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Gravite Set-Up (Optional)","type":"text"}]},{"type":"paragraph","content":[{"text":"Please reach out to your Ströer Publisher Account Manager to enable the Gravite plugin.","type":"text"}]},{"type":"expand","attrs":{"title":"How to set-up"},"content":[{"type":"paragraph","content":[{"text":"The Stroeer SDK only references the Gravite Core Library. To use the ad networks provided by Gravite, you must include the ad networks for Gravite Library. For more details, refer to the Gravite setup page.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"You can upgrade the Gravite SDK version to utilize additional features. The officially supported version is ","type":"text"},{"text":"3.12.5 for Android ","type":"text","marks":[{"type":"strong"}]},{"text":"and","type":"text"},{"text":" 3.12.0 for iOS","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Android ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://aatkit.gitbook.io/android-integration/start/setup/maven"}},{"text":" ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Repository settings","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"allprojects {\n repositories {\n google()\n mavenCentral()\n \n // Third-party repositories\n maven { url 'https://android-sdk.aatkit.com/maven/' } // AATKit\n maven { url 'https://s3.amazonaws.com/smaato-sdk-releases/' } // Smaato\n maven { url 'https://packagecloud.io/smartadserver/android/maven2' } // SmartAdServer\n maven { url 'https://verve.jfrog.io/artifactory/verve-gradle-release' } // PubNative\n maven { url 'https://android-sdk.is.com/' } // ironSource\n maven { url 'https://maven.ogury.co' } // Ogury\n maven { url 'https://android-sdk-rtb.gravite.net/maven' } // GraviteRTB\n maven { url 'https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea' } // Mintegral\n maven { \n url 'https://slabs-yieldlove-ad-integration.s3.eu-central-1.amazonaws.com/android' \n content {\n includeGroup(\"com.yieldlove.adIntegration\")\n }\n } // Yieldlove\n }\n}","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Dependency settings","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"dependencies {\n implementation ('com.yieldlove.adIntegration:gravite:7.0.0')\n implementation ('com.intentsoftware.addapptr:AATKit:3.12.5') {\n transitive = true\n } \n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"iOS ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://aatkit.gitbook.io/ios-integration/start/setup/cocoapods"}},{"text":" ","type":"text"}]},{"type":"codeBlock","content":[{"text":"pod 'YieldloveAdIntegration/Gravite', '10.0.0'\npod 'AATKit', '3.12.0' ","type":"text"}]},{"type":"paragraph"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Confiant Set-Up (Optional)","type":"text"}]},{"type":"paragraph","content":[{"text":"Please contact your Ströer Publisher Account Manager to enable the Confiant plugin.","type":"text"}]},{"type":"expand","attrs":{"title":"How to set-up"},"content":[{"type":"heading","attrs":{"level":4},"content":[{"text":"Android","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Repository settings","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"repositories {\n maven{\n url 'https://cdn.confiant-integrations.net/backend-integrations/in-app/releases/android/maven'\n content {\n includeGroup(\"com.confiant.android\")\n }\n \n maven { \n url 'https://slabs-yieldlove-ad-integration.s3.eu-central-1.amazonaws.com/android' \n content {\n includeGroup(\"com.yieldlove.adIntegration\")\n }\n } // Yieldlove\n }\n}","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Dependency setting","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"dependencies {\n implementation 'com.confiant.android:sdk:6.1.1'\n implementation 'com.yieldlove.adIntegration:confiant:7.0.0'\n}","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"iOS","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CocoaPod ","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"# This should be decleared before \"Target\"\nsource 'https://cdn.cocoapods.org/'\nsource 'https://cdn.confiant-integrations.net/backend-integrations/in-app/releases/ios/podspecs.git'\n\n# This should be decleared in \"Target\"\npod 'ConfiantSDK', '6.1.0'\npod 'YieldloveAdIntegration', :podspec => 'https://slabs-yieldlove-ad-integration.s3.eu-central-1.amazonaws.com/ios/YieldloveAdIntegration-10.0.0.podspec', subspecs: ['Confiant']","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CocoaPod for Gravite & Confiant ","type":"text"},{"type":"hardBreak"},{"text":"If you want to use both Confiant and Gravite, use the following settings. (","type":"text"},{"text":"Android doesn’t require the different settings","type":"text","marks":[{"type":"strong"}]},{"text":")","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"# This should be decleared before \"Target\"\nsource 'https://cdn.cocoapods.org/'\nsource 'https://cdn.confiant-integrations.net/backend-integrations/in-app/releases/ios/podspecs.git'\n\n# This should be decleared in \"Target\"\npod 'AATKit', '3.12.0' \npod 'ConfiantSDK', '6.1.0'\npod 'YieldloveAdIntegration', :podspec => 'https://slabs-yieldlove-ad-integration.s3.eu-central-1.amazonaws.com/ios/YieldloveAdIntegration-10.0.0.podspec', subspecs: ['Confiant', 'Gravite']","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example Code","type":"text"}]},{"type":"paragraph","content":[{"text":"Contact to your account manager to obtain your application name (","type":"text"},{"text":"APPLICATION_NAME","type":"text","marks":[{"type":"code"}]},{"text":") and call strings (","type":"text"},{"text":"INTERSTITIAL_CALL_STRING","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"BANNER_CALL_STRING","type":"text","marks":[{"type":"code"}]},{"text":"). Each call string represents a single slot.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"import { Yieldlove, YieldloveBannerAd } from 'react-native-yieldlove';\n\n// before using any other method from Yieldlove and/or rendering YieldloveBannerAd you have to set the application name\nYieldlove.setApplicationName(APPLICATION_NAME);\n\n// optional global custom targeting\nYieldlove.setCustomTargeting({fruit: 'apple', colour: 'pink'});\n\n// optional global content url\nYieldlove.setContentUrl(\"\")\n\n// loading & showing interstitial ad\nYieldlove.loadInterstitial({\n callString: INTERSTITIAL_CALL_STRING,\n options: {\n contentUrl: '\n customTargeting: {\n fruit: 'banana',\n day: 'saturday'\n }\n },\n onAdLoaded: (event) => {\n console.log('interstitial onAdLoaded', event);\n Yieldlove.showInterstitial().catch(error => console.log(error));\n },\n onAdFailedToLoad: (event) => {\n console.log('interstitial onAdFailedToLoad', event);\n }\n});\n\n// rendering banner ad\n// ...\n\n }}\n onAdLoaded={({ nativeEvent }) => {\n const {width, height, source, version, placement} = nativeEvent;\n console.log(`banner width: ${width}, height: ${height}, source: ${source}, version: ${version}, placement: ${placement}`);\n this.setState({ width, height });\n }}\n/>","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example Code for Gravite (Optional)","type":"text"}]},{"type":"expand","attrs":{"title":"Check how to do"},"content":[{"type":"codeBlock","content":[{"text":"import { Yieldlove, YieldloveBannerAd } from 'react-native-yieldlove';\nimport { Gravite } from 'react-native-yieldlove'; // For Gravite\n\n// before using any other method from Yieldlove and/or rendering YieldloveBannerAd you have to set the application name\nYieldlove.setApplicationName(APPLICATION_NAME);\n\n// optional global custom targeting\nYieldlove.setCustomTargeting({fruit: 'apple', colour: 'pink'});\n\n// optional global content url\nYieldlove.setContentUrl(\"\")\n\n// Initializing Gravite \nGravite.enableDebugMode();\n// Gravite.enableTestMode(\"\", 0, true);\nGravite.setCacheSize(2);\n\nconst stroeerToGravite = {\n \"b1\": \"gb1\",\n \"b2\": \"gb2\"\n};\n\nGravite.setPlacementMapTable(stroeerToGravite);\nGravite.initialize((isInitialized: boolean) => {\n console.log('Gravite Initialized', isInitialized ? 'Success' : 'Failure');\n});\n\n\n// The same as the loading code.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"To ensure proper functionality, please preload an interstitial ad before use—ideally when the application starts. Since GraviteSDK requires 3 to 10 seconds to load an interstitial, StroeerSDK cannot effectively manage interstitial results from Gravite in real time. If not preloaded, the SDK will return a 'No Interstitial' error, and the initial interstitial will fail to display.","type":"text"}]}]},{"type":"nestedExpand","attrs":{"title":"Gravite.enableDebugMode()"},"content":[{"type":"paragraph","content":[{"text":" EnableDebugMode Method. The Debug Mode provides detailed logs to assist with troubleshooting and debugging","type":"text"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"Debug Mode","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" must not be enabled in production environments. This mode is intended only for testing and development.","type":"text","marks":[{"type":"em"}]}]}]}]},{"type":"nestedExpand","attrs":{"title":"Gravite.enableTestMode(\"\", 0, true)"},"content":[{"type":"paragraph","content":[{"text":"EnableTestMode Method","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"public void enableTestMode(String bundleId, Integer accountId, boolean forceToExecute)","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"bundleId","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Gravite identifies your app using its bundle ID. If you need to use a different bundle ID for publishing, testing, or other purposes, you can override the default bundle ID by specifying an \"alternative bundle ID\" here.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To use the app’s default bundle ID, pass ","type":"text"},{"text":"“\"","type":"text","marks":[{"type":"code"}]},{"text":"empty string.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"accountId","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"AATKit’s test mode allows ad testing even before your app is fully set up with Gravite. Use your ","type":"text"},{"text":"accountId","type":"text","marks":[{"type":"code"}]},{"text":" to activate test mode.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If not needed, pass ","type":"text"},{"text":"0","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"forceToExecute","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"If set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", the SDK will bypass normal ad rendering and always call Gravite Ads. This ensures that your application integrates properly with Gravite.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"Test Mode","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" must not be enabled in production environments. This modes is intended only for testing and development.","type":"text","marks":[{"type":"em"}]}]}]}]},{"type":"nestedExpand","attrs":{"title":"Gravite.setCacheSize(2)"},"content":[{"type":"paragraph","content":[{"text":"Gravite includes a preloading feature to ensure seamless display of banner and interstitial ads. By default, the cache size is set to 1. However, if Gravite is accessed frequently, the cache may empty too quickly, causing delays or empty ads while new ads load. To mitigate this, consider increasing the cache size","type":"text"}]}]},{"type":"nestedExpand","attrs":{"title":"Gravite.enableDirectGraviteCall()"},"content":[{"type":"paragraph","content":[{"text":"StroeerSDK provides to call Gravite directly bypassing the Stroeer Ad request. Please contact the Stroeer administrator to discuss this feature.","type":"text"},{"type":"hardBreak"},{"text":"To enable Gravite Direct Call, use the the code","type":"text"}]}]},{"type":"nestedExpand","attrs":{"title":"Gravite.setPlacementMapTable(stroeerToGravite);"},"content":[{"type":"paragraph","content":[{"text":"StroeerSDK features a placement mapping capability that automatically translates Stroeer placement names to their corresponding Gravite placements. This eliminates the need to create identical placement names for each provider, streamlining the integration process.","type":"text"},{"type":"hardBreak"},{"text":"Create a mapping table and send it via setPlacementMapTable.","type":"text"}]},{"type":"codeBlock","content":[{"text":"const stroeerToGravite = {\n \"b1\": \"gb1\",\n \"b2\": \"gb2\"\n};\nGravite.setPlacementMapTable(stroeerToGravite);","type":"text"}]},{"type":"paragraph","content":[{"text":"This configuration ensures that when Gravite processes placements:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Stroeer placement ","type":"text"},{"text":"b1","type":"text","marks":[{"type":"code"}]},{"text":" will be mapped to Gravite placement ","type":"text"},{"text":"gb1","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Stroeer placement ","type":"text"},{"text":"b2","type":"text","marks":[{"type":"code"}]},{"text":" will be mapped to Gravite placement ","type":"text"},{"text":"gb2","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]}]},{"type":"nestedExpand","attrs":{"title":"Gravite.initialize((isInitialized: boolean) => {}"},"content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Gravite.initialize","type":"text","marks":[{"type":"code"}]},{"text":" function is responsible for initializing the Gravite SDK. This setup process ensures that the necessary configurations and resources are properly loaded before the application starts displaying ads.","type":"text"}]},{"type":"paragraph","content":[{"text":"isInitialized indicates whether the Gravite SDK was initialized successfully (","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":") or failed (","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Transferring Resume / Pause events.","type":"text"}]},{"type":"paragraph","content":[{"text":"Gravite requires page resume and pause events for efficient resource management. Call ","type":"text"},{"text":"Gravite.onResume();","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"Gravite.onPause();","type":"text","marks":[{"type":"code"}]},{"text":" whenever the page state changes. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"These methods must be invoked on every page; otherwise, ads may not render properly. Refer to the following code for implementation.","type":"text"}]}]},{"type":"codeBlock","content":[{"text":"class App extends Component {\n constructor(props) {\n super(props);\n this.state = { appState: AppState.currentState };\n }\n\n componentDidMount() {\n this.appStateListener = AppState.addEventListener('change', this.handleAppStateChange);\n }\n\n componentWillUnmount() {\n this.appStateListener.remove(); // Cleanup event listener\n }\n\n handleAppStateChange = (nextAppState) => {\n if (this.state.appState.match(/inactive|background/) && nextAppState === 'active') {\n Gravite.onResume();\n } else if (nextAppState === 'background') {\n Gravite.onPause();\n }\n this.setState({ appState: nextAppState });\n };\n\n render() {\n return (\n \n Current App State: {this.state.appState}\n \n );\n }\n}","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Example Code for Confiant (Optional)","type":"text"}]},{"type":"expand","attrs":{"title":"Check how to do"},"content":[{"type":"codeBlock","content":[{"text":"import { Yieldlove, YieldloveBannerAd } from 'react-native-yieldlove';\nimport { Confiant } from 'react-native-yieldlove'; // For Gravite\n\n// before using any other method from Yieldlove and/or rendering YieldloveBannerAd you have to set the application name\nYieldlove.setApplicationName(APPLICATION_NAME);\n\n// optional global custom targeting\nYieldlove.setCustomTargeting({fruit: 'apple', colour: 'pink'});\n\n// optional global content url\nYieldlove.setContentUrl(\"\")\n\n// Initializing Confiant \n// Confiant.enableTestMode();\nConfiant.initialize(\n '',\n true,\n (isInitialized: boolean) => {\n console.log('Confiant Initialized', isInitialized ? 'Success' : 'Failure');\n }\n);\n\n// The same as the loading code.","type":"text"}]},{"type":"nestedExpand","attrs":{"title":"Confiant.enableTestMode()"},"content":[{"type":"paragraph","content":[{"text":"This is to test if Confiant works. If this method is called, all the ads will be blocked. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"paragraph","content":[{"text":"Test Mode","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" must not be enabled in production environments. This modes is intended only for testing and development.","type":"text","marks":[{"type":"em"}]}]}]}]},{"type":"nestedExpand","attrs":{"title":"Confiant.initialize( 'confiantPropertyID', true, (isInitialized: boolean) => {} )"},"content":[{"type":"paragraph","content":[{"text":"Parameters:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"confiantPropertyID","type":"text","marks":[{"type":"code"}]},{"text":": To obtain the ","type":"text"},{"text":"confiantPropertyID","type":"text","marks":[{"type":"code"}]},{"text":", please contact ","type":"text"},{"text":"your Ströer Publisher Account Manager","type":"text","marks":[{"type":"underline"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"enableReload","type":"text","marks":[{"type":"code"}]},{"text":": This setting determines whether Confiant should reload advertisements when they are blocked.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", Confiant will attempt to reload the advertisement up to two times.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If set to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":", the invalid advertisement will simply be blocked without a reload attempt.","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"isInitialized indicates whether the Confiant SDK was initialized successfully (","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":") or failed (","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Enable ID5","type":"text"}]},{"type":"paragraph","content":[{"text":"Starting from ","type":"text"},{"text":"Version 3","type":"text","marks":[{"type":"strong"}]},{"text":", the SDK supports ","type":"text"},{"text":"ID5","type":"text","marks":[{"type":"strong"}]},{"text":". This feature is ","type":"text"},{"text":"disabled by default","type":"text","marks":[{"type":"strong"}]},{"text":". To enable it, please contact your ","type":"text"},{"text":"Ströer account manager","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"You ","type":"text"},{"text":"don’t need to make any code changes","type":"text","marks":[{"type":"strong"}]},{"text":" to use ID5. However, for improved identification, you can provide additional user information to ID5. Please refer to the ","type":"text"},{"text":"ID5 website","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://www.id5.io/"}}]},{"text":" for details.","type":"text"}]},{"type":"paragraph","content":[{"text":"This information can be added at any time. ","type":"text"},{"text":"StroeerSDK","type":"text","marks":[{"type":"strong"}]},{"text":" automatically checks the provided variables and updates the ID from ID5. However, for optimal identification, we recommend setting this information ","type":"text"},{"text":"before SDK initialization","type":"text","marks":[{"type":"strong"}]},{"text":", if possible.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"To use ","type":"text"},{"text":"ID5","type":"text","marks":[{"type":"strong"}]},{"text":", the user must provide ","type":"text"},{"text":"consent","type":"text","marks":[{"type":"strong"}]},{"text":" as required by the publisher. Additionally, if the user opts out of ","type":"text"},{"text":"ID5","type":"text","marks":[{"type":"strong"}]},{"text":" in their ","type":"text"},{"text":"privacy settings","type":"text","marks":[{"type":"strong"}]},{"text":", the SDK will ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" use ID5.","type":"text"}]}]},{"type":"codeBlock","content":[{"text":"Identity.setEmail('test@test.com'); //User Email\nIdentity.setPhone('12345656'); //User Phonenumber\nIdentity.setPuid('115352342'); //Publisher User ID\nIdentity.setRegionCode('CA'); //Region Code\nIdentity.setCityCode('MTL'); //City Code\nIdentity.apply(); //Call to apply the updates","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Custom Information","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CustomInfo is optional, and you are not required to provide all the information.","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For RegionalCode, use the ","type":"text"},{"text":"ISO-3166-2","type":"text","marks":[{"type":"strong"}]},{"text":" standard. If the location is in the ","type":"text"},{"text":"USA","type":"text","marks":[{"type":"strong"}]},{"text":", specify the ","type":"text"},{"text":"2-letter state code","type":"text","marks":[{"type":"strong"}]},{"text":"(","type":"text"},{"text":"reference","type":"text","marks":[{"type":"link","attrs":{"href":"https://en.wikipedia.org/wiki/ISO_3166-2"}}]},{"text":").","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For CityCode, use the ","type":"text"},{"text":"United Nations Code for Trade & Transport Locations (UN/LOCODE)","type":"text","marks":[{"type":"strong"}]},{"text":" format (","type":"text"},{"text":"reference","type":"text","marks":[{"type":"link","attrs":{"href":"https://unece.org/trade/uncefact/unlocode-country-subdivisions-iso-3166-2"}}]},{"text":").","type":"text"}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Troubleshooting","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Error: Multiple dependencies with different sources with CocoaPod","type":"text"}]},{"type":"expand","attrs":{"title":"How to solve the issue"},"content":[{"type":"paragraph","content":[{"text":"This is because you may want to use Gravite and Confiant together and use both settings in the Podfile.","type":"text"},{"type":"hardBreak"},{"text":"Use the following settings in the Podfile","type":"text"},{"type":"inlineCard","attrs":{"url":"https://stroeerdigitalgroup.atlassian.net/wiki/spaces/SDGPUBLIC/pages/5024874499/React+Native+Integraiton+document#iOS.1"}},{"text":" ","type":"text"}]},{"type":"codeBlock","content":[{"text":"# This should be decleared before \"Target\"\nsource 'https://cdn.cocoapods.org/'\nsource 'https://cdn.confiant-integrations.net/backend-integrations/in-app/releases/ios/podspecs.git'\n\n# This should be decleared in \"Target\"\npod 'AATKit', '3.12.0' \npod 'ConfiantSDK', '6.1.0'\npod 'YieldloveAdIntegration', :podspec => 'https://slabs-yieldlove-ad-integration.s3.eu-central-1.amazonaws.com/ios/YieldloveAdIntegration.podspec', subspecs: ['Confiant', 'Gravite']","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Error: Confiant could not block Gravite Banner.","type":"text"}]},{"type":"paragraph","content":[{"text":"Unfortunately, Confiant doesn’t block the Gravite Banner very well. We are investigating with the Confiant team. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"My application crashes on start","type":"text"}]},{"type":"paragraph","content":[{"text":"The Google Mobile Ads SDK may be initialized without an application ID.","type":"text"}]},{"type":"paragraph","content":[{"text":"Ad Manager","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"iOS: ","type":"text"},{"text":"Update your Info.plist","type":"text","marks":[{"type":"link","attrs":{"href":"https://developers.google.com/ad-manager/mobile-ads-sdk/ios/quick-start#update_your_infoplist"}}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"Android: ","type":"text"},{"text":"Get Started","type":"text","marks":[{"type":"link","attrs":{"href":"https://developers.google.com/ad-manager/mobile-ads-sdk/android/quick-start"}}]}]},{"type":"paragraph","content":[{"text":"AdMob","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"iOS: ","type":"text"},{"text":"Update your Info.plist","type":"text","marks":[{"type":"link","attrs":{"href":"https://developers.google.com/admob/ios/quick-start#update_your_infoplist"}}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"Android: ","type":"text"},{"text":"Get Started","type":"text","marks":[{"type":"link","attrs":{"href":"https://developers.google.com/admob/android/quick-start"}}]}]}],"version":1}