How to get search results from Radius Targeting

[김지원]

Hi,

1. We would like to know how to get search results from Radius Targeting. Code examples would be great!

We found how to get search results for Geo targeting as following: 

Selector selector = new SelectorBuilder()

                .fields(

                        "Id",

                        "LocationName",

                        "CanonicalName",

                        "DisplayType",

                        "Reach",

                        "TargetingStatus")

                .in("LocationName",locationName)

                .equals("Locale", "en")

                .build();

But for radius targeting, there is no code example for search results. (API doc link: https://developers.google.com/adwords/api/docs/guides/location-targeting)

2. Is getting search results for Geo targeting and radius targeting different? If yes, how is it different in codes?

Thank you.

[Ivan Bautista]

Hi,

As per documentation, Radius targets are implemented as Proximity criteria and are created using a latitude, longitude, and radius. You can use CampaignCriterionService.get() to retrieve radius targets for particular campaigns and filter the results by adding a predicate value in Criterion.type field to only show Proximity Criteria.

Below is a sample code (in Java) for reference.

   CampaignCriterionServiceInterface campaignCriterionService =
        adWordsServices.get(session, CampaignCriterionServiceInterface.class);
    ....
    SelectorBuilder builder = new SelectorBuilder();
    Selector selector = builder
        .fields(
            CampaignCriterionField.Id,
            CampaignCriterionField.CampaignId,
            CampaignCriterionField.GeoPoint,
            CampaignCriterionField.RadiusDistanceUnits,
            CampaignCriterionField.RadiusInUnits,
            CampaignCriterionField.Address)
        .offset(offset)
        .limit(PAGE_SIZE)
        .equals(CampaignCriterionField.CampaignId, campaignId.toString())
        .equals(CampaignCriterionField.CriteriaType, "PROXIMITY")
        .build();
   .......
     CampaignCriterionPage page = campaignCriterionService.get(selector);

Regards,

Ivan

AdWords API Team 

[김지원]

HI Ivan,

Thanks for the answer. But we haven't exactly got the answer we need. So this time I've attached an image that could better explain our struggle on Radius targeting.

As you can see from the image, search results for 'basic Search tab' and 'Radius Targeting tab' is different. 

What we need is how to get that search result such as '20.0 mi around Mokdong-dong,  Paju-si, KR - custom' when we click Search button from Radius Targeting.

Even comparing search results from geo targeting with radius targeting. When you search location from geo targeting, you get list of all matching locations. But for Radius targeting, you only get 1 result. So we wonder how we can retrieve this result from Radius targeting. 

To sum up, we would like to know the difference between 'search results' between geo location targeting and Radius targeting and how we can get retrieve search result from Radius targeting. Code examples would be great!

Thank you

Jiwon

2017년 9월 6일 수요일 오후 3시 16분 50초 UTC+9, 김지원 님의 말:

[Ivan Bautista]

Hi Jiwon,

Thank you for providing the screenshot to help us understand your concern even more. As per documentation, the only way to look up for targettable locations by name (similar to the UI screenshot provided) is via LocationCriterionService. However, this service only returns Location Criteria. As mentioned earlier, radius targets are implemented as Proximity criteria and thus will not be returned in the LocationCriterionService.get().

Currently, you may only retrieve already targeted Proximity Criteria via CampaignCriterionService.get() but not look up for targettable radius targets similar to the AdWords UI.

On the other hand, if you want to know the difference between the Search Tab and Radius Targeting Tab in the AdWords UI as pointed out in your screenshot, then it would be best to raise that question and any other AdWords UI related questions to the AdWords Community forum as it is the more appropriate forum to get answers for those kind of queries.

[김지원]

Hi Ivan

Thank you for thorough answer. We now understand we can only look up for targetable locations by name via LocationCriteria.
However, we've tested several locations and found out that we were only able to look up locations for Cities (e.g. Seoul, Busan) and NOT with detail addresses (e.g. 702-19 yeoksamdong).

Here is the result when we entered '702-19 yeoksamdong' for radius targeting:

        String[] locationNames = new String[] {"702-19 yeoksamdong"};

        // Get the LocationCriterionService.

        LocationCriterionServiceInterface locationCriterionService =

                adWordsServices.get(session, LocationCriterionServiceInterface.class);

        Selector selector = new SelectorBuilder()

                .fields(

                        "Id",

                        "LocationName",

                        "CanonicalName",

                        "DisplayType",

                        "ParentLocations",

                        "Reach",

                        "TargetingStatus")

                .in("LocationName", locationNames)

                .build();

        // Make the get request.

        LocationCriterion[] locationCriteria = locationCriterionService.get(selector);

We tried the same address in AdWords, and the result came out accurately (refer to image I attached). But we weren't able to get that result through API.

By looking at this result, tell us which part of the codes we must improve to get same results as AdWords for radius targeting.

Please note that we do use Proximity criteria when creating radius targeting, but this issue is mainly deals with looking up and getting result for targetable locations.

Thank you.

2017년 9월 8일 금요일 오후 5시 42분 20초 UTC+9, Ivan Bautista 님의 말:

[Peter Oliquino]

Hi Jiwon,

I'm a colleague of Ivan and I will be providing support for now. As mentioned previously by Ivan, you will not be able to retrieve radius or address information using the LocationCriterionService. Additionally, targetable locations as seen in the AdWords UI are currently not supported in the AdWords API. You may follow our blog for any updates if and when it can be available.

If you have implemented radius/proximity targeting then what you need to use instead is the CampaignCriterionService.get to retrieve the Proximity information you need such as the RadiusDistanceUnits, RadiusInUnits, and Address fields of the said criterion.

Thanks and regards,

Peter

AdWords API Team