Skip to main content

Ad View

An event that describes the action of seeing an ad.

Here's an example of a Ad View:

pcdp("event", "track", {
"clientId": "kevel",
"siteId": "kevel.com",
"type": "adView",
"customFields": {
"debug": "true",
"role": "superuser"
},
"campaignId": "ADWORDS_KEVEL_456",
"source": "g_adwords"
})

In more detail, the fields supported on every Ad View are:

FieldRequiredTypeDefaultExampleDescription
clientIdstring"kevel"The client identifier.
siteIdstring"kevel.com"The client's site identifier.
typerequired"adView""adView"The event type.
customFieldsobject of string{...}An object with custom fields for extra metadata to be supplied in the event. The values within this object must all be strings.
facebookConversionTrackingFacebook Conversion Tracking Details{...}A description of a tracking event to send to Facebook using Facebook Conversions API.
campaignIdstring"ADWORDS_KEVEL_456"The id of the advertising campaign the ad is associated with.
sourcestring"g_adwords"The source of the ad that was viewed.

Facebook Conversion Tracking Details

A description of a tracking event to send to Facebook using Facebook Conversions API.

FieldRequiredTypeDefaultExampleDescription
pixel_idstring"396622227884531"The pixel ID to associate this Facebook tracking event with.
event_idstring"0c53d0b57"ID used to deduplicate events sent by both Facebook Pixel and Conversions API. More information about the usefulness of this ID is available at https://developers.facebook.com/docs/marketing-api/server-side-api/using-the-api/deduplicate-pixel-and-server-side-events.
event_namestring"AddToCart"A Facebook pixel Standard Event or Custom Event name. This field is used to deduplicate events sent by both Facebook Pixel and Conversions API. The available Standard Events are listed in https://developers.facebook.com/docs/facebook-pixel/reference#standard-events.
custom_dataobject{...}Parameters to send additional data Facebook can use for ads delivery optimization. More information about the fields that can be supplied here is available at https://developers.facebook.com/docs/marketing-api/conversions-api/parameters/custom-data.