Clarification on Mapping UI Audience Types and API Enums for UserList

[Amit Tomar]

Dear Team,

I hope you're doing well.

I am currently working on integrating and managing audience segments using the Google Ads API and need some clarifications to ensure proper mapping and handling of audience data. I’ve reviewed the documentation and UI, but I would appreciate your confirmation on the following points:

1. Mapping UI Audience Types to API UserListType Enums

In the Google Ads UI under Audience Manager > Your data segments, we can create various types of audiences such as:

• Website visitors

• App users

• YouTube users

• Customer list

• Google Analytics

• Lead form segment

• Custom combination

In the API, I see corresponding UserListType enums like: REMARKETING, LOGICAL, RULE_BASED, CRM_BASED, etc.

Can you please help confirm how each UI audience type maps to the corresponding UserListType enum in the API?

2. Retrieving "Customer Type" and "Segment Type" from API

In the Audience Manager UI, each audience shows Customer Type and Segment Type columns.

When fetching audiences using the user_list resource via the Google Ads API, could you please clarify:

• Which specific fields in the user_list resource represent the "Customer Type" and "Segment Type" shown in the UI?

• If not directly available, is there a recommended approach to derive or infer these values?

Your guidance on these points will help ensure accurate audience classification and handling in our application. For your reference, I have also attached the screenshots.

Thank you in advance for your support.

[Google Ads API Forum Advisor]

Hi,

Thank you for reaching out to the Google Ads API support team.

By reviewing your query, I understand that you want to retrieve the "Customer Type" and "Segment Type" through the Google Ads API. Kindly note that retrieving the segment types are not yet supported in the Google Ads API. However, I'll raise a feature request for this to be available in the Google Ads API. I cannot provide a scheduled timeline for the availability of this request, I would recommend you to please follow our release notes and blog post for further updates.

Please find the below GAQL query to retrieve the customer type of an audience from the  user_list_customer_type resource:

SELECT user_list_customer_type.customer_type_category FROM user_list_customer_type

You can use the search or searchStream methods in making the API calls while retrieving the data. Additionally, you can utilize the Google Ads Query Builder and Query Validator to build and validate the queries for retrieving the data from the Google Ads API. 

