Documentation

Description

TrafficStars is an advertising platform that provides comprehensive campaign management and reporting capabilities. The platform offers REST API access for programmatic integration with support for OAuth2 authentication.

Follow our setup guide to connect TrafficStars Advertising to Improvado.

Step 1. Click the Make a new connection button on the Connections page and select TrafficStars Advertising in the Data sources catalog.

Step 2. To authorize your account, you need to provide your API Key:

Note: You can generate your API key from the Profile Page at https://admin.trafficstars.com/profile/. The API key will be used as a refresh token for OAuth2 authentication, which automatically handles access token generation and renewal.

Step 3. The platform uses OAuth2 authentication with automatic token refresh. Once you provide your API Key:

• Improvado will automatically obtain an access token
• The access token will be automatically refreshed when needed
• No manual token management is required

Step 4. After completing the connection process, the TrafficStars Advertising connection will appear in your Connected sources list.

Step 5. When the connection status is Active, and the account status column shows connected, you can move on to data extraction.

Step 6. To extract data from the connected sources, check the instructions on how to set up data extraction.

API Rate Limits

TrafficStars API has the following rate limits:

• 100 requests per 60 seconds
• Improvado automatically manages rate limiting to ensure compliance
• Rate limit errors (HTTP 429) are automatically handled with retry logic

Troubleshooting

Authentication Issues:

• Ensure your API key is valid and not expired
• Verify you have the correct permissions on your TrafficStars account
• Check that your API key was generated from the correct profile page

Data Extraction Issues:

• Verify your date range parameters are within allowed limits
• For Advertising Report, ensure only one dimension is selected at a time
• Check that rate limits are not being exceeded

Common Error Codes:

• 401 Unauthorized: Invalid or expired API key/access token (automatically refreshed)
• 429 Too Many Requests: Rate limit exceeded (automatically retried)
• 400 Bad Request: Invalid request parameters
• 403 Forbidden: Insufficient permissions
• 404 Not Found: Resource not found

The schema information shows all report types you can use to extract data from TrafficStars Advertising.

Available Report Types:

1. Campaigns Entity

• Campaign entities and configuration data
• Includes campaign settings, targeting parameters, and optimization rules
• Entity-level data (no date range required)

2. Applications Entity

• Application entities and configuration data
• Application-level settings and metadata
• Entity-level data (no date range required)

3. Advertising Report

• Comprehensive statistics with multiple time granularities (day, week, month)
• Dynamic dimension grouping support
• Date-range based reporting with customizable metrics
• Supports various grouping dimensions for detailed analysis