Social media interaction tracking

Social media interaction tracking captures how users engage with social widgets embedded on your website, such as like buttons, share buttons, and tweet buttons.

Use social interaction tracking to:

• Measure how often content is shared on social platforms
• Identify which social networks drive the most engagement
• Understand which content resonates with users enough to share
• Track the performance of social sharing features

This table shows the support for social interaction tracking across the main client-side Snowplow tracker SDKs:

Tracker	Supported	Since version	Auto-tracking	Notes
Web	✅	3.0.0	❌	Requires site tracking plugin
iOS	❌
Android	❌
React Native	❌
Flutter	❌
Roku	❌
Google Tag Manager	✅	v3	❌

The social interaction event captures the social network, the action performed, and optionally the target content.

social_interaction

Event

Schema for a social interaction event

Schema URIiglu:com.snowplowanalytics.snowplow/social_interaction/jsonschema/1-0-0

Example

json

{
  "action": "like",
  "network": "facebook",
  "target": "pbz00123"
}

Properties and schema

Table

Property	Description
action string	Required. The social action performed, e.g. like, retweet, share
network string	Required. The social network, e.g. facebook, twitter
target string	Optional. The object of the social action, e.g. a page ID or product ID

JSON schema

json

{
  "$schema": "http://iglucentral.com/schemas/com.snowplowanalytics.self-desc/schema/jsonschema/1-0-0#",
  "description": "Schema for a social interaction event",
  "self": {
    "vendor": "com.snowplowanalytics.snowplow",
    "name": "social_interaction",
    "format": "jsonschema",
    "version": "1-0-0"
  },
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "description": "The social action performed, e.g. like, retweet, share"
    },
    "network": {
      "type": "string",
      "description": "The social network, e.g. facebook, twitter"
    },
    "target": {
      "type": "string",
      "description": "The object of the social action, e.g. a page ID or product ID"
    }
  },
  "required": [
    "action",
    "network"
  ],
  "additionalProperties": false
}

Warehouse query

Snowflake

sql

select
unstruct_event_com_snowplowanalytics_snowplow_social_interaction_1 social_interaction_1
from
atomic.events
where
events.collector_tstamp > getdate() - interval '1 hour'
and events.event = 'unstruct'
and events.event_name = 'social_interaction'
and events.event_vendor = 'com.snowplowanalytics.snowplow'

BigQuery

sql

select
unstruct_event_com_snowplowanalytics_snowplow_social_interaction_1_0_0
from
PIPELINE_NAME.events events
where
events.collector_tstamp > timestamp_sub(current_timestamp(), interval 1 hour)
and events.event = 'unstruct'
and events.event_name = 'social_interaction'
and events.event_vendor = 'com.snowplowanalytics.snowplow'

Databricks

sql

select
unstruct_event_com_snowplowanalytics_snowplow_social_interaction_1
from
atomic.events events
where
events.collector_tstamp > timestampadd(HOUR, -1, current_timestamp())
and events.event = 'unstruct'
and events.event_name = 'social_interaction'
and events.event_vendor = 'com.snowplowanalytics.snowplow'
and unstruct_event_com_snowplowanalytics_snowplow_social_interaction_1 is not null

Redshift & Postgres

sql

select
"social_interaction_1".*
from
atomic.events events
join atomic.com_snowplowanalytics_snowplow_social_interaction_1 "social_interaction_1"
  on "social_interaction_1".root_id = events.event_id and "social_interaction_1".root_tstamp = events.collector_tstamp
where
events.collector_tstamp > getdate() - interval '1 hour'
and "social_interaction_1".root_tstamp > getdate() - interval '1 hour'
and events.event = 'unstruct'
and events.event_name = 'social_interaction'
and events.event_vendor = 'com.snowplowanalytics.snowplow'