Resolver

The TrackVision Resolver enables intelligent redirection from Digital Link URIs to custom web pages, with support for business rules, linktype data provision, and enhanced consumer experiences.

Overview

The TrackVision Resolver acts as an intelligent intermediary between Digital Link URIs and destination content, providing:

Smart Redirection - Route consumers to appropriate web pages based on context
Business Rules Engine - Apply conditional logic for redirections and content
JSON Linktype Data - Provide structured data alongside or instead of redirections
Consumer Experience Optimization - Personalize destinations based on device, location, and preferences
Brand Integration - Seamlessly connect to brand websites and applications

Base Resolver Endpoint

The resolver processes all Digital Link requests through:

https://customer.tvai.me/{ai}/{identifier}/{qualifier}?{parameters}

Core Functionality

Redirection Types

Product Consumer Pages

Redirect GTIN-based Digital Links to product consumer pages:

GET https://customer.tvai.me/01/00614141999996

Default Behavior: Redirects to configured product consumer page Example Destination: https://www.yourbrand.com/products/coffee-beans-premium

Location Information

Redirect GLN-based Digital Links to location details:

GET https://customer.tvai.me/414/0614141000000

Default Behavior: Shows location information page Example Destination: https://facilities.yourbrand.com/location/warehouse-east

Shipment Tracking

Redirect SSCC-based Digital Links to tracking pages:

GET https://customer.tvai.me/00/006141411234567890

Default Behavior: Shows shipment tracking information Example Destination: https://track.yourlogistics.com/shipment/006141411234567890

Linktype-Based Routing

Use the linkType parameter to control destination:

Product Information Page (PIP)

GET https://customer.tvai.me/01/00614141999996?linkType=pip

Routes to detailed product information page with specifications, certifications, and compliance data.

Brand Homepage

GET https://customer.tvai.me/01/00614141999996?linkType=brandHomepage

Redirects to brand's official product marketing page.

Traceability

GET https://customer.tvai.me/01/00614141999996?linkType=traceability

Routes to supply chain traceability visualization.

Verification

GET https://customer.tvai.me/01/00614141999996?linkType=verify

Routes to product authentication and anti-counterfeiting page.

Sustainability

GET https://customer.tvai.me/01/00614141999996?linkType=sustainability

Routes to environmental impact and sustainability information.

Safety Information

GET https://customer.tvai.me/01/00614141999996?linkType=safety

Routes to safety data sheets and handling instructions.

Business Rules Engine

Rule Configuration

Intelligent routing rules are configured using Flows (see Platform Automation - Flows for detailed documentation). Flows provide a visual, node-based interface for creating complex business logic and conditional routing.

Flow-Based Rule Examples

The following examples show the logic that would be implemented as Flows in the TrackVision Platform:

Mobile Consumer Redirect Flow

{
  "name": "Mobile Consumer Redirect",
  "trigger": "digital_link_scan",
  "conditions": {
    "device_type": "mobile",
    "country": ["US", "CA"],
    "linkType": "pip"
  },
  "actions": {
    "type": "redirect",
    "url": "https://mobile.yourbrand.com/product/{gtin}",
    "code": 302
  }
}

European Compliance Flow

{
  "name": "European Compliance",
  "trigger": "digital_link_scan",
  "conditions": {
    "country": ["DE", "FR", "IT", "ES"],
    "linkType": "pip"
  },
  "actions": {
    "type": "redirect",
    "url": "https://eu.yourbrand.com/product/{gtin}/compliance",
    "code": 302
  }
}

Recall Active Flow

{
  "name": "Recall Active",
  "trigger": "digital_link_scan",
  "conditions": {
    "product_status": "recalled"
  },
  "actions": {
    "type": "redirect",
    "url": "https://recall.yourbrand.com/product/{gtin}",
    "code": 302
  },
  "priority": 1000
}

Note: These rules are created and managed through the TrackVision Platform's Flow designer interface, not through direct API calls. See the Platform Automation documentation for step-by-step Flow creation instructions.

Rule Conditions

Device-Based Conditions

