UpdateBannersTags (Live)

Associates tags with ads.

The method assigns the specified tags and removes any that are not specified, that were previously assigned to the ad. An ad can have no more than 30 tags from the campaign's tag list.

Input data

The method accepts an array of BannerTagsInfo objects. Each object specifies tags for a single ad.

{
   "method": "UpdateBannersTags",
   "param": [
      {  /* BannerTagsInfo */
         "BannerID": (long),
         "TagIDS": [
            (int)
            ...
         ]
      }
      ...
   ]
}

Parameters are described below.

Parameter Description Required
BannerTagsInfo object
BannerID The ad ID. Yes
TagIDS

Array with tag IDs (no more than 30).

Tags must be present in the list of campaign tags (see UpdateCampaignsTags).

Attention. The method removes tags that are not specified in the method call. To preserve tags for an ad, you must directly specify the tag IDs. To get the current list of assigned tags, use GetBannersTags.
Yes
Parameter Description Required
BannerTagsInfo object
BannerID The ad ID. Yes
TagIDS

Array with tag IDs (no more than 30).

Tags must be present in the list of campaign tags (see UpdateCampaignsTags).

Attention. The method removes tags that are not specified in the method call. To preserve tags for an ad, you must directly specify the tag IDs. To get the current list of assigned tags, use GetBannersTags.
Yes

Output data

Returns 1 if successful, as shown below.

{
   "data": 1
}

Examples of input data

Python

[
   {
      'BannerID': 2571700,
      'TagIDS': [16590, 16734]
   }
]

PHP

array(
   array(
      'BannerID' => 2571700,
      'TagIDS' => array(16590, 16734)
   )
)

Perl

[
   {
      'BannerID' => 2571700,
      'TagIDS' => [16590, 16734]
   }
]