DefinedReport:Account Structure: Question regarding keyword statuses returned

[timprepscius]

Concerning defined report -> account structure:

In http://www.google.com/apis/adwords/developer/DefinedReportJob.html

It says (in specifying a report):

adGroupStatuses <---- this one matches the adgroup documentation
* Enabled
* Paused
* Deleted

campaignStatuses <----- this one does not match the campaign, but I
assume "Active" to mean every state besides "Paused" or "Deleted" (is
this assumption correct?)
* Active
* Paused
* Deleted

keywordStatuses <-- this one definitely does not match, and is
confusing
* Disapproved
* Deleted
* Paused
* Active
* InActive

--

In http://www.google.com/apis/adwords/developer/adwords_api_report_keyword.html

It has the fields:
KeywordStatus Keyword Status (attribute) kwStatus / siteStatus /
siteKwStatus
CampaignStatus Campaign Status (attribute) campStatus
AdGroupStatus Ad Group Status (attribute) agStatus

--

In http://www.google.com/apis/adwords/developer/Keyword.html

Keywords' status is specified as
* Active -- the criterion is active. This indicates that the
maxCpc is greater than the minCpc, and there is nothing about the
criterion that would prevent it from triggering the ad group.
* InActive -- Applies only to Keyword criterion, not website. The
keyword is inactive. The Keyword criterion is currently not being used
to trigger the ad group. A Keyword becomes inactive, for example, when
the maxCpc is less than the required minCpc.
* Disapproved -- the criterion has been disapproved, most likely
because it violates Google's editorial policy. This status corresponds
to "Disapproved" in the Google AdWords web-based interface.
* Deleted -- the criterion has been deleted. This status
corresponds to "Deleted" in the Google AdWords web-based interface.

Keywords also have the field
paused boolean The pause status of the criterion

---

So..
1. Will I receive a paused status for keywords in the structure
report?
2. If I receive a paused status for keywords, does that mean InActive
& Paused
3. If I do not receive a paused status for keywords..
Is the only way of figuring out if a keyword is paused by
querying each keyword?
Is there a way to decipher if a keyword is paused (... if maxCpc
> minCpc and status is InActive, keyword must be paused.)

----

Thanks,

-tim

[AdWords API Advisor]

Hello Tim,

First off, I'm referring the documentation folks to this post as
there obviously are some points that could use clarification in the
docs.

As for the questions regarding the values for the keyword status
column in Keyword Structure reports, in my experience the following is
true:

- As long as a keyword is not paused or deleted, it will show up with
a status of "Active" in a Structure report, regardless of whether the
current max CPC is above the min CPC needed to trigger ad display.

- If a keyword is paused then it will show up with a status of
"Paused" in a Structure report.

- If a keyword is deleted then it will not be included in a Structure
report.

Note that all of the above only applies to the behavior of a Keyword
Structure report. If you run a normal Keyword report (including zero
impression keywords if desired) then the values in the keyword status
column should more closely match what the underlying status is for
each keyword (InActive keywords will be marked as such, and Deleted
keywords will be included).

Cheers,
-Jeff Posnick, AdWords API Team

On Mar 26, 10:21 am, timprepscius <timprepsc...@gmail.com> wrote:
> Concerning defined report -> account structure:
>

> Inhttp://www.google.com/apis/adwords/developer/DefinedReportJob.html

>
> It says (in specifying a report):
>
> adGroupStatuses <---- this one matches the adgroup documentation
> * Enabled
> * Paused
> * Deleted
>
> campaignStatuses <----- this one does not match the campaign, but I
> assume "Active" to mean every state besides "Paused" or "Deleted" (is
> this assumption correct?)
> * Active
> * Paused
> * Deleted
>
> keywordStatuses <-- this one definitely does not match, and is
> confusing
> * Disapproved
> * Deleted
> * Paused
> * Active
> * InActive
>
> --
>

> Inhttp://www.google.com/apis/adwords/developer/adwords_api_report_keywo...

>
> It has the fields:
> KeywordStatus Keyword Status (attribute) kwStatus / siteStatus /
> siteKwStatus
> CampaignStatus Campaign Status (attribute) campStatus
> AdGroupStatus Ad Group Status (attribute) agStatus
>
> --
>

> Inhttp://www.google.com/apis/adwords/developer/Keyword.html

[timprepscius]

Thanks for your help.

Last question, hopefully, regarding the structure report:

Is there (currently) any reason to use the structure report?


Is there any information that

a creative report and a keyword report,
both specifying includeZeroImpressions,
and when appropriate, specifying all possible keyword statuses

does not have that a structure report would?

---

Thanks,

-tim


On Mar 27, 4:05 pm, AdWords API Advisor <adwordsapiadvi...@google.com>
wrote:

[AdWords API Advisor]

Hello Tim,

includeZeroImpressions only has an effect for Keyword reports:

http://www.google.com/apis/adwords/developer/DefinedReportJob.html#includeZeroImpression

so running a Creative report with that active won't give you
information for ads that haven't received impressions, while a
Structure report will.

I know I've said this elsewhere, but the core engineering team is
definitely aware that Structure reports would benefit if additional
columns were available for each report type, and if the keyword
statuses returned the full range of accurate values. The Structure
report was added as to provide developers an alternative to repeated
calls to getAllAdGroups() and the like and, to some extent, zero
impression reports. We're obviously interested in making them as
useful as possible so that they can serve that purpose for developers,
though as you might expect, I can't give any public timelines for when
you might expect to see changes.

Cheers,
-Jeff Posnick, AdWords API Team

[nutkenz]

From the docs:

==
CriterionStatus This criterion's status. Values are:

Active -- the criterion is active. This indicates that the maxCpc is
greater than the minCpc, and there is nothing about the criterion that
would prevent it from triggering the ad group.

InActive -- Applies only to Keyword criterion, not website. The
keyword is inactive. The Keyword criterion is currently not being used
to trigger the ad group. A Keyword becomes inactive, for example, when
the maxCpc is less than the required minCpc.

Disapproved -- the criterion has been disapproved, most likely because
it violates Google's editorial policy. This status corresponds to
"Disapproved" in the Google AdWords web-based interface.

Deleted -- the criterion has been deleted. This status corresponds to
"Deleted" in the Google AdWords web-based interface.

==

If a criterion is Paused, will it show up as Acive, Inactive,
Disapproved or Deleted?

On 3 apr, 23:25, AdWords API Advisor <adwordsapiadvi...@google.com>
wrote:
> Hello Tim,
>

>  includeZeroImpressions only has an effect for Keyword reports:
>

>  http://www.google.com/apis/adwords/developer/DefinedReportJob.html#in...

> > > > -tim- Tekst uit oorspronkelijk bericht niet weergeven -
>
> - Tekst uit oorspronkelijk bericht weergeven -

[AdWords API Advisor]

In that context it will show up with a "status" of Active. There is a
separate "paused" attribute, and it will be set to true if the website
criterion is paused.

Cheers,
-Jeff Posnick, AdWords API Team