Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/agilie/ads-and-payment-demo-app
The demo application demonstrates the integration of several advertising platforms in a single application and the use of advertising banners in non-standard situations. The application emulates the process of purchasing movie tickets with the ability to choose between available cinemas.
https://github.com/agilie/ads-and-payment-demo-app
Last synced: about 2 months ago
JSON representation
The demo application demonstrates the integration of several advertising platforms in a single application and the use of advertising banners in non-standard situations. The application emulates the process of purchasing movie tickets with the ability to choose between available cinemas.
- Host: GitHub
- URL: https://github.com/agilie/ads-and-payment-demo-app
- Owner: agilie
- Created: 2019-03-25T13:29:48.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2019-03-26T07:54:48.000Z (almost 6 years ago)
- Last Synced: 2024-11-09T09:11:43.702Z (3 months ago)
- Language: Kotlin
- Size: 345 KB
- Stars: 0
- Watchers: 10
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# AdsDemoApp
The demo application demonstrates the integration of several advertising
platforms in a single application and the use of advertising banners in
non-standard situations. The application emulates the process of
purchasing movie tickets with the ability to choose between available
cinemas.
The following advertising platforms are used:
- Leadbolt (https://www.leadbolt.com/)
- Adform (https://site.adform.com/)
- Inmobi (https://www.inmobi.com/)
1. Using with Google Maps
1. Using as an element of GridView
- (Leadbolt)
- (Adform)
1. Using inside of CoordinatorLayout
4. Handling the back button as a separate event (implemented only for
Leadbolt)
## Add dependencies
#### 1. Leadbolt
- To add an SDK to the project, you need to download the `.jar` file at
this
[link](http://d8fj70cz9kmyh.cloudfront.net/dwn/Android/leadbolt_native_android_sdk_v9.0.zip).
- Put the downloaded file in the `libs` folder of your application or
module.
- Add a dependency to the `build.gradle` file of the application /
module level:
```groovy
implementation fileTree(dir: 'libs', include: ['*.jar'])
implementation "com.google.android.gms:play-services-base:[actual_version]"
```
- More detailed instructions can be found on the
[link](https://help.leadbolt.com/android-native-integration-guide/).
#### 2. Adform
- Add to the `build.gradle` file of **the project** level repository:
```groovy
allprojects {
repositories {
...
maven { url "https://github.com/adform/adform-android-sdk/raw/master/releases/" }
}
}
```
- Add a dependency to the `build.gradle` file of **the application /
module** level:
```groovy
implementation "com.adform.advertising.sdk:advertising-sdk:[actual_version]@aar"
implementation "com.google.android.gms:play-services-ads:[actual_version]"
```
- More detailed instructions can be found on the
[link](https://github.com/adform/adform-android-sdk).
#### 3. InMobi
- Integration is described in detail in our article
[How to Integrate InMobi SDK to Start Monetizing Your Android App](https://agilie.com/en/blog/how-to-integrate-inmobi-sdk-to-start-monetizing-your-android-app)
and also you can look at the official website
[Android Guidelines | Getting Started with Android SDK Integration](https://support.inmobi.com/monetize/android-guidelines/)
## Interaction with advertising SDK
An interface `AdProvider` has been created to interact with various SDK's:
```kotlin
interface AdProvider : LifecycleObserver {
fun init(context: Context)
fun inflateDefaultBanner(parent: ViewGroup, lifecycleOwner: LifecycleOwner)
fun loadAdForDefaultBanner(lifecycleOwner: LifecycleOwner, observer: Observer)
fun inflateBigBanner(parent: ViewGroup, lifecycleOwner: LifecycleOwner)
fun loadAdForBigBanner(lifecycleOwner: LifecycleOwner, observer: Observer)
fun displayFullScreenAd(
context: Context,
lifecycleOwner: LifecycleOwner,
observer: Observer
)
fun createGridViewHolder(parent: ViewGroup): AdViewHolder
fun getAdAdapterManager(): AdRecyclerView.AdAdapterManager
fun getAdLayoutManager(): AdRecyclerView.AdLayoutManager
}
```
- SDK initialization
```kotlin
fun init(context: Context)
```
- Inflate View, that will contain and display a standard banner ad.
It adds the created View to the passed `parent`
```kotlin
fun inflateDefaultBanner(parent: ViewGroup, lifecycleOwner: LifecycleOwner)
```
* `LifecycleOwner` is used to process the lifecycle methods of the
object that caused this method (for example, canceling the loading
of advertising data if the user returned to the previous screen).
Adform also requires calling lifecycle methods for its View.
- Initializes the loading of ad data.
Received data is returned to `Observer`
```kotlin
fun loadAdForDefaultBanner(lifecycleOwner: LifecycleOwner, observer: Observer)
```
- Inflate View for a **"Big Banner"**, that will contain and display a
standard banner ad.
It adds the created View to the passed `parent`
```kotlin
fun inflateBigBanner(parent: ViewGroup, lifecycleOwner: LifecycleOwner)
```
* `LifecycleOwner` is used to process the lifecycle methods of the
object that caused this method (for example, canceling the loading
of advertising data if the user returned to the previous screen).
Adform also requires calling lifecycle methods for its View.
* **"Big Banner" is:**
* **Adform** is an interactive ad with a given height.
* **Leadbolt** is a native banner with a height of 300dp.
* **Inmobi** there is the implementation of native advertising
with given dimensions.
- Initializes the loading of ad data for a **"Big Banner"**.
Received data is returned to `Observer`
```kotlin
fun loadAdForBigBanner(lifecycleOwner: LifecycleOwner, observer: Observer)
```
- Initializes the display of full-screen advertising.
Full-screen advertising events are returned to
`Observer` (for example, closing ads, ending
downloads, etc.)
```kotlin
fun displayFullScreenAd(
context: Context,
lifecycleOwner: LifecycleOwner,
observer: Observer
)
```
- Returns an object of the `AdViewHolder` class that extends
`RecyclerView.ViewHolder` for further use in `RecyclerView.Adapter`.
```kotlin
fun createGridViewHolder(parent: ViewGroup): AdViewHolder
```
- Returns an object of the `AdRecyclerView.AdAdapterManager` class that
manages the list of data displayed in `RecyclerView` with the addition
of advertisements to this list
```kotlin
fun getAdAdapterManager(): AdRecyclerView.AdAdapterManager
```
- Returns an object of the `AdRecyclerView.AdAdapterManager` class,
which in turn creates a `RecyclerView.LayoutManager`, which will
manage a specific `AdProvider` implementation for displaying
advertisements in `RecyclerView`.
*For example, for __Adform__, you need to use built-in mechanisms for
displaying advertisements in `RecyclerView`, but they do not support
displaying advertisements in custom View like an item in
`GridLayoutManager`*
```kotlin
fun getAdLayoutManager(): AdRecyclerView.AdLayoutManager
```
## Payment system
For the payment system was used [Stripe](https://stripe.com/).