Set up An App-ads.txt File for Your App

This topic explains how to set up an app-ads.txt file for your app.

Establish Developer Website

To establish your app's ownership, you must establish a link between your developer website and your app's store listings on either Google Play or the App Store.

  1. Set up a website for your app development business if not already done.
  2. Update your app's store listing with the developer website in the contact URL.
  3. Verify the website URL for accuracy and functionality.
  4. Confirm the correct developer website displays for each language variation, if applicable.

Create App-ads.txt File

Create your app-ads.txt file using the following file format and data record:

File Format

Data encoding details:

  • Use 'text/plain' as the HTTP content type; treat other types as errors.
  • Core syntax: Comma-separated format with three fields per line.
  • Records are separated by an end-of-line marker.
  • Records follow a specific line format.
    • <FIELD #1>, <FIELD #2>, <FIELD #3>, <FIELD #4>
      placeholder.example.com, placeholder, DIRECT, placeholder
Field Name Mandatory/Optional Description
Field #1 Domain name of the advertising system Mandatory The canonical domain name of the SSP, Exchange, Header Wrapper, and so on that bidders connect to.
Field #2 Publisher’s Account ID Mandatory The identifier associated with the seller or reseller account within the advertising system in field #1.
Field #3 Type of Account/Relationship Mandatory Indicates the type of account.
‘DIRECT’ indicates that the Publisher directly controls the account. This means a direct business contract between the Publisher and the advertising system.
‘RESELLER’ indicates that the Publisher has authorized another entity to control their account and resell their ad space.
Field #4 Certification Authority ID Optional An ID that uniquely identifies the advertising system within a certification authority (this ID maps to the entity listed in field #1).

Add Your Personalized Code Snippet

For the app-ads.txt setup, you must ensure to:

  • Use InMobi's personalized app-ads.txt entries.
    • InMobi's line: This a mandatory line to be included in your app-ads.txt file to authorize InMobi to sell your inventory.
    • Priority lines: This list includes the above mandatory line and the reseller lines to help you achieve optimal monetisation through InMobi.
    • Maximum lines: This list includes InMobi's line and all the reseller lines suggested by InMobi to maximize your earning potential on InMobi's platform.
  • Add business/payment info to generate entries. For more information, see Payment Settings.
  • Append entries to your app-ads.txt file.

Follow the instructions below to get your personalized ads.txt entries, which include your InMobi payment ID:

  1. Log in to InMobi.
  2. Navigate to Inventory >>  app-ads.txt.
  3. Scroll down and download the app-ads.txt file.
  4. Post the file in your website's root directory.
  5. Ensure correct formatting and line breaks after updating InMobi’s entries into your app-ads.txt file.

Publish App-ads.txt File on Developer's Website

InMobi's app-ads.txt crawler locates your file using the developer URL from your app's Google Play or Apple App Store listing. Per app-ads.txt specs, the crawler checks the file at:

  • https://<<hostname>>/app-ads.txt
  • http://<<hostname>>/app-ads.txt

Determine the hostname from your app's developer URL. It's the website's root domain or, in specific cases, a subdomain, as explained below.

Refer to the table for examples where the InMobi crawler checks for an app-ads.txt file based on different developers' website root domains.

If the developer website is: Crawler looks in the following order:
https://example.com/game https://example.com/app-ads.txt
http://example.com/app-ads.txt
http://help.example.com/game https://help.example.com/app-ads.txt
http://help.example.com/app-ads.txt
https://example.com/app-ads.txt
http://example.com/app-ads.txt

The app-ads.txt specification outlines rules for subdomains. Crawlers will explore up to five redirections within a subdomain and one outside the root domain.

To verify correct publication, ensure the app-ads.txt URL displays its content when accessed through your web browser. If it is visible in your browser, crawlers will probably locate it successfully.

Ensure Crawlable App-ads.txt File

Ensure the app-ads.txt is accessible via both HTTP and HTTPS.

Check Verification Status of App-ads.txt File

Monitor your app-ads.txt files in your InMobi account:

  1. Log in at https://publisher.inmobi.com/.
  2. Navigate to Inventory on the left menu.
  3. Select App-ads.txt.
  4. After you add the app.ads.txt with seller information, you can view the verification status loading below.

If your file wasn't located or verified, review the details in your InMobi account or explore troubleshooting tips for app-ads.txt issues.

Note

If you've recently updated your ads.txt file, it may take at least 24 hours for the crawler to display the latest verification status.

First-time Setup Process

Upon creating your account on InMobi and establishing your inventory, access the verification status through Inventory >> app-ads.txt. Activation of the InMobi crawler occurs once any of the added apps has generated 10 thousand bid requests.

On This Page

Last Updated on: 18 Nov, 2024