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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.playgama.com/playgama/guides/monetization/intrinsic-ads/unity.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.