# Unity Intrinsic ads Integration

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

{% 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 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** – if Landscape 1.55, if portrait 0.67
* **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
* **Shrink To Fit** – When enabled, automatically adjusts the object’s scale to match the ad’s aspect ratio (we encourage to keep this on)

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. <mark style="background-color:red;">(!)</mark> 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**](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, please contact your Development 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/intrinsic-in-game-ads/unity-intrinsic-ads-integration.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.