Skip to content

How to Schedule Lucit Campaigns in Place Exchange

Integration Overview

Lucit integrates with Place Exchange (PX) as a dynamic creative provider for programmatic OOH campaigns. The core of the integration is a Deal ID link connecting a PX programmatic deal to a Lucit campaign. When a DSP wins a bid for one of those deals, PX replaces the placeholder creative with a Lucit-generated dynamic HTML ad tag, pulling the current creative in real time.

The high-level flow:

  1. Client loads a placeholder (JPEG) creative (CRID) into their DSP for each ad size.
  2. Lucit generates HTML ad tags and fills in the PX tag sheet.
  3. PX AdOps side-loads the Lucit tags against those CRIDs.
  4. At bid time, when the DSP wins, PX substitutes the Lucit tag for the JPEG and serves dynamic content.
  5. PX reports impressions to both Lucit and the DSP.

Prerequisites

Before starting, ensure you have:

✅ Place Exchange App added to your Lucit account — see Adding the Place Exchange App below
✅ Published Lucit Campaign with at least one screen configured — see the Campaign Page Navigation Guide if you need help navigating the campaign page
✅ Place Exchange Deal IDs (GUID format) from your PX account rep
✅ Ad Unit IDs imported into Lucit (done during campaign setup — see Ad Unit IDs)
✅ API Token from Lucit Account Settings
✅ DSP Access to traffic placeholder creatives and complete the tag sheet

Adding the Place Exchange App

If you do not see a Place Exchange tab inside Link Player, you first need to add the Place Exchange application to your Lucit account.

  1. Log in to Lucit and switch to your Account profile using the Profile Switcher.
  2. Click Apps & Data in the left sidebar.
  3. Find Place Exchange and add it to your account.

For full instructions see the Place Exchange App Reference.

Ad Unit IDs

Every Lucit screen is linked to a Place Exchange screen via its Ad Unit ID. These Ad Unit IDs are imported into Lucit during campaign setup — typically by Lucit or your account representative when the campaign is being configured. You do not need to enter these manually.

Lucit Configuration

All Place Exchange configuration lives in the Link Player dialog for a Lucit campaign.

  1. Open your published Lucit campaign (see the Campaign Page Navigation Guide for an overview of the campaign page).
  2. Click the ⋯ (3-dots) icon in the top-right and select Link Player.
  3. Select the Place Exchange tab.

The Place Exchange tab has three sub-tabs: Deals, Ad Tags, and Ad HTML (Legacy).

Deals Tab — Linking Deal IDs

Deal IDs are the primary way PX communicates with Lucit. A Deal ID is a GUID that identifies a specific programmatic deal in Place Exchange, for example:

123e4567-e89b-12d3-a456-426614174000

You must request your list of Deal IDs from your Place Exchange account rep. PX typically sends these in a spreadsheet with columns like: Deal ID, Deal Name, Deal Token, Organization Name.

To link a Deal ID:

  1. In the Deals tab, click Add.
  2. Enter the Deal ID (GUID).
  3. Repeat for every Deal ID that should be associated with this campaign.

Important: A Deal ID can only be attached to a single Lucit campaign. Duplicates are not allowed.

A single Lucit campaign can have multiple Deal IDs linked to it, which is the normal setup when a campaign spans multiple PX deals or inventory sources.

Ad Tags Tab — Generating Creative Markup

The Ad Tags tab is where you configure and generate the HTML creative markup (ad tags) that you will provide to the PX team on the tag sheet.

Configuration Fields

Field Description
Geographic Specificity Controls the geographic level at which creative snapshots are cached and reused. Options: None, Screen / AdUnit, Lat Lon, Zip, City, DMA, Region, Country. For most campaigns, City or DMA is a reasonable default.
Refresh Rate Controls how frequently PX re-pulls the creative to get an updated snapshot. Set based on how often your creative content changes.
3P Impression Tracking Tag Select an existing third-party impression tracker or click Add New to create one. Only needed if your DSP (e.g. Google DV360) requires a separate impression pixel per CRID.

Generating the Tag

Once configured, the Generated Ad Tag HTML Markup field displays the complete <iframe> tag to use. Click Copy to Clipboard to copy it.

Ad HTML (Legacy) Tab

⚠️ Do not use this tab. It is a legacy interface and should be ignored for all new campaigns.

The Tag Sheet Process