Regarding how each Google Ads UI audience type maps to the corresponding UserListType enum in the API, I have raised your concern with the rest of our team and one of my teammates will reach out to you once we have an update. Meanwhile, your patience is appreciated.

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               
[2025-07-02 16:32:55Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01rgydp:ref" (ADR-00316761)

[Amit Tomar]

Dear Team,

Thank you for your previous response and for raising a feature request regarding the "Segment Type" support.

I’d like to follow up on a couple of pending points for further clarification:

---

1. Mapping of UI Audience Types to API UserListType Enums

The UI under Audience Manager > Your data segments provides the following audience creation options:

• Website visitors

• App users

• YouTube users

• Customer list

• Google Analytics

• Lead form segment

• Custom combination

Could you please help map these UI options to the corresponding UserListType enums such as:

• REMARKETING

• RULE_BASED

• CRM_BASED

• LOGICAL

• EXTERNAL_REMARKETING

• etc.

This mapping is essential to classify existing user lists programmatically when retrieved via the API.

---

2. Identification of Special Audience Types

While user_list.resource_name and user_list.type give us basic classification, how can we:

• Identify whether a user list is a Lead Form Segment or from Google Analytics?

• Distinguish between App Users, YouTube users, or Website Visitors using API fields?

Any pointers on which fields (e.g., data_source_type, integration_code, etc.) or workaround queries would be helpful for segmenting audiences properly.

---

I truly appreciate your continued support and look forward to your guidance on the above.

Thanks

[Amit Tomar]

Hi Team,

I hope you're doing well.

I wanted to kindly follow up on my previous query. I understand that responses can take time, and I truly appreciate the effort your team puts into reviewing each case carefully.

If there’s any update or further clarification needed from my end to help move things forward, please feel free to let me know. I’d be happy to assist.

Looking forward to your response whenever possible.

[Google Ads API Forum Advisor]

Hi Amit,

Thanks for your understanding. We are still looking into the issue and will get back once we have the confirmation from the according team. Thanks for your patience in the meantime. While we wait for an answer from the according team, one thing that may be helpful is trying to create test user lists through the UI, and then investigate the according field values via the GAQLs through the API to confirm.

Thanks,
 

Da Yang Google Ads API Team

Feedback
How was our support today?
               

[2025-07-07 07:14:36Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01rgydp:ref" (ADR-00316761)

[Amit Tomar]

any update?

[Amit Tomar]

Dear Team,

I hope you're doing well.

I had posted a follow-up message yesterday in the ongoing thread regarding the audience segment mappings and related API fields (screenshot attached). However, upon refreshing the page today, I noticed that the message now shows as "Message has been deleted."

To the best of my knowledge, I did not include any confidential information in that response. If the message was removed for a specific reason, could you kindly let me know what might have triggered it? I’ll be happy to repost the query or rephrase it accordingly if there was a misunderstanding.

Looking forward to your guidance so I can continue the discussion smoothly.

Thanks again for your time and continued support.

[Google Ads API Forum Advisor]

Hi Amit,

We don't have visibility into the post content moderation logic, and I don't see any manual action for removing that. You may try with the "Reply to author" button to post direct messages to us, which may be helpful to avoid such issue, since it generates private messages instead of makes public posts. In the meantime, thanks for your patience while we work on getting the according team to clarify your inquiries.
 

Thanks,
 

Da Yang Google Ads API Team

Feedback
How was our support today?
               

[2025-07-11 07:27:16Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01rgydp:ref" (ADR-00316761)

[Amit Tomar]

Hi Team,

Just checking in to see if there’s any update on my concern?

Thanks

[Amit Tomar]

Hi Team,

Just checking in to see if there’s any update on my concern?

Thanks

[Amit Tomar]

Dear Team,

I’d like to follow up on a couple of pending clarifications:

1. Mapping UI Audience Types to API Enums
   Under Audience Manager > Your data segments, the UI provides the following audience types:

• Website visitors

• App users

• YouTube users

• Customer list

• Google Analytics

• Lead form segment

• Custom combination

Could you kindly help map these to the corresponding UserListType enums such as REMARKETING, RULE_BASED, CRM_BASED, LOGICAL, EXTERNAL_REMARKETING, etc.?
This mapping will help us classify user lists programmatically when retrieved via the API.

2. Identification of Special Audience Types via API
   We would also appreciate guidance on how to:

• Identify Lead Form Segments or Google Analytics lists

• Distinguish App Users, YouTube Users, and Website Visitors

Are there specific fields (e.g., data_source_type, integration_code, or others) that can help differentiate these audience types? Any recommended workarounds would also be appreciated.

Thank you again for your continued support. Looking forward to your inputs.

[Amit Tomar]

Hi Team,

I am writing to kindly follow up on my previous query regarding the mapping of UI audience types to API enums and the identification of special audience types via the API.

Could you please let me know if there has been any update or progress on this matter? I understand that these investigations can take time, and I truly appreciate your continued efforts.

Thank you for your time and support.

Best regards,

Amit

--
--
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
Also find us on our blog:
https://googleadsdeveloper.blogspot.com/
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
 
You received this message because you are subscribed to the Google
Groups "AdWords API and Google Ads API Forum" group.
To post to this group, send email to adwor...@googlegroups.com
To unsubscribe from this group, send email to
adwords-api...@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/adwords-api?hl=en
---
You received this message because you are subscribed to the Google Groups "Google Ads API and AdWords API Forum" group.
To unsubscribe from this group and stop receiving emails from it, send an email to adwords-api...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/adwords-api/760bacc4-4f0d-46e0-8818-4c7d8e8b4976n%40googlegroups.com.