Video Metadata Targeting Guide

The Rules Engine enables powerful targeting based on video content metadata, allowing publishers to match advertisements and content enhancements with what viewers are actually watching in real-time. This guide explores practical applications and implementation strategies.

Video Metadata Targeting Components

1. Visual Elements Detection

{
  "type": "json-logic",
  "id": "automotive-content",
  "rule": {
    "some": {
      "in": [
        {"var": "metadata.keywords[*].keyword"},
        ["car", "vehicle", "driving", "road", "highway", "parking"]
      ]
    }
  }
}

Real-world applications:

• Auto manufacturer ads during car scenes
• Insurance ads during driving sequences
• Car rental promotions during travel scenes
• Auto parts retailers during repair scenes

Implementation strategy:

{
  "type": "content",
  "id": "ford-commercial",
  "on": "automotive-content",
  "content": [{
    "type": "activation",
    "id": "ford-f150",
    "instance": {
      "text": "The All-New Ford F-150",
      "start": {"var": "metadata.keywords[?(@.keyword=='car')].start"},
      "duration": 15000
    }
  }]
}

2. Scene Context Targeting

{
  "type": "json-logic",
  "id": "outdoor-activity",
  "rule": {
    "and": [
      {
        "some": {
          "in": [
            {"var": "metadata.keywords[*].keyword"},
            ["hiking", "camping", "outdoors", "wilderness", "backpack"]
          ]
        }
      },
      {">=": [{"var": "metadata.keywords[?(@.keyword=='hiking')].score"}, 0.8]}
    ]
  }
}

Publisher use cases:

• REI/outdoor retailer ads during hiking scenes
• Camping gear during outdoor sequences
• Adventure travel promotions
• Sports drink ads during athletic activities

3. Multiple Element Correlation

{
  "type": "json-logic",
  "id": "pet-care-moment",
  "rule": {
    "and": [
      {
        "some": {
          "in": [
            {"var": "metadata.keywords[*].keyword"},
            ["dog", "cat", "pet", "animal"]
          ]
        }
      },
      {
        "some": {
          "in": [
            {"var": "metadata.keywords[*].keyword"},
            ["food", "feeding", "care", "grooming"]
          ]
        }
      }
    ]
  }
}

Targeting applications:

• Pet food ads during feeding scenes
• Veterinary services during pet care moments
• Pet insurance during health-related scenes
• Pet supply retailers during grooming scenes

4. Emotional Context Targeting

{
  "type": "json-logic",
  "id": "happy-family-moment",
  "rule": {
    "and": [
      {
        "some": {
          "in": [
            {"var": "metadata.keywords[*].keyword"},
            ["family", "together", "celebration", "happiness"]
          ]
        }
      },
      {
        "some": {
          "in": [
            {"var": "metadata.categories.iab[*].cat"},
            ["IAB8-1", "IAB8-5"]  // Family & Parenting categories
          ]
        }
      }
    ]
  }
}

Publisher opportunities:

• Family vacation promotions
• Insurance and financial planning
• Family restaurant advertising
• Family entertainment services

5. Setting-Based Targeting

{
  "type": "json-logic",
  "id": "kitchen-scene",
  "rule": {
    "and": [
      {
        "some": {
          "in": [
            {"var": "metadata.keywords[*].keyword"},
            ["kitchen", "cooking", "appliance", "food preparation"]
          ]
        }
      },
      {">=": [{"var": "moment.duration"}, 5000]}
    ]
  }
}

Targeting scenarios:

• Kitchen appliance manufacturers
• Cooking ingredient brands
• Meal delivery services
• Cookware retailers

Advanced Metadata Targeting Strategies

1. Sequential Scene Targeting

{
  "type": "json-logic",
  "id": "workout-sequence",
  "rule": {
    "and": [
      {
        "some": {
          "in": [
            {"var": "metadata.keywords[*].keyword"},
            ["exercise", "workout", "fitness"]
          ]
        }
      },
      {">=": [{"var": "moment.duration"}, 30000]},
      {"==": [{"var": "environment.device.type"}, "mobile"]}
    ]
  }
}

Publisher applications:

• Fitness app promotions
• Sports equipment advertising
• Health supplement brands
• Workout apparel retailers

2. Location Context Enhancement

{
  "type": "json-logic",
  "id": "travel-destination",
  "rule": {
    "and": [
      {
        "some": {
          "in": [
            {"var": "metadata.keywords[*].keyword"},
            ["beach", "resort", "vacation", "tropical"]
          ]
        }
      },
      {
        "in": [
          {"var": "environment.time.monthName"},
          ["december", "january", "february"]
        ]
      }
    ]
  }
}

Targeting opportunities:

• Travel agency promotions
• Hotel chains
• Airline ticket sales
• Travel insurance

3. Product Placement Enhancement

{
  "type": "json-logic",
  "id": "fashion-moment",
  "rule": {
    "and": [
      {
        "some": {
          "in": [
            {"var": "metadata.keywords[*].keyword"},
            ["clothing", "fashion", "style", "accessories"]
          ]
        }
      },
      {
        ">=": [{"var": "metadata.keywords[?(@.keyword=='fashion')].score"}, 0.7]
      }
    ]
  }
}

Implementation ideas:

• Shoppable video overlays
• Fashion brand promotions
• Accessory retailer ads
• Beauty product targeting

Industry-Specific Implementation Examples

1. Cooking Shows

{
  "type": "json-logic",
  "id": "recipe-moment",
  "rule": {
    "and": [
      {
        "some": {
          "in": [
            {"var": "metadata.keywords[*].keyword"},
            ["recipe", "ingredient", "cooking", "baking"]
          ]
        }
      },
      {
        "in": [{"var": "metadata.categories.iab[*].cat"}, ["IAB8-5"]]
      }
    ]
  }
}

Targeting applications:

• Grocery store promotions
• Kitchen appliance ads
• Cooking tool retailers
• Food delivery services

2. Home Improvement Content

{
  "type": "json-logic",
  "id": "diy-project",
  "rule": {
    "and": [
      {
        "some": {
          "in": [
            {"var": "metadata.keywords[*].keyword"},
            ["renovation", "tools", "home improvement", "DIY"]
          ]
        }
      },
      {">=": [{"var": "moment.duration"}, 15000]}
    ]
  }
}

Publisher opportunities:

• Hardware store promotions
• Tool manufacturer ads
• Home improvement services
• Paint and supplies retailers

3. Sports Content

{
  "type": "json-logic",
  "id": "sports-equipment",
  "rule": {
    "and": [
      {
        "some": {
          "in": [
            {"var": "metadata.keywords[*].keyword"},
            ["baseball", "bat", "glove", "game"]
          ]
        }
      },
      {
        "in": [{"var": "metadata.categories.iab[*].cat"}, ["IAB17"]]
      }
    ]
  }
}

Implementation strategies:

• Sports equipment retailers
• Team merchandise
• Training equipment
• Sports betting services (where legal)

Best Practices for Video Metadata Targeting

1. Metadata Quality

   • Ensure accurate scene detection
   • Maintain consistent keyword tagging
   • Regular metadata validation
   • Monitor detection accuracy

2. Timing Optimization

   • Consider scene duration
   • Account for viewer engagement
   • Optimize ad placement
   • Respect content flow

3. Relevance Scoring

   • Use confidence thresholds
   • Consider multiple metadata points
   • Weight different factors
   • Monitor performance metrics

4. Content Enhancement

   • Interactive overlays
   • Complementary information
   • Related content suggestions
   • Shopping opportunities