How to setup Brand inclusion and exclusion in the campaign

[san...@knorex.com]

Hi,

Can you provide us the documentation how to setup Brand in the campaign detail?

1. How to get list of available list when we type the keyword?

2. How to create a brand list?

3. How to add/remove brand list into campaign inclusion and exclusions?

I attached the screenshots.

Thank you.

[Google Ads API Forum Advisor]

Hi,

Thank you for contacting the Google Ads API support team.

Could you please confirm that you are using Google Ads platform/UI to set up 'Brand' in the campaign? If yes, kindly share your customer Id(Google Ads account Id) to assist you further.
 

This message is in relation to case "ref:!00D1U01174p.!5004Q02vG9If:ref" (ADR-00268196)

Thanks,
 

Google Ads API Team

[san...@knorex.com]

Hi,

Please find my test customer ID: 173-591-1398 

Martin.

[Google Ads API Forum Advisor]

Hi,

I would suggest you to contact the Google Ads Product support team as they are better equipped to address the concern about setup 'Brand' in the campaign in Google Ads platform/UI. You may refer to the 'Manage a brand list' article for brand list inclusion and exclusion via Google Ads UI. Please note that our team can only assist with the technical queries or concerns related to the Google Ads API, Google Ads UI related concerns are out of scope for our team.

[san...@knorex.com]

Hi,

Perhaps you misunderstood about my question.

I am asking about how to use Google Ads API to manage Brand list and add Brand inclusions/exclusions.

I cannot find the Google Ads API documentation related to the management of Brand list in the campaign.

https://developers.google.com/google-ads/api/docs/start

Thanks.

Martin

[Google Ads API Forum Advisor]

Hi,

You can utilize the below endpoint to create or remove the campaign shared sets. So in your case, you can create the CampaignSharedSet by adding the shared set associated with the campaign. To do this, first you need to create the shared set by adding the SharedSetType as BRANDS type. (A set of brands can be included or excluded from targeting across campaigns.)

• POST https://googleads.googleapis.com/v17/customers/{customerId}/campaignSharedSets:mutate

I hope it helps. 

[san...@knorex.com]

Hi,

Thanks for sharing. I have used the G Ads API to query all shared sets in my account. But it returns only 1 shared set which is irrelevant to my campaign.

I am expecting they return 2 sets as my screenshot.

Regards,

Martin 

-------

Query: SELECT campaign_shared_set.campaign, campaign_shared_set.resource_name, campaign_shared_set.shared_set, campaign_shared_set.status, shared_set.id, shared_set.member_count, shared_set.name, shared_set.reference_count, shared_set.resource_name, shared_set.status, shared_set.type FROM campaign_shared_set

SUCCESS REQUEST SUMMARY. Method: google.ads.googleads.v15.services.GoogleAdsService/Search, Endpoint: googleads.googleapis.com:443, CustomerID: xxx, RequestID: Y1sQUcsV6ASzX3i5vxZyeQ, ResponseCode: OK, Fault: null.

Results
shared_set {
  resource_name: "customers/xxx/sharedSets/10373158645"
  type: NEGATIVE_PLACEMENTS
  status: ENABLED
  id: 10373158645
  name: "API Negative placement list - Tue Jan 17 14:30:53 IST 2023"
  member_count: 1
  reference_count: 1
}
campaign_shared_set {
  resource_name: "customers/xxx/campaignSharedSets/19577039908~10373158645"
  status: ENABLED
  campaign: "customers/xxx/campaigns/19577039908"
  shared_set: "customers/xxx/sharedSets/10373158645"
}

[Google Ads API Forum Advisor]

Hi,

Could you confirm whether you have linked your shared set with the particular campaign. If not, then you can refer to the CampaignSharedSet document for linking the shared set with the campaign.

If you have already done this earlier and still you are not able to retrieve the shared set through the campaign, kindly provide us with the complete API logs (request and response with request-id and request header) generated at your end and also the uncropped (complete) UI screenshot of the Google Ads Account with the visibility of the customer ID to investigate further on your issue without redacting any information.

If you are using a client library and haven't enabled the logging yet, I would request you to enable logging for the specific client library that you are using. You can refer to the guides Java, .Net, PHP, Python, Ruby or Perl to enable logging at your end. For REST interface requests, you can enable logging via the curl command by using the -i flag.

Please note that the 'v15' is deprecated and about to sunset on September 25, 2024. After this date, all v15 API requests will begin to fail. I would suggest you upgrade to the latest version, 'v17', as soon as possible to benefit from new features. You may refer to this documentation on deprecation and sunset for more information regarding the specific deprecation and sunset dates for each available version.

You can send the details via Reply privately to the author option, or direct private reply to this email.

[san...@knorex.com]

Hi,

1. We already link 1 Brand exclusion in the campaign. Please refer the attached screenshot.

2. Here is the request & response with v17. Still have no data returned.

Request
-------
MethodName: google.ads.googleads.v17.services.GoogleAdsService/Search
Endpoint: googleads.googleapis.com:443
Headers: {developer-token=REDACTED, login-customer-id=xxx, x-goog-api-client=gl-java/1.8.0_202__Oracle-Corporation gccl/32.0.0 gapic/32.0.0 gax/2.48.1 grpc/1.62.2}
Body: customer_id: "5355568482"
query: "SELECT campaign_shared_set.campaign, campaign_shared_set.resource_name, campaign_shared_set.shared_set, campaign_shared_set.status, shared_set.id, shared_set.member_count, shared_set.name, shared_set.reference_count, shared_set.resource_name, shared_set.status, shared_set.type FROM campaign_shared_set WHERE campaign.id = 21627166957"


Response
--------
Headers: Metadata(content-disposition=attachment,content-type=application/grpc,request-id=7eGgfHJPhC2YPtq0tkmfFQ,date=Thu, 19 Sep 2024 03:28:53 GMT,alt-svc=h3=":443"; ma=2592000,h3-29=":443"; ma=2592000)
Body: field_mask {
  paths: "campaign_shared_set.campaign"
  paths: "campaign_shared_set.resource_name"
  paths: "campaign_shared_set.shared_set"
  paths: "campaign_shared_set.status"
  paths: "shared_set.id"
  paths: "shared_set.member_count"
  paths: "shared_set.name"
  paths: "shared_set.reference_count"
  paths: "shared_set.resource_name"
  paths: "shared_set.status"
  paths: "shared_set.type"
}
query_resource_consumption: 971

Failure message: null
Status: Status{code=OK, description=null, cause=null}.

Regards,

Martin

[Google Ads API Forum Advisor]

Hi,

With regard to your concern, I am checking with the rest of our team and one of our colleagues will reach out to you once we have an update.

[任Robin]

Got the same problem, any updates?

[Google Ads API Forum Advisor]

Robin:

This was escalated to me and I've just pinged my fellow engineer who is an expert in this for an update. I'll report as soon as I hear back.

 

Thanks,
 

Bob Hancock Google Ads API Team

Feedback
How was our support today?
               
[2025-03-04 16:32:15Z GMT] This message is in relation to case "ref:!00D1U01174p.!5004Q02vG9If:ref" (ADR-00268196)

[Google Ads API Forum Advisor]

Robin:

You can obtain the data with:

SELECT 
  campaign_criterion.display_name, 
  campaign_criterion.type, 
  campaign_criterion.brand_list.shared_set 
FROM campaign_criterion 
WHERE 
  campaign_criterion.type = 'BRAND_LIST' 

 

[{
  "results": [
    {
      "campaignCriterion": {
        "resourceName": "customers/5355568482/campaignCriteria/21627166957~2341310125360",
        "type": "BRAND_LIST",
        "displayName": "11206153104",
        "brandList": {
          "sharedSet": "customers/5355568482/sharedSets/11206153104"
        }
      }
    }
  ],
  "fieldMask": "campaignCriterion.displayName,campaignCriterion.type,campaignCriterion.brandList.sharedSet",
  "requestId": "U7qpzbfTyCIwDzqFpF7GdQ",
  "queryResourceConsumption": "3142"
}
* Connection #0 to host googleads.googleapis.com left intact
]

Thanks,
 

Bob Hancock Google Ads API Team

Feedback
How was our support today?
               

[2025-03-11 13:13:04Z GMT] This message is in relation to case "ref:!00D1U01174p.!5004Q02vG9If:ref" (ADR-00268196)