Ad Campaign Methods

TelemetryTV supports four methods for delivering advertising content within playlists. Each method serves different use cases and offers varying levels of functionality, targeting, and campaign management capabilities.

Place Exchange (PE) – Deprecated

⚠️

Deprecated: Place Exchange is no longer recommended for new implementations. This method has been superseded by the Ad Campaigns system.

Place Exchange represents an early advertising integration method that connects TelemetryTV to a single external ad provider. This method provides basic ad insertion but lacks the flexibility and features of modern campaign management systems.

How it works: Place Exchange establishes a direct connection between TelemetryTV and one ad provider. When a playlist reaches an ad break point, the system requests an ad from the configured provider. The provider returns ad content, which plays before playlist content resumes.

Limitations:

• Single provider only: Cannot integrate multiple ad sources or create fallback chains
• No campaign management: Lacks scheduling, targeting, or campaign-level controls
• Limited reporting: Provides basic impression data without detailed campaign analytics
• No tag-based targeting: Cannot target ads to specific devices or locations
• No source prioritization: Cannot create waterfall ad delivery with multiple sources

Current status: Place Exchange remains available for existing implementations but receives no feature updates. Customers using Place Exchange should plan migration to Ad Campaigns for access to modern advertising features.

Migration path: Transition to Ad Campaigns by creating new campaigns with VAST provider sources. Ad Campaigns support the same ad providers as Place Exchange while adding scheduling, targeting, multi-source support, and comprehensive reporting.

Manual Assignment – Legacy Format

⚠️

Legacy Format: Manual assignment uses non-standard logic and does not follow modern ad campaign rules. Consider migrating to Ad Campaigns for full feature support.

Manual assignment represents a legacy method for inserting advertising content into playlists. This method allows direct assignment of ad content to specific playlist positions but operates outside the standard ad campaign framework.

How it works: Manual assignment enables users to directly place ad content (typically media folders or individual files) at specific positions within playlist pages. The system plays assigned content at designated times without applying campaign logic such as scheduling rules, device targeting, or source prioritization.

Limitations:

• Non-standard logic: Does not follow ad campaign rules for scheduling, tags, or targeting
• No campaign management: Lacks centralized campaign configuration and reporting
• Manual updates required: Content changes require manual playlist modifications
• No device targeting: Cannot target specific devices or locations using tags
• No scheduling controls: Cannot set day, time, or date-based activation rules
• Limited reporting: Provides basic playback data without campaign-level analytics
• No source prioritization: Cannot create multi-source ad delivery with fallback chains
• No VAST integration: Cannot leverage external ad networks or programmatic inventory

Current status: Manual assignment remains functional for existing implementations but lacks modern advertising features. This method serves customers who need simple, direct ad placement without campaign management requirements.

When to use: Manual assignment suits scenarios requiring one-time or infrequent ad placements where campaign management features are unnecessary. For ongoing ad operations, Ad Campaigns provides superior functionality.

Migration considerations: Migrating to Ad Campaigns requires recreating ad assignments as campaign configurations. The Ad Campaigns system provides equivalent functionality with added scheduling, targeting, and reporting capabilities.

Media Folder Injection – Supports Ad Campaign Logic

Media folder injection provides a toggle-based method for inserting advertising content from media folders into playlists. This method supports ad campaign logic including scheduling, device targeting, and source prioritization while operating at the folder level.

How it works: Media folder injection enables users to add media folders to playlist pages with advertising activation enabled. When the advertising toggle is active, the system treats folder content as ad inventory and applies campaign rules including:

• Tag-based targeting: Folder content displays only on devices matching specified tags
• Scheduling controls: Folder content activates based on day, time, and date settings
• Source prioritization: Folders participate in ad source waterfall chains
• Campaign reporting: Folder ad plays appear in campaign analytics

The folder injection method integrates with the broader ad campaign system, allowing folders to serve as ad sources within campaign configurations. Folders can function as primary ad sources or fallback inventory when external sources lack available content.

Key features:

• Toggle-based activation: Simple enable/disable control for advertising functionality
• Folder-level management: All folder content participates in ad delivery
• Campaign logic support: Full integration with scheduling, targeting, and prioritization
• Dynamic updates: Folder content changes automatically reflect in ad delivery
• Fallback capability: Folders can serve as backup inventory in multi-source campaigns

Limitations:

• Folder-only: Cannot inject individual media files, only entire folders
• No VAST integration: Cannot directly connect to external ad networks
• Content management: Requires manual folder content updates for ad changes

Use cases:

• Owned content campaigns: Promoting internal content, products, or services
• Local inventory: Region-specific or location-targeted owned content
• Fallback inventory: Backup ad content when external sources are unavailable
• Simple campaigns: Single-folder campaigns without external ad network requirements

Integration with Ad Campaigns: Media folder injection works alongside Ad Campaigns, allowing folders to serve as ad sources within campaign configurations. Campaigns can prioritize folders alongside VAST providers and TelemetryTV CTV inventory.

Ad Campaigns – Current Implementation (Recommended)

✅

Recommended Method: Ad Campaigns is the current, fully-documented implementation supporting complete ad campaign logic and modern advertising features.

Ad Campaigns represents the current, recommended method for managing advertising within TelemetryTV. This system provides comprehensive campaign management including scheduling, device targeting, multi-source ad delivery, VAST integration, and detailed reporting.

How it works: Ad Campaigns operates as a centralized campaign management system where users create campaign configurations defining:

• Campaign identification: Labels and metadata for campaign tracking and reporting
• Device targeting: Tag-based selection of devices that receive campaign content
• Ad sources: Prioritized list of VAST providers, TelemetryTV CTV inventory, and media folders
• Scheduling: Day, week, hour, and date-range controls for campaign activation
• Source prioritization: Waterfall delivery logic ensuring continuous ad display

When playlists with active campaigns reach ad break points, the system evaluates campaign eligibility based on device tags, schedule rules, and campaign status. Eligible campaigns provide ad content from their configured sources, following priority order with automatic fallback to ensure ad display continuity.

Key Features

Multi-source ad delivery: Campaigns support multiple ad source types in priority order:

• VAST providers: External ad networks and programmatic exchanges
• TelemetryTV CTV: Platform-provided fill inventory
• Media folders: Owned content fallback inventory

Device targeting: Tag-based device selection enables:

• Geographic segmentation (location, region, venue type)
• Demographic targeting (audience, use case, content policy)
• Multi-dimensional targeting (devices matching multiple tag criteria)

Advanced scheduling: Temporal controls include:

• Day-level selection (specific weekdays)
• Week recurrence (every week or specific weeks: 1st, 2nd, 3rd, 4th, 5th, 6th)
• Hour ranges (daily time windows, e.g., 9am-5pm)
• Date boundaries (campaign start and end dates)

Source prioritization: Waterfall delivery ensures:

• Highest-priority sources checked first
• Automatic progression to next source when inventory unavailable
• Guaranteed ad display through fallback chains
• Content folders serve as final backstop inventory

Comprehensive reporting: Campaign analytics track:

• Impression counts by device, source, and time period
• Playback duration and completion rates
• Source fill rates and fallback frequency
• Geographic distribution across tagged device groups
• 90-day data retention in standard reports

VAST integration: Full support for VAST-compliant ad servers including:

• Standard VAST protocol requests and responses
• Multiple VAST provider integration
• Dynamic ad insertion (DAI)
• Programmatic ad buying (RTB)
• Cross-platform ad delivery

Use cases:

• Programmatic advertising: Integration with major ad networks and exchanges
• Multi-source campaigns: Combining external ads with owned content
• Targeted campaigns: Geographic or demographic device targeting
• Scheduled campaigns: Time-based and date-range campaign activation
• Enterprise advertising: Comprehensive campaign management and reporting

Advantages over other methods:

• Full feature support: All modern advertising capabilities
• Multi-source flexibility: Combine VAST, CTV, and folder sources
• Advanced targeting: Tag-based device selection
• Comprehensive scheduling: Day, week, hour, and date controls
• Detailed reporting: Campaign-level analytics and metrics
• Industry standards: VAST compliance for ad network integration
• Continuous updates: Active development and feature additions

Documentation: Ad Campaigns includes complete documentation covering campaign creation, configuration, source management, scheduling, targeting, reporting, and best practices. This method receives ongoing updates and feature enhancements.

Summary Comparison

Migration Guidance

From Place Exchange to Ad Campaigns

1. Create new campaign: Set up Ad Campaigns configuration in campaign management interface
2. Configure VAST source: Add your existing Place Exchange provider as a VAST source
3. Set targeting: Configure device tags if targeting is required
4. Configure scheduling: Set day, time, and date rules if needed
5. Test and verify: Validate ad delivery matches Place Exchange behavior
6. Deactivate Place Exchange: Remove Place Exchange configuration once Ad Campaigns is verified
7. Monitor reporting: Use Ad Campaigns reporting to track performance

From Manual Assignment to Ad Campaigns

1. Audit current assignments: Document all manual ad placements and their positions
2. Create campaign structure: Organize assignments into logical campaigns
3. Configure media folder sources: Add folders containing manually-assigned content
4. Set targeting rules: Define device tags matching current manual assignment scope
5. Configure scheduling: Replicate any time-based or date-based activation logic
6. Test incrementally: Migrate assignments one at a time to verify behavior
7. Update playlists: Remove manual assignments as campaigns become active
8. Leverage new features: Take advantage of reporting, multi-source, and VAST capabilities

From Media Folder Injection to Ad Campaigns

Media folder injection already supports campaign logic, so migration focuses on adding external ad sources:

1. Audit folder campaigns: Review current folder-based campaign configurations
2. Add VAST sources: Integrate external ad networks as primary or secondary sources
3. Configure source priority: Set folder as fallback after VAST providers
4. Enhance targeting: Expand device tag configurations if needed
5. Leverage reporting: Use comprehensive Ad Campaigns analytics
6. Optimize delivery: Adjust source priorities based on fill rates and performance

Best Practices

For new implementations: Always use Ad Campaigns for access to full feature set, VAST integration, and ongoing platform updates.

For existing Place Exchange: Plan migration to Ad Campaigns to gain multi-source support, scheduling, targeting, and comprehensive reporting.

For manual assignments: Evaluate migration to Ad Campaigns when campaign management features become necessary or when VAST integration is required.

For media folder injection: Continue using this method for owned content campaigns, but consider adding VAST sources within Ad Campaigns for programmatic inventory access.

Multi-source strategy: Combine VAST providers (premium inventory), TelemetryTV CTV (fill), and media folders (backup) for optimal ad delivery continuity.

Targeting strategy: Use device tags strategically for geographic, demographic, or use-case-based campaign segmentation.

Scheduling strategy: Leverage day, week, hour, and date controls for time-sensitive campaigns and inventory optimization.