REST Resource: floodlightActivities

Resource: FloodlightActivity

Contains properties of a Floodlight activity.

JSON representation 
{
  "id": string,
  "name": string,
  "tagString": string,
  "expectedUrl": string,
  "secure": boolean,
  "kind": string,
  "countingMethod": enum (CountingMethod),
  "tagFormat": enum (TagFormat),
  "cacheBustingType": enum (CacheBustingCodeType),
  "userDefinedVariableTypes": [
    enum (UserDefinedVariableType)
  ],
  "notes": string,
  "defaultTags": [
    {
      object (FloodlightActivityDynamicTag)
    }
  ],
  "publisherTags": [
    {
      object (FloodlightActivityPublisherDynamicTag)
    }
  ],
  "floodlightActivityGroupId": string,
  "floodlightConfigurationId": string,
  "advertiserId": string,
  "subaccountId": string,
  "accountId": string,
  "floodlightActivityGroupType": enum (FloodlightActivityGroupType),
  "floodlightActivityGroupTagString": string,
  "floodlightActivityGroupName": string,
  "sslCompliant": boolean,
  "advertiserIdDimensionValue": {
    object (DimensionValue)
  },
  "floodlightConfigurationIdDimensionValue": {
    object (DimensionValue)
  },
  "idDimensionValue": {
    object (DimensionValue)
  },
  "sslRequired": boolean,
  "floodlightTagType": enum (TagFormat),
  "status": enum (Status),
  "attributionEnabled": boolean
}
Fields
id

string (int64 format)

ID of this floodlight activity. This is a read-only, auto-generated field.
name

string

Name of this floodlight activity. This is a required field. Must be less than 129 characters long and cannot contain quotes.
tagString

string

Value of the

cat=

parameter in the floodlight tag, which the ad servers use to identify the activity. This is optional: if empty, a new tag string will be generated for you. This string must be 1 to 8 characters long, with valid characters being

[a-z][A-Z][0-9][-][ _ ]

. This tag string must also be unique among activities of the same activity group. This field is read-only after insertion.
expectedUrl

string

URL where this tag will be deployed. If specified, must be less than 256 characters long.
secure

boolean

Whether this tag should use SSL.
kind

string

Identifies what kind of resource this is. Value: the fixed string

"dfareporting#floodlightActivity"

.
countingMethod

enum (CountingMethod)

Counting method for conversions for this floodlight activity. This is a required field.
tagFormat

enum (TagFormat)

Tag format type for the floodlight activity. If left blank, the tag format will default to

HTML

.
cacheBustingType

enum (CacheBustingCodeType)

Code type used for cache busting in the generated tag. Applicable only when

floodlightActivityGroupType

is

COUNTER

and

countingMethod

is

STANDARD_COUNTING

or

UNIQUE_COUNTING

.
userDefinedVariableTypes[]

enum (UserDefinedVariableType)

floodlightActivities.list of the user-defined variables used by this conversion tag. These map to the "

u[1-100]=

" in the tags. Each of these can have a user defined type.

Acceptable values are

U1

to

U100

, inclusive.
notes

string

General notes or implementation instructions for the tag.
defaultTags[]

object (FloodlightActivityDynamicTag)

Dynamic floodlight tags.
publisherTags[]

object (FloodlightActivityPublisherDynamicTag)

Publisher dynamic floodlight tags.
floodlightActivityGroupId

string (int64 format)

Floodlight activity group ID of this floodlight activity. This is a required field.
floodlightConfigurationId

string (int64 format)

Floodlight configuration ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's floodlight configuration or from the existing activity's floodlight configuration.
advertiserId

string (int64 format)

Advertiser ID of this floodlight activity. If this field is left blank, the value will be copied over either from the activity group's advertiser or the existing activity's advertiser.
subaccountId

string (int64 format)

Subaccount ID of this floodlight activity. This is a read-only field that can be left blank.
accountId

string (int64 format)

Account ID of this floodlight activity. This is a read-only field that can be left blank.
floodlightActivityGroupType

enum (FloodlightActivityGroupType)

