Native Ads

Native Ad Format

Unlike other ad formats where the ad monetization SDK implements the ad view, native ads provide ad components for you to build the ad view directly.
The key advantage is minimizing disruption by implementing layouts based on your UI/UX. However, you must include ad markers to prevent users from confusing ads with content.

4 Required Native Ad ElementsNative ads can be freely designed to match your app’s UI, but the following 4 elements are mandatory:

Ad Label: Add “AD” or similar text so users clearly recognize it as an advertisement.
AdChoices Icon: The AdChoices overlay icon enables users to identify and control ads, typically displayed as an ’ⓘ’ icon. This icon is automatically added by the DARO SDK, so no separate implementation is required. It is placed in one of the four corners of the ad view (top-left, top-right, bottom-right, bottom-left), with bottom-right as the default. You can pick the corner via the preferredAdChoicesPosition option (see the AdChoices Position section below). Please lay out your ad view so the selected corner is not overlapped or obscured by other UI elements. The icon’s appearance and behavior may vary depending on the ad source (demand).
Ad Title: Display the ad’s headline.
CTA (Call to Action): Include a CTA button such as “Install”, “Open”, “Download”. The size and format are flexible.

Registering Native Factory

The layouts below include a persistent AD label supplied by your app. Size the ad container for the actual content and font size, and verify on devices that AdChoices in any corner does not overlap the label or buttons and that content is not clipped. The AD label is separate from the ad assets. To use native ads in Flutter, you must register a native ad factory on the native platform (iOS/Android). The factoryId is the identifier of the factory registered on the native platform.

Android
iOS

Create Ad Layout XML

Create a native ad layout file in android/app/src/main/res/layout/.ad_badge is a View ID in your app’s example XML, not a fixed SDK resource or a Dart widget property. You can change its style and position in this XML; keep the AD label visible and clear of AdChoices.

sample_native_ad.xml

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="480dp">

    <androidx.cardview.widget.CardView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:cardCornerRadius="12dp"
        app:cardElevation="4dp"
        app:cardBackgroundColor="#1E1E1E">

        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:orientation="vertical"
            android:padding="24dp">

            <TextView
                android:id="@+id/ad_badge"
                android:layout_width="wrap_content"
                android:layout_height="wrap_content"
                android:text="AD"
                android:textColor="#FFFFFF"
                android:background="#333333"
                android:padding="4dp"
                android:layout_marginBottom="8dp" />

            <LinearLayout
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:orientation="horizontal"
                android:paddingBottom="12dp">

                <ImageView
                    android:id="@+id/ad_app_icon"
                    android:layout_width="56dp"
                    android:layout_height="56dp"
                    android:scaleType="centerCrop" />

                <LinearLayout
                    android:layout_width="0dp"
                    android:layout_height="wrap_content"
                    android:layout_weight="1"
                    android:layout_marginStart="12dp"
                    android:orientation="vertical">

                    <TextView
                        android:id="@+id/ad_headline"
                        android:layout_width="match_parent"
                        android:layout_height="wrap_content"
                        android:textSize="16sp"
                        android:textStyle="bold"
                        android:maxLines="2"
                        android:ellipsize="end" />

                    <TextView
                        android:id="@+id/ad_advertiser"
                        android:layout_width="match_parent"
                        android:layout_height="wrap_content"
                        android:textSize="13sp"
                        android:layout_marginTop="4dp" />
                </LinearLayout>
            </LinearLayout>

            <FrameLayout
                android:id="@+id/ad_media"
                android:layout_width="match_parent"
                android:layout_height="180dp" />

            <TextView
                android:id="@+id/ad_body"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:layout_marginTop="12dp"
                android:textSize="14sp"
                android:maxLines="2"
                android:ellipsize="end" />

            <Button
                android:id="@+id/ad_call_to_action"
                android:layout_width="match_parent"
                android:layout_height="44dp"
                android:layout_marginTop="12dp"
                android:textSize="16sp"
                android:textStyle="bold" />
        </LinearLayout>
    </androidx.cardview.widget.CardView>
</FrameLayout>

Implement DaroNativeAdFactory

Create a class that implements the DaroNativeAdFactory interface.

SampleNativeAdFactory.kt

import android.content.Context
import android.view.LayoutInflater
import android.view.View
import so.daro.flutter.native.DaroNativeAdFactory
import droom.daro.core.model.DaroNativeAdBinder
import droom.daro.core.model.DaroNativeAdChoicePlacement

class SampleNativeAdFactory(private val context: Context) : DaroNativeAdFactory {

