MEmediamath
Strategies

Create a Strategy

Create a strategy. If your use case requires more than 100,000 IPs or postal codes, please contact your MediaMath representative to discuss custom solutions or alternative approaches.

post/strategies

Request

Query parameters

extendedboolean

Get extended properties in response

Request body

campaign_idinteger required
namestring required
descriptionstring
statusboolean
archivedboolean
is_programmatic_guaranteedboolean
media_type'DISPLAY' | 'VIDEO' required
use_optimizationboolean
ads_txt_verified'ANY' | 'AUTHORIZED_ONLY' | 'AUTHORIZED_DIRECT_ONLY' | 'NONE' nullable
type'REM' | 'GBO' | 'AUD'
feature_compatibilitystring nullable
device_graph_onlyboolean
mfa_avoidance'INHERIT' | 'ALLOW_ALL' | 'EXCLUDE_MFA'
zone_namestring
created_onstring date-time
updated_onstring date-time
groupsstring[] nullable
strategy_group_idinteger nullable

ID of the strategy group this strategy belongs to (one-to-one). Must reference a strategy_groups row whose campaign_id matches this strategy's campaign_id. Pass null to clear the assignment.

Example request

{
  "campaign_id": 45,
  "goals": {
    "bid_min_devices": 1
  },
  "inventory": {
    "domain_restrictions": {
      "include": [
        {
          "domain": "www.mediamath.com"
        }
      ],
      "exclude": [
        {
          "domain": "www.mediamath.com"
        }
      ]
    },
    "site_lists": [
      {
        "site_list_id": 32
      }
    ],
    "campaign_site_lists": [
      {
        "site_list_id": 32
      }
    ],
    "deals": [
      {
        "deal_id": 8
      }
    ],
    "deal_groups": [
      {
        "deal_group_id": 9
      }
    ],
    "supply_sources": [
      {
        "supply_source_id": 54
      }
    ]
  },
  "pacing": {
    "impression_pacing_amount": 23
  },
  "zone_name": "America/New_York",
  "frequency": {
    "frequency_amount": 345
  },
  "strategy_group_id": 1,
  "targeting": {
    "audience": {
      "include": [
        {
          "segments": [
            {
              "audience_segment_id": 24
            }
          ]
        }
      ],
      "exclude": {
        "segments": [
          {
            "audience_segment_id": 24
          }
        ]
      }
    },
    "contextual": {
      "include": [
        {
          "segments": [
            {
              "targeting_segment_id": 33
            }
          ]
        }
      ],
      "exclude": {
        "segments": [
          {
            "targeting_segment_id": 33
          }
        ]
      }
    },
    "audience_groups": {
      "include": [
        {
          "segment_groups": [
            {
              "segment_group_id": 43
            }
          ]
        }
      ]
    },
    "contextual_groups": {
      "include": [
        {
          "segment_groups": [
            {
              "segment_group_id": 43
            }
          ]
        }
      ]
    },
    "geofence": {
      "include": {
        "segments": [
          {
            "geofence_segment_id": 45
          }
        ]
      },
      "exclude": {
        "segments": [
          {
            "geofence_segment_id": 45
          }
        ]
      }
    },
    "my_data": {
      "include": {
        "pixels": [
          {
            "pixel_id": 65
          }
        ]
      },
      "exclude": {
        "pixels": [
          {
            "pixel_id": 65
          }
        ]
      }
    },
    "location": {
      "include": [
        {
          "target_value_id": 87
        }
      ],
      "exclude": [
        {
          "target_value_id": 87
        }
      ]
    },
    "technology": {
      "include": [
        {
          "target_value_id": 77
        }
      ],
      "exclude": [
        {
          "target_value_id": 77
        }
      ]
    },
    "day_parts": [
      {
        "start_hour": 1,
        "end_hour": 5,
        "days": [
          "M",
          "T",
          "W",
          "S",
          "U"
        ]
      }
    ],
    "ip_addresses": {
      "restriction": "INCLUDE"
    },
    "postal_codes": {
      "restriction": "INCLUDE",
      "codes": [
        "us-14392",
        "us-24981",
        "us-25632",
        "us-16191",
        "us-48574",
        "us14392",
        "us24981",
        "us25632",
        "us16191",
        "us48574",
        "14392",
        "24981",
        "25632",
        "16191",
        "48574"
      ]
    },
    "recency": [
      {
        "pixel_id": 55,
        "from_hour": 5,
        "to_hour": 7
      }
    ]
  }
}

Response

Strategy created response

OR

Example response

{
  "data": {
    "viewability": {
      "type": "AUTO_TAG"
    },
    "zone_name": "America/New_York",
    "frequency": {
      "frequency_amount": 345
    },
    "strategy_group_id": 1,
    "version": 2,
    "goals": {
      "bid_min_devices": 1
    },
    "pacing": {
      "impression_pacing_amount": 23
    },
    "inventory": {
      "domain_restrictions": {
        "include": [
          {
            "domain": "www.mediamath.com"
          }
        ],
        "exclude": [
          {
            "domain": "www.mediamath.com"
          }
        ]
      },
      "site_lists": [
        {
          "site_list_id": 32
        }
      ],
      "campaign_site_lists": [
        {
          "site_list_id": 32
        }
      ],
      "deals": [
        {
          "deal_id": 8
        }
      ],
      "deal_groups": [
        {
          "deal_group_id": 9
        }
      ],
      "supply_sources": [
        {
          "supply_source_id": 54
        }
      ]
    },
    "targeting": {
      "audience": {
        "include": [
          {
            "segments": [
              {
                "audience_segment_id": 24
              }
            ]
          }
        ],
        "exclude": {
          "segments": [
            {
              "audience_segment_id": 24
            }
          ]
        }
      },
      "contextual": {
        "include": [
          {
            "segments": [
              {
                "targeting_segment_id": 33
              }
            ]
          }
        ],
        "exclude": {
          "segments": [
            {
              "targeting_segment_id": 33
            }
          ]
        }
      },
      "audience_groups": {
        "include": [
          {
            "segment_groups": [
              {
                "segment_group_id": 43
              }
            ]
          }
        ]
      },
      "contextual_groups": {
        "include": [
          {
            "segment_groups": [
              {
                "segment_group_id": 43
              }
            ]
          }
        ]
      },
      "geofence": {
        "include": {
          "segments": [
            {
              "geofence_segment_id": 45
            }
          ]
        },
        "exclude": {
          "segments": [
            {
              "geofence_segment_id": 45
            }
          ]
        }
      },
      "my_data": {
        "include": {
          "pixels": [
            {
              "pixel_id": 65
            }
          ]
        },
        "exclude": {
          "pixels": [
            {
              "pixel_id": 65
            }
          ]
        }
      },
      "location": {
        "include": [
          {
            "target_value_id": 87
          }
        ],
        "exclude": [
          {
            "target_value_id": 87
          }
        ]
      },
      "technology": {
        "include": [
          {
            "target_value_id": 77
          }
        ],
        "exclude": [
          {
            "target_value_id": 77
          }
        ]
      },
      "day_parts": [
        {
          "start_hour": 1,
          "end_hour": 5,
          "days": [
            "M",
            "T",
            "W",
            "S",
            "U"
          ]
        }
      ],
      "ip_addresses": {
        "restriction": "INCLUDE",
        "count": 500
      },
      "postal_codes": {
        "restriction": "INCLUDE",
        "count": 5
      },
      "recency": [
        {
          "pixel_id": 55,
          "from_hour": 5,
          "to_hour": 7
        }
      ]
    }
  },
  "meta": {
    "status": "success"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.