Creative template fields

Posted in General by Alex Beskosty Mon Jun 27 2016 10:44:32 GMT+0000 (UTC)·10·Viewed 1,146 times

I'm looking for a documentation to understand what UI controls are needed to populate each type of creative.
Ari Paparo
June 27, 2016

The attributes are listed here: http://docs.beeswax.com/docs/list-of-creative-attribute-modules-and-keys

Most modules are either boolean, like mobile.mraid_playableor an enum, like advertiser. advertiser_category. In the case of an enum, there is always a lookup table, with values available using the /view method. For example, if you would like a list of advertiser categories you can make a GET request to:

/view?view_name=advertiser_category

Some of these attributes can be a bit obscure, so feel free to reach out to our support email for help with your API project.

Alex Beskosty
June 27, 2016

Ari, thank you for response. How do I know which modules and keys are to be set if some particular creative template was chosen (for example 'Banner Image')?
In case of targeting there is an association between strategy and targeting modules so I can request all possible modules for a given line item type.

Ari Paparo
June 27, 2016

Good question!

First, when you use a creative_template certain attributes are automatically added to the creative. For example, if you choose to use template #4, for a javascript tag, the attributes {"technical":{"tag_type":[3]}} are automatically added, to indicate that the tag is javascript.

Further, if you upload a creative_asset such as an image or video file, and use it to create a creative, then the metadata from the asset will automatically create relevant attributes in the creative, such as technical.banner_mime.

As an API developer there are two things you should do: 1) fill in the advertiser-related attributes, 2) for creatives that point to external tags, you should ask the user to declare the technical, mobile, and video parameters.

Alex Beskosty
June 29, 2016

why creative_type field is required for creative object although it can be computed from creative_template_id?

Ari Paparo
June 29, 2016

creative_type field allows Buzz to confirm that the Creative object properly matches both the proper creative_template and the line_item it is associated with. It is somewhat duplicative since it also exists in the template.

Alex Beskosty
June 29, 2016

When I create new creative and creative_template_id is set then creative_type parameter isn't required. Is there any reason why it is marked as required in docs http://docs.beeswax.com/docs/creative ?

Ari Paparo
June 29, 2016

Both creative_type and creative_template_id are required in the Creative object and the type of the template must match the type of the Creative.

Alex Beskosty
June 29, 2016

however POST request to .../rest/creative works without creative_type parameter. What is a use case why both parameters are required?

Ari Paparo
June 29, 2016

It is required, but if you don't send it on POST it defaults to 0, which is banner type. If you sent "creative_type":null you would see the error saying it is required.

Alex Beskosty
June 29, 2016

Got it. Thank you.

  
Markdown is allowed