Integration and onboarding FAQ's

Integration and Onboarding FAQ’s

Technical Implementation 

Setting Up Inventory 

Native Integrations 

Ad Request Behavior: 

How often do I need to send ad requests?

You need to send a single ad request in real time every time you have an open spot for an ad placement. 

How far in advance can I send an ad request from the time it will play?

You can send an ad request up to 15 minutes ahead of time of the actual ad play 

  • Example: You can send an ad request at 11am for an 11:15am spot 
How long does it take to receive an ad response?

The ad server typically responds in milliseconds. We can take up to 60 seconds to timeout on an ad request. 

How many creatives are in an ad response?

The ad server returns a single creative in every ad response. 

How long do I have to hit the PoP URL?

You have 15 minutes from the display time passed in the ad request to hit the PoP URL.

When can I hit the PoP?
  • 1 to many impressions - You can only hit the PoP URL after 75% of the ad is displayed. We prefer the logic to be at 100% completion. 
  • 1 to 1 impressions (Interactive Inventory) - According to IAB measurement guidelines, both static and video ads count as an impression as soon as the ad begins to render on a screen. Therefore you are allowed to hit the PoP url after the creative has been on the screen for 2 seconds. 
    • Types of 1 to 1 Inventory:
      • Work Out Equipment 
      • Tablets
      • Interactive kiosks 
Why do I have to hit the expiration URL if I can't play an ad?

This allows the ad to be leased out to another requesting screen to help ensure the campaign delivers in full. 

What happens if I don’t hit the PoP or the expiration URL?

The PoP and expiration URL becomes invalid after 15 minutes from the indicated display time in the ad request. 

Should I pass lat/long in an ad request?
  • If your inventory is static (does not move), do not pass a lat/long. A lat/long is associated with your venues in the trafficking UI and Vistar uses that data for geo targeting purposes. 
    • Examples of static inventory: Billboard, charging station, bar screen 
  • If your inventory is moving you have to pass a lat/long in the ad request so our ad server knows the location of the screen when requesting.  
    • Examples of moving inventory: Taxis and rideshares. 
What if I play the ad at a different time than indicated in the ad request?

You can append the display time at the end of the PoP URL string. 

I’m plugged into multiple SSP’s, is that an issue?

You can plug into as many SSP’s as you would like. We expect you to implement waterfall logic for your SSP integrations. We do not allow you to host a secondary auction. 

Creatives and Creative Caching: 

What caching logic should I implement?
  • We recommend making a call to the Vistar creative caching endpoint once a day.
  • We recommend using the creative ID metadata to identify new creatives and map creatives from the ad response to the pool of cached creatives. 
  • If you receive a creative that is not already cached, we highly recommend you download the creative in real time and add to the pool of cached creatives. 
  • You can delete a creative if it’s not used for 30 days. 
What creatives are returned from the caching API?
  • Creatives qualify to be returned if all of the below requirements are met:
  • Approved in the trafficking UI
  • Targeting your inventory 
  • Campaign is live or will be live within 30 hours 
How many creatives run at a time?

This depends on the level of demand targeting your inventory. 

How large are creatives?

Creative files range in size depending on the file type (jeg, png, mp4, etc.) For more detail, see “how much storage should I allocate for creative caching” at the bottom of our creative caching endpoint KB article. 

What’s the duration of the creatives?
  • You determine how long static creatives are displayed for. 
  • You also determine what video duration(s) you support. The average video durations buyers upload are 15 and 30 seconds. 
How long do creatives run for?

This varies campaign to campaign. Some campaigns only run for 3 days while others run for a quarter or longer. 

How are my creative specs shown to buyers?

Vistar pulls creative specs from the ad request and populates that data to our DSP so buyers know what creatives they must upload in order to run on your inventory. 

Can I run multiple ads on the screen at once?
  • We do not allow partners to run multiple ads at once. Buyers purchase ad space through Vistar assuming they are the only advertiser on the screen. We also do not want competitive ads displayed at once. Example: Pepsi and Coca-Cola 
  • We do allow partners to have multi-zone screens if the other content on the screen is not ad related. Example: Weather, traffic, news, etc. 

Broadsign Integrations 

Does the Broadsign URL cache creatives?

Unfortunately we are unable to cache creatives. The creative is downloaded in real time.

What happens if the ad server returns no ads?

The web redirect skips the spot to avoid a black screen. 

Can I only schedule the web redirect when I receive a creative(s) for approval?

No - We need you to actively request in order to show avails on the DSP side. If you are not sending us requests we assume your inventory is sold out and limit avails for buyers to purchase. 

Ayuda Integrations 

Does the Ayuda HTML5 asset cache creatives?

We support creative caching using an FTP server but it is not a requirement. 

What happens if the ad server returns no ads?

The HTML5 asset skips the spot to avoid a black screen. 

Can I only schedule the HTML5 asset when I receive a creative for approval?

No - We need you to actively request in order to show avails on the DSP side. If you are not sending us requests we assume your inventory is sold out and limit avails for buyers to purchase. 

Network & Venue Management: 

What if I cannot play certain types of creatives? Example: alcohol ads

We support category restrictions at the network and venue level. You indicate what creative categories you cannot play and the ad server will block any creative in that category from running on your screens. 

What if I cannot play certain advertisements? Example: Coca-cola brand

We support advertiser restrictions at the network and venue level. You indicate what creative advertisers you cannot play and the ad server will block any creative with that advertiser from running on your screens. 

What impression data do you support?

We allow you to upload impression data that is sourced from a third party impression body. For a full list of approved impression audit companies, see here

What if I did not receive a third party impression audit?

Vistar is willing to review first party impression data. If approved, you can upload your first party impression data. If not approved, your inventory will be set up with a 1 to 1 impression multiplier. 

Buyer Behavior:

How do buyers purchase my inventory?

Buyers can purchase your inventory through Private marketplace deals (PMP) or open exchange campaigns. Buyers create campaigns using our DSP or a 3rd party DSP that Vistar is integrated with. The buyers apply targeting to see what venues qualify and are available for purchase. 

What media owner data do buyers see in the DSP?

Buyers can see your account name, network name and venue names. If you wish to be non-transparent we can change your display name so buyers are not aware of the media owner they are targeting. Buyers prefer to purchase transparent inventory so being non-transparent can affect revenue potential. 

How do buyers know what creative sizes to upload?

Vistar pulls creative specs from ad requests into our DSP. This tells buyers what creatives they must upload in order to run on your inventory. 

Training and Onboarding 

How long does it take to onboard?

Typically it takes 6-8 weeks to onboard. However this is dependent on how quickly you can provide Vistar with data and resources to launch the integration. 

What are the requirements to go live on the Vistar SSP?
  • You must meet our integration health requirements:
    • 90%+ spend rate 
    • Valid request volume
    • Approved integration logic (Native integrations only)
  • You must provide the requested data:
    • Billing information 
    • Media owner profile 
    • Onboarding form 
    • Impression data 
When do I receive training?

Once your network is activated, you receive training. If you are a SaaS partner, training may be conducted during onboarding to help transition direct campaigns over to the Vistar trafficking UI.

When do I get paid?

We process payments every 2 weeks. We perform account reconciliations throughout the month but based on the timing of funds received and sequential liability, we issue payments. As soon as we collect the funds from the demand side, they are included on the next payment cycle. 

 

Was this article helpful?
1 out of 1 found this helpful