type AudienceSegment (v202411)

AI-generated Key Takeaways

• An AudienceSegment object represents audience segments, which can be used for targeting ad campaigns.

• It has properties such as ID, name, categories, description, status, and size, reflecting audience characteristics.

• AudienceSegment can be categorized into types like First-Party, Shared, and Third-Party, indicating ownership and data source.

• The status (Active, Inactive, Unused) indicates the segment's availability for targeting in ad campaigns.

• It includes information on data provider and detailed breakdowns of audience size across platforms and identifier types (mobile web, IDFA, AdID, PPID).

Service

AudienceSegmentService

Dependencies

AudienceSegmentPage

▼

AudienceSegment

Inheritance

AudienceSegment

▼

FirstPartyAudienceSegment SharedAudienceSegment ThirdPartyAudienceSegment

An AudienceSegment represents audience segment object.

---

Namespace

https://www.google.com/apis/ads/publisher/v202411

Field
id	xsd:long Id of the AudienceSegment. This attribute is readonly and is populated by Google.
name	xsd:string Name of the AudienceSegment. This attribute is required and has a maximum length of 255 characters.
categoryIds	xsd:long[] The ids of the categories this segment belongs to. This field is optional, it may be empty.
description	xsd:string Description of the AudienceSegment. This attribute is optional and has a maximum length of 8192 characters.
status	AudienceSegment.Status Status of the AudienceSegment. This controls whether the given segment is available for targeting or not. During creation this attribute is optional and defaults to ACTIVE. This attribute is readonly for updates. Enumerations UNKNOWN The value returned if the actual value is not exposed by the requested API version. ACTIVE Active status means this audience segment is available for targeting. INACTIVE Inactive status means this audience segment is not available for targeting. UNUSED Unused status means this audience segment was deactivated by Google because it is unused.
size	xsd:long Number of unique identifiers in the AudienceSegment. This attribute is readonly and is populated by Google.
mobileWebSize	xsd:long Number of unique identifiers in the AudienceSegment for mobile web. This attribute is read-only.
idfaSize	xsd:long Number of unique IDFA identifiers in the AudienceSegment. This attribute is read-only.
adIdSize	xsd:long Number of unique AdID identifiers in the AudienceSegment. This attribute is read-only.
ppidSize	xsd:long Number of unique PPID (publisher provided identifiers) in the AudienceSegment. This attribute is read-only.
dataProvider	AudienceSegmentDataProvider Owner data provider of this segment. This attribute is readonly and is assigned by Google.
type	AudienceSegment.Type Type of the segment. This attribute is readonly and is assigned by Google. Enumerations FIRST_PARTY First party segments created and owned by the publisher. SHARED First party segments shared by other clients. THIRD_PARTY Third party segments licensed by the publisher from data providers. This doesn't include Google-provided licensed segments. UNKNOWN The value returned if the actual value is not exposed by the requested API version.