To help customers understand how to customize their campaign's reach, another essential JSON example is the Area Parameter Configuration.

Digital Out-of-Home (DOOH) advertising relies heavily on physical location. The areas parameter allows you to define specific geographic zones where your ads should or should not appear.

Example: Geographic Targeting (Inclusion and Exclusion)

This JSON object is part of the areas array used during campaign creation or updates. It demonstrates how to target a specific city while explicitly excluding a certain neighborhood within it.

{
  "areas": [
    {
      "title": "Target City Center",
      "action": "include",
      "latitude": 55.75583,
      "longitude": 37.61778,
      "radius": 50
    },
    {
      "title": "Exclude Competitor Zone",
      "action": "exclude",
      "latitude": 55.80112,
      "longitude": 37.54223,
      "radius": 5
    }
  ]
}

Why This Example is Important for Learning

• Action Logic: The action field is critical. Using "include" captures all devices within that radius, while "exclude" ensures your ads are never shown in that specific zone, even if it overlaps with an included area.

• Precision Control: The radius is measured in kilometers. This allows for broad regional targeting (e.g., 50km) or "hyper-local" targeting (e.g., 5km around a specific store or event).

• Coordinate-Based Targeting: Because the API uses latitude and longitude floats, it allows for high-precision placement regardless of postal boundaries or city names.

• Cost Efficiency: By excluding areas where your target demographic is not present, you can optimize your budget and focus your max_bid on high-value locations.

• Inventory Impact: Configuring these areas directly affects the inventory.value and impressions.value returned in the cost estimation reports.

Understanding this structure is key to Step 6 of the general procedure, where you refine your territorial restrictions to get an accurate cost estimate before launching your campaign.