The new Search Ads 360 Reporting API is now available. Join the
searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.
campaign_effective_label
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-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThis resource defines the relationship between a campaign and an effective label, which can be either inherited or directly assigned to the campaign.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ecampaign_effective_label\u003c/code\u003e resource provides access to the campaign, label, and owner customer ID associated with the effective label.\u003c/p\u003e\n"],["\u003cp\u003eFields from the campaign, customer, and label resources can be selected along with this resource, but they will not segment metrics.\u003c/p\u003e\n"],["\u003cp\u003eThe resource name for CampaignEffectiveLabel follows the format \u003ccode\u003ecustomers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAvailable fields include the assigned effective label, the associated campaign and the customer who owns the effective label.\u003c/p\u003e\n"]]],["This describes the `campaign_effective_label` resource, which links a campaign to an assigned or inherited label. Key information includes the `campaign` and `label` resource names, which represent the campaign and its effective label respectively. The `owner_customer_id` indicates the customer who owns the label. The `resource_name` field provides the complete identifier for the relationship and fields can be selected and filtered but won't segment metrics.\n"],null,["# campaign_effective_label\n\nRepresents a relationship between a campaign and an effective label. An effective label is a label inherited or directly assigned to this campaign.\n\n| Attributed resources |\n|--------------------------------------------------------------------|\n| [campaign](/search-ads/reporting/api/reference/fields/v0/campaign) |\n| [customer](/search-ads/reporting/api/reference/fields/v0/customer) |\n| [label](/search-ads/reporting/api/reference/fields/v0/label) |\n\nFields from the above resources may be selected along with this\nresource in your SELECT and WHERE clauses. These fields **will not segment**\nmetrics in your `SELECT` clause.\n\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| | campaign_effective_label.campaign --------------------------------- || |-------------------|--------------------------------------------------------| | Field description | The campaign to which the effective label is attached. | | Category | `ATTRIBUTE` | | Data Type | `RESOURCE_NAME` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | False | | Repeated | False | |\n| | campaign_effective_label.label ------------------------------ || |-------------------|-----------------------------------------------| | Field description | The effective label assigned to the campaign. | | Category | `ATTRIBUTE` | | Data Type | `RESOURCE_NAME` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | False | | Repeated | False | |\n| | campaign_effective_label.owner_customer_id ------------------------------------------ || |-------------------|--------------------------------------------------------| | Field description | The ID of the Customer which owns the effective label. | | Category | `ATTRIBUTE` | | Data Type | `INT64` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | True | | Repeated | False | |\n| | campaign_effective_label.resource_name -------------------------------------- || |-------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------| | Field description | Name of the resource. CampaignEffectivelabel resource names have the form: `customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}` | | Category | `ATTRIBUTE` | | Data Type | `RESOURCE_NAME` | | Type URL | `N/A` | | Filterable | True | | Selectable | True | | Sortable | False | | Repeated | False | |"]]
