> For the complete documentation index, see [llms.txt](https://wiki.playgama.com/playgama/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.playgama.com/playgama/guides/monetization/intrinsic-ads/unity.md).

# 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.

{% file src="/files/JHBtufo2pHHWNBfODvJy" %}

**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. <mark style="background-color:red;">(!)</mark> 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**](https://developer.playgama.com/) to test real ads in a live environment.

<mark style="background-color:red;">(!)</mark> <mark style="background-color:red;">After uploading the updated build, contact your Developer Success Manager to enable live ads for your game.</mark>