Re: Differences between similar fields in UserList and CriterionUserList entities

Hello Joyce,

Thank you for your  detailed response.  The explanations you provide are very clear and make sense, but they do not quite fully answer my inquiry.

I probably did not phrase my inquiry in the most direct way in my initial posting, so let me try another way of posing the question.

a) Let's say I have created an instance of an AdwordsUserListService.UserList and it has an id field value of 1234 and an isEligibleForSearch field value of "true".

b) Let's say that I have an instance of an AdGroupCriterionService.AdGroupCriterion entity whose criterion field is  an instance of CriterionUserList

c) Let's say that the particular CriterionUserList set for the "criterion" has a userListId value of 1234 that references the AdwordsUserListService.UserList instance from "a".

So now my question becomes...

Would the userListEligibleForSearch value for the criterion described in "c" be determined by the value of the isEligibleForSearch field for the referenced UserList?  If not, what factors would determine the value of the userListEligibleForSearch value of this criterion - keeping in mind that the value of the userListEligibleForSearch field is not, itself, settable via the AdWords API?

Thanks again!

-Al

On Thursday, June 16, 2016 at 2:30:21 AM UTC-4, Joyce Lava wrote:

Hi Al,

Please see below differences for each field in each service:

CampaignCriterionService.CriterionUserList.userListEligibleForSearch - is used to manage campaign-level criteria. This is used when the campaign targets a group of people who visited the campaign on Google Search. You need to set the CampaignCriterion with criterion as CriterionUserList. CampaignCriterionService.CriterionUserList.userListEligibleForDisplay on the other hand is used to target people who visited the website on Google Display Network.

AdGroupCriterionService.CriterionUserList.userListEligibleForSearch - is used to manage criteria such as keywords or placements. This is used when the keyword bids for people who recently visited the website on Google Search. You need to set BiddableAdGroupCriterion with criterion as CriterionUserList. AdGroupCriterionService.CriterionUserList.userListEligibleForDisplay on the other hand is used to target people who visit Google Display Network.

UserList.isEligibleForSearch - is used to manage the user lists. This is the list of users that an account may target. With the list of users that has been created using the AdWordsUserListService, you may then use this user list to target on the campaign level(CampaignCriterionService.CriterionUserList) or on keywords or placements(AdGroupCriterionService.CriterionUserList).

With the explanation above on the differences, what I am aware of is you should only use the CriterionUserList.userListEligibleForSearch and CriterionUserList.userListEligibleForDisplay for validation as they are read-only fields in the CampaignCriterionService and AdGroupCriterionService.

Hope it helps.

Thanks and Regards,

Joyce, AdWords API Team

--
--
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
Also find us on our blog and Google+:
https://googleadsdeveloper.blogspot.com/
https://plus.google.com/+GoogleAdsDevelopers/posts
=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~=~
 
You received this message because you are subscribed to the Google
Groups "AdWords API Forum" group.
To post to this group, send email to adwords-api@googlegroups.com
To unsubscribe from this group, send email to
adwords-api+unsubscribe@googlegroups.com
For more options, visit this group at
http://groups.google.com/group/adwords-api?hl=en
---
You received this message because you are subscribed to the Google Groups "AdWords API Forum" group.
To unsubscribe from this group and stop receiving emails from it, send an email to adwords-api+unsubscribe@googlegroups.com.
Visit this group at https://groups.google.com/group/adwords-api.
To view this discussion on the web visit https://groups.google.com/d/msgid/adwords-api/53fdc792-e23e-4ea7-b687-e0e0e360201c%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.