|
1 | | -# Getting started with Google Ad Manager |
| 1 | +# Getting started with Kodular Monetize |
2 | 2 |
|
3 | | -**Kodular has partnered with Google** to provide a **hight quality monetization** integration. This is done thanks to |
4 | | -**Google Ad Manager**, a Google's product that provides custom access to monetization tools. We have implemented their |
5 | | -features into a set of components that will allow you to monetize your apps with Google Ad Manager advertising. |
| 3 | +**Kodular Monetize** is a new system to allow you to monetize your apps with ease. It provides a simple way to |
| 4 | +integrate ads and manage your advertising networks directly from Kodular Creator, without intermediaries. |
6 | 5 |
|
7 | | -!!! info |
8 | | - If you are looking for Payments Support, please visit [this Kodular Support page](https://support.kodular.io/support/solutions/folders/204000115658). |
| 6 | +!!! tip "Public Preview" |
| 7 | + This feature is currently in public review. If you wish to try it out, you can fill the following form: [kodul.ar/monetize-join](https://kodul.ar/monetize-join). |
| 8 | + You will receive a link to activate it if selected. |
| 9 | + Please report any issues you encounter in [Kodular Community](https://community.kodular.io/). |
9 | 10 |
|
10 | | -## Registering for a Child Account |
| 11 | +This new system aims to replace the existing commission-based monetization system, which had some limitations. With |
| 12 | +Kodular Monetize, you will have **lower charges**, and a post-usage based pricing model. It will result in a lower |
| 13 | +"effective" commission for you. |
11 | 14 |
|
12 | | -In order to start using Google Ad Manager, you have to apply for a child account to be part of Kodular's network. |
| 15 | +## Enabling Kodular Monetize |
13 | 16 |
|
14 | | -Go to My Kodular, head to the [Payments](https://my.kodular.io/payments) page, and make sure your account is eligible. |
15 | | -Some of the reasons why your account may not be eligible are: |
| 17 | +1. Kodular Monetize requires a **Kodular Premium** subscription. If you don't have one, you can subscribe in [my.kodular.io/premium](https://my.kodular.io/premium). |
16 | 18 |
|
17 | | -- You have no approved apps for monetization. |
18 | | -- You have way too many apps rejected for monetization. |
| 19 | +2. Buy a **Kodular Monetize** activation license in [my.kodular.io/premium](https://my.kodular.io/premium). |
| 20 | + * This is a **one-time payment**: once bought, you own it for life, for all components. |
| 21 | + * During Public Preview, buying an activation license is restricted to a limited number of users. You can fill the |
| 22 | + [kodul.ar/monetize-join](https://kodul.ar/monetize-join) form to join the waiting list, and you will receive a |
| 23 | + link to buy it if selected. |
19 | 24 |
|
20 | | - |
| 25 | +3. Complete an identity verification process in [my.kodular.io/monetize](https://my.kodular.io/monetize). |
| 26 | + * _This page is still under development._ |
21 | 27 |
|
22 | | -If your account is eligible, you may see a "Request Invite" button. |
| 28 | +And done, you are ready to use Kodular Monetize components! |
23 | 29 |
|
24 | | - |
| 30 | +## Adding Kodular Monetize to your app |
25 | 31 |
|
26 | | -Follow the setup instructions to create the Google Ad Manager Child Account, and wait until it gets approved by Google. |
27 | | -This process should take _around 2 business days_. |
| 32 | +Kodular Monetize is not a single component, but a set of components that you can use to monetize your app. As of now, |
| 33 | +two ad networks are supported: |
28 | 34 |
|
29 | | -!!! warning |
30 | | - Make sure you no longer hold a Google Ad Manager account. If so, ask to create a new one. |
| 35 | +* **Google AdMob** |
| 36 | +* **Google Ad Manager** |
31 | 37 |
|
32 | | -Once all the process has been completed, **your account will be ready to show ads**. |
| 38 | +If you use any of those ad networks' components, you will be using Kodular Monetize underneath. |
33 | 39 |
|
34 | | - |
| 40 | +### Build Errors |
35 | 41 |
|
36 | | -## Registering your app in Google Ad Manager |
| 42 | +* **`NOT_ACTIVATED`**: this error means that the Kodular Monetize license has not been purchased yet. |
| 43 | + * During Public Preview, buying a license is based in a waiting list. If you have not filled the |
| 44 | + [kodul.ar/monetize-join](https://kodul.ar/monetize-join) form, please do so to join the waiting list. |
37 | 45 |
|
38 | | -The next step is applying for a Google Ads App ID. To do so, head to |
39 | | -the [Google Ad Manager console](https://admanager.google.com), and go to Inventory>Apps section. |
| 46 | +* **`NOT_VERIFIED`**: this error means that the identity verification process has not been completed yet. |
| 47 | + * Please go to [my.kodular.io/monetize](https://my.kodular.io/monetize) and complete the verification process. |
40 | 48 |
|
41 | | - |
| 49 | +* **`OVERDUE_INVOICES`**: this error means that your account no longer has a valid Kodular Premium subscription, or that |
| 50 | + you have unpaid overdue invoices. |
| 51 | + * Please go to [my.kodular.io/premium](https://my.kodular.io/premium), and make sure you have an active |
| 52 | + Kodular Premium subscription, and that all your invoices are paid. |
42 | 53 |
|
43 | | -Click on "New App", input your desired app name and check Android as platform. |
| 54 | +## FAQ |
44 | 55 |
|
45 | | -=== "Play Store" |
| 56 | +### How does it work? |
46 | 57 |
|
47 | | - If your app is published in Google Play Store, just search for its name, and all data will automatically be linked. |
| 58 | +Kodular Monetize **tracks events**: whenever a billable "event" occurs in your app, it gets recorded and charged in the |
| 59 | +next month invoice. An event may be an ad impression, a click, or any other action that can be monetized. |
48 | 60 |
|
49 | | -=== "Not in Play Store" |
| 61 | +For example, ads displayed in the month of June will be charged in an invoice issued in the first week of July. The |
| 62 | +invoice is due within 30 days, to allow you to **pay for it after the ad network distributes the earnings to you**. |
50 | 63 |
|
51 | | - If your app is not published in Google Play Store, check the alternative store and manually type the package name. |
52 | | - It is important that it matches the same one that you wrote in Kodular Creator. |
53 | | - Please note that **we do require apps to be published in any of those app stores**. If this is not your case, we |
54 | | - recommend publishing it in Amazon Appstore, which is free and it takes just 5 minutes to upload an app. |
| 64 | +### How does it differ from the commission-based monetization system? |
55 | 65 |
|
56 | | -Once finished, copy the **App ID** field that appears in the list (it will start with `ca-app-pub-`). We will need it |
57 | | -for later. |
| 66 | +In the commission-based monetization system, you were charged a percentage of your earnings. This however required |
| 67 | +complex integrations with ad networks, and was not flexible enough to allow you to use any ad network you wanted. It |
| 68 | +was also limiting the number of users that could use it. |
58 | 69 |
|
59 | | -## Implementing ads in your app |
| 70 | +This new system however allows unlimited users to monetize their apps, and provides a more transparent usage-based |
| 71 | +pricing model, on top of being ad-network agnostic. |
60 | 72 |
|
61 | | -This step is the easiest one. Go to Kodular Creator, and open the Monetization>Advertising section. You will find right |
62 | | -at the top 3 components: [**Kodular Banner**](../components/monetization/advertising/banner-ad.md), |
63 | | -[**Kodular Interstitial**](../components/monetization/advertising/interstitial-ad.md) and |
64 | | -[**Kodular Rewarded**](../components/monetization/advertising/rewarded-ad.md). Those three components are the ones that |
65 | | -will provide Google Ad Manager ads in your app. |
| 73 | +### What is the cost associated with Kodular Monetize? |
66 | 74 |
|
67 | | -Drag and drop them anywhere you want, and play with blocks to properly integrate them. **No Ad Units are needed**, as |
68 | | -all the integration happens automatically. |
| 75 | +1. **Kodular Premium**: this is a flat-rate recurring subscription, as stated in [kodular.io/pricing](https://kodular.io/pricing). |
| 76 | +2. **Kodular Monetize Activation License**: this is a one-time activation payment, granting access forever to all |
| 77 | + components. |
| 78 | + * For Public Preview users, the fee is 5 EUR. |
| 79 | + * For anyone else acquiring it in 2025, the fee is 10 EUR. |
| 80 | + * On or after 1st January 2026, the fee is 15 EUR. |
| 81 | +3. **Kodular Monetize Usage**: on the following month after events are recorded, you will receive an invoice with the |
| 82 | + total amount of events that occurred in your app. |
69 | 83 |
|
70 | | - |
| 84 | +### How is the usage-based pricing calculated? |
71 | 85 |
|
72 | | -Finally, open the **App Settings** modal with the gear button next to the Designer/Blocks ones. Go to the Monetization |
73 | | -section, and input the previously copied **App ID** into the **Google Ads App ID** field. |
| 86 | +There are three variables to take into account when calculating the usage-based pricing: |
74 | 87 |
|
75 | | -### app-ads.txt |
| 88 | +* **Country where the event occurred**: there are 3 tiers, or groups of countries. These tiers have been determined |
| 89 | + based on purchase power parity (PPP) and average revenue per user (ARPU) in each country. |
| 90 | + * For example, an ad served in the United States will be charged at a higher rate than an event occurring in India. |
| 91 | +* **Event type**: there are different types of events, such as ad impressions, clicks, etc. Each event type has a |
| 92 | + different price. |
| 93 | + * For example, an ad click is charged at a higher rate than a normal not-clicked ad impression. |
| 94 | +* **Number of events**: the total number of events that occurred in your app during the month. |
| 95 | + * For example, |
76 | 96 |
|
77 | | -For a better ad delivery, **you should have deployed an `app-ads.txt` file**. You must include our Google Publisher ID |
78 | | -in it. |
| 97 | +There is a **free allowance** to allow for testing and new apps to get started. If you serve ads within the free |
| 98 | +allowance, an empty invoice will be generated. |
| 99 | +You can see the full list of prices in [kodul.ar/monetize-rates](https://kodul.ar/monetize-rates). |
79 | 100 |
|
80 | | -Check **[this page](../support/adm/app-ads-txt.md) to learn how to properly implement it**. |
| 101 | +### How can I view my usage? |
81 | 102 |
|
82 | | -## Exporting your app |
| 103 | +Daily and monthly usage reports will be made available at [my.kodular.io/monetize](https://my.kodular.io/monetize). You |
| 104 | +will receive breakdowns of event types and countries, along with their tier. |
83 | 105 |
|
84 | | -**Your app is now ready!** Just click the Export button and publish it anywhere. |
| 106 | +### In the free tier, what happens if I have events in different country tiers? |
| 107 | + |
| 108 | +Free tier allowance is per country tier, per event type. This means that if you serve one ad in each tier, the free |
| 109 | +allowance count will still be at "1" in each tier (and not at 3 globally). |
| 110 | + |
| 111 | +For example, if the first 1,000 ad clicks are free in each tier, this means you can serve up to 3,000 ad clicks free |
| 112 | +of charge, as long as they are evenly distributed across the tiers. |
| 113 | + |
| 114 | +### What happens if I stop paying Kodular Premium, or have an unpaid Kodular Monetize invoice? |
| 115 | + |
| 116 | +If you stop paying Kodular Premium, or you did not pay within 30 days a Kodular Monetize invoice, ad serving will stop |
| 117 | +in your apps until it gets resolved. If you have any questions, you can contact us at |
| 118 | +[support@kodular.io](mailto:support@kodular.io). |
| 119 | + |
| 120 | +After your account becomes compliant again, note it may take up to 4 hours for all the apps to restore their ad serving |
| 121 | +status. |
0 commit comments