Get Started with Avocarrot

Overview

Examples

Android

Overview

Getting Started

- Integrating Ads

Stream

Native Assets

Banner

Interstitial

Video

- Others

Supported Networks & Ad Types

Troubleshooting

- Adapters

Admob Android Adapter

Mopub Android Adapter

iOS

Overview

Getting Started

- Integrating Ads

Stream

Native Assets

Banner

Interstitial

Video

- Others

Supported Networks & Ad Types

Troubleshooting

- Adapters

Admob iOS Adapter

Mopub iOS Adapter

API Documentation

Reporting API

Help

General

Earnings

Payments and Accounting

Integration

Reporting

Mediation Network Optimization

Legal and Privacy

Updates

SDK Change Log

Android Change Log

iOS Change Log

FAQ

Updated 9 days ago ​by Chris

General

How does Avocarrot Exchange Work?


What is the Avocarrot Exchange?

Avocarrot Exchange (AVX) is an ad exchange platform where app publishers offer advertising space in their apps and advertisers bid for it. The exchange operates as a real-time auction platform under the OpenRTB v2.3 standards and the latest native advertising specs. 

What is Avocarrot Mediation?

Avocarrot mediation is our ad mediation solution for app developers that helps publishers monetize their apps and further optimize their revenue. It mediates major Ad Networks & DSPs to find the highest yielding margins and most relevant ads.

Why is Avocarrot different from the competition? 

Avocarrot is the only ad exchange platform that serves purely in-app Native Ad traffic in a programmatic manner. This guarantees the best experience for the app users as well as the optimal revenue results for the app developers. In addition, the easy integration, the wide selection of tools (e.g. customized ads, video ads, revenue optimizer, reporting API) and the guaranteed monthly payments make Avocarrot the favorite choice amongst app developers for their monetization solution.

Avocarrot's mediation technology has a successful track record of finding the best eCPMs and increasing fill rates to increase profitability. Our sophisticated algorithm calculates the best available ad networks to maximize your revenue for every impression! Our strategic demand partnerships allows us to cover global markets and consequently help you yield higher margins.

In addition, you will have access to our transparency reports which efficiently shows how the ads are being optimized in the waterfall. The purpose of this report is to give you an unambiguous view of the number of ad requests, fill rate %, average eCPMs and total ad requests by countries and ad networks.

Our ad mediation solution also provides valuable audience insights to help you understand your app users. The insights include daily active users, top countries, average session time, device type, OS version, top device model, internet access type and the users’ Avocarrot SDK version.

How does the auction mechanism work?

Our programmatic auctions run under the second best price auction model. This means that the top bidder will pay the bid price that was set from the second top bidder. For example if the top bid was for 1.5$ and the second was for 1.2$ then the top bidder will win the auction by paying 1.2$. This model has been proven to be the most economical favorable for both ends of the auction.

How does the mediation mechanism work?

Our mediation technology allows the publisher to send ad requests to multiple ad networks in order to find the optimal ad opportunity to fill their ad space, therefore maximizing their revenue.

This single SDK is a great benefit as it avoids the issues of having to manage a large number of SDK integrations. The publisher can find the best ad networks to fill the ad space by prioritizing ad networks based on specific metrics.

Since the advertisers are competing over the inventory, the publisher has a greater opportunity to increase their overall advertising profit, while being in control of the ad network prioritization.

Is Avocarrot a self-serve platform?

Avocarrot is a self-serve platform with a dedicated and knowledgeable support team. We are here to answer all your questions and ensure the integration process is seamless as possible.

In which countries is Avocarrot available?

Avocarrot is highly connected in over 190 countries across developed and emerging markets.

We are proud of our global reach!

What are Native Ads?

Native ads can match the look and feel of your app to create a better user experience that doesn’t spam your users.

How do the different Native ad formats look?

Native Ads can look any way that you want since they are fully customizable. The most common implementations are Feed, List and Native interstitial.


What are the key metrics that affect my performance?

The most important metrics are the following: 

  • Ad requests: The number of times your app requested an ad to be displayed on an advertising space
  • Impressions: The number of times an ad was actually shown in one of the advertising spaces within your app  
  • Clicks: The number of times a user clicked on one of the ads shown in your app  
  • CTR- Click Through Rate: The number of clicks divided by the total impressions (clicks/impressions)  
  • Fill rate: The number of ad requests that successfully won an auction divided by the total number of ad requests  
  • eCPM: Your ad revenue per thousand impressions from your app

Earnings

How do I earn money?

