Documentation & Guides

Everything you need to install, configure, and integrate Attributer with your marketing stack.

Add the Attributer tracking script before the </head> tag on every page of your website:

<script
  src="https://your-domain.com/sdk/v1/attributer.js"
  data-tracking-id="attr_your_tracking_id"
  async
></script>

Once installed, Attributer automatically listens for visits, parses UTM parameters and Google Ads click identifiers (GCLID, GBRAID), and writes the attribution data to form hidden fields.

Add these hidden inputs to your website forms. Attributer automatically discovers and populates them:

• channel              (e.g. Paid Search, Paid Social, Organic Search, Direct)
• source               (e.g. google, linkedin, newsletter)
• medium               (e.g. cpc, paid_social, email)
• campaign             (e.g. q1_growth, brand_2026)
• drilldown1           (e.g. google, linkedin)
• drilldown2           (e.g. brand_campaign_name)
• drilldown3           (e.g. ad_variant_headline)
• gclid                (Google Ads click ID)
• landing_page_group   (e.g. /features, /pricing)
• submit_page          (URL where the form was submitted)

Attributer natively supports standard field names across popular form builders and CRMs:

• HubSpot: Automatically fills fields like hs_lead_source and custom contact properties.
• Salesforce: Maps to LeadSource, First_Click_Source__c, and First_Click_Medium__c.
• WordPress / Gravity Forms / Contact Form 7: Maps wpcf7-channel, gform_channel, and standard form inputs.
• Webflow & Typeform: Supports data-attributer-field="channel" attribute selectors.

Whenever a lead is created, Attributer dispatches an HTTP POST webhook with a timing-safe HMAC-SHA256 signature in the X-Attributer-Signature header.

Verify signatures using your webhook secret:
const expected = "sha256=" + crypto.createHmac("sha256", secret).update(rawBody).digest("hex");