Guide: Add Placements For Advertising

Prerequisites

• IR SDK for Unity is installed into your Unity project.

• Experience is created on the IR platform.

• IR SDK is authenticated.

• Experience is chosen there.

Step-by-Step Integration

1. Add IR SDK Controller (if not added already)

• Add empty gameObject into the scene. You can call it "IR_SDK_Controller"

• Add Component "iR SDK Controller"

• Set Master Update Interval

2. Add iR Ad Controller into the SDK controller

3. Add placements

Go to Unity menu -> LV -> Ads -> Manage Placements

The next window will open, allowing you to add your very first placement. To do this:

1. Click the “Add New Placement” button.

2. Choose Placement Type: Select the type of placement you want to create.

3. Set Placement Size: Specify the dimensions for the placement.

4. Name Your Placement: Provide a descriptive name for easy identification.

5. Press Create Placement

Read more about placement types, ad sizes and bets practices of how to place then into your experience here.

After you pressed "Create Placement" you will see placement GameObject added to your scene hierarchy. Place it according to the best practices.

You can also see the newly created banner in the iR SDK UI.

You may notice various statuses and warning icons in the IR SDK Ads UI. This interface is designed to display the synchronization status between your project and the IR Enterprise Platform. For detailed information about each status and its meaning, refer to the IR SDK Ad Placement Statuses article. This resource will help you understand and resolve any issues related to ad placement synchronization.

4. Register placement

All newly created banners will initially display a grey icon status, indicating that the placement is new and has not yet been registered on the IR platform. To register the placement and make it available for advertising:

1. Place the Banner: Position the banner in the desired location within your experience. Ensure it is properly aligned and visually appealing for potential advertisers. Placement object settings to consider:

   1. Scale. The default Unity Transform Scale parameter is disabled for the IR SDK banner GameObject. This restriction ensures the ad object maintains its correct aspect ratio and is properly scaled or resized. Incorrect scaling could disrupt ad serving functionality. To adjust the banner’s size, use the Scale option provided in the IR Banner Ad component instead:

      
   2. Emissivity. You can apply additional visual settings for the banner to correspond more closer to the environment. This effect comes f rom the shader settings.

      
2. Take a Snapshot: Capture a snapshot of the banner in its designated location. This snapshot will serve as a visual representation of the placement on the IR Platform Explore section. To do so:

   1. Open iR SDK UI from the Unity Menu -> LV - Ads -> Manage Placements.

   2. Press on "photo" icon near the placement you'd like to register.

      

      On the Snapshot UI, you have a camera which you can locate nicely to make a snapshot. You can: - rotate - Control (Option) + Left Mouse button - zoom - Control (Option) + Scroll wheel - pan - Control (Option) + Right Mouse

   3. Press upload to upload the snapshot.

   Once it is uploaded, you'll see warning icon gone and you'll see image preview instead.

   
3. Register the Placement: The final step is to register the placement within the iR Enterprise platform. This ensures the platform recognizes and associates the placement with the newly created experience.

   

   If completed successfully, a green status will appear next to the placement in the SDK, indicating that it is properly configured. The placement will also be visible in the draft section of the IR Enterprise Monetize module for further setup and will be used to show the advertisers who may explore your experience.

   

Next Steps:

1. Check Draft Settings: Review placement settings on the IR Enterprise platform.
2. Build and Publish: Build your project and upload it for hosting on the IR Enterprise platform.
3. Check Placement Validation: Validate placements on the IR SDK platform.