Integration guide

Welcome to the HighVibes Media integration guide! This document provides a step-by-step approach to integrating our platform into your webpage. We offer two integration options: a basic integration and an integration for Google Ad Manager.

This guide will walk you through both, explaining what each attribute does, and how to ensure the integration works perfectly for your needs.

Standard Integration Script
Google Ad Manager Integration Script
Explanation of Attributes
Prebid Integration
Sample Scripts

Integration Scripts

Standard integration

To integrate HighVibes Media into your website, simply add the following script tag to your webpage:

<script
  async
  id="hvm-integration"
  src="https://static.highvibes.media/libs/hia/hvm-integration.js"
  data-tagid="xxxxxxx"
></script>

Steps to Implement:

Place this <script> tag in the <head> or <body> section of your webpage.
Replace the value of the data-tagid attribute with the unique Tag ID provided to you by HighVibes Media.
See Explanation of Attributes for additional script attributes

Google Ad Manager integration

For integration with Google Ad Manager, use the following script:

<script
  async
  id="hvm-integration"
  src="https://static.highvibes.media/libs/hia/hvm-integration.js"
  data-gc="%%CLICK_URL_UNESC%%"
  data-gi="%%VIEW_URL_UNESC%%"
  data-tagid="xxxxxxx"
></script>

Steps to implement:

Place this <script> tag in the <head> or <body> section of your webpage.
Replace the data-tagid with your unique Tag ID.
The data-gc and data-gi attributes are Google Ad Manager macros. These will automatically be replaced by the correct URLs for tracking clicks and impressions when the script runs.
See Explanation of Attributes for additional script attributes

By using this script, Google Ad Manager will correctly track clicks and impressions, ensuring proper reporting for your ads.

Setup requirements

To ensure the successful operation of the HighVibes Media integration script, please ensure the following conditions are met:

Avoid secure frames and safeframes

The integration script must not be placed in a secure frame or safeframe. These environments impose restrictions that prevent the script from executing correctly, leading to issues such as:
- Inability to fetch or render ads correctly.
- Restricted communication between the script and the webpage.
- Blocked access to necessary tracking and analytics functionality.
Script placement

The script can be placed in the <head> or <body> section where you desire.
Only one integration script per page

HighVibes Media supports only one integration script per website.
Only use IDs provided by HighVibes Media

IDs and placement names corresponds to your account in HighVibes Media.

Attributes

Attribute	Description
data-tagid	Holds your Placement ID in HighVibes Media platform.
data-targetid	Corresponds to the DIV tag appended to the page where the creative scripts will be loaded.
data-gc	(GAM only) A macro used for tracking clicks on ads. When the script runs, this macro is replaced with the correct URL by Google Ad Manager.
data-gi	(GAM only) A macro used for tracking ad impressions (views). It gets replaced with the correct URL for tracking views.

Prebid integration

We support being added as a bidder in your existing Prebid setup. Use the configuration snippet below to include us as a bidder.

Configuration Example:

{
  "bidder": "appnexus",
  "params": {
    "member": 16496,
    "placementId": "xxxxxxx",
    "usePaymentRule": false
  }
}

Requirements:

Include AppNexus Bidder Adapter:
- Ensure the AppNexus bidder adapter is included in your Prebid library build.
- You can check Prebid’s documentation to verify the adapter is enabled in your configuration.
Adapter Info: https://docs.prebid.org/dev-docs/bidders/appnexus.html
Size Agreement:
- Ensure that our bid profile is included for the banner sizes we support or have agreed upon with your team. For instance, if we support 300x250 and 320x50, these sizes should be explicitly configured in your ad unit setup.

Sample scripts

Please only use scripts and IDs provided by HighVibes Media.

Custom placement name

Use the data-targetid attribute to add the custom placement name. Only run 1 integration script on your page

<script
  async
  id="hvm-integration"
  src="https://static.highvibes.media/libs/hia/hvm-integration.js"
  data-tagid="xxxxxxx"
  data-targetid="hvm_floorad_mobile"
></script>