Policy & controlIntegration Preview
Brand Safety Policies
Express category rules, advertiser and creative approval, and sponsor and competitor restrictions as policies.
Preview
The policy schema, category codes and endpoint paths are illustrative. The final category taxonomy is shared after account approval.
A policy is a named rule set the Decision Engine applies when evaluating a request. You can reuse a policy across placements and override the default by passing a policy name in the decision request.
- Category rules: block categories such as gambling, alcohol or political content entirely, or allow them only on specific placements.
- Advertiser approval: require that only approved advertisers are eligible.
- Creative approval: require every creative to pass manual or automated review before going live.
- Sponsor protection: block a sponsor's competitors on the relevant placements for the duration of a sponsorship.
- Source restrictions: control which programmatic sources may be considered under each policy.
POST
/v1/policiesCreates a policy, or publishes a new version of an existing policy with the same name.Integration Previewcurl https://api.reinoads.com/v1/policies \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"name": "brand-safe",
"blocked_categories": ["gambling", "alcohol", "political"],
"require_advertiser_approval": true,
"require_creative_approval": true,
"sponsor_protection": {
"enabled": true,
"competitor_groups": ["telecom", "banking"]
},
"allowed_sources": ["src_programmatic_restricted_a"]
}'| reason.code | Stage | Description |
|---|---|---|
| category_blocked | brand_safety | The creative's category is blocked by the policy. |
| advertiser_not_approved | brand_safety | The advertiser has not been approved yet. |
| creative_not_approved | brand_safety | The creative is pending review or was rejected. |
| competitor_restricted | commercial_check | Competitor of an active sponsor. |
| source_not_allowed | source_eligibility | The demand source is not allowed by the publisher. |
| kill_switch_active | policy_check | A kill switch is active on the source, advertiser or placement. |
Fail-closed behavior
If a creative's category cannot be determined or its approval status is unknown, the Decision Engine treats it as ineligible. Uncertainty always resolves to not serving.
