Skip to main content

Test PIDs and Configurations

warning

Production Warning: These test PIDs and configurations are for development and testing purposes only. Never use them in your production environment.

info

Testing Overview: Use these test PIDs and configurations to validate your integration, test different creative formats, and ensure proper functionality before going live with production placements.

Media Placement Test PIDs

Media Video Ads

Use these PIDs to test different creative formats and orientations:

PIDDescriptionCreative Format
84242Landscape creatives onlyLandscape video ads
127546Vertical creatives onlyVertical video ads
127547Square creatives onlySquare video ads
128779Carousel creatives onlyCarousel video ads
128780Multiple creative sizes & formatsMixed formats for comprehensive testing

Usage Example

val adPlacementSettings = TeadsAdPlacementSettings.Builder()
.enableDebug()
.build()

val adRequestSettings = TeadsAdRequestSettings.Builder()
.pageUrl(Uri.parse("https://example.com/article"))
.build()

val mediaPlacement = TeadsAdPlacementMedia(this, 84242, adPlacementSettings, this)
mediaPlacement.requestAd(adRequestSettings)

Media Native Placement Test PIDs

Media Native Ads

Use this PID to test native video ads with custom layouts:

PIDDescriptionCreative Format
124859Display creatives onlyNative video ads with custom rendering

Usage Example

val adPlacementSettings = TeadsAdPlacementSettings.Builder()
.enableDebug()
.build()

val adRequestSettings = TeadsAdRequestSettings.Builder()
.pageUrl(Uri.parse("https://example.com/article"))
.build()

val mediaNativePlacement = TeadsAdPlacementMediaNative(this, 124859, adPlacementSettings, this)
mediaNativePlacement.requestAd(adRequestSettings)

Feed Placement Test Configuration

Use this configuration to test content recommendation widgets:

ParameterValueDescription
Article URLhttps://test-demo.outbrain.comTest article URL for content recommendations
Widget IDMB_1, MB_2, TEST_FEEDTest widget identifiers
Installation KeyNANOWDGT01, TESTKEY01Test installation keys
User IDnullOptional user identifier
Dark ModetrueEnable dark mode for testing

Usage Example

val config = TeadsAdPlacementFeedConfig(
articleUrl = Uri.parse("https://test-demo.outbrain.com"),
widgetId = "MB_1",
installationKey = "NANOWDGT01",
widgetIndex = 0,
userId = null,
darkMode = true,
testDisplay = false,
extId = null,
extSecondaryId = null,
obPubImpl = null
)

val feedPlacement = TeadsAdPlacementFeed(this, config, this)
feedPlacement.load()

Recommendations API Test Configuration

Use this configuration to test programmatic content recommendations:

ParameterValueDescription
Article URLhttps://test-demo.outbrain.comTest article URL for content recommendations
Widget IDSDK_1, RECS_1, TEST_RECSTest recommendations identifiers
Installation KeyNANOWDGT01, TESTKEY01Test installation keys
User IDnullOptional user identifier
Dark ModetrueEnable dark mode for testing

Usage Example

val config = TeadsAdPlacementRecommendationsConfig(
Uri.parse("https://test-demo.outbrain.com"),
"SDK_1" // Your unique Placement ID
)

val recommendationsPlacement = TeadsAdPlacementRecommendations(this, config, this)
recommendationsPlacement.load()

Testing Best Practices

Development Testing

  1. Use appropriate test PIDs: Choose PIDs that match your expected creative formats
  2. Test all placement types: Validate Media, Media Native, Feed, and Recommendations
  3. Test different configurations: Try various widget IDs and installation keys
  4. Enable test mode: Adds detailed logging

Integration Validation

  1. Run Validation Tool: Use the Validation Tool for comprehensive testing
  2. Test visibility: Ensure ads are fully visible and clickable
  3. Test audio management: Verify proper audio handling during video playback
  4. Test lifecycle events: Confirm all placement events are firing correctly

Pre-Production Checklist

  • Remove all test PIDs and configurations
  • Remove enableDebug() and enableValidationMode() settings
  • Replace with production PIDs and configurations
  • Test with production settings in staging environment
  • Verify app-ads.txt implementation
  • Confirm privacy compliance settings

Common Testing Scenarios

Testing Creative Formats

  • Landscape videos: Use PID 84242
  • Vertical videos: Use PID 127546
  • Square videos: Use PID 127547
  • Carousel ads: Use PID 128779
  • Mixed formats: Use PID 128780

Testing Feed Widgets

  • Standard feed: Use widget ID MB_1 with installation key NANOWDGT01
  • Alternative feed: Use widget ID MB_2 with installation key TESTKEY01
  • Test feed: Use widget ID TEST_FEED for basic functionality testing

Testing Recommendations

  • Standard recommendations: Use widget ID SDK_1
  • Alternative recommendations: Use widget ID RECS_1
  • Test recommendations: Use widget ID TEST_RECS for basic functionality

Troubleshooting Test Issues

No Ads Loading

  1. Check that you're using valid test PIDs
  2. Verify network connectivity
  3. Ensure proper placement configuration
  4. Check console logs for error messages

Creative Format Issues

  1. Try different test PIDs for various formats
  2. Verify your container size matches creative requirements
  3. Check for overlay issues affecting visibility

Feed/Recommendations Issues

  1. Verify widget ID and installation key combinations
  2. Check article URL accessibility
  3. Ensure proper delegate implementation