Development Newsletters

Release: 14-03-2012

List of new features and major fixes for this release:

  • AdOcean API update

AdOcean API update

Three AdOcean API operations are going to be changed on 14th March in the following ways:

AddCreativeTemplate operation:

  • sov numerical parameter is added - the default value of this parameter is 100;
  • aggressive boolean parameter is added - possible values are Y and N and the default one is N.

UpdateCreativeTemplate operation:

  • sov numerical parameter is added;
  • aggressive boolean parameter is added - possible values are Y and N.

GetCreativeTemplateInfo operation's semantics are changing:

  • sov, isActive, isAggressive additional parameters will be returned by the operation;
  • in its current version the operation returns creative parameters in following form:

    <param_parameter_name>parameter_value</param_parameter_name>

  • but in the new version the operation will return creative parameters as:

    <parameter>
    	<name>
    		parameter_name
    	</name>
    	<value>
    		parameter_value
    	</value>
    </parameter>
    

Sample result of a GetCreativeTemplateInfo request after the deployment of API changes:

<GetCreativeTemplateInfo>
    <status>OK</status>
    <name>creative</name>
    <comments/>
    <url/>
    <templateID>89</templateID>
    <sov>100</sov>
    <isActive>Y</isActive>
    <isAggressive>N</isAggressive>
    <isSelfExcluded>N</isSelfExcluded>
    <isVideo>N</isVideo>
    <videoLength>NULL</videoLength>
    <parameters>
        <parameter>
            <name>width</name>
            <value>404</value>
        </parameter>
        <parameter>
            <name>height</name>
            <value>303</value>
        </parameter>
    </parameters>
</GetCreativeTemplateInfo>

Sample result of a GetCreativeTemplateInfo before the deployment of API changes:

<GetCreativeTemplateInfo>
    <status>OK</status>
    <name>creative</name>
    <comments/>
    <url/>
    <templateID>89</templateID>
    <isSelfExcluded>N</isSelfExcluded>
    <isVideo>N</isVideo>
    <videoLength>NULL</videoLength>
    <param_width>404</param_width>
    <param_height>303</param_height>
</GetCreativeTemplateInfo>

Please check your internal tools that make use of these AO API operations and make necessary modifications to them accordingly. If you have any questions, please contact your local Tech Support.

adocean api