type Activity (v202311)

An activity is a specific user action that an advertiser wants to track, such as the completion of a purchase or a visit to a webpage. You create and manage activities in Ad Manager. When a user performs the action after seeing an advertiser's ad, that's a conversion.

For example, you set up an activity in Ad Manager to track how many users visit an advertiser's promotional website after viewing or clicking on an ad. When a user views an ad, then visits the page, that's one conversion.


Namespace
https://www.google.com/apis/ads/publisher/v202311

Field

id

xsd:long

The unique ID of the Activity. This value is readonly and is assigned by Google.

activityGroupId

xsd:long

The ID of the ActivityGroup that this Activity belongs to.

name

xsd:string

The name of the Activity. This attribute is required and has a maximum length of 255 characters.

expectedURL

xsd:string

The URL of the webpage where the tags from this activity will be placed. This attribute is optional.

status

Activity.Status

The status of this activity. This attribute is readonly.


Enumerations
ACTIVE
INACTIVE

type

Activity.Type

The activity type. This attribute is optional and defaults to Activity.Type.PAGE_VIEWS


Enumerations
PAGE_VIEWS
Tracks conversions for each visit to a webpage. This is a counter type.
DAILY_VISITS
Tracks conversions for visits to a webpage, but only counts one conversion per user per day, even if a user visits the page multiple times. This is a counter type.
CUSTOM
Tracks conversions for visits to a webpage, but only counts one conversion per user per user session. Session length is set by the advertiser. This is a counter type.
ITEMS_PURCHASED
Tracks conversions where the user has made a purchase, the monetary value of each purchase, plus the number of items that were purchased and the order ID. This is a sales type.
TRANSACTIONS
Tracks conversions where the user has made a purchase, the monetary value of each purchase, plus the order ID (but not the number of items purchased). This is a sales type.
IOS_APPLICATION_DOWNLOADS
Tracks conversions where the user has installed an iOS application. This is a counter type.
ANDROID_APPLICATION_DOWNLOADS
Tracks conversions where the user has installed an Android application. This is a counter type.
UNKNOWN
The value returned if the actual value is not exposed by the requested API version.