When a user views and clicks an ad or performs a specific action. 
We run advertising campaigns on a CPM/CPC/CPA basis and we first deliver the campaigns that will generate the most revenue.

How much can I make using Native Ads?

The results of using Avocarrot as a monetization solution can vary depending on the geographic location, the category of the app, the amount of traffic you're able to generate and the implementation of native ads in your app. 

Can I keep my existing monetization mechanism?

Yes. 
We work well with other in-app monetization solutions and you can earn additional revenue on top of what you make today.

Do you work on CPC or CPM or CPI?

We offer a mix of campaigns (depending on the advertisers and the regions) which could be CPC/CPM/CPA. 

Currently, the majority of the campaigns ran by our advertising partners are on CPC basis. However, for any type of campaign, your revenue will always be calculated on a CPM basis.

What regions do you cover?

Proudly cover globally!

Will you bombard users with ads?

No. 
Every user will see a limited number of ads each day and the most engaging campaigns are given a priority.

Payments and Accounting

How often do you pay?

Payments are sent monthly with a Net 30. 
Net 30 means that money earned from July 1st – July 31st, will be received on August 30th. This 30-day delay is necessary due to the long payment cycles of the advertisers.

Will you pay every month?

Yes! 
We try to win your trust every month and it’s not in our interest to miss a payment for any reason.

What payment methods do you support?

Paypal and Wire transfer. 
For every payment, normal Paypal and bank fees apply. Also, please note that the company is incorporated in the United States and you should use that for all tax purposes.

What’s the minimum payout?

For Paypal it’s $50 and for Wire transfer it’s $250. 
Outstanding balances are carried forward to the next month until the minimum threshold has been reached.

When should I receive my bonus payment?

You will get paid any promotional bonus with the regular monthly payment cycle once you reach the minimum payout threshold as defined above. This bonus will be paid on top of your ad earnings for the month.

Can I access my transaction history?

You can access all your past invoices in the “Payment” section within the dashboard. In the “History” tab, you can see all the past transactions, while in the “Invoices” tab, you have access to the invoices for any accounting purposes.

Do you charge for mediation?

No, we do not charge for mediation. The self-service platform is FREE of charge.

Integration

Why is my app not marked as live yet?

Our algorithm is constantly running and monitors the apps that are live in Google Play and in the Apple Store. In order for your app to be marked as “live” in the dashboard, you need to reach the threshold of 100 ad requests per day. 


In the meantime, if your app is working fine in the Google Play/ Apple Store, then you have nothing to worry about. Ad requests are served, impressions are counted respectively and you are still making revenue.

Why can't I see live ads?

Our advertising partners require for new publishers to reach a minimum threshold of ad requests per day before they start bidding on their traffic. If you are testing from one device (yours) and you are making a low number of requests, our advertising partners will not be able to spot your app and start running their campaigns. 

If you can receive ads while in Sandbox we advise you to disable Sandbox and then upload your app on the app store so that your users can start making requests to our servers and advertisers start evaluating your traffic. 
Finally, keep in mind that the vast majority of the advertisers are only sending ads on apps that are uploaded in Google Play and Apple Store. We strongly recommend that you upload your app in the respective app stores.

Do you comply with Google and Apple developer policies?

Yes. 

We are in full compliance with the latest developer policies both on Google Play and Apple Store. We consider this a serious matter and re-evaluate our ad unit’s compliance on every policy update.

What type of ad units are available?

With the Avocarrot exchange SDK, you can create any type of ad since Native Ads are fully customizable. The most common implementations that are out-of-the-box ready are Stream and Interstitial ads.

We also support video ads on all the above implementations and on your customized ads.

To see ad formats that are supported by each of our mediation networks click here .

What ad sizes do you support?

The Avocarrot exchange only supports only native ads (custom size).

The Avocarrot mediation supports the following ad formats:

  • Banner (320×50)
  • Fullscreen (300×250)
  • Fullscreen (320×480)
  • Fullscreen (768×1024)
  • Native (Custom size)

What permissions will my app need in order to integrate Avocarrot?

Only INTERNET and ACCESS_NETWORK_PERMISSIONS are required.

What’s your SDK size?

Android

Android Change Log can be found here

PackagesSize
Avocarrot Light~0.768 MB
Avocarrot Exchange~1.01 MB
Avocarrot Full~1.08 MB


iOS

iOS Change Log can be found here

PackagesSwift SizeObj-C Size
Avocarrot Light~4.1 MB~1.17 MB
Avocarrot Exchange~5.5 MB~2.57 MB
Avocarrot Full~6.6 MB~3.77MB


 *The SDK size can be changed depending on which third-party ad networks and which ad format you choose to integrate.

What’s the network usage for an ad?

~60KB for Native interstitial ads (Natural Pause). 
~20KB for in-Stream ads. 
For video ads the network usage can vary, depending on the restrictions you want to set.

Are the video ads on auto play?

Yes, by default the video ads are on auto-play and muted. An impression is counted once the first frame of the video has been shown to the user.

Can I switch the video ads on and off?

Yes. 
You can turn the video ad capability on or off, whenever you want, from your dashboard settings.

What platforms do you support?

We offer Android, iOS and Unity (Android) SDKs.

What are the minimum requirements of configuring a native ad for the different ad networks?  

Various ad networks have their own minimum requirements for a native ad unit. Note that if you include the following basic elements, you will be able to leverage the native ad unit and are safe from being disabled out of any ad network.

  • Icons/Image
  • Title
  • ‘Call to Action’ button
  • AdChoices logo OR anything that hints that this is an advert and not a part of the content. EX: ‘sponsored post’, ‘promoted post’, etc.

For your reference, here are the guidelines for individual networks:

What if I’m not happy?

You can switch off any app from the dashboard at any time. 
We hope this will never happen but if for any reason your expectations have not been met, no code update will be needed to stop the service and the performance of your app will not be affected.

Reporting

How does Avocarrot mediation obtain the data from the ad networks?

We use APIs to access the data, which is pulled once a day. Setting Reporting API to “ON” will enable Avocarrot to fetch external data from the network’s reporting API to use in your Analytics and Automatic eCPM optimization. Remember to fill in your credentials for each network.

Why is there an impression discrepancy between Avocarrot mediation and my ad network?  

Each ad network counts an impression differently which can be the result for the discrepancy in the reporting.

  • For an S2S integration:

Avocarrot mediation SDK counts the ad impressions and sends this information to our Server but not to the ad network server. They usually use an “impression tracking pixel url” in order to track impressions for their ad. A tracking pixel is simply a code inserted into the HTML ad which makes a server call and return a transparent 1×1 image. If they do not support this (ie. if the ad is not HTML ads), they count their ad response as an ad impression. 

  • For Client side (SDK bundle) integration:

The adapter in our SDK sends impression data to the ad network. Our core Avocarrot mediation SDK is not involved in this communication.

For instance, AdMob states they count an impression when at least 1 pixel of an ad is visible on a device’s screen : https://support.google.com/admob/answer/3269069?hl=en 

When is the impression recorded by Avocarrot mediation SDK?

  • An impression is counted each time the ad is shown in your app. (when the ad callback method (ad opened/ad shown) is triggered) 

Why do we need to count impressions separately? 

  • We count impressions separately because all the ad networks count their impressions differently. Essentially, we want to be able to run fair performance comparisons of the various ad networks. 
Note: from the reports, we only export the network revenue, then calculate the eCPM by taking our impression count.

What time zone is the reporting?

All reports are calculated on UTC timezone.

Is the Avocarrot dashboard updated in real-time?

Yes, all the metrics on the Avocarrot dashboard are in real-time (within 30min), except for the revenue on the mediation report. This is pulled once a day from the networks that you have configured in your mediation waterfall.

Do you offer reporting API?

Yes, we offer reporting API for the Avocarrot exchange. You can see how to implement it here.

How do we deal with reporting API outage in the Avocarrot mediation?

In these rare circumstances, the network would get deprioritized in the waterfall. You would still have the opportunity to manually reconfigure the waterfall to ensure proper traffic allocation.

What if I see a revenue discrepancy in the Avocarrot and Ad Network reports?

Some Ad Networks display gross revenue on their dashboards which means they have not yet deducted their share from your revenue. You will see its net revenue at the end of the month when the invoices are issued by the Ad Networks. Our Avocarrot reporting system receives reports from the different Ad Networks with the net revenue.

If you would like to inquire regarding which Ad Networks show gross revenue, you would be required to contact the Ad Network directly.

E.g. Smaato SPX displays gross revenue for their publishers.

Can I mix and match ad networks so that some utilize the ad network optimization feature and others have priorities set manually?

Avocarrot's mediation dynamic waterfall enables you to either select the automatic optimization (Auto Rule) or custom functionality (Custom) for each ad placement to ensure the algorithm accuracy. Depending on the Ad Networks, they may allow you to alter your performance optimization for each placement within their specific accounts.

For instance, Facebook and AdMob provide this custom functionality to attain a full fill rate or by eCPM

Mediation Network Optimization

Which networks have Avocarrot partnered with?

You can see the full list of the supported ad networks here.

