type FirstPartyAudienceSegmentRule (v202411)

AI-generated Key Takeaways

• FirstPartyAudienceSegmentRule defines the criteria for users to be included in a FirstPartyAudienceSegment.

• It uses inventoryRule for specifying inventory like ad units and placements within the segment rule.

• customCriteriaRule allows for defining custom criteria sets to further refine user eligibility based on custom targeting.

• The custom criteria rule structure is hierarchical, with specific logical operators (OR, AND) at different levels to combine criteria.

Service

AudienceSegmentService

Dependencies

RuleBasedFirstPartyAudience...

▼

FirstPartyAudienceSegmentRule

Rule of a FirstPartyAudienceSegment that defines user's eligibility criteria to be part of a segment.

---

Namespace

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

Field
inventoryRule	InventoryTargeting Specifies the inventory (i.e. ad units and placements) that are part of the rule of a FirstPartyAudienceSegment. This attribute is required.
customCriteriaRule	CustomCriteriaSet Specifies the collection of custom criteria that are part of the rule of a FirstPartyAudienceSegment. Once the FirstPartyAudienceSegment is updated or modified with custom criteria, the server may return a normalized, but equivalent representation of the custom criteria rule. customCriteriaRulewill have up to three levels including itself. The top level CustomCriteriaSet i.e. the customTargeting object can only contain a CustomCriteriaSet.LogicalOperator.OR of all its children. The second level of CustomCriteriaSet objects can only contain CustomCriteriaSet.LogicalOperator.AND of all their children. If a CustomCriteria is placed on this level, the server will wrap it in a CustomCriteriaSet. The third level can only comprise of CustomCriteria objects. The resulting custom criteria rule would be of the form: