type Activity (v202311)

Service

ActivityService

Dependencies

ActivityPage createActivities() updateActivities()

▼

Activity

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.