Type of the associated floodlight activity group. This is a read-only field.
floodlightActivityGroupTagString

string

Tag string of the associated floodlight activity group. This is a read-only field.
floodlightActivityGroupName

string

Name of the associated floodlight activity group. This is a read-only field.
sslCompliant

boolean

Whether the floodlight activity is SSL-compliant. This is a read-only field, its value detected by the system from the floodlight tags.
advertiserIdDimensionValue

object (DimensionValue)

Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
floodlightConfigurationIdDimensionValue

object (DimensionValue)

Dimension value for the ID of the floodlight configuration. This is a read-only, auto-generated field.
idDimensionValue

object (DimensionValue)

Dimension value for the ID of this floodlight activity. This is a read-only, auto-generated field.
sslRequired

boolean

Whether this floodlight activity must be SSL-compliant.
floodlightTagType

enum (TagFormat)

The type of Floodlight tag this activity will generate. This is a required field.
status

enum (Status)

The status of the activity. This can only be set to

ACTIVE

or

ARCHIVED_AND_DISABLED

. The

ARCHIVED

status is no longer supported and cannot be set for Floodlight activities. The

DISABLED_POLICY

status indicates that a Floodlight activity is violating Google policy. Contact your account manager for more information.
attributionEnabled

boolean

Whether the activity is enabled for attribution.

CountingMethod

Types of counting methods for conversions for spotlight activity

Enums
STANDARD_COUNTING Count every conversion.
UNIQUE_COUNTING Count the first conversion for each unique user during each 24-hour day, from midnight to midnight, Eastern Time.
SESSION_COUNTING Count one conversion per user per session. Session length is set by the site where the Spotlight tag is deployed.
TRANSACTIONS_COUNTING Count all conversions, plus the total number of sales that take place and the total revenue for these transactions.
ITEMS_SOLD_COUNTING Count each conversion, plus the total number of items sold and the total revenue for these sales.

TagFormat

Tag format types for spotlight activity.

Enums
HTML
XHTML

CacheBustingCodeType

Cache busting code types for spotlight activity

Enums
JAVASCRIPT
ACTIVE_SERVER_PAGE
JSP
PHP
COLD_FUSION

FloodlightActivityDynamicTag

Dynamic Tag

JSON representation 
{
  "id": string,
  "name": string,
  "tag": string
}
Fields
id

string (int64 format)

ID of this dynamic tag. This is a read-only, auto-generated field.
name

string

Name of this tag.
tag

string

Tag code.

FloodlightActivityPublisherDynamicTag

Publisher Dynamic Tag

JSON representation 
{
  "dynamicTag": {
    object (FloodlightActivityDynamicTag)
  },
  "siteId": string,
  "directorySiteId": string,
  "clickThrough": boolean,
  "viewThrough": boolean,
  "siteIdDimensionValue": {
    object (DimensionValue)
  }
}
Fields
dynamicTag

object (FloodlightActivityDynamicTag)

Dynamic floodlight tag.
siteId

string (int64 format)

Site ID of this dynamic tag.
directorySiteId

string (int64 format)

Directory site ID of this dynamic tag. This is a write-only field that can be used as an alternative to the

siteId

field. When this resource is retrieved, only the

siteId

field will be populated.
clickThrough

boolean

Whether this tag is applicable only for click-throughs.
viewThrough

boolean

Whether this tag is applicable only for view-throughs.
siteIdDimensionValue

object (DimensionValue)

Dimension value for the ID of the site. This is a read-only, auto-generated field.

TagFormat

Enums
IFRAME
IMAGE
GLOBAL_SITE_TAG

Status

Enums
ACTIVE
ARCHIVED_AND_DISABLED
ARCHIVED
DISABLED_POLICY

Methods

delete

 Deletes an existing floodlight activity.

generatetag

 Generates a tag for a floodlight activity.

get

 Gets one floodlight activity by ID.

insert

 Inserts a new floodlight activity.

list

 Retrieves a list of floodlight activities, possibly filtered.

patch

 Updates an existing floodlight activity.

update

 Updates an existing floodlight activity.