documentation for types on some reporting fields appears incorrect

[GregT]

Hi,

We're upgrading from v201506 of the API, and because of the RMF, we need to be able to display all the newly available metrics columns for the reports that our end users see. Some of the metrics added to the reports since v201506 appear to be documented incorrectly, with the types in the documentation not matching reality. We just want to verify that the documentation is wrong, as opposed to the documentation being correct and eventually the reports changing the types of these fields (i.e. so we don't find our code breaking down the road).  The fields:

1. ActiveViewMeasurability: the documentation claims it's a double, but we are getting back percentages ("0.0%"), and the AdWords UI displays a percentage for this metric.
2. ActiveViewViewability: same thing as #1.
3. ActiveViewCtr: same thing as #1.
4. AverageCpe: the documentation claims it's a double, but we appear to be getting back Money (i.e. micros), and the AdWords UI displays this as money.
5. AverageCpv: same thing as #4.

Thanks in advance,

Greg

[Michael Cloonan (AdWords API Team)]

Hello,

I definitely agree that these inconsistencies in the way things actually work versus the way they're documented are really frustrating. Unfortunately, I don't know which way is truly intended, so I am going to get in contact with the engineering team to clarify and hopefully update either the report rendering or the documentation so the two match.

Regards,

Mike, AdWords API Team

[GregT]

Hi, Mike.

Have you received any info about these fields?  

Additionally, we have found a couple more:

1. AverageCost. The documentation says it's of type Money (so should be in micros), but we're getting back text like "3255123 per click". The number part looks fine (i.e. that it could be micros), but obviously "per click" is not.
2. Interactions.  The documentation says it's a long, but we're getting back text like "35123 clicks".

Thanks again,

Greg

[Michael Cloonan (AdWords API Team)]

Hello,

I am advocating internally for fixing these fields to just render as numbers, because the current formatting doesn't really make sense for data that's meant to be parsed by applications.

However, for now, it is safe to assume that these fields are rendering as intended. If we do decide to make any changes, we will announce them on our blog.

I apologize for the inconvenience.

Regards,

Mike, AdWords API Team

[GregT]

Okay, thanks for the help!