Pinterest Conversion Event

About

Description

A conversion event to be delivered to Pinterest's Conversions API. Scoped per ad account; events are deduplicated by event_id within a 48-hour window.

Unique Name

pinterest_conversion_event

Type

object

Properties

pinterest_ad_account_idRequired

Numeric Pinterest ad account ID (no act_ prefix).

View

action_sourceRequired

Where the conversion occurred.

View

event_idRequired

Deduplication key within a 48-hour window.

View

event_nameRequired

Pinterest standard event type, lowercase snake_case.

View

event_timeRequired

When the conversion occurred. Pinterest accepts events up to ~7 days old.

View

event_source_urlOptional

URL where the conversion occurred. Required when action_source = web.

View

opt_outOptional

If true, excludes the event from attribution and optimisation. For app_android/app_ios this is the Limit Ad Tracking / Ads Personalization opt-out signal.

View

partner_nameOptional

Free-text partner identifier.

View

languageOptional

Two-character ISO-639-1 code for the user's language.

View

custom_dataOptional

Additional business data about the conversion event.

View

device_infoOptional

Modern device-context block. Pinterest is migrating callers from the flat device_* fields to this.