AdMob Android

From POKKT DOCUMENTATION
Jump to: navigation, search

AdMob Pokkt Mediation

Last Update: 4th June, 2018


Pokkt SDK version used: - 7.2.0

AdMob SDK version used: - 11.8.0 (GDPR Compliance)


Download Latest Version Pokkt Mediation.


  1. Common Steps for AdMob Pokkt Mediation:This is common documentation which is useful for all plugin.
  2. Native Integration:Check the Steps Mentioned for Native.
  3. Xamarin Integration:Check the Steps Mentioned for Xamarin.
  4. AIR Integration:Check the Steps Mentioned for AIR.
  5. Marmalade Integration:Check the Steps Mentioned for Marmalade.
  6. ShiVa Integration:There is no separate documentation for this. Please follow “Common AdMob Pokkt Mediation” page.
  7. Cocos2d-x Integration:There is no separate documentation for this. Please follow “Common AdMob Pokkt Mediation” page.
  8. Unity3D Integration:There is no separate documentation for this. Please follow “Common AdMob Pokkt Mediation” page.
  9. Titanium Integration:There is no separate documentation for this. Please follow “Common AdMob Pokkt Mediation” page.

Common Steps for AdMob Pokkt Mediation

Prerequisites


Step 1: Configure Pokkt Dashboard

  • Create Account and login at http://www.pokkt.com
  • Register your app here if not registered.
  • To use the AdMob Mediation please enter the following details on Pokkt Dashboard:

    Admob config n.jpg


  • Class Name (required): This is the class name that you define inside your application to set up the network. Classname for the network can be set during SDK integration. If you are using Pokkt’s default adaptors for mediation which is given in PokktMediation.jar, then class name will be com.pokkt.thirdparty.AdMobNetwork.
  • Test Device Id (optional): For testing AdMob and if you want to see test ad for interstitial then please provide test divide Id. You can add multiple device Id with comma (,) separated without any space.
  • ECPM: Put your expected value of ECPM which will in turn rank this network in comparison to other configured networks.
  • Screens (required): Here need to provide "AdMob Ad unit ID". First create screen name in Pokkt dashboard which will reflect here as screen name so provide “Ad unit ID’here. Now for getting “Ad unit ID”from AdMob, create new monetize app in AdMob dashboard and open that app then there is a option “New Ad Unit”. So create new ad unit which will generate Ad unit ID and that Ad unit ID you need to provide here. This screen name will map with this Ad unit ID. Please check below screen shot for how to create screen in Pokkt dashboard.

    Screen.jpg

  • Reporting (required): Enter publisher id, client id, client secret and Refresh token. You can get it from your AdMob account manager. Please follow https://developers.google.com/adwords/api/docs/guides/authentication for details.


Note: For More Detail, Please follow the below link

https://support.google.com/admob/answer/3052638

  • Publisher Id (For Reporting): This is AdMob publisher Id. Once you create AdMob account, in right top corner you will see this publisher id.
  • Client Id, Client secret and Refresh token (For Reporting): Please follow the below process
    1. Open the Google API Console Credentials page.
    2. From the project drop-down, select an existing project or create a new one.
    3. On the Credentials page, select Create credentials, then select OAuth client ID.
    4. Under Application type, choose Web application.
    5. Under Authorized redirect URIs, add a line with: https://developers.google.com/oauthplayground
    6. Click Create.
    7. Take note of the client ID and client secret. Same you need to provide here.

Refresh Token:

  1. Go to the OAuth2 Playground via this link, which should pre-populate some key values for you.
  2. Click the gear icon in the upper right corner and check the box labeled Use your own OAuth credentials (if it isn't already checked).
  3. Enter the OAuth2 client ID and OAuth2 client secret you obtained above.

    Admob oauth config.jpg

  4. In the section labeled Step 1 - Select & authorize APIs, enter the following URL in
  5. the text box at the bottom, if it's not already there, then click Authorize APIs:
    https://www.googleapis.com/auth/adsense.readonly

    Admob oauth step1.jpg

  6. If prompted, log in to the account to which you want to grant access and authorization. Otherwise, confirm that the current Google user in the top right corner is the AdWords or manager account for whom you want to obtain credentials.
  7. A prompt appears indicating your app would like to Manage your AdWords Campaigns. Click Accept to continue.
  8. In the tab labeled Step 2 - Exchange authorization code for tokens, you should now see an Authorization code. Click Exchange authorization code for tokens

    Admob oauth step2.jpg

  9. If all goes well, you should see the Refresh token and Access token filled in for you (you may have to re-expand Step 2 - Exchange authorization code for tokens to see these values).

    Admob oauth step2 a.jpg

  10. Copy the Refresh token into the configuration file for your client library of choice, along with the client ID and client secret. See the instructions above to set configuration options for your client library of choice.

Notes:

  1. If you got your client ID and secret only a few minutes ago, and you get an error such as Error: redirect_uri_mismatch, it's possible the changes you made haven't yet propagated. Click the back button in your browser, wait a few minutes, then try clicking Authorize APIs again.
  2. You need to enable AdSense API so please go to AdSense Management API and enable this.

For more details about AdMob reporting, please see AdMob reporting documentation:


Step 2: Configuration in Application (Native)

  • Download the mediation project from POKKT and it is suggested to use the same class file AdMobNetwork(AdMobNetwork.java, AdMobVideoAdManager.java, AdMobBannerManager.java and AdMobInterstitialManager.java) in your project. You have the option to make changes to these classes, in-fact you can create your own custom adaptor for AdMob using our protocol, just make sure to mention the exact name of class in the “class name” box, refer the Step 1.
  • Add “Google play services ads framework” into your project. Make sure to update your project's dependencies accordingly.
  • Add the necessary permissions for AdMob as suggested in AdMob integration document to your application manifest.
  • Add the recommended activitiesand meta datato your AndroidManifest.xmlas suggested in AdMob integration guide.

Xamarin Android

Follow the below steps to integrate Mediation in Xamarin android project:

  1. Add downloaded file PokktMediation.dllin your project under reference section.
  2. You need to download AdMob extension for Xamarin.
  3. Follow above all process to complete integration.

AIR Android

Follow the below steps to integrate Mediation in AIR android project:

  1. Add downloaded file PokktMediation.anein your project
  2. You need AdMob so please google to download AdMob .ane file and and use that.
  3. Google play service .ane file also required and few of the AdNetwork .ane comes with google play service .ane so be careful with this. We are giving PokktMediation.ane separate GooglePlayService.ANE separate.
  4. Follow above all process to complete integration and also check our given example specially app.xml file.

Marmalade Android

Follow the below steps to integrate Mediation in Marmalade android project:

  1. Check downloaded file which has one mediation project “PokktMediationExtension” and this need to be added in your project as subproject in .mkb file.
  2. Marmalade is providing AdMob extension “s3eGoogleAdMob” so add this as subproject in .mkb file.
  3. Follow above all process to complete integration and also check our given example.