Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dreamsoftin/facebook_audience_network
Flutter Facebook Audience Network
https://github.com/dreamsoftin/facebook_audience_network
ads ads-sdk dart facebook facebook-audience-network flutter flutter-plugin flutter-widget
Last synced: about 3 hours ago
JSON representation
Flutter Facebook Audience Network
- Host: GitHub
- URL: https://github.com/dreamsoftin/facebook_audience_network
- Owner: dreamsoftin
- License: mit
- Created: 2019-04-27T05:46:07.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-08-09T09:35:41.000Z (6 months ago)
- Last Synced: 2025-01-20T04:55:15.473Z (7 days ago)
- Topics: ads, ads-sdk, dart, facebook, facebook-audience-network, flutter, flutter-plugin, flutter-widget
- Language: Swift
- Homepage: https://pub.dartlang.org/packages/facebook_audience_network/
- Size: 21.2 MB
- Stars: 158
- Watchers: 8
- Forks: 90
- Open Issues: 75
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# facebook_audience_network
 
[Facebook Audience Network](https://developers.facebook.com/docs/audience-network) plugin for Flutter applications (Android & iOS).
| Banner Ad | Native Banner Ad | Native Ad |
| - | - | - |
|  |  |  |
| Interstitial Ad | Rewarded Video Ad |
| - | - |
|  |  |
---
## Getting Started
### 1. Initialization:
For testing purposes you need to obtain the hashed ID of your testing device. To obtain the hashed ID:
1. Call `FacebookAudienceNetwork.init()` during app initialization.
2. Place the `FacebookBannerAd` widget in your app.
3. Run the app.
The hased id will be in printed to the logcat. Paste that onto the `testingId` parameter.
```dart
FacebookAudienceNetwork.init(
testingId: "37b1da9d-b48c-4103-a393-2e095e734bd6", //optional
iOSAdvertiserTrackingEnabled: true //default false
);
```
##### IOS Setup
In Pod file, set the IOS deployment target version to 9.0
*IN iOS, Banner, Interstital and Native Ads are supported*
---
### 2. Show Banner Ad:
```dart
Container(
alignment: Alignment(0.5, 1),
child: FacebookBannerAd(
placementId: Platform.isAndroid ? "YOUR_ANDROID_PLACEMENT_ID" : "YOUR_IOS_PLACEMENT_ID",
bannerSize: BannerSize.STANDARD,
listener: (result, value) {
switch (result) {
case BannerAdResult.ERROR:
print("Error: $value");
break;
case BannerAdResult.LOADED:
print("Loaded: $value");
break;
case BannerAdResult.CLICKED:
print("Clicked: $value");
break;
case BannerAdResult.LOGGING_IMPRESSION:
print("Logging Impression: $value");
break;
}
},
),
)
```
---
### 3. Show Interstitial Ad:
```dart
FacebookInterstitialAd.loadInterstitialAd(
placementId: "YOUR_PLACEMENT_ID",
listener: (result, value) {
if (result == InterstitialAdResult.LOADED)
FacebookInterstitialAd.showInterstitialAd(delay: 5000);
},
);
```
---
### 4. Show Rewarded Video Ad:
(Android Only)
```dart
FacebookRewardedVideoAd.loadRewardedVideoAd(
placementId: "YOUR_PLACEMENT_ID",
listener: (result, value) {
if(result == RewardedVideoResult.LOADED)
FacebookRewardedVideoAd.showRewardedVideoAd();
if(result == RewardedVideoResult.VIDEO_COMPLETE)
print("Video completed");
},
);
```
---
### 5. Show Native Ad:
- NativeAdType NATIVE_AD_HORIZONTAL & NATIVE_AD_VERTICAL ad types are supported only in iOS. In Android use NATIVE_AD.
```dart
FacebookNativeAd(
placementId: "YOUR_PLACEMENT_ID",
adType: NativeAdType.NATIVE_AD,
width: double.infinity,
height: 300,
backgroundColor: Colors.blue,
titleColor: Colors.white,
descriptionColor: Colors.white,
buttonColor: Colors.deepPurple,
buttonTitleColor: Colors.white,
buttonBorderColor: Colors.white,
keepAlive: true, //set true if you do not want adview to refresh on widget rebuild
keepExpandedWhileLoading: false, // set false if you want to collapse the native ad view when the ad is loading
expandAnimationDuraion: 300, //in milliseconds. Expands the adview with animation when ad is loaded
listener: (result, value) {
print("Native Ad: $result --> $value");
},
),
```
---
### 6. Show Native Banner Ad:
Use `NativeBannerAdSize` to choose the height for Native banner ads. `height` property is ignored for native banner ads.
```dart
FacebookNativeAd(
placementId: "YOUR_PLACEMENT_ID",
adType: NativeAdType.NATIVE_BANNER_AD,
bannerAdSize: NativeBannerAdSize.HEIGHT_100,
width: double.infinity,
backgroundColor: Colors.blue,
titleColor: Colors.white,
descriptionColor: Colors.white,
buttonColor: Colors.deepPurple,
buttonTitleColor: Colors.white,
buttonBorderColor: Colors.white,
listener: (result, value) {
print("Native Ad: $result --> $value");
},
),
```
---
**Check out the [example](https://github.com/dreamsoftin/facebook_audience_network/tree/master/example) for complete implementation.**
iOS wrapper code contribution by **lolqplay team from birdgang**
### Note: Instream video ad has been removed by Facebook. Read more [here](https://www.facebook.com/business/help/645132129564436?id=211412110064838)
## Future Work
Implement Rewarded video for iOS platform.