    override fun createNativeAdView(): View {
        return LayoutInflater.from(context).inflate(R.layout.sample_native_ad, null)
    }

    override fun createAdBinder(
        view: View,
        adChoicePlacement: DaroNativeAdChoicePlacement,
    ): DaroNativeAdBinder {
        return DaroNativeAdBinder.Builder(view)
            .setTitleViewId(R.id.ad_headline)
            .setBodyTextViewId(R.id.ad_body)
            .setIconViewId(R.id.ad_app_icon)
            .setMediaViewGroupId(R.id.ad_media)
            .setCallToActionViewId(R.id.ad_call_to_action)
            .setAdChoicePlacement(adChoicePlacement)
            .build()
    }
}

MainActivity.kt

import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import so.daro.flutter.DaroFlutterPlugin

class MainActivity: FlutterActivity() {
    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)

        DaroFlutterPlugin.registerNativeAdFactory(
            flutterEngine,
            "sample_native_ad",
            SampleNativeAdFactory(this)
        )
    }
}

Implement DaroNativeAdFactory

Create a factory class that implements the DaroNativeAdFactory protocol and a custom view that inherits from DaroAdNativeView.

SampleNativeAdFactory.swift

import UIKit
import daro_flutter
import Daro

class SampleNativeAdFactory: NSObject, DaroNativeAdFactory {
    func createNativeAdView(
        unit: DaroAdUnit,
        preferredAdChoicesPosition: DaroAdChoicesPosition
    ) -> DaroAdNativeView {
        return SampleNativeAdContentView(
            unit: unit,
            preferredAdChoicesPosition: preferredAdChoicesPosition
        )
    }
}

final class SampleNativeAdContentView: DaroAdNativeView {
    init(unit: DaroAdUnit, preferredAdChoicesPosition: DaroAdChoicesPosition) {
        super.init(
            unit: unit,
            autoLoad: false,
            preferredAdChoicesPosition: preferredAdChoicesPosition
        )
        setupUI()
    }

    @available(*, unavailable)
    public required init?(coder: NSCoder) {
        fatalError("init(coder:) has not been implemented")
    }

    // Define UI elements
    let iconImageView: UIImageView = {
        let view = UIImageView()
        view.contentMode = .scaleAspectFill
        view.layer.cornerRadius = 8
        view.clipsToBounds = true
        return view
    }()

    let titleLabel: UILabel = {
        let label = UILabel()
        label.font = .systemFont(ofSize: 16, weight: .bold)
        label.numberOfLines = 2
        return label
    }()

    let advertiserLabel: UILabel = {
        let label = UILabel()
        label.font = .systemFont(ofSize: 13)
        label.numberOfLines = 1
        return label
    }()

    let bodyLabel: UILabel = {
        let label = UILabel()
        label.font = .systemFont(ofSize: 14)
        label.numberOfLines = 2
        return label
    }()

    let mediaContentView = UIView()

    let callToActionButton: UIButton = {
        let button = UIButton()
        button.titleLabel?.font = .systemFont(ofSize: 16, weight: .bold)
        button.backgroundColor = .systemBlue
        button.layer.cornerRadius = 8
        return button
    }()

    let adBadgeLabel: UILabel = {
        let label = UILabel()
        label.text = "AD"
        label.font = .systemFont(ofSize: 12, weight: .bold)
        label.textColor = .label
        return label
    }()

    private func setupUI() {
        let stack = UIStackView(arrangedSubviews: [
            adBadgeLabel, iconImageView, titleLabel, advertiserLabel,
            bodyLabel, mediaContentView, callToActionButton
        ])
        stack.axis = .vertical
        stack.alignment = .fill
        stack.spacing = 8
        stack.translatesAutoresizingMaskIntoConstraints = false
        addSubview(stack)
        NSLayoutConstraint.activate([
            stack.topAnchor.constraint(equalTo: topAnchor, constant: 24),
            stack.leadingAnchor.constraint(equalTo: leadingAnchor, constant: 24),
            stack.trailingAnchor.constraint(equalTo: trailingAnchor, constant: -24),
            stack.bottomAnchor.constraint(lessThanOrEqualTo: bottomAnchor, constant: -24),
            iconImageView.heightAnchor.constraint(equalToConstant: 48),
            mediaContentView.heightAnchor.constraint(equalToConstant: 120),
            callToActionButton.heightAnchor.constraint(equalToConstant: 44)
        ])

        // Bind views to Daro SDK
        bindViews(
            titleLabel: titleLabel,
            advertiserLabel: advertiserLabel,
            bodyLabel: bodyLabel,
            iconImageView: iconImageView,
            mediaContentView: mediaContentView,
            callToActionButton: callToActionButton
        )
    }
}

AppDelegate.swift

import Flutter
import UIKit
import daro_flutter

@main
@objc class AppDelegate: FlutterAppDelegate {
    override func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        GeneratedPluginRegistrant.register(with: self)

        DaroFlutterPlugin.registerNativeAdFactory(
            self,
            factoryId: "sample_native_ad",
            nativeAdFactory: SampleNativeAdFactory()
        )

        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
}

The factoryId passed to DaroNativeAd must exactly match the factory ID registered on the native platform.

Implementing Native Ads

Native ads follow a Create Ad object → Load → Display widget → Dispose pattern.

import 'package:daro_flutter/daro_flutter.dart';

1. Create Ad Object

Create a DaroNativeAd object and configure callbacks.

final nativeAd = DaroNativeAd(
  adUnitId: 'YOUR_AD_UNIT_ID',
  factoryId: 'YOUR_FACTORY_ID',
  onAdLoaded: (adInfo) {
    print('Native ad loaded: ${adInfo.adUnitId}');
    setState(() {
      _isAdLoaded = true;
    });
  },
  onAdFailedToLoad: (error) {
    print('Native ad failed to load: ${error.message}');
    nativeAd.dispose();
  },
  onAdClicked: (adInfo) {
    print('Native ad clicked');
  },
  onAdImpression: (adInfo) {
    print('Native ad impression');
  },
);

2. Load the Ad

nativeAd.load();

After the onAdLoaded callback fires, place the DaroNativeAdWidget in the widget tree.

@override
Widget build(BuildContext context) {
  return Column(
    children: [
      // ... other widgets
      if (_isAdLoaded)
        DaroNativeAdWidget(ad: nativeAd),
    ],
  );
}

Placing DaroNativeAdWidget in the widget tree before calling ad.load() will throw a FlutterError. Always mount the widget after the onAdLoaded callback.

4. Dispose Resources

Call dispose() to clean up resources when leaving the page or when the ad is no longer needed.

@override
void dispose() {
  nativeAd.dispose();
  super.dispose();
}

Callback Reference

Callback	Description
`onAdLoaded`	Called when the ad is successfully loaded
`onAdFailedToLoad`	Called when ad loading fails
`onAdClicked`	Called when the user clicks the ad
`onAdImpression`	Called when an ad impression is recorded

AdChoices Position

The preferredAdChoicesPosition option on DaroNativeAd lets you choose which corner the AdChoices icon renders in. When not specified, the bottom-right corner (bottomRight) is used. Supported on both iOS and Android (daro_flutter 1.0.3+).

final nativeAd = DaroNativeAd(
  adUnitId: 'YOUR_AD_UNIT_ID',
  factoryId: 'YOUR_FACTORY_ID',
  preferredAdChoicesPosition: DaroAdChoicesPosition.topLeft,
  onAdLoaded: (adInfo) { /* ... */ },
  onAdFailedToLoad: (error) { /* ... */ },
);

Supported values: topLeft, topRight, bottomLeft, bottomRight.

Fixed at construction timepreferredAdChoicesPosition is fixed when the DaroNativeAd instance is created and cannot be changed afterwards. To use a different position, create a new ad instance.

Behavior varies by demand (preferred, not guaranteed)preferredAdChoicesPosition is a preferred-position hint passed to the underlying ad demand. The corner where the AdChoices icon actually renders depends on the implementation of the demand that fills the ad:

Some demands honor the option as-is.
Some demands ignore the option and enforce their own fixed position.
Some demands replace the AdChoices icon with their own privacy control (such as a demand-specific ad badge).

Keep your AD label and the ad demand source’s AdChoices control visible and unobstructed. This position option alone does not guarantee compliance with all advertising requirements. When designing your ad view layout, assume the AdChoices icon or ad badge can appear in any of the four corners and reserve sufficient padding accordingly.

LINE Native Ads

LINE native ads are compact native ad formats designed to be naturally inserted into feeds or lists.
They are more compact than standard native ads, ideal for embedding between list items.
The ad height is fixed at 36dp (Android) / 36pt (iOS).
Styles can be customized to match your app’s UI.

Implementing LINE Native Ads

LINE native ads follow the same Create Ad object → Load → Display widget → Dispose pattern.

1. Create Ad Object

final lineNativeAd = DaroLineNativeAd(
  adUnitId: 'YOUR_AD_UNIT_ID',
  onAdLoaded: (adInfo) {
    print('Line native ad loaded: ${adInfo.adUnitId}');
    setState(() {
      _isAdLoaded = true;
    });
  },
  onAdFailedToLoad: (error) {
    print('Line native ad failed to load: ${error.message}');
    lineNativeAd.dispose();
  },
  onAdClicked: (adInfo) {
    print('Line native ad clicked');
  },
  onAdImpression: (adInfo) {
    print('Line native ad impression');
  },
);

2. Load the Ad

lineNativeAd.load();

if (_isAdLoaded)
  DaroLineNativeAdWidget(ad: lineNativeAd),

Placing DaroLineNativeAdWidget in the widget tree before calling ad.load() will throw a FlutterError. Always mount the widget after the onAdLoaded callback.

4. Dispose Resources

@override
void dispose() {
  lineNativeAd.dispose();
  super.dispose();
}

Callback Reference

Callback	Description
`onAdLoaded`	Called when the ad is successfully loaded
`onAdFailedToLoad`	Called when ad loading fails
`onAdClicked`	Called when the user clicks the ad
`onAdImpression`	Called when an ad impression is recorded

Style Customization

Use DaroLineNativeAdStyle to customize LINE native ad colors. Pass the style when creating the DaroLineNativeAd object.

final lineNativeAd = DaroLineNativeAd(
  adUnitId: 'YOUR_AD_UNIT_ID',
  style: DaroLineNativeAdStyle(
    backgroundColor: Colors.white,
    contentColor: Colors.black,
    adMarkLabelTextColor: Colors.white,
    adMarkLabelBackgroundColor: Colors.grey,
  ),
  onAdLoaded: (adInfo) {
    print('Line native ad loaded');
    setState(() {
      _isAdLoaded = true;
    });
  },
  onAdFailedToLoad: (error) {
    print('Line native ad failed: ${error.message}');
    lineNativeAd.dispose();
  },
);

Style Properties

Property	Type	Description
`backgroundColor`	`Color?`	Overall ad background color
`contentColor`	`Color?`	Ad content text color
`adMarkLabelTextColor`	`Color?`	Ad mark label text color
`adMarkLabelBackgroundColor`	`Color?`	Ad mark label background color

Adapt the UI to received assets

Use onNativeAdAssetLoaded on DaroNativeAd or DaroLineNativeAd to handle missing assets.
The callback receives Set<NativeAdAssetType>.
Add this code to your State class and call initializeNativeAd() after super.initState() in initState(). Keep your existing loading and widget display flow.

Value	Meaning
`title`	Ad title
`body`	Ad body text
`icon`	Ad icon
`media`	Ad image or video
`callToAction`	Call-to-action button text (e.g., Install)
`advertiser`	Advertiser name (iOS)

Set<NativeAdAssetType>? assetTypes;
late DaroNativeAd nativeAd;

void initializeNativeAd() {
  nativeAd = DaroNativeAd(
    adUnitId: 'YOUR_AD_UNIT_ID',
    factoryId: 'YOUR_FACTORY_ID',
    onNativeAdAssetLoaded: (received) {
      if (!mounted) return;
      setState(() {
        assetTypes = received;
      });
    },
  );
}

// Handle media availability
bool? get hasMedia => assetTypes?.contains(NativeAdAssetType.media);

DARO 2.0 SDK Migration

Getting Started

SDK Integration

How to Use DARO

FAQ

Legacy SDK

Native Ad Format

Registering Native Factory

Implementing Native Ads

1. Create Ad Object

2. Load the Ad

3. Display the Widget

4. Dispose Resources

Callback Reference

AdChoices Position

LINE Native Ads

Implementing LINE Native Ads

1. Create Ad Object

2. Load the Ad

3. Display the Widget

4. Dispose Resources

Callback Reference

Style Customization

Style Properties

Adapt the UI to received assets

​Native Ad Format

​Registering Native Factory

​Implementing Native Ads

​1. Create Ad Object

​2. Load the Ad

​3. Display the Widget

​4. Dispose Resources

​Callback Reference

​AdChoices Position

​LINE Native Ads

​Implementing LINE Native Ads

​1. Create Ad Object

​2. Load the Ad

​3. Display the Widget

​4. Dispose Resources

​Callback Reference

​Style Customization

​Style Properties

​Adapt the UI to received assets

Native Ad Format

Registering Native Factory

Implementing Native Ads

1. Create Ad Object

2. Load the Ad

3. Display the Widget

4. Dispose Resources

Callback Reference

AdChoices Position

LINE Native Ads

Implementing LINE Native Ads

1. Create Ad Object

2. Load the Ad

3. Display the Widget

4. Dispose Resources

Callback Reference

Style Customization

Style Properties

Adapt the UI to received assets