device_type: mobile, tablet, desktop
operating_system: iOS, Android, Windows, macOS
browser: Safari, Chrome, Firefox, Edge
app_context: native_app, web_browser

Geographic Conditions

country: ISO 3166-1 country codes
region: State/province codes
city: City names
timezone: IANA timezone identifiers

Product Context

product_status: active, discontinued, recalled
batch_status: active, quarantined, recalled
certification_status: valid, expired, pending

Time-Based Conditions

time_of_day: Business hours, after hours
day_of_week: Monday through Sunday
date_range: Specific date periods
campaign_active: Marketing campaign periods

User Context

language: Preferred language from browser
returning_visitor: Based on cookies/tracking
authentication_status: authenticated, anonymous

Action Types

Redirect Actions

{
  "type": "redirect",
  "url": "https://destination.com/path/{gtin}",
  "code": 302,
  "preserve_query": true
}

JSON Response Actions

{
  "type": "json_response",
  "template": "product_info",
  "include_links": true
}

Template Actions

{
  "type": "template",
  "template_id": "consumer_page",
  "variables": {
    "theme": "dark",
    "locale": "{country}"
  }
}

JSON Linktype Data

Structured Data Responses

Instead of redirecting, the resolver can return structured JSON data:

GET https://customer.tvai.me/01/00614141999996?linkType=pip&format=json
Accept: application/json

Example Response

{
  "digitalLink": {
    "uri": "https://customer.tvai.me/01/00614141999996",
    "identifier": {
      "gtin": "00614141999996"
    },
    "linkType": "pip"
  },
  "product": {
    "gtin": "00614141999996",
    "name": "Premium Organic Coffee Beans",
    "brand": "TrackVision Coffee Co.",
    "description": "Single-origin arabica coffee beans from sustainable farms",
    "image": "https://cdn.yourbrand.com/products/coffee-premium.jpg",
    "certifications": [
      {
        "type": "Organic",
        "agency": "USDA",
        "validUntil": "2025-01-15",
        "certificateUrl": "https://certs.yourbrand.com/organic-001.pdf"
      }
    ],
    "nutritionalInfo": {
      "servingSize": "1 cup (8 fl oz)",
      "calories": 2,
      "caffeine": "95mg"
    }
  },
  "availability": {
    "status": "in_stock",
    "retailers": [
      {
        "name": "Premium Coffee Store",
        "url": "https://premiumcoffee.com/buy/premium-organic",
        "price": "$24.99",
        "currency": "USD"
      }
    ]
  },
  "links": [
    {
      "rel": "brandHomepage",
      "href": "https://customer.tvai.me/01/00614141999996?linkType=brandHomepage",
      "title": "Visit Brand Website"
    },
    {
      "rel": "traceability",
      "href": "https://customer.tvai.me/01/00614141999996?linkType=traceability",
      "title": "View Supply Chain"
    },
    {
      "rel": "sustainability",
      "href": "https://customer.tvai.me/01/00614141999996?linkType=sustainability",
      "title": "Sustainability Info"
    }
  ]
}

Location Data Response

GET https://customer.tvai.me/414/0614141000000?format=json

Example Response

{
  "digitalLink": {
    "uri": "https://customer.tvai.me/414/0614141000000",
    "identifier": {
      "gln": "0614141000000"
    }
  },
  "location": {
    "gln": "0614141000000",
    "name": "TrackVision Distribution Center - East",
    "type": "Distribution Center",
    "address": {
      "street": "456 Logistics Way",
      "city": "Newark",
      "state": "NJ",
      "postalCode": "07102",
      "country": "US"
    },
    "coordinates": {
      "latitude": 40.735657,
      "longitude": -74.172367
    },
    "contact": {
      "phone": "+1-800-555-0199",
      "email": "east-dc@trackvision.ai"
    },
    "operatingHours": {
      "monday": "06:00-22:00",
      "tuesday": "06:00-22:00",
      "wednesday": "06:00-22:00",
      "thursday": "06:00-22:00",
      "friday": "06:00-22:00",
      "saturday": "08:00-18:00",
      "sunday": "closed"
    }
  }
}

