type CustomCriteria (v202408)
Stay organized with collections
Save and categorize content based on your preferences.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-06 UTC.
[null,null,["Last updated 2025-08-06 UTC."],[[["\u003cp\u003eCustom Criteria allows for targeted advertising based on custom targeting keys.\u003c/p\u003e\n"],["\u003cp\u003eIt uses predefined or freeform custom targeting key types for precise audience selection.\u003c/p\u003e\n"],["\u003cp\u003eAdvertisers can target specific custom targeting values associated with chosen keys.\u003c/p\u003e\n"],["\u003cp\u003eCriteria comparison operators offer flexibility in defining targeting conditions (e.g., "is" or "is not").\u003c/p\u003e\n"],["\u003cp\u003eCustom Criteria is utilized within various Google Ad Manager services, such as AudienceSegmentService and LineItemService, for refined ad delivery.\u003c/p\u003e\n"]]],["The core content describes how to use `CustomCriteria` for custom targeting. It details that `CustomCriteria` targets custom keys of `PREDEFINED` or `FREEFORM` types. Key information includes the required `keyId` from `CustomTargetingKey` and `valueIds` from `CustomTargetingValue`. The comparison operator (`operator`) field is also required, and supports `IS` and `IS_NOT` enums. Additionally, it references services such as `AdRuleService`, `AdjustmentService`, `AudienceSegmentService` and more, and inheritance of `CustomCriteriaNode` and `CustomCriteriaLeaf`.\n"],null,["# type CustomCriteria (v202408)\n\n**Service** \n[AdRuleService](/ad-manager/api/reference/v202408/AdRuleService.CustomCriteria) [AdjustmentService](/ad-manager/api/reference/v202408/AdjustmentService.CustomCriteria) **AudienceSegmentService** [ForecastService](/ad-manager/api/reference/v202408/ForecastService.CustomCriteria) [LineItemService](/ad-manager/api/reference/v202408/LineItemService.CustomCriteria) [NativeStyleService](/ad-manager/api/reference/v202408/NativeStyleService.CustomCriteria) [ProposalLineItemService](/ad-manager/api/reference/v202408/ProposalLineItemService.CustomCriteria) [ProposalService](/ad-manager/api/reference/v202408/ProposalService.CustomCriteria) [PublisherQueryLanguageService](/ad-manager/api/reference/v202408/PublisherQueryLanguageService.CustomCriteria) [TargetingPresetService](/ad-manager/api/reference/v202408/TargetingPresetService.CustomCriteria) [YieldGroupService](/ad-manager/api/reference/v202408/YieldGroupService.CustomCriteria) **Inheritance** \n[CustomCriteriaNode](/ad-manager/api/reference/v202408/AudienceSegmentService.CustomCriteriaNode) \n▼\n[CustomCriteriaLeaf](/ad-manager/api/reference/v202408/AudienceSegmentService.CustomCriteriaLeaf) \n▼\n[AudienceSegmentCriteria](/ad-manager/api/reference/v202408/AudienceSegmentService.AudienceSegmentCriteria) [CmsMetadataCriteria](/ad-manager/api/reference/v202408/AudienceSegmentService.CmsMetadataCriteria) **CustomCriteria**\n\nA [CustomCriteria](/ad-manager/api/reference/v202408/AudienceSegmentService.CustomCriteria) object is used to perform custom criteria targeting on custom targeting\nkeys of type [CustomTargetingKey.Type.PREDEFINED](/ad-manager/api/reference/v202408/CustomTargetingService.CustomTargetingKey.Type#PREDEFINED) or [CustomTargetingKey.Type.FREEFORM](/ad-manager/api/reference/v202408/CustomTargetingService.CustomTargetingKey.Type#FREEFORM).\n\n*** ** * ** ***\n\nNamespace\n:\n `https://www.google.com/apis/ads/publisher/v202408`\n\n| Field ----- ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **`CustomCriteriaNode` (inherited)** ||\n| **`CustomCriteriaLeaf` (inherited)** ||\n| **`CustomCriteria`** ||\n| ### `keyId` | ` `xsd:`long` The [CustomTargetingKey.id](/ad-manager/api/reference/v202408/CustomTargetingService.CustomTargetingKey#id) of the [CustomTargetingKey](/ad-manager/api/reference/v202408/CustomTargetingService.CustomTargetingKey) object that was created using [CustomTargetingService](/ad-manager/api/reference/v202408/CustomTargetingService). This attribute is required. |\n| ### `valueIds` | ` `xsd:`long[]` The ids of [CustomTargetingValue](/ad-manager/api/reference/v202408/CustomTargetingService.CustomTargetingValue) objects to target the custom targeting key with id [CustomCriteria.keyId](/ad-manager/api/reference/v202408/AudienceSegmentService.CustomCriteria#keyId). This attribute is required. |\n| ### `operator` | ` `[CustomCriteria.ComparisonOp...](/ad-manager/api/reference/v202408/AudienceSegmentService.CustomCriteria.ComparisonOperator \"CustomCriteria.ComparisonOperator\")` ` The comparison operator. This attribute is required. *** ** * ** *** **Enumerations** `IS` : `IS_NOT` : \u003cbr /\u003e |"]]