Set up the app-ads.txt file
Follow instructions to create and upload an app-ads.txt file to your developer website and register it with Unity for verification.
Read time 2 minutesLast updated 2 months ago
To set up the to your developer website for the first time, follow these steps:
app-ads.txtFind your app’s listed website URL
Locate the website associated with your app in its app store listing. For example, on Google Play, open your app’s store page and find the Developer Website field. This is the root domain you’ll use (for example, ). Your file must be placed at this exact domain.
https://www.example-app-name.comapp-ads.txtGet your app-ads.txt content from the Unity dashboard
From the Unity Monetization dashboard, follow these steps:
- Go to the Monetization menu > Settings > Organization. This opens the Organization settings page.
- Go to the App-ads.txt section. The **App-Ads URL field **automatically displays a list of authorized digital sellers in the correct file format. If it doesn't, refer to this website root directory guide for more information.
- Select Show full list to view all the values for your file, then copy this list.
app-ads.txt
Create and upload the app-ads.txt file
Once you have the list, create your app-ads.txt file and upload it to your website's root directory:
- Use a text editor to create an and paste the list from the Monetization dashboard into the file.
app-ads.txt - Copy the file into the root of the developer website so that it’s accessible at the location listed in the app-ads URL field. For example,
app-ads.txt.https://www.example-app-name.com/app-ads.txt
Set your Developer website URL in Unity
With your file uploaded, register your developer website URL in the Unity dashboard so Unity can verify your file:
app-ads.txt- In the Organization info section, locate the Developer Website field and select the edit icon.
- Enter the root URL of the website where your game is listed. Ensure it matches the domain in your app store listing, for example: https://www.unity3d.com.
Note
This field must contain only the root domain without any paths. You can find this domain on your Developer page in Google Play or in your Apple store Settings.
If the file is configured correctly, a message will display to inform you that no action is needed at this time.
app-ads.textImportant
The list of verified ad sellers can change over time. Check the settings page monthly, or whenever you are notified.
Publisher transparency with OwnerDomain
As part of the framework, you must include the field in your file.
ads.txtOwnerDomainapp-ads.txtPurpose of the OwnerDomain field
The IAB's framework enhances publisher transparency and accountability in the digital advertising ecosystem. It plays a key role in clarifying the use of first-party and third-party data in programmatic advertising.
OwnerDomainThe field identifies the business domain of the publisher that owns the media property, establishing a direct link between the and files.
OwnerDomainads.txtsellers.jsonImplement OwnerDomain in your ads.txt file
To support , ensure your app-ads.txt or ads.txt files include the following required variable:
OwnerDomainType | Variable | Description |
|---|---|---|
| | For publishers, an |
For more information, refer to the IAB documentation or the IAB standard implementation guide.