react-native-audienzz
v0.5.6
Published
React Native implementation of the AppNexus (Xandr) ads
Downloads
13
Readme
React Native Audienzz Library (AppNexus)
React Native implementation of the AppNexus SDK (TypeScript).
Installation
yarn add react-native-audienzz
(cd ios && pod install)
You don't have to manually link this library as it supports React Native auto-linking.
Usage
There are 2 types of ads implemented in the library: AppNexusBanner and AppNexusVideoBanner. Even though Banner ads may show videos as well (allowVideo
property), AppNexusVideoBanner has its own separate instance.
AppNexusBanner
AppNexusBanner component is used to display banners of different sizes.
Component example:
import { AppNexusBanner } from 'react-native-audienzz';
<AppNexusBanner
placementId={"123456789"}
sizes={[[300, 250]]}
reloadOnAppStateChangeIfFailed
autoRefreshInterval={30}
keywords={{
environment: 'test',
}}
allowVideo
onAdLoadSuccess={() => console.log(`Loaded!`)}
onAdLazyLoadSuccess={() => console.log(`Lazy loaded!`)}
onAdLoadFail={() => {
console.log(`Load failed!`);
}}
onAdVisibleChange={(visibilityType) => {
console.log(`The ad visibility has changed`)
}}
/>
AppNexusBanner props:
| Name | Description | Required | Type | Example |
| --- |---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| :---: |----------|-------------------------------------------------------------------------|
| placementId
| The placement ID identifies your banner in the system. You should have a valid, active placement ID to monetize your application | YES | String | "1234567"
|
| sizes
| An array of banner ad sizes to request | YES | Array | [[300,250], [320,460]]
|
| allowVideo
| Enabling Video Ads (outstream only). For the instream video ads, please refer to the AppNexusVideoBanner
.Default: false
AppNexus documentation: depending on which type of creative has the highest bid, either VAST video or regular HTML banner ads will appear in the app. The mechanism for deciding which type of ad to show is handled automatically for you by the SDK. | No | Boolean | true
|
| autoRefreshInterval
| The interval (in seconds) on how often to reload the banner ad. The minimum allowed is 15, default is 30. To disable autorefresh, set to 0. | No | Number | 30
|
| keywords
| Add a custom keyword to the request URL for the ad. This is used to set custom targeting parameters within the AppNexus platform. You will be given the keys and values to use by your AppNexus account representative or your ad network. | No | Object | { environment: 'test' }
|
| onAdLoadSuccess
| A callback triggered when the ad is loaded and placed within the view. | No | Function | () => console.log("The ad has been loaded")
|
| onAdLazyLoadSuccess
| A callback triggered when the ad is pre-loaded. | No | Function | () => console.log("The ad is lazy loaded / preloaded")
|
| onAdVisibleChange
| A callback triggered when the visibility of the banner has been changed. Returns a visibility type (0
- if banner is not visible, 1
- if banner is partially visible, 2
- If banner is fully visible | No | Function | (visibilityType: number) => console.log("The visibility has changed")
|
| onAdLoadFail
| A callback triggered when the ad request to the server has failed. | No | Function | () => console.log("The ad hasn't been loaded")
|
| reloadOnAppStateChangeIfFailed
| Reloading ad if the app state has changed (background -> foreground). Works only if the ad is shown within the viewport and it is not loaded. Default: false
| No | Boolean | true
|
| customUserAgent
| For IOS only. This parameter sets a custom UserAgent to correctly display received ad blocks. | No | String | "" |
| percentVisibility
| The offset when the banner is considered visible (percentage of the entire banner view holder). Default: 50
| No | Number | 50 |
| openDeviceBrowser
| Add this flag to open the device's native browser when the user clicks an ad. Default: false
| No | Boolean | false
|
AppNexusVideoBanner
AppNexusVideoBanner component is used to display video banners.
Component example:
import { AppNexusVideoBanner } from 'react-native-audienzz';
<AppNexusVideoBanner
placementId={"123456789"}
sizes={[[300, 250]]}
keywords={{
environment: 'test',
}}
onAdLoadSuccess={() => console.log('The video ad has been loaded!')}
onAdLoadFail={() => console.log('The video ad has failed to load!')}
onAdVisibleChange={(visibilityType) => {
console.log(`The ad visibility has changed`)
}}
/>
AppNexusVideoBanner props:
| Name | Description | Required | Type | Example |
| --- |--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| :---: | --- | --- |
| placementId
| The placement ID identifies your banner in the system. You should have a valid, active placement ID to monetize your application | YES | String | "1234567"
|
| sizes
| An array of banner ad sizes to request | YES | Array | [[300,250], [320,460]]
|
| keywords
| Add a custom keyword to the request URL for the ad. This is used to set custom targeting parameters within the AppNexus platform. You will be given the keys and values to use by your AppNexus account representative or your ad network. | No | Object | { environment: 'test' }
|
| onAdLoadSuccess
| A callback triggered when the ad is loaded and placed within the view. | No | Function | () => console.log("The ad has been loaded")
|
| onAdVisibleChange
| A callback triggered when the visibility of the video banner has been changed. Returns a visibility type (0
- if banner is not visible, 1
- if banner is partially visible, 2
- If banner is fully visible | No | Function | (visibilityType: number) => console.log("The visibility has changed")
|
| onAdLoadFail
| A callback triggered when the ad request to the server has failed. | No | Function | () => console.log("The ad hasn't been loaded")
|
| customUserAgent
| For IOS only. This parameter sets a custom UserAgent to correctly display received ad blocks. | No | String | "" |
| percentVisibility
| The offset when the banner is considered visible (percentage of the entire banner view holder). Default: 50
| No | Number | 50 |
Changelog
Our Changelog is handled by Github releases. See all releases