Ads API Location/Country data for App Install campaigns

[LevPog]

Hello,
My analytics team is trying to pull spend data through the Twitter API for App Install campaigns. Currently they are pulling country from the targeting-criteria API:

https://developer.twitter.com/en/docs/ads/campaign-management/api-reference/targeting-criteria

value ‘name’ is the one we are using to identify country when

{targeting_type = ‘LOCATION’ and location_type=‘COUNTRIES’}

If our goal is to pull the location of the user where the impression/click/install of the app happened should we be pulling for country data from the targeting-options API rather than the targeting-criteria API? Or is there a different solution you can suggest in order to pull the correct country where the install and spend allocation actually happened?

Account ID: 18ce54olzf9

Thank You,
Lev

[JBabichJapan]

Hi @LevPog

The only way of retrieving metrics broken down by pivots like locations or platforms is described on the Metrics and Segmentation page (see especially the very bottom). This should match the functionality available on ads.twitter.com UI, meaning you will see these breakdowns under the campaign or via exported report files. Some of the location related segmentations require you to pass in a country parameter, but LOCATIONS should match the targeting you see set on the campaigns for location targeting.

[LevPog]

Hi @JBabichJapanI
Unless I am not understanding the documentation correctly, the Metrics and Segmentation page (especially the bottom) does not address my main issue. I am looking for the country where the user clicked on the ad and installed my app. Currently I am only able to retrieve “United States” as the country parameter, but I am running campaigns and seeing installs in the ads dashboard in at least 5-6 different countries.

I am looking to get the country pram from the twitter API based on the install location, rather than submitting the country param for further granular segmentation. Could you please advise if there is an API end point to retrieve the country of where the app install occurred after the user engaged with the ad on twitter?
Thanks,
Lev

[JBabichJapan]

I think I know what you mean, but unfortunately we don’t offer the way you are mentioning and frequently what partners do is retrieve the stats based upon countries or regions being targeted in targeting_criteria. Also the country we segment user into is for the Twitter user as best that Twitter knows, whereas the device level data (like from a Mobile App Conversion Tracking partner) might say something different about their country depending on many factors. Generally the Ads API should be able to return the same stats you see in the Ads UI, and if you ever find a specific column or XLS output that you cannot replicate feel free to post a new thread (For visibility) and we would track as high priority if you cannot do it right now. Since you are saying it’s not easy or feasible to do the same thing you see in the UI, I will try to raise this as an issue with the team.