RTB Bid Request: Region Code/Name and City

25 views

Skip to first unread message

edison yang

unread,

Mar 28, 2025, 6:24:51 AM Mar 28

to Authorized Buyers API Forum

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

unread,

Mar 28, 2025, 12:24:51 PM Mar 28

to ironbo...@gmail.com, google-doubleclick-a...@googlegroups.com

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)

Reply all

Reply to author

Forward

0 new messages