How do I integrate third-party Ad Networks?

You can see how to integrate third-party ad networks for Android here and for iOS here.

How do you prioritize the ad networks? How is the waterfall calculated?

The Avocarrot mediation waterfall is a sophisticated and fully transparent monetization model based off the historical data collected by Avocarrot's network performances.

The data-driven approach mediates the blend of demand networks and helps developers make more informed decisions for further optimization in real-time. Powered by our advanced algorithm, the waterfall calculates and prioritizes to give you the best mix of eCPM and fill rate for your app.

As a result, the Avocarrot mediation waterfall essentially helps to balance out and mediate the different networks by finding the best floor price to achieve maximum revenue for publishers.

What is the lookback window for the Avocarrot mediation waterfall?

Our lookback window for the waterfall is 24hrs (calendar day).

Do I need an account for the other ad networks to incorporate into my waterfall?

Yes, you will simply create an account for each ad network you would like to incorporate into your monetization waterfall. This ensures you have the option to plug into various demand partners and maximize your revenue potential.

How does traffic allocation start initially?

The general requirement to customize your waterfall is at least 300 impressions and over $0.00 in revenue for at least one day. Then after 2 days, the waterfall will automatically be built based on the algorithm of our decision engine.

How do I integrate a new third-party ad network that is not found on your list?

We are always looking to add more ad networks to provide you with a variety of demand. If you would like to add a new ad network, please do not hesitate to reach out to us and we would be happy to help mediate.

How do you ensure that after the waterfall is configured, all networks still get the chance of the first impression?

Once the app has been created, our mediation systems begin to gather traffic from various ad networks. Over the following days, the Avocarrot waterfall is built accordingly from the data it has collected. This process gives the opportunity to explore all the different ad networks and find the best eCPM and fill rate for your app.

Can you gather my revenue from all the Ad Networks?

As a self-serve platform, we are not collecting the revenue for you. You have full control of each ad network relationship and would collect the revenue directly from the ad networks. Although, Avocarrot enables you to see revenue for all of your ad networks on a single dashboard without manual updates.

Can I switch off Glispa demand?

Yes, you can switch off the Glispa demand from your mediation configuration page, however, the Avocarrot waterfall mediates between ad networks based off of performance. Therefore, the Glispa demand will only be utilized when it performs better than all the other ad networks for that specific ad opportunity.

In addition, you can manually rearrange the mediation waterfall to override and choose a preferred ad network to be used for a specific ad placement.

How do I use Google Ad Exchange and DoubleClick with Avocarrot mediation?

You can still use Avocarrot mediation even if you are using Google Ad Exchange.

The Ad Exchange account and Google Mobile Ads SDK (bundled with Avocarrot mediation SDK) are required to serve ads from Ad Exchange. You simply need to take the ad unit ID from AdExchange and configure it to the AdMob ad placement. Although, due to the structure and capabilities, we are unable to accommodate if you are solely using DFP.

Guide on how to add an ad unit ID in AdExchange: https://support.google.com/adxseller/answer/6146995

Glispa GmbH 
Sonnenburger Str. 73 
10437 Berlin 
Germany 

The company has offices in multiple locations around the world, including Berlin and Athens.

Who is Avocarrot?

Avocarrot, Glispa’s monetization platform for app developers, combines a programmatic exchange and a mediation solution in a single platform, making it a one-stop solution to boost ad revenue. The company was acquired by Glispa Global Group and its technology has been awarded several times.

For more information on Avocarrot you can take a look in our company page while you can also read some developer success stories in the case study section of our website.

Can I put restrictions on the content of the ads that I am serving to my users?

We offer 3 main blocking levels (low, moderate and high) where you can block certain ad categories. More specifically: 

  • Low (Uncategorized, Non-Standard Content, Illegal Content) 
  • Moderate(Dating, Sexuality, Cocktails/Beers, Wine, Cigars) 
  • Strict(Pregnancy, AIDS/HIV, Incest/Abuse Support, Infertility, Divorce Support, Gay Life). 

Those categories are customizable meaning that you can add or remove specific tags from specific blocking levels. 
Please note that the tags are part of the categorization standards of OpenRTB .

Regarding the ads from the ad networks in your mediation waterfall, we recommend that you change the content settings within your ad network accounts to limit the explicit content.

Can I select specific ad categories to display in the app? 

The selection of specific ad categories can be done directly through the ad network accounts.

What is your privacy policy?

We are in full compliance with all the IAB privacy policies as you may see in our privacy policy section. Please also note that all of our publishers should comply with the content guidelines found here.


Was this article useful?