Unity Intrinsic ads Integration
Step-by-step Intrinsic ads integration guide for Unity
Integrating Anzu SDK into Your Unity Game
1. Import the SDK
To integrate Intrinsic Ads into your Unity game using the Anzu SDK, start by importing the SDK package:
In Unity, go to Assets → Import Package → Custom Package...
Select and import the PlaygamaBridgeIntrinsicAds package.
Once imported, navigate to Assets/Anzu/Prefabs/Extras and drag the AnzuSDK prefab into your scene.
2. Configure the Anzu SDK
Select the AnzuSDK prefab in your scene. In the Anzu SDK component, you’ll find an App Key field.
Enter the App Key provided by the Playgama Dev Success team to ensure the SDK functions correctly.
At this point, the SDK is successfully integrated into your project.
3. Adding Intrinsic Ads
Intrinsic ads can be displayed on 3D objects (with materials) or UI elements.
To add an ad to a 3D object, follow these steps:
Create a 3D object in your scene: GameObject → 3D Object → Plane
Make sure your object has Mesh Renderer and Mesh Filter components.
Add the Anzu Ad component to the newly created Plane.
In DemoAds scene you can see pre-configured ad components (clickable 3d, non clickable 3d, click and hold 3d, Double Click 3d, UI, Sprite).
Go to IntrinsicAdsPlaygama->Demo folder and open DemoAds scene, on the scene you can see pre-configured 3d and 2d ads, that you can just drag and drop into your scene and ads will be correctly loaded inside of the frames!
Feel free to edit and disable part you don't need.
4. Configure the Anzu Ad Component
In the Anzu Ad script, configure the following settings:
Channel Name – Defines the ad load channel (e.g., Level1, Level1-Part2, etc.)
Aspect Ratio – Sets the aspect ratio of the ad (refer to standard creative sizes used in the ad industry)
Allow Image – Enable if image ads are allowed
Allow Video – Enable if video ads are allowed
Is Dynamic – Enable if the ad content should dynamically change
Is Clickable – Enable if the ad should be interactive (users can click to open it)
Shrink To Fit – When enabled, automatically adjusts the object’s scale to match the ad’s aspect ratio
To improve fill rate and overall performance of the intrinsic ad placement, we recommend enabling both Image and Video formats, as this increases the number of eligible demand sources. Additionally, make the placement clickable to support full ad interaction.
If your UI layout allows it, we also suggest enabling the Shrink To Fit option to ensure that ad creatives adapt smoothly to the placement size and remain viewable. (!) Please be cautious about Shrink To Fit checkbox, if it's enabled the ads size can change and can make harder to fit into your scene.
5. Placing and Testing the Ad
Position your ad object in the scene or within a prefab where you want the ad to appear. If you see a black and white logo in the editor, it means the placeholder ad has been loaded successfully — your setup is correct.
Finally, build your project and upload it to Playgama Developer Dashboard to test real ads in a live environment.
(!) After uploading the updated build, please contact your Development Success Manager to enable live ads for your game.
Last updated