Add the view to the layout

<?xml version="1.0" encoding="utf-8"?>
    <ScrollView
        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="match_parent">
        
        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:orientation="vertical">
            
            <TextView
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="@string/lorem_medium"/>
                
            <FrameLayout
                android:id="@+id/adContainer"
                android:layout_width="match_parent"
                android:layout_height="wrap_content">
                        
                <tv.teads.sdk.android.InReadAdView
                    android:id="@+id/teads_ad_view"
                    android:layout_width="match_parent"
                    android:layout_height="wrap_content"
                    app:teads_pid="84242"/>
                            
            </FrameLayout>
                    
            <TextView
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="@string/lorem_medium"/>
        </LinearLayout>
    </ScrollView>

Please note the following attributes:

• app:teads_pid - Set this to the placement id (example includes the test PID)
• app:teads_maxHeight - Sets the maximum height that the ad can take once expanded
• app:teads_autoload - Requests an ad once the view is inflated (works only with layout_height:wrap_content)
• app:teads_debug - Enable debug log ( ⚠️ Don't forget to remove this option before releasing)

import tv.teads.sdk.android.InReadAdView; 

public class MainActivity extends AppCompatActivity { 
    private InReadAdView mAdView; 

    protected void onCreate(Bundle savedInstanceState) { 
        super.onCreate(savedInstanceState); 
        setContentView(R.layout.activity_main);
				
        mAdView = findViewById(R.id.teads_ad_view);
        mAdView.load(); 
    }
}

⚠️ Some creatives like VPAIDs may ask for a resize after the initialization of the ad View.

No action is required if the height constraint of the ad view (and its parent) is set to "wrap_content".

In the other case, it is mandatory to manually adapt the size of the Ad container.

The SDK will warn you that the creative need another resize to be correctly displayed.

Use onRatioUpdated to listen to resize updates at any time.

We encourage you testing different creative sizes from the test PIDs article.

public void onRatioUpdated(float adRatio) {
 //Should be override to be listened
}

mAdView.setListener(new TeadsListener() {
    @Override
    public void onAdLoaded(float adRatio) {
        //When the ad request has been made and it receive a successfull response.
        //If the auto expand is disabled, the slot should be open here following the given ratio
    }

    @Override
    public void onAdFailedToLoad(AdFailedReason adFailedReason) {
        //When the SDK doesn't succeed to get an ad, following code error:
        //ERROR_NOSLOT          = 1
        //ERROR_NETWORK         = 2
        //ERROR_NOTFILLED       = 3   //when our ad server didn't found an ad for your placement
        //ERROR_BAD_RESPONSE    = 4
        //ERROR_VASTERROR       = 5
        //ERROR_USERID_MISSING  = 6
    }

    @Override
    public void onAdDisplayed() {
        //Notify that the ad is displayed
    }

    @Override
    public void closeAd() {
        //Ask to close the ad if the {@link AdSettings#autoExpandDisabled} is disable. Otherwise, it notify 
        //that the view will close by itself.
    }

    @Override
    public void onError(String message) {
        //When an error shows up, the player fail to play a video or an exception occured in the SDK.
    }

    @Override
    public void onAdPlaybackChange(@PlayerConstants.PlaybackState int state) {
        super.onAdPlaybackChange(state);

        switch (state) {
            case PlayerConstants.LOADED:
            case PlayerConstants.STARTED:
            case PlayerConstants.RESUMED:
            case PlayerConstants.PAUSED:
            case PlayerConstants.IMPRESSION:
            case PlayerConstants.PROGRESS:
            case PlayerConstants.FIRST_QUARTILE:
            case PlayerConstants.MID_POINT:
            case PlayerConstants.THIRD_QUARTILE:
            case PlayerConstants.COMPLETE:
            case PlayerConstants.STOPPED:
            case PlayerConstants.MUTED:
            case PlayerConstants.UNMUTED:
            default:
                // ...
                break;
        }
    }
});

Use the reset method before each new load in order to call a new ad with the same InReadAdView instance.

mAdView.reset()

To avoid potentials leaks, don't forget to clean the InReadAdView when your activity is destroyed.

@Override
public void onDestroy() {
    super.onDestroy();
    mAdView.clean();
}

adView.load(new AdSettings.Builder()
                    .pageUrl("https://example.com/article1")
                    .build())

• You need to be sure that the InReadAdView is in the view hierarchy, where you want to display the ad (even with a height of 0 in case you have no ad). It will allow us to get accurate stats and optimize your revenue.
• Ensure Brand Safety is enabled.
• Ensure you comply with GDPR.

If you want to load an ad from your activity side, you can set the following option:

AdSettings.Builder adSettingsBuilder = new AdSettings.Builder();

• adSettingsBuilder.enableDebug(); - Enable all Teads SDK Log for debugging purpose (such as webviews inspector chrome://inspect).
• adSettingsBuilder.disableAutoExpand(); - Disable the auto expand and collapse on the ad view. You will have responsability to manage the ad size (see the TeadsListener)
• adSettingsBuilder.hideBrowserUrl(); - Hide the website url in the internal browser only. The url is visible by default.
• adSettingsBuilder.pageUrl(articleUrl); - The publisher http page url that matches the content where Teads Ad will be loaded into.
• adSettingsBuilder.useLightEndscreen(); - When the ad playback is finished, we display an endscreen with light color (Dark color by default).
• adSettingsBuilder.toolbarBackgroundColor(int color); - Set the toolbar background color on the browser.
• adSettingsBuilder.userConsent(String subjectToGDPR, String consent); - The user consent following the IAB specifications.

Once you have set your adSettingBuilder you can build it in your load request:

adView.load(adSettingBuilder.build());