SDK Native - Customizations

Native SDK — Customizations

Prerequisite: Complete the Native SDK - Quick Start first.

These customizations require no custom layout XML — you configure the built-in default renderer or extend it with small tweaks.

---

1. Configuration Options

1.1 Scroll Direction

// Horizontal (default)
adView.setOrientation(RecyclerView.HORIZONTAL);

// Vertical list
adView.setOrientation(RecyclerView.VERTICAL);

1.2 Maximum Number of Campaigns

adView.setMaxCampaigns(5);   // Show at most 5 campaigns
adView.setMaxCampaigns(10);  // Show all (default)

1.3 Nested Scrolling

If your MCNativeAdView is not inside a ScrollView, you can disable nested scrolling (enabled by default):

adView.setNestedScrollingEnabled(false);

1.4 Open Campaign Details In-App

By default, tapping a campaign opens in the device's external browser. To keep users inside your app:

MCOfferwallSDK.SetOpenInApp(true);

If you enable this, register the WebView activity in your AndroidManifest.xml:

<activity android:name="io.mychips.offerwall.controller.MCOfferwallActivity"
          android:theme="@style/Theme.AppCompat.NoActionBar"/>

---

2. Change the Currency Icon

The default renderer shows a coin icon next to the reward value.

You can replace it in two ways:

Option A: Set a custom URL

Kotlin

val renderer = MCDefaultAdRenderer()
renderer.setCurrencyIconUrl("https://example.com/my_coin.png")
adView.setRenderer(renderer)
adView.load()

Java

MCDefaultAdRenderer renderer = new MCDefaultAdRenderer();
renderer.setCurrencyIconUrl("https://example.com/my_coin.png");
adView.setRenderer(renderer);
adView.load();

Option B: Use a local drawable

To use a drawable from your app's resources, disable the URL-based icon and set it in onBindCampaign:

Kotlin

val renderer = object : MCDefaultAdRenderer() {
    override fun onBindCampaign(itemView: View, campaign: MCCampaign, position: Int) {
        super.onBindCampaign(itemView, campaign, position)

        val ivCurrency = itemView.findViewById<ImageView>(
            io.mychips.offerwall.R.id.mc_iv_currency)
        ivCurrency?.setImageResource(R.drawable.my_currency_icon)
    }
}
renderer.setCurrencyIconUrl("")  // disable default CDN icon
adView.setRenderer(renderer)
adView.load()

Java

MCDefaultAdRenderer renderer = new MCDefaultAdRenderer() {
    @Override
    public void onBindCampaign(View itemView, MCCampaign campaign, int position) {
        super.onBindCampaign(itemView, campaign, position);

        ImageView ivCurrency = itemView.findViewById(
            io.mychips.offerwall.R.id.mc_iv_currency);
        if (ivCurrency != null) {
            ivCurrency.setImageResource(R.drawable.my_currency_icon);
        }
    }
};
renderer.setCurrencyIconUrl("");  // disable default CDN icon
adView.setRenderer(renderer);
adView.load();

Important: Call setCurrencyIconUrl("") when using a local drawable. This prevents the default CDN icon from loading asynchronously and overwriting your resource.

---

3. Customize Text Colors

Override onBindCampaign and change colors after the default binding:

MCDefaultAdRenderer renderer = new MCDefaultAdRenderer() {
    @Override
    public void onBindCampaign(View itemView, MCCampaign campaign, int position) {
        super.onBindCampaign(itemView, campaign, position);

        TextView tvReward = itemView.findViewById(
            io.mychips.offerwall.R.id.mc_tv_reward);
        if (tvReward != null) {
            tvReward.setTextColor(Color.parseColor("#FF1976D2")); // Blue
        }
    }
};
adView.setRenderer(renderer);

Default Layout View IDs

View ID	Type	Description
io.mychips.offerwall.R.id.mc_iv_thumbnail	ImageView	Campaign image
io.mychips.offerwall.R.id.mc_tv_name	TextView	Campaign name
io.mychips.offerwall.R.id.mc_tv_reward	TextView	Reward value
io.mychips.offerwall.R.id.mc_iv_currency	ImageView	Currency icon
io.mychips.offerwall.R.id.mc_tv_badge_promo	TextView	Promo badge
io.mychips.offerwall.R.id.mc_tv_badge_progress	TextView	In Progress badge

---

4. Custom Loading View

By default, the SDK shows a pulsing skeleton placeholder while loading.

You can replace it:

// Simple spinner
val spinner = ProgressBar(this)
adView.setLoadingView(spinner)

Or doing something more complex with text as well:

// Spinner + text
LinearLayout loading = new LinearLayout(this);
loading.setOrientation(LinearLayout.VERTICAL);
loading.setGravity(Gravity.CENTER);

ProgressBar spinner = new ProgressBar(this);
loading.addView(spinner);

TextView text = new TextView(this);
text.setText("Loading offers...");
text.setGravity(Gravity.CENTER);
loading.addView(text);

adView.setLoadingView(loading);

Pass null to restore the default skeleton:

adView.setLoadingView(null);

---

5. Custom Click Handler

Override the default click behavior per-view:

Kotlin

adView.setOnCampaignClickListener { campaign, position ->
    // Your custom logic: show a dialog, navigate, etc.
    MCOfferwallSDK.OnClick(campaign)  // or handle it yourself
}

Java

adView.setOnCampaignClickListener((campaign, position) -> {
    // Your custom logic: show a dialog, navigate, etc.
    MCOfferwallSDK.OnClick(campaign); // or handle it yourself
});

Tip: You can configure the default click behavior globally without writing a custom click handler. Call MCOfferwallSDK.SetOpenInApp(true) to open campaign details in an in-app WebView instead of the external browser. See the Open Campaign Details In-App.

---

6. Loading Lifecycle Listener

Monitor loading state for your own UI logic:

Kotlin

adView.setLoadingListener(object : MCNativeAdView.LoadingListener {
    override fun onLoadingStarted() { }
    override fun onCampaignsLoaded(count: Int) { }
    override fun onError(e: Exception) { }
})

Java

adView.setLoadingListener(new MCNativeAdView.LoadingListener() {
    @Override
    public void onLoadingStarted() { }

    @Override
    public void onCampaignsLoaded(int count) { }

    @Override
    public void onError(Exception e) { }
});

---

Next Steps

• Need a completely different card design? See Custom Layouts →

• Need the full data reference? See Data Reference →