Record ad impression events
Record when players view ads in your game to track ad revenue and measure advertising performance.
Read time 2 minutesLast updated 9 months ago
Use the event to track what happens when you show an ad to a player.
adImpressionThe event is a standard event with a predefined schema you must match to process and track the event. A special object is provided by the Analytics SDK to help you fulfil the schema when recording an ad impression.
adImpressionAdImpressionParametersUse the following code to record a minimal event:
adImpressionpublic void RecordAdImpression(){ AdImpressionEvent adImpression = new AdImpressionEvent { AdProvider = AdProvider.UnityAds, AdCompletionStatus = AdCompletionStatus.Completed, AdEcpmUsd = 12.34, AdStoreDestinationId = "CoolStore1337", PlacementId = "PLACEMENTID", PlacementName = "PLACEMENTNAME", PlacementType = AdPlacementType.BANNER }; AnalyticsService.Instance.RecordEvent(adImpression);}
Some of these fields need to be populated with values that come from your ad mediation SDK, while others are specific to your game. See the breakdown:
Property | Description |
|---|---|
| The ad network name or ID that served the ad, for example, UNITY, IRONSOURCE. This value is often passed on a per-impression level by your mediation provider or ad network. You might need to map it to a value in the |
| If the user watched the entire ad ( |
| eCPM ("effective Cost Per Mille": the revenue generated by 1000 impressions) in US Dollars. This value is often passed on a per-impression level by your mediation provider or ad network and used in ad LTV calculations. Populate this value if possible. |
| The store the player is directed to after cliking the ad, for example, Google Play, App Store, Amazon. |
| The unique identifier for the placement as integrated in the game. |
| The name of the placement as integrated in the game, for example, "Boosters" or "Daily Reward". This correlates with the placement name configured in your ad network or mediation provider. |
| Indicates what type of ad is shown, for example, |
The object contains a number of other fields that are less important, which you can also populate if you want and have the data available.
AdImpressionEvent