Response Formats

The resolver supports multiple response formats based on Accept headers:

HTML Response (Default)

GET https://customer.tvai.me/01/00614141999996
Accept: text/html

Returns consumer-friendly HTML page.

JSON-LD Response

GET https://customer.tvai.me/01/00614141999996
Accept: application/ld+json

Returns structured data in JSON-LD format.

Plain JSON Response

GET https://customer.tvai.me/01/00614141999996
Accept: application/json

Returns simplified JSON data structure.

Use Cases

E-commerce Integration

Route mobile users to mobile-optimized product pages
Redirect based on inventory availability by region
Integrate with shopping cart and checkout flows
Support multiple brand websites and marketplaces

Regulatory Compliance

Route EU consumers to GDPR-compliant pages
Direct to region-specific safety information
Handle product recalls with immediate redirection
Provide localized regulatory documentation

Marketing Campaigns

Campaign-specific landing pages
A/B testing for conversion optimization
Seasonal promotions and special offers
Influencer and affiliate tracking

Brand Experience

Consistent brand experience across touchpoints
Personalized content based on consumer profile
Integration with loyalty programs
Cross-selling and upselling opportunities

Best Practices

Performance Optimization

Keep Flow logic concise and well-organized
Use caching for frequently accessed Flows
Monitor Flow execution times
Implement graceful fallbacks

Flow Design

Use specific conditions to avoid conflicts
Implement clear priority hierarchies
Test Flows thoroughly before deployment
Document Flow purposes and logic through the Platform interface

Consumer Experience

Ensure fast response times
Provide meaningful error pages
Implement proper mobile optimization
Maintain consistent branding

Security Considerations

Validate all redirect destinations
Implement rate limiting
Monitor for malicious patterns
Use HTTPS for all redirections

Digital Links - Digital Link URI structure and standards
Scan Events - Consumer interaction tracking
GS1 Web Vocabulary - Structured data formats

Overview​

Base Resolver Endpoint​

Core Functionality​

Redirection Types​

Product Consumer Pages​

Location Information​

Shipment Tracking​

Linktype-Based Routing​

Product Information Page (PIP)​

Brand Homepage​

Traceability​

Verification​

Sustainability​

Safety Information​

Business Rules Engine​

Rule Configuration​

Flow-Based Rule Examples​

Mobile Consumer Redirect Flow​

European Compliance Flow​

Recall Active Flow​

Rule Conditions​

Device-Based Conditions​

Geographic Conditions​

Product Context​

Time-Based Conditions​

User Context​

Action Types​

Redirect Actions​

JSON Response Actions​

Template Actions​

JSON Linktype Data​

Structured Data Responses​

Example Response​

Location Data Response​

Example Response​

Response Formats​

HTML Response (Default)​

JSON-LD Response​

Plain JSON Response​

Use Cases​

E-commerce Integration​

Regulatory Compliance​

Marketing Campaigns​

Brand Experience​

Best Practices​

Performance Optimization​

Flow Design​

Consumer Experience​

Security Considerations​

Related Documentation​

Overview

Base Resolver Endpoint

Core Functionality

Redirection Types

Product Consumer Pages

Location Information

Shipment Tracking

Linktype-Based Routing

Product Information Page (PIP)

Brand Homepage

Traceability

Verification

Sustainability

Safety Information

Business Rules Engine

Rule Configuration

Flow-Based Rule Examples

Mobile Consumer Redirect Flow

European Compliance Flow

Recall Active Flow

Rule Conditions

Device-Based Conditions

Geographic Conditions

Product Context

Time-Based Conditions

User Context

Action Types

Redirect Actions

JSON Response Actions

Template Actions

JSON Linktype Data

Structured Data Responses

Example Response

Location Data Response

Example Response

Response Formats

HTML Response (Default)

JSON-LD Response

Plain JSON Response

Use Cases

E-commerce Integration

Regulatory Compliance

Marketing Campaigns

Brand Experience

Best Practices

Performance Optimization

Flow Design

Consumer Experience

Security Considerations

Related Documentation