# GoogleMobileAds.Api.AppOpenAd

App open ads are used to display ads when users launch your app.

## Summary

Unlike interstitial ads, app open ads make it easy to provide app branding so that users understand the context in which they see the ad.

| ### Events ||
|---|---|
| `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad_1af070de00539360967ea971adee3d408e` | `Action` Raised when a click is recorded for an ad. |
| `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad_1aab8128c181a09e16d89b52dc2c4a51fd` | `Action` Raised when the ad closed full-screen content. |
| `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad_1ae4b1513915377b9c6382db3f1eb31a96` | `Action< https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/ad-error#class_google_mobile_ads_1_1_api_1_1_ad_error >` Raised when the ad failed to open full-screen content. |
| `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad_1aac7f7096da949d57c82a3e3c6aa47115` | `Action` Raised when an ad opened full-screen content. |
| `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad_1aa5f7a0ae1e03790ee5b5a9e9ab96464c` | `Action` Raised when an impression is recorded for an ad. |
| `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad_1a2ffa5a5771ce116dd11db01724e71217` | `Action< https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/ad-value#class_google_mobile_ads_1_1_api_1_1_ad_value >` Raised when the ad is estimated to have earned money. |

| ### Properties ||
|---|---|
| `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad_1ab6d39eec7dd42e449bb2a710e0bdcc93` | `long` A long integer provided by the AdMob UI for the configured placement. |

| ### Public static functions ||
|---|---|
| `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad_1a7873ce9daec8a965ea20d38b0574a24b(string adUnitId)` | `bool` Verify if an ad is preloaded and available to show. |
| `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad_1a02249eb8b39eeb453df84d7bbb73b7c8(string adUnitId, https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/ad-request#class_google_mobile_ads_1_1_api_1_1_ad_request request, Action< https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad, https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/load-ad-error#class_google_mobile_ads_1_1_api_1_1_load_ad_error > adLoadCallback)` | `void` Loads an app open ad. |
| `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad_1a5937c18add95aebe64a66f11cab51c37(string adUnitId)` | `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad` Returns the next pre-loaded app open ad and null if no ad is available. |

| ### Public functions ||
|---|---|
| `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad_1aa979417c717361ad1a0a2c70591b663b()` | `bool` Returns true if the ad is loaded and not shown. |
| `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad_1ae41d2767f226d9193ad359963936d64b()` | `void` Destroys the ad. |
| `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad_1a0635b4a23dce2a727fce95a2fb463162()` | `string` Returns the ad unit ID. |
| `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad_1a5558d41770a2a98d3fb4e199605b1317()` | `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/response-info#class_google_mobile_ads_1_1_api_1_1_response_info` Returns the ad request response info. |
| `https://developers.google.com/admob/unity/reference/class/google-mobile-ads/api/app-open-ad#class_google_mobile_ads_1_1_api_1_1_app_open_ad_1afcea60d40599a90bebae3d08e20e9a56()` | `void` Shows an app open ad. |

## Events

### OnAdClicked

```c#
Action OnAdClicked
```
Raised when a click is recorded for an ad.

### OnAdFullScreenContentClosed

```c#
Action OnAdFullScreenContentClosed
```
Raised when the ad closed full-screen content.

On iOS, this event is only raised when an ad opens an overlay, not when opening a new application such as Safari or the App Store.

### OnAdFullScreenContentFailed

```c#
Action< AdError > OnAdFullScreenContentFailed
```
Raised when the ad failed to open full-screen content.

### OnAdFullScreenContentOpened

```c#
Action OnAdFullScreenContentOpened
```
Raised when an ad opened full-screen content.

### OnAdImpressionRecorded

```c#
Action OnAdImpressionRecorded
```
Raised when an impression is recorded for an ad.

### OnAdPaid

```c#
Action< AdValue > OnAdPaid
```
Raised when the ad is estimated to have earned money.

## Properties

### PlacementId

```c#
long PlacementId
```
A long integer provided by the AdMob UI for the configured placement.

To ensure this placement ID is included in reporting, set a value before showing the ad.

## Public static functions

### IsAdAvailable

```c#
bool IsAdAvailable(
  string adUnitId
)
```
Verify if an ad is preloaded and available to show.

<br />

Details Parameters `adUnitId` The ad Unit Id of the ad to verify.

### Load

```c#
void Load(
  string adUnitId,
  AdRequest request,
  Action< AppOpenAd, LoadAdError > adLoadCallback
)
```
Loads an app open ad.

### PollAd

```c#
AppOpenAd PollAd(
  string adUnitId
)
```
Returns the next pre-loaded app open ad and null if no ad is available.

<br />

Details Parameters `adUnitId` The ad Unit ID of the ad to poll.

## Public functions

### CanShowAd

```c#
bool CanShowAd()
```
Returns true if the ad is loaded and not shown.

### Destroy

```c#
void Destroy()
```
Destroys the ad.

### GetAdUnitID

```c#
string GetAdUnitID()
```
Returns the ad unit ID.

### GetResponseInfo

```c#
ResponseInfo GetResponseInfo()
```
Returns the ad request response info.

### Show

```c#
void Show()
```
Shows an app open ad.