The tag sheet is a collaborative spreadsheet used to get Lucit's dynamic HTML tags into Place Exchange. Here is the end-to-end process:

Step 1 — PX Creates the CRID Spreadsheet

Place Exchange creates and sends a tag sheet to the Agency / Client with the following columns:

Column Owner Description
A Agency DSP Creative ID (CRID)
B Agency Ad Size
C Agency 3P Impression Tag (if applicable)
D Lucit Creative Markup (the Lucit ad tag)

Step 2 — Client Fills Out Columns A, B, C

The agency fills in the DSP Creative IDs, ad sizes, and any third-party impression tracking tags. One CRID is needed per ad size (not per creative idea — see Limitations).

The client also traffics a placeholder JPEG creative in the DSP for each CRID at this stage, but does not activate the campaign yet.

Step 3 — Client Sends Sheet to Lucit

The client shares the tag sheet with Lucit (include Lucit on the email / share).

Step 4 — Lucit Fills Out Column D

Lucit uses the Ad Tags tab in Link Player to generate the HTML markup for each CRID/size combination and fills in column D.

Example tag — without 3P impression tracker:

<!-- AD CONFIGURATION
        ENABLE_DYNAMIC_CREATIVE=True
        DYNAMIC_CONFIG_GEOGRAPHIC_SPECIFICITY=CITY
        DYNAMIC_CONFIG_GEOGRAPHIC_PRECISION=0
        DYNAMIC_CONFIG_REFRESH_RATE_IN_SECONDS=10800
-->
<!--LUCIT:Campaign Name|Image Media;a:lch-XXXX;e:lch-XXXX;3p:-->
<iframe src="https://backbone-proxy-1.lcdevops.com/api/v1/campaigns/px/$!{CAMPAIGN_ID}/pull/$!{ADUNIT_ID}/bundle?rendered_on_play=$!{RENDERED_ON_PLAY}&snapshot_hash=$!{SNAPSHOT_HASH}&silent_fail=1&api_token=YOUR_API_TOKEN&timestamp=$!{PLAY_START}&impressions=$!{IMP_X}&3p_tag_id=&3p_tag_fire_method=once" style="width:100%; height:100%; border: none;"></iframe>

Example tag — with 3P impression tracker:

<!-- AD CONFIGURATION
        ENABLE_DYNAMIC_CREATIVE=True
        DYNAMIC_CONFIG_GEOGRAPHIC_SPECIFICITY=CITY
        DYNAMIC_CONFIG_GEOGRAPHIC_PRECISION=0
        DYNAMIC_CONFIG_REFRESH_RATE_IN_SECONDS=10800
-->
<!--LUCIT:Campaign Name|Image Media;a:lch-XXXX;e:lch-XXXX;3p:my-impression-tracker-id-->
<iframe src="https://backbone-proxy-1.lcdevops.com/api/v1/campaigns/px/$!{CAMPAIGN_ID}/pull/$!{ADUNIT_ID}/bundle?rendered_on_play=$!{RENDERED_ON_PLAY}&snapshot_hash=$!{SNAPSHOT_HASH}&silent_fail=1&api_token=YOUR_API_TOKEN&timestamp=$!{PLAY_START}&impressions=$!{IMP_X}&3p_tag_id=my-impression-tracker-id&3p_tag_fire_method=once" style="width:100%; height:100%; border: none;"></iframe>

The PX macros ($!{CAMPAIGN_ID}, $!{ADUNIT_ID}, etc.) are filled in automatically by Place Exchange at serve time.

Step 5 — Lucit Sends the Completed Sheet to PX

Lucit returns the completed tag sheet to the Place Exchange AdOps team.

Step 6 — PX Side-Loads the Lucit Tags

The PX AdOps team creates ads in Place Exchange using the DSP CRIDs and associates the Lucit tags with each one. When a DSP bid wins for a CRID, PX substitutes the Lucit dynamic HTML tag for the placeholder JPEG and serves the dynamic creative.

How Creative Delivery Works

Once live, the delivery flow on each impression is:

  1. DSP bids using a CRID
  2. DSP wins the bid
  3. PX replaces the placeholder JPEG for that CRID with the Lucit dynamic HTML tag
  4. PX snapshots the dynamic ad and caches it for the configured refresh duration, then serves it
  5. PX reports plays and impressions to both Lucit and the DSP

Lucit returns the correct creative for the screen's ad size, based on the campaign's weighting configuration.

