KEkevel

Create/Update Tag

Changed on

This creates or updates the stored tags in your network. This should be used in combination with the Tag Manager URL to render tags. If you want to update tags, you must supply a tag Id. This will update all tag contents, so be sure to include the entire tag object when you update.

post/tag/{NetworkID}

Request

  • Base URL
    https://e-YOUR-NETWORKID.adzerk.net
  • URL
    https://e-YOUR-NETWORKID.adzerk.net/tag/{NetworkID}
  • Auth
    none required

Path parameters

NetworkIDinteger required

Your Network ID

Request body

Idinteger

The Tag Id. If you do not supply your own Id, an Id will be randomly generated. Id is required when updating a tag.

Bodystring

The tag to be rendered. Must use HTML tags. Adzerk macro expansion is supported. Example: "<img src=\"https://e.serverbid.com/udb/1234/match?redir=https%3A%2F%2Fmfad.domain.com%2Fudb%2F9874%2Fpool%2Fset%2Fi.gif%3FpoolId%3D1234%26poolKey%3D\">"

Enabledboolean

Sets whether the tag is enabled. Only enabled tags will be rendered in the client.

Priorityinteger

The render order of the tag when tags are called. Tags are rendered in ascending order (1 is first).

FrequencyCapinteger

How often to render this tag per user (seconds). A frequency cap less than or equal to zero disables frequency capping.

Targetingstring

Valid Zerkel markup used for targeting the tag to properties in the client. Example: "$device.brandName like \"*Samsung*\"

Response

200

Example response

{
  "Tags": [
    {
      "Id": "322ade5fff5441c3829240e37b1c3ec8",
      "Enabled": true,
      "Body": "<img src=\"http://example.com/updated.gif\">",
      "Priority": 100
    }
  ]
}

Changes