This guide explains how to integrate and use the OpenRTBBidLoader in your iOS project for loading native ads via OpenRTB protocol.

• Use Xcode 16.0 or higher
• Requires deployment target 12.0 or later
• Adform Advertising SDK integrated in your project

Using Swift Package Manager:

dependencies: [
    .package(url: "https://github.com/adform/adform-ios-sdk", .upToNextMajor(from: "2.19.0"))
]                                                                            

The OpenRTBBidLoader requires an OpenRTB request object that specifies the ad request details:

        // Create a native ad request.
        let nativeAd = AFNative()
        let nativeRequest = AFNativeRequest()

        // Create assets for the native ad (e.g., main image)
        let nativeAsset = AFNativeRequestAsset()
        nativeAsset.rtbId = "0"
        nativeAsset.required = true
        nativeAsset.img = AFRequestImgAsset()
        nativeAsset.img?.heightMin = 166
        nativeAsset.img?.widthMin = 200
        nativeAsset.img?.type = 3
        
        // Add the asset to the request
        nativeRequest.assets = [nativeAsset]
        nativeAd.request = nativeRequest
        
        // Create an impression
        let imp = AFImp()
        imp.rtbId = "1"
        imp.tagId = "YOUR_TAG_ID"
        imp.native = nativeAd
        
        // Build the complete request
        let builder = AFOpenRTBRequestBuilder(
            rtbId: "YOUR_REQUEST_ID",
            imps: [imp]
        )
        let request = builder.createOpenRtbRequest()

Once you have your request object, you can request an ad using OpenRTBBidLoader:

        AFOpenRTBBidLoader.requestAd(request) { response, error in
            print("Native ad response: \(response), error: \(error)")
        }

This guide explains how to integrate the Adform Native Mediation Adapter into your iOS project, using OpenRTB for loading native ads via Google Mobile Ads mediation.

• Use Xcode 16.0 or higher
• Requires deployment target 12.0 or later
• Google Mobile Ads SDK (12.6.0+ recommended)
• Mediation Adapter integrated in the mediation waterfall

We recommend using Swift Package Manager for easy integration.

dependencies: [
    .package(url: "https://github.com/adform/adform-ios-sdk", .upToNextMajor(from: "2.21.0"))
]

For a full guide on how to set up mediation in AdMob, refer to the official documentation:

Set up mediation in AdMob Set up a custom event

You would need to set up Custom Events manually in your mediation configuration, use the class name of the adapter: AdformAdmob.AdmobNativeAdapter

In the AdMob mediation network UI, configure the parameter value with: id=<request_id>,tagid=<tag_id> For example: id=1234,tagid=567890

Here is a guide how to implement AdMob native ads: Native AdMob ads setup in android

If you want to customize which native assets are requested from Adform or how they are mapped, you can subclass AdmobNativeAdapter and override key methods:

1. Subclass the Adapter

class CustomAdformNativeAdapter: AdformNativeAdapter {
    open func makeAdAssets() -> [AFNativeRequestAsset] {
        let mainImageAsset = AFNativeRequestAsset()
        mainImageAsset.rtbId = "0"
        mainImageAsset.required = false
        mainImageAsset.img = AFRequestImgAsset()
        mainImageAsset.img?.heightMin = 166
        mainImageAsset.img?.widthMin = 200
        mainImageAsset.img?.type = 3
        
        let titleAsset = AFNativeRequestAsset()
        titleAsset.rtbId = "1"
        titleAsset.required = false
        titleAsset.data = AFRequestDataAsset()
        titleAsset.data?.type = 2
        
        return [
            mainImageAsset,
            titleAsset
        ]
    }
}

2. Register your custom adapter class name in mediation configuration or custom event:

Please use YourAppName.CustomAdformNativeAdapter instead of AdformAdmob.AdmobNativeAdapter