RTB Bid Request: Region Code/Name and City

[edison yang]

Dear Support,

(1) Region Code And Name

We found there are many sub-versions of the standard(ISO-3166-1) and we tried to match it with adx bid request but failed. Then, we used the Google Ads mapping, which mostly works, but some issues remain. So, could you pls provide the version of your standard.

https://www.google.com/help/hc/downloads/sa360/Location-Language-Codes-GoogleAds.xlsx

(2)Region and City Name

We want to build a list of regions and cities and we tried to collect the fully list from bid requests collected, but the city list seems incomplete. Is there a full, up-to-date list available?

Thanks.

Best Regards,

Edison

[Authorized Buyers API Forum Advisor]

Hello Edison,

Thanks for bringing this to my attention. In general, if our reference content for a field states that its value is based on a particular version of a spec–such as ISO-3166-2–without stating any exceptions or custom behavior in its description, the expected behavior should be that the field uses that spec exactly as written. The region field uses ISO-3166-2, so my expectation is that your mention of ISO-3166-1 was a typo (other fields in the Geo message use that).

So to answer your first question, region should be populated with ISO-3166-2 as currently described. If that is not the case, that would be a bug that we should investigate.

For your second question, it sounds as though you're looking for the list of possible cities that can appear in the bid request? Our documentation for the city field currently links here for the source of city names, which is broken down by country. That said, viewing our RTB samples, I do see some inconsistencies with the values listed there. For example, one of our examples uses the name "Jiddah" for a city in Saudi Arabia, which doesn't exist at the linked site. It does seem to be referring to "Jeddah", so I think you're correct here that these city names may be getting drawn from a different source than what is linked to. I'll file a bug internally to see if we can determine why this is different than described, and whether we can update the documentation to point to the correct source.

Regards,
Mark
 

Thanks,
 

Mark Saniscalchi Authorized Buyers API Team

Feedback
How was our support today?
               
[2025-03-28 16:24:44Z GMT] This message is in relation to case "ref:!00D1U01174p.!5004Q02vHDUr:ref" (ADR-00297219)