Unity

Step-by-step intrinsic ads integration guide for Unity

Integrating the 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.

2MB

PlaygamaBridgeIntrinsicAds.unitypackage

Open

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 Developer Success team.

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.

The DemoAds scene contains preconfigured ad components, including clickable 3D, non-clickable 3D, click-and-hold 3D, double-click 3D, UI, and sprite placements.

Open IntrinsicAdsPlaygama → Demo → DemoAds to see ready-made 3D and 2D ad placements. You can drag them into your scene and adjust or disable the parts you do not 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 – Use 1.55 for landscape placements and 0.67 for portrait placements.

• Allow Image – Enable if image ads are allowed.

• Allow Video – Enable if video ads are allowed.

• Is Dynamic – Enable if the ad content should change dynamically.

• Is Clickable – Enable to allow ad interaction.

• Shrink To Fit – Automatically adjusts the object's scale to match the ad aspect ratio.

To improve fill rate and placement performance, enable both image and video formats. This increases the number of eligible demand sources. Also, make the placement clickable to support full ad interaction.

If your UI layout allows it, enable Shrink To Fit so ad creatives adapt to the placement size and remain viewable. (!) Be careful with this option: when it is enabled, the ad size can change, which may make the placement 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, contact your Developer Success Manager to enable live ads for your game.