diff --git a/docs/components/monetization/advertising/applovin-interstitial.md b/docs/components/deprecated/applovin-interstitial.md similarity index 76% rename from docs/components/monetization/advertising/applovin-interstitial.md rename to docs/components/deprecated/applovin-interstitial.md index 64b9c2d79..5e61bd344 100644 --- a/docs/components/monetization/advertising/applovin-interstitial.md +++ b/docs/components/deprecated/applovin-interstitial.md @@ -4,31 +4,26 @@ | Category | Requires | Version | |:--------:|:-------:|:--------:| -|**Monetization > Advertising**|API 21, Android 5.0 Lollipop|1| +|**Deprecated**|API 21, Android 5.0 Lollipop|2| + +!!! danger "Deprecated component" + This component is deprecated. Projects that still contain it will fail to build until it is removed. You can still load existing projects in the Designer and live-test them with the Companion while you migrate, but APK and AAB builds are blocked. Look for an up-to-date replacement in the active component palette. ## Overview A non-visible component to show ads from AppLovin. -??? example "Permissions" - * [android.permission.INTERNET](https://developer.android.com/reference/android/Manifest.permission.html#INTERNET) - * [android.permission.ACCESS_NETWORK_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_NETWORK_STATE) - -!!! info "Commission" - **Type:** Fixed Rate - **Value:** `8%` - ## Events ### Ad Closed -Called when an ad was closed. +Deprecated. Never fires.
### Ad Failed To Load -Called when an ad request failed to load. The message will display the error code and error message. +Deprecated. Never fires. @@ -39,25 +34,25 @@ Called when an ad request failed to load. The message will display the error cod ### Ad Loaded -Called when an ad is received. +Deprecated. Never fires. ### Ad Opened -Called when an ad was opened. +Deprecated. Never fires. ### Ad Started -Called when an ad was started. +Deprecated. Never fires. ### Error -Called when an ad request failed. The message will display the reason for why the ad failed. +Deprecated. Never fires. @@ -70,7 +65,7 @@ Called when an ad request failed. The message will display the reason for why th ### Initialize -Initialize the AppLovin SDK. You should call this function before loading ads to ensure proper initialization. +Deprecated. Does nothing. @@ -78,19 +73,19 @@ Initialize the AppLovin SDK. You should call this function before loading ads to Returns: Boolean -Returns true if the current app user is located in europe. If true you must ask the user as example in a dialog if he give his consent for personalized ads. +Deprecated. Always returns false. ### Load Ad -Loads a new ad. +Deprecated. Does nothing. ### Show Ad -Shows an ad to the user. +Deprecated. Does nothing. @@ -108,7 +103,7 @@ Property for SdkKey Boolean Default: False :heavy_minus_sign: Read Write - Designer Blocks -With AppLovin SDK 13.2.0+, test mode must be configured through the AppLovin dashboard. This property is maintained for backwards compatibility but has no effect. +Deprecated. Does nothing. @@ -117,7 +112,7 @@ With AppLovin SDK 13.2.0+, test mode must be configured through the AppLovin das Boolean :heavy_minus_sign: Read Write - Blocks -If set to true the user allowed the ad network to show personalized ads. You only need to request the consent from european users. +Deprecated. Does nothing. diff --git a/docs/components/mkdocs.yml b/docs/components/mkdocs.yml index 150f69c44..823fc1ef0 100644 --- a/docs/components/mkdocs.yml +++ b/docs/components/mkdocs.yml @@ -194,7 +194,12 @@ - AdColony Interstitial: components/monetization/advertising/adcolony-interstitial.md - Amazon Banner: components/monetization/advertising/amazon-banner.md - Amazon Interstitial: components/monetization/advertising/amazon-interstitial.md - - AppLovin Interstitial: components/monetization/advertising/applovin-interstitial.md + - AppLovin Max App Open: components/monetization/advertising/applovin-max-app-open.md + - AppLovin Max Banner: components/monetization/advertising/applovin-max-banner.md + - AppLovin Max Interstitial: components/monetization/advertising/applovin-max-interstitial.md + - AppLovin Max MREC: components/monetization/advertising/applovin-max-mrec.md + - AppLovin Max Native: components/monetization/advertising/applovin-max-native.md + - AppLovin Max Rewarded: components/monetization/advertising/applovin-max-rewarded.md - Facebook Banner: components/monetization/advertising/facebook-banner.md - Facebook Interstitial: components/monetization/advertising/facebook-interstitial.md - Facebook Rewarded Video: components/monetization/advertising/facebook-rewarded-video.md diff --git a/docs/components/monetization/advertising/adcolony-interstitial.md b/docs/components/monetization/advertising/adcolony-interstitial.md index 9bd0e5ca4..9e461f230 100644 --- a/docs/components/monetization/advertising/adcolony-interstitial.md +++ b/docs/components/monetization/advertising/adcolony-interstitial.md @@ -16,9 +16,8 @@ A non-visible component that shows AdColony ads as full-screen advertisements. * [android.permission.ACCESS_NETWORK_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_NETWORK_STATE) * [android.permission.VIBRATE](https://developer.android.com/reference/android/Manifest.permission.html#VIBRATE) -!!! info "Commission" - **Type:** Fixed Rate - **Value:** `8%` +!!! info "Subscription" + This component requires an active **Kodular Premium** subscription. See [my.kodular.io/premium](https://my.kodular.io/premium). ## Events diff --git a/docs/components/monetization/advertising/amazon-banner.md b/docs/components/monetization/advertising/amazon-banner.md index 8402bad87..a92f3b269 100644 --- a/docs/components/monetization/advertising/amazon-banner.md +++ b/docs/components/monetization/advertising/amazon-banner.md @@ -15,9 +15,8 @@ AdAmazon component allows you to monetize your app. You must have a valid publis * [android.permission.ACCESS_NETWORK_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_NETWORK_STATE) * [android.permission.ACCESS_WIFI_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_WIFI_STATE) -!!! info "Commission" - **Type:** Fixed Rate - **Value:** `6%` +!!! info "Subscription" + This component requires an active **Kodular Premium** subscription. See [my.kodular.io/premium](https://my.kodular.io/premium). ## Events diff --git a/docs/components/monetization/advertising/amazon-interstitial.md b/docs/components/monetization/advertising/amazon-interstitial.md index 81c8c7073..b2bfcd154 100644 --- a/docs/components/monetization/advertising/amazon-interstitial.md +++ b/docs/components/monetization/advertising/amazon-interstitial.md @@ -17,9 +17,8 @@ An interstitial ad is a full-page ad. AdAmazonInterstitial component allows you * [android.permission.ACCESS_NETWORK_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_NETWORK_STATE) * [android.permission.ACCESS_WIFI_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_WIFI_STATE) -!!! info "Commission" - **Type:** Fixed Rate - **Value:** `9%` +!!! info "Subscription" + This component requires an active **Kodular Premium** subscription. See [my.kodular.io/premium](https://my.kodular.io/premium). ## Events diff --git a/docs/components/monetization/advertising/applovin-max-app-open.md b/docs/components/monetization/advertising/applovin-max-app-open.md new file mode 100644 index 000000000..d66c373f3 --- /dev/null +++ b/docs/components/monetization/advertising/applovin-max-app-open.md @@ -0,0 +1,108 @@ +# AppLovin Max App Open + +{>> Non-Visible component<<} + +| Category | Requires | Version | +|:--------:|:-------:|:--------:| +|**Monetization > Advertising**|API 24, Android 7.0 Nougat|1| + +==This component requires a higher **Minimum Android SDK** in your app (_API 21, Android 5.0 Lollipop_ -> _API 24, Android 7.0 Nougat_)== + +## Overview + +Shows AppLovin MAX app open ads when the app returns to the foreground. Requires an AppLovin SDK key in the project settings and a MAX app open ad unit ID. + +??? example "Permissions" + * [com.google.android.gms.permission.AD_ID](https://developer.android.com/reference/android/Manifest.permission.html#com.google.android.gms.permission.AD_ID) + * [android.permission.INTERNET](https://developer.android.com/reference/android/Manifest.permission.html#INTERNET) + * [android.permission.ACCESS_NETWORK_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_NETWORK_STATE) + * [android.permission.ACCESS_WIFI_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_WIFI_STATE) + +!!! info "Kodular Monetize" + This component requires **Kodular Monetize** to be activated. See [my.kodular.io/monetize](https://my.kodular.io/monetize) and the [Monetize rates](https://kodul.ar/monetize-rates). + +## Events + +### Ad Clicked + +Event raised when an ad was clicked. + + + +### Ad Closed + +Event raised when an ad was closed. + + + +### Ad Opened + +Event raised when an ad was opened. + + + +### Failed To Load + +Event raised when an ad could not be loaded. + + + +| Param | Type | +|--------|------| +|error Message|Text| + +### Failed To Show + +Event raised when an ad could not be shown. + + + +| Param | Type | +|--------|------| +|error Message|Text| + +### Loaded + +Event raised when an ad was loaded successfully. + + + +## Methods + +### Load + +Loads an app open ad and prepares it for showing. + + + +### Show + +Displays a previously loaded app open ad. + + + +## Properties + +### Ad Unit Id + +Text :heavy_minus_sign: Read Write - Designer Blocks + +Sets the MAX ad unit ID for app open ads. + + + + +### AutoShowOnForeground + +Boolean Default: False :heavy_minus_sign: Read Write - Designer Blocks + +If enabled, a loaded app open ad is automatically shown when the app returns to the foreground. + + + + +### Test Mode + +Boolean Default: False :heavy_minus_sign: Write - Designer + +If enabled, the ad is treated as a test ad. Always enabled in companion. Note: AppLovin MAX test ads are configured through the MAX dashboard (test device GAIDs); this property only controls Kodular-side test behavior. diff --git a/docs/components/monetization/advertising/applovin-max-banner.md b/docs/components/monetization/advertising/applovin-max-banner.md new file mode 100644 index 000000000..0c1006d76 --- /dev/null +++ b/docs/components/monetization/advertising/applovin-max-banner.md @@ -0,0 +1,136 @@ +# AppLovin Max Banner + +| Category | Requires | Version | +|:--------:|:-------:|:--------:| +|**Monetization > Advertising**|API 24, Android 7.0 Nougat|1| + +==This component requires a higher **Minimum Android SDK** in your app (_API 21, Android 5.0 Lollipop_ -> _API 24, Android 7.0 Nougat_)== + +## Overview + +Shows AppLovin MAX banner ads. Requires an AppLovin SDK key in the project settings and a MAX banner ad unit ID. + +??? example "Permissions" + * [com.google.android.gms.permission.AD_ID](https://developer.android.com/reference/android/Manifest.permission.html#com.google.android.gms.permission.AD_ID) + * [android.permission.INTERNET](https://developer.android.com/reference/android/Manifest.permission.html#INTERNET) + * [android.permission.ACCESS_NETWORK_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_NETWORK_STATE) + * [android.permission.ACCESS_WIFI_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_WIFI_STATE) + +!!! info "Kodular Monetize" + This component requires **Kodular Monetize** to be activated. See [my.kodular.io/monetize](https://my.kodular.io/monetize) and the [Monetize rates](https://kodul.ar/monetize-rates). + +## Events + +### Ad Clicked + +Event raised when an ad was clicked. + + + +### Ad Collapsed + +Event raised when the ad collapsed back from fullscreen. + + + +### Ad Expanded + +Event raised when the ad expanded to fullscreen. + + + +### Failed To Load + +Event raised when an ad could not be loaded. + + + +| Param | Type | +|--------|------| +|error Message|Text| + +### Loaded + +Event raised when an ad was loaded successfully. + + + +## Methods + +### Load + +Loads a banner ad. + + + +### StartAutoRefresh + +Resumes auto-refresh of the banner. + + + +### StopAutoRefresh + +Pauses auto-refresh of the banner. + + + +## Properties + +### Ad Unit Id + +Text :heavy_minus_sign: Read Write - Designer Blocks + +Sets the MAX ad unit ID for banner ads. + + + + +### Height + +Number :heavy_minus_sign: Read Write - Blocks + +Specifies the component's vertical height, measured in pixels. + + + + +### Height Percent + +Number :heavy_minus_sign: Write - Blocks + +Specifies the component's vertical height as a percentageof the height of its parent Component. + + + +### Test Mode + +Boolean Default: False :heavy_minus_sign: Write - Designer + +If enabled, the ad is treated as a test ad. Always enabled in companion. MAX test ads are configured through the MAX dashboard. + +### Visible + +Boolean Default: True :heavy_minus_sign: Read Write - Designer Blocks + +Returns true iff the component is visible. + + + + +### Width + +Number :heavy_minus_sign: Read Write - Blocks + +Specifies the component's horizontal width, measured in pixels. + + + + +### Width Percent + +Number :heavy_minus_sign: Write - Blocks + +Specifies the component's horizontal width as a percentageof the Width of its parent Component. + + diff --git a/docs/components/monetization/advertising/applovin-max-interstitial.md b/docs/components/monetization/advertising/applovin-max-interstitial.md new file mode 100644 index 000000000..11cdd90b1 --- /dev/null +++ b/docs/components/monetization/advertising/applovin-max-interstitial.md @@ -0,0 +1,99 @@ +# AppLovin Max Interstitial + +{>> Non-Visible component<<} + +| Category | Requires | Version | +|:--------:|:-------:|:--------:| +|**Monetization > Advertising**|API 24, Android 7.0 Nougat|1| + +==This component requires a higher **Minimum Android SDK** in your app (_API 21, Android 5.0 Lollipop_ -> _API 24, Android 7.0 Nougat_)== + +## Overview + +Shows AppLovin MAX interstitial ads. Requires an AppLovin SDK key in the project settings and a MAX interstitial ad unit ID. + +??? example "Permissions" + * [com.google.android.gms.permission.AD_ID](https://developer.android.com/reference/android/Manifest.permission.html#com.google.android.gms.permission.AD_ID) + * [android.permission.INTERNET](https://developer.android.com/reference/android/Manifest.permission.html#INTERNET) + * [android.permission.ACCESS_NETWORK_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_NETWORK_STATE) + * [android.permission.ACCESS_WIFI_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_WIFI_STATE) + +!!! info "Kodular Monetize" + This component requires **Kodular Monetize** to be activated. See [my.kodular.io/monetize](https://my.kodular.io/monetize) and the [Monetize rates](https://kodul.ar/monetize-rates). + +## Events + +### Ad Clicked + +Event raised when an ad was clicked. + + + +### Ad Closed + +Event raised when an ad was closed. + + + +### Ad Opened + +Event raised when an ad was opened. + + + +### Failed To Load + +Event raised when an ad could not be loaded. + + + +| Param | Type | +|--------|------| +|error Message|Text| + +### Failed To Show + +Event raised when an ad could not be shown. + + + +| Param | Type | +|--------|------| +|error Message|Text| + +### Loaded + +Event raised when an ad was loaded successfully. + + + +## Methods + +### Load + +Loads an interstitial ad and prepares it for showing. + + + +### Show + +Displays a previously loaded interstitial ad. + + + +## Properties + +### Ad Unit Id + +Text :heavy_minus_sign: Read Write - Designer Blocks + +Sets the MAX ad unit ID for interstitial ads. + + + + +### Test Mode + +Boolean Default: False :heavy_minus_sign: Write - Designer + +If enabled, the ad is treated as a test ad. Always enabled in companion. Note: AppLovin MAX test ads are configured through the MAX dashboard (test device GAIDs); this property only controls Kodular-side test behavior. diff --git a/docs/components/monetization/advertising/applovin-max-mrec.md b/docs/components/monetization/advertising/applovin-max-mrec.md new file mode 100644 index 000000000..53b709c47 --- /dev/null +++ b/docs/components/monetization/advertising/applovin-max-mrec.md @@ -0,0 +1,136 @@ +# AppLovin Max MREC + +| Category | Requires | Version | +|:--------:|:-------:|:--------:| +|**Monetization > Advertising**|API 24, Android 7.0 Nougat|1| + +==This component requires a higher **Minimum Android SDK** in your app (_API 21, Android 5.0 Lollipop_ -> _API 24, Android 7.0 Nougat_)== + +## Overview + +Shows AppLovin MAX MREC (300x250) ads. Requires an AppLovin SDK key in the project settings and a MAX MREC ad unit ID. + +??? example "Permissions" + * [com.google.android.gms.permission.AD_ID](https://developer.android.com/reference/android/Manifest.permission.html#com.google.android.gms.permission.AD_ID) + * [android.permission.INTERNET](https://developer.android.com/reference/android/Manifest.permission.html#INTERNET) + * [android.permission.ACCESS_NETWORK_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_NETWORK_STATE) + * [android.permission.ACCESS_WIFI_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_WIFI_STATE) + +!!! info "Kodular Monetize" + This component requires **Kodular Monetize** to be activated. See [my.kodular.io/monetize](https://my.kodular.io/monetize) and the [Monetize rates](https://kodul.ar/monetize-rates). + +## Events + +### Ad Clicked + +Event raised when an ad was clicked. + + + +### Ad Collapsed + +Event raised when the ad collapsed back from fullscreen. + + + +### Ad Expanded + +Event raised when the ad expanded to fullscreen. + + + +### Failed To Load + +Event raised when an ad could not be loaded. + + + +| Param | Type | +|--------|------| +|error Message|Text| + +### Loaded + +Event raised when an ad was loaded successfully. + + + +## Methods + +### Load + +Loads an MREC ad. + + + +### StartAutoRefresh + +Resumes auto-refresh of the MREC. + + + +### StopAutoRefresh + +Pauses auto-refresh of the MREC. + + + +## Properties + +### Ad Unit Id + +Text :heavy_minus_sign: Read Write - Designer Blocks + +Sets the MAX ad unit ID for MREC ads. + + + + +### Height + +Number :heavy_minus_sign: Read Write - Blocks + +Specifies the component's vertical height, measured in pixels. + + + + +### Height Percent + +Number :heavy_minus_sign: Write - Blocks + +Specifies the component's vertical height as a percentageof the height of its parent Component. + + + +### Test Mode + +Boolean Default: False :heavy_minus_sign: Write - Designer + +If enabled, the ad is treated as a test ad. Always enabled in companion. MAX test ads are configured through the MAX dashboard. + +### Visible + +Boolean Default: True :heavy_minus_sign: Read Write - Designer Blocks + +Returns true iff the component is visible. + + + + +### Width + +Number :heavy_minus_sign: Read Write - Blocks + +Specifies the component's horizontal width, measured in pixels. + + + + +### Width Percent + +Number :heavy_minus_sign: Write - Blocks + +Specifies the component's horizontal width as a percentageof the Width of its parent Component. + + diff --git a/docs/components/monetization/advertising/applovin-max-native.md b/docs/components/monetization/advertising/applovin-max-native.md new file mode 100644 index 000000000..30254b48b --- /dev/null +++ b/docs/components/monetization/advertising/applovin-max-native.md @@ -0,0 +1,153 @@ +# AppLovin Max Native + +| Category | Requires | Version | +|:--------:|:-------:|:--------:| +|**Monetization > Advertising**|API 24, Android 7.0 Nougat|1| + +==This component requires a higher **Minimum Android SDK** in your app (_API 21, Android 5.0 Lollipop_ -> _API 24, Android 7.0 Nougat_)== + +## Overview + +A layout component for showing AppLovin MAX native ads. Native ads use the app's own UI elements (Labels, Buttons, Images) so they blend naturally with your content. The ad unit must be of type "Manual" in the AppLovin MAX dashboard. + +??? example "Permissions" + * [com.google.android.gms.permission.AD_ID](https://developer.android.com/reference/android/Manifest.permission.html#com.google.android.gms.permission.AD_ID) + * [android.permission.INTERNET](https://developer.android.com/reference/android/Manifest.permission.html#INTERNET) + * [android.permission.ACCESS_NETWORK_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_NETWORK_STATE) + * [android.permission.ACCESS_WIFI_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_WIFI_STATE) + +!!! info "Kodular Monetize" + This component requires **Kodular Monetize** to be activated. See [my.kodular.io/monetize](https://my.kodular.io/monetize) and the [Monetize rates](https://kodul.ar/monetize-rates). + +## Events + +### Ad Clicked + +Called when the user clicks on the native ad. + + + +### Failed To Load + +Called when a native ad fails to load. + + + +| Param | Type | +|--------|------| +|error Message|Text| + +### Loaded + +Called when a native ad has been loaded successfully. + + + +## Methods + +### Load + +Initiates a request to load a new native ad. Does nothing if ads are disabled or a load is already in progress. + + + +## Properties + +### Ad Enabled + +Boolean Default: True :heavy_minus_sign: Read Write - Designer Blocks + +Specifies whether ads should be enabled. If set to false, no ads will be loaded or shown. + + + + +### Ad Unit Id + +Text :heavy_minus_sign: Read Write - Designer Blocks + +Sets the MAX ad unit ID for native ads. The ad unit must be of type "Manual" in the AppLovin MAX dashboard. + + + + +### Body Label + +Component :heavy_minus_sign: Write - Designer Blocks + +The label component for the ad body text. + + + +### Call To Action Button + +Component :heavy_minus_sign: Write - Designer Blocks + +The button component for the ad call-to-action. + + + +### Headline Label + +Component :heavy_minus_sign: Write - Designer Blocks + +The label component for the ad headline (required). + + + +### Height + +Number :heavy_minus_sign: Read Write - Blocks + +Specifies the component's vertical height, measured in pixels. + + + + +### Height Percent + +Number :heavy_minus_sign: Write - Blocks + +Specifies the component's vertical height as a percentageof the height of its parent Component. + + + +### Icon Image + +Component :heavy_minus_sign: Write - Designer Blocks + +The image component for the ad icon. + + + +### Test Mode + +Boolean Default: False :heavy_minus_sign: Write - Designer + +If enabled, the ad is treated as a test ad. Always enabled in companion. MAX test ads are configured through the MAX dashboard. + +### Visible + +Boolean Default: True :heavy_minus_sign: Read Write - Designer Blocks + +Returns true iff the component is visible. + + + + +### Width + +Number :heavy_minus_sign: Read Write - Blocks + +Specifies the component's horizontal width, measured in pixels. + + + + +### Width Percent + +Number :heavy_minus_sign: Write - Blocks + +Specifies the component's horizontal width as a percentageof the Width of its parent Component. + + diff --git a/docs/components/monetization/advertising/applovin-max-rewarded.md b/docs/components/monetization/advertising/applovin-max-rewarded.md new file mode 100644 index 000000000..ad8babfb6 --- /dev/null +++ b/docs/components/monetization/advertising/applovin-max-rewarded.md @@ -0,0 +1,110 @@ +# AppLovin Max Rewarded + +{>> Non-Visible component<<} + +| Category | Requires | Version | +|:--------:|:-------:|:--------:| +|**Monetization > Advertising**|API 24, Android 7.0 Nougat|1| + +==This component requires a higher **Minimum Android SDK** in your app (_API 21, Android 5.0 Lollipop_ -> _API 24, Android 7.0 Nougat_)== + +## Overview + +Shows AppLovin MAX rewarded video ads. Requires an AppLovin SDK key in the project settings and a MAX rewarded ad unit ID. + +??? example "Permissions" + * [com.google.android.gms.permission.AD_ID](https://developer.android.com/reference/android/Manifest.permission.html#com.google.android.gms.permission.AD_ID) + * [android.permission.INTERNET](https://developer.android.com/reference/android/Manifest.permission.html#INTERNET) + * [android.permission.ACCESS_NETWORK_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_NETWORK_STATE) + * [android.permission.ACCESS_WIFI_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_WIFI_STATE) + +!!! info "Kodular Monetize" + This component requires **Kodular Monetize** to be activated. See [my.kodular.io/monetize](https://my.kodular.io/monetize) and the [Monetize rates](https://kodul.ar/monetize-rates). + +## Events + +### Ad Clicked + +Event raised when an ad was clicked. + + + +### Ad Closed + +Event raised when an ad was closed. + + + +### Ad Opened + +Event raised when an ad was opened. + + + +### Failed To Load + +Event raised when an ad could not be loaded. + + + +| Param | Type | +|--------|------| +|error Message|Text| + +### Failed To Show + +Event raised when an ad could not be shown. + + + +| Param | Type | +|--------|------| +|error Message|Text| + +### Loaded + +Event raised when an ad was loaded successfully. + + + +### Rewarded + +Event raised when the user should be rewarded for watching the ad. + + + +| Param | Type | +|--------|------| +|amount|Number| +|label|Text| + +## Methods + +### Load + +Loads a rewarded ad and prepares it for showing. + + + +### Show + +Displays a previously loaded rewarded ad. + + + +## Properties + +### Ad Unit Id + +Text :heavy_minus_sign: Read Write - Designer Blocks + +Sets the MAX ad unit ID for rewarded ads. + + + + +### Test Mode + +Boolean Default: False :heavy_minus_sign: Write - Designer + +If enabled, the ad is treated as a test ad. Always enabled in companion. Note: AppLovin MAX test ads are configured through the MAX dashboard (test device GAIDs); this property only controls Kodular-side test behavior. diff --git a/docs/components/monetization/advertising/facebook-banner.md b/docs/components/monetization/advertising/facebook-banner.md index d966aa7a8..8b9fba36a 100644 --- a/docs/components/monetization/advertising/facebook-banner.md +++ b/docs/components/monetization/advertising/facebook-banner.md @@ -12,9 +12,8 @@ A non-visible component that shows Facebook ads as static banners. * [android.permission.INTERNET](https://developer.android.com/reference/android/Manifest.permission.html#INTERNET) * [android.permission.ACCESS_NETWORK_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_NETWORK_STATE) -!!! info "Commission" - **Type:** Fixed Rate - **Value:** `6%` +!!! info "Subscription" + This component requires an active **Kodular Premium** subscription. See [my.kodular.io/premium](https://my.kodular.io/premium). ## Events diff --git a/docs/components/monetization/advertising/facebook-interstitial.md b/docs/components/monetization/advertising/facebook-interstitial.md index e6461159a..47782bebe 100644 --- a/docs/components/monetization/advertising/facebook-interstitial.md +++ b/docs/components/monetization/advertising/facebook-interstitial.md @@ -14,9 +14,8 @@ A non-visible component that shows Facebook ads as full-screen advertisements. * [android.permission.INTERNET](https://developer.android.com/reference/android/Manifest.permission.html#INTERNET) * [android.permission.ACCESS_NETWORK_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_NETWORK_STATE) -!!! info "Commission" - **Type:** Fixed Rate - **Value:** `9%` +!!! info "Subscription" + This component requires an active **Kodular Premium** subscription. See [my.kodular.io/premium](https://my.kodular.io/premium). ## Events diff --git a/docs/components/monetization/advertising/facebook-rewarded-video.md b/docs/components/monetization/advertising/facebook-rewarded-video.md index e399f1a5a..245a9e533 100644 --- a/docs/components/monetization/advertising/facebook-rewarded-video.md +++ b/docs/components/monetization/advertising/facebook-rewarded-video.md @@ -14,9 +14,8 @@ A non-visible component that shows Facebook ads as full-screen video where users * [android.permission.INTERNET](https://developer.android.com/reference/android/Manifest.permission.html#INTERNET) * [android.permission.ACCESS_NETWORK_STATE](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_NETWORK_STATE) -!!! info "Commission" - **Type:** Fixed Rate - **Value:** `12%` +!!! info "Subscription" + This component requires an active **Kodular Premium** subscription. See [my.kodular.io/premium](https://my.kodular.io/premium). ## Events diff --git a/docs/components/monetization/advertising/google-ad-manager-app-open.md b/docs/components/monetization/advertising/google-ad-manager-app-open.md index fcc70c16b..31d7d0123 100644 --- a/docs/components/monetization/advertising/google-ad-manager-app-open.md +++ b/docs/components/monetization/advertising/google-ad-manager-app-open.md @@ -18,6 +18,9 @@ A non-visible component that displays app open ads from multiple advertisers and * [android.permission.ACCESS_ADSERVICES_ATTRIBUTION](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_ADSERVICES_ATTRIBUTION) * [android.permission.ACCESS_ADSERVICES_TOPICS](https://developer.android.com/reference/android/Manifest.permission.html#ACCESS_ADSERVICES_TOPICS) +!!! info "Kodular Monetize" + This component requires **Kodular Monetize** to be activated. See [my.kodular.io/monetize](https://my.kodular.io/monetize) and the [Monetize rates](https://kodul.ar/monetize-rates). + ## Events ### Ad Clicked diff --git a/docs/components/monetization/advertising/google-ad-manager-banner.md b/docs/components/monetization/advertising/google-ad-manager-banner.md index a994f800c..ffb850a61 100644 --- a/docs/components/monetization/advertising/google-ad-manager-banner.md +++ b/docs/components/monetization/advertising/google-ad-manager-banner.md @@ -17,6 +17,9 @@ Note\: This component is currently available on an invite-only basis. Click General** (such as In App Billing and Pollfish) are free and require neither + Kodular Monetize nor Kodular Premium. + +The split is **temporary**. Kodular Premium ad networks are legacy: over time they will all be migrated to Kodular +Monetize, until every ad network is covered by Kodular Monetize and the Kodular Premium tier no longer gates any ad +component. + ## FAQ ### How does it work? diff --git a/docs/release-notes/202605.md b/docs/release-notes/202605.md index 275c107d9..222a0cd05 100644 --- a/docs/release-notes/202605.md +++ b/docs/release-notes/202605.md @@ -215,3 +215,64 @@ ### Component Bug Fixes * Fixed **Map** component mock rendering in the Designer. + +## 2026.05.2 \| _28 June 2026_ + +### New Components + +* **AppLovin Max Banner** Monetization > Advertising + * New component to show AppLovin MAX banner ads. + +{ width="300" } + +* **AppLovin Max MREC** Monetization > Advertising + * New component to show AppLovin MAX 300×250 MREC ads. + +{ width="300" } + +* **AppLovin Max Native** Monetization > Advertising + * New layout component for AppLovin MAX native ads that blend with the app's own UI. The ad unit must be of type *Manual* in the AppLovin MAX dashboard. + +{ width="300" } + +* **AppLovin Max Interstitial** Monetization > Advertising + * New non-visible component for full-screen AppLovin MAX interstitial ads. + +{ width="300" } + +* **AppLovin Max Rewarded** Monetization > Advertising + * New non-visible component for AppLovin MAX rewarded video ads. + +{ width="300" } + +* **AppLovin Max App Open** Monetization > Advertising + * New non-visible component to show AppLovin MAX app open ads when the app returns to the foreground. + +{ width="300" } + +!!! note + The AppLovin Max components are now part of the **Monetize** plan, and are no longer included in **Premium**. + + All AppLovin Max components require an **AppLovin SDK Key** set once in the project settings (found under *Account > Keys* in the AppLovin dashboard), plus a per-component MAX ad unit ID. + +### Component Changes + +* Deprecated the legacy **AppLovin Interstitial** component in favour of the new **AppLovin Max** components. AppLovin discontinued the direct-serve (SDK-key-only) ad APIs it relied on, so its blocks now do nothing. Move existing projects to the AppLovin Max components. + +### Creator Changes + +* **Custom Project Name On Import**. The AIA Upload dialog now lets you choose the imported project's name instead of forcing the file name, with unified project name validation. + +* **Custom Screen Name On Import**. Importing a screen now lets you set a custom screen name. + +* **Asset Rename**. Assets can now be renamed directly from the Asset Manager. + +* **Improved Copy Component naming**. Copying a copy now yields `Button1_copy`, `Button1_copy1`, and so on instead of `Button1_copy_copy`. + +### Creator Bug Fixes + +* Fixed undo/redo keyboard shortcuts (Ctrl+Z / Ctrl+Y) leaking to other handlers by stopping event propagation. + +### Component Bug Fixes + +* Fixed an occasional build failure when generating the Build ID for Monetize apps. diff --git a/extras/adcolony interstitial/extras.html b/extras/adcolony interstitial/extras.html index 27b44eb10..ce5efaee4 100644 --- a/extras/adcolony interstitial/extras.html +++ b/extras/adcolony interstitial/extras.html @@ -1,5 +1,4 @@