Creative Targeting Capabilities

Lucit can target and customize creative output based on a wide range of signals.

Location-Based Targeting

Creative can be filtered or personalized based on screen-level location data:

  • Screen Name, Media Owner Name, Venue Taxonomy ID
  • Screen Format, Screen City, Screen State/Province, Postal Code
  • DMA Code (US), Screen Country
  • Screen Timezone and Timezone Offset
  • Screen Latitude/Longitude
  • Screen Tags

Dynamic Data Source Targeting

For any data source that generates data per location (or globally), Lucit can ingest it and use it to drive creative content or targeting. Examples:

  • Weather — temperature, conditions, forecasts at the screen's location
  • Air Quality — AQI data (e.g. AirNow API)
  • Retail Proximity — distance to nearest store location
  • Live Scores / Sports Data — game scores, odds, standings
  • Custom Spreadsheet / CSV — any data tied to lat/lon or screen area

Lucit accepts data in essentially any format: REST API (authenticated or not), JSON, XML, Google Sheets, CSV, FTP, and more. Data can be ingested on a configurable schedule (minimum every 30 minutes is recommended).

Limitations & Considerations

Creative Weighting and Rotation

  • The DSP controls budget, spend, bidding, and venue type at the Deal/CRID level.
  • The DSP cannot control weighting or rotation of individual creative ideas within a single size. Lucit manages that internally based on campaign configuration.
  • If a client has, say, 3 creative ideas across 3 sizes, the DSP loads 3 CRIDs (one per size), not one per creative. Lucit rotates the creative ideas at delivery time.
  • If the client wants to change the allocation/split of creative ideas, that is done in Lucit.

Impression Tracking Per Creative Idea

  • DSP reporting is broken down by CRID (ad size).
  • Lucit reporting is broken down per creative change/event.
  • If a client needs to track impressions per individual creative idea (e.g. via Google DV360), they need a separate CRID per creative and a corresponding separate Lucit campaign (or campaign segment) per CRID group.

Deal ID Assignment

  • Each Deal ID can only be attached to one Lucit campaign at a time.

Activation Timeline

Place Exchange and Lucit use a structured activation process. Lead times vary based on whether creative needs to be developed from scratch.

Express (9 business days)

Applies when all of the following are true:

  • Creative concept and all ad sizes are already finalized
  • Dynamic data source is already available in Lucit's platform (e.g. weather, AQI, existing integrations)

Standard (15 business days)

Applies when any of the following are true:

  • Creative design needs to be developed or refined with the advertiser
  • A new dynamic data source needs to be integrated

Summary of Stages

Day(s) Stage Owner
Day 1 Initial request; collect creative concepts, branding, screen list Advertiser + PX Client Success
Days 2–8 Creative brief development; Lucit XR Proofs (mocks) Lucit
Days 9–11 Asset collection and creative development Advertiser + Lucit
Days 12–13 Review, feedback, revisions Advertiser + Lucit
Day 14 QA; Client traffics placeholder CRIDs, fills out tag sheet, shares with Lucit; Lucit fills in markup and returns All parties
Day 15 Campaign launch; PX AdOps creates ads; monitoring begins Advertiser + PX AdOps

Pricing for creative activation is $0.75 CPM with no minimums.

Troubleshooting

Problem: Place Exchange tab is not visible in Link Player
Solution: Add the Place Exchange app to your account via Apps & Data. See Adding the Place Exchange App.

Problem: Deal ID is rejected or shows a conflict
Solution: - Confirm the Deal ID is in GUID format (e.g. 123e4567-e89b-12d3-a456-426614174000) - Check that the Deal ID is not already linked to another Lucit campaign — each Deal ID can only be attached to one campaign - Contact your Place Exchange account rep to verify the Deal ID is valid

Problem: Tag is not serving / returning errors
Solution: - Temporarily change silent_fail=1 to silent_fail=0 in the tag URL to see descriptive error responses - See the PX Tag Bundle — Error Code Reference for a full list of error codes and remediation steps

Problem: Creative is not updating on screens
Solution: - Check the Refresh Rate setting — content is cached for the configured duration - Confirm the Lucit campaign is published and has approved creatives - Verify the Deal ID is correctly linked in the Deals tab

Problem: Wrong creative size is being served
Solution: - Confirm Ad Unit IDs were imported into Lucit correctly for the target screens - Verify the Lucit campaign has creatives configured for the sizes in use