Site and Category Exclusion with the v13 API

[j.e.frank]

I'm trying to figure out if I can manipulate site and category
exclusions for placement campaigns through the API. (This would be
similar to using the Site and Category Exclusion tool that is
available in the AdWords web UI.) I have looked through the v13 docs
and I can't see anything that looks promising. So my first question
is, can I do this with the v13 API? I suppose I can do site exclusion
by setting the "negative" flag on a Keyword criterion, but this is at
the AdGroup level, not the Campaign level.

If I can't do Campaign-level site exclusions, or category exclusions,
with v13, then I wonder if I can do it with the v2009 API. I see
something in the CampaignCriterionService, the Criterion.ContentLabel,
that says it is for category exclusion, but I would prefer to stick
with v13 if possible.

[AdWords API Advisor]

Hi,

It is possible to set negative website (aka placement) criteria on a
campaign level with the v13 API by using the method
CriterionService.setCampaignNegativeCriteria():
http://code.google.com/apis/adwords/docs/developer/CriterionService.html#setCampaignNegativeCriteria.
Setting category exclusions is not possible using v13 API, but can be
done using the v2009 ContentLabel criterion that you mentioned.

Best,
- Eric Koleda, AdWords API Team

[j.e.frank]

Thanks for the reply. Ok so I will have to use the v2009 API to do
category exclusion. One concern I have is that the documentation is,
shall we say, sparse. I wonder if there is any documentation to tell
me which of these "ContentLabelTypes" refer to what category or site
type for exclusion. I would like to match them up with the check
boxes on the various tabs of the Site and Category Exclusion Tool in
the UI.

http://code.google.com/apis/adwords/v2009/docs/reference/CampaignCriterionService.ContentLabelType.html

Some of them are reasonably clear, like "ADULTISH" and "VIDEO", but
others are more cryptic, like "AFE" and "DP".

On Sep 28, 11:50 am, AdWords API Advisor

<adwordsapiadvi...@google.com> wrote:
> Hi,
>
> It is possible to set negative website (aka placement) criteria on a
> campaign level with the v13 API by using the method

> CriterionService.setCampaignNegativeCriteria():http://code.google.com/apis/adwords/docs/developer/CriterionService.h....

[AdWords API Advisor]

Hi,

We are aware of the lack of documentation currently available for
these values, and we are currently working on updating it. Until
then, here are descriptions of the various content labels:

ADULTISH = Sexually suggestive content
AFE = Error pages
CONFLICT = Military & international conflict
CONFLICT_TRAGEDY = Conflict & tragedy
DP = Parked domains
EDGY = Edgy content
EMBEDDED_VIDEO = Embedded video
JACKASS = Juvenile, gross & bizarre content
PROFANITY = Profanity & rough language
UGC = User generated content, online communities
UGC_FORUMS = Forums
UGC_IMAGES = Image-sharing pages
UGC_SOCIAL = Social networks
UGC_VIDEOS = Video-sharing pages
SENSITIVE = Sensitive themes
SIRENS = Crime, police & emergency
TRAGEDY = Death & tragedy
VIDEO = Video

Best,
- Eric

On Sep 28, 12:01 pm, "j.e.frank" <j.e.fr...@gmail.com> wrote:
> Thanks for the reply.  Ok so I will have to use the v2009 API to do
> category exclusion.  One concern I have is that the documentation is,
> shall we say, sparse.  I wonder if there is any documentation to tell
> me which of these "ContentLabelTypes" refer to what category or site
> type for exclusion.  I would like to match them up with the check
> boxes on the various tabs of the Site and Category Exclusion Tool in
> the UI.
>

> http://code.google.com/apis/adwords/v2009/docs/reference/CampaignCrit...

[j.e.frank]

Thanks for this list. Most of them match up nicely but there are
still a few issues.

I was trying to match these up with the choices available in the
AdWords UI, and I couldn't find one related to "Sensitive Themes". As
an experiment, I tried to set a category exclusion using SENSITIVE
with the API, and when I looked in the UI, it showed up in the
exclusions list with the name "null". So I'm not sure if it was a
valid exclusion and there was just no name to show for it in the UI,
or what was going on there.

Also, I think that some of these values are "groups of categories"
rather than actual categories. You can see these in the separate Site
and Category Exclusion Tool in the UI, not in the little section for
doing exclusions right in the Networks tab for a campaign. For
example, in the Exclusion Tool, "Edgy Content" is the heading above
the 3 categories Juvenile, Profanity, and Sexually suggestive. It is
not actually a choice you can make in the UI, it is just a heading.
This also applies to "Conflict and Tragedy" and "User generated
content". I did another test where I tried to set an exclusion for
CONFLICT_TRAGEDY via the API, and again I got an entry with the name
"null" in the UI. So it may be that SENSITIVE is also a "heading"
rather than an actual category.

On Sep 28, 12:30 pm, AdWords API Advisor

[AdWords API Advisor]

Hi,

Thank you for bringing this to our attention. I tested out the
behavior myself, and I am seeing the same "null" values in the UI. I
think you are right, that the category groupings probably got mixed in
with the actual categories, and that SENSITIVE is perhaps another
grouping. I'll bring up this issue with the core engineering team
and let you know once I have more information.

Best,
- Eric

[alka....@nearbuy.com]

Hey was this problem solved for you ?

[alka....@nearbuy.com]

Hey 

how do we do multiple campaign updates for category exclusion.