Developer Center
Back to Engine.tech
  • Welcome!
  • Top of Funnel Applications
    • Embeddable Calculators
      • Embeddable Personal Loan Calculator
      • Embeddable Debt Consolidation Loan Calculator
      • Embeddable Personal Loan vs Debt Relief Calculator
      • Embeddable Savings Calculator
      • Adding Your Client Tags for Reporting Attribution
  • Loans / Savings / Second Look Marketplace
    • Hosted Integrations
      • Partner Pages / Embeds
        • Loans Partner Pages
          • Frond-End Customization Options
          • Preferred Look Partner Pages
          • Bridge Partner Pages
          • Special Offer Partner Pages
        • Loans Embeds
        • Pre-Populating Existing Customer Data
        • Adding Your Client Tags for Reporting Attribution
      • Mobile SDK
        • Mobile SDK - Prefilling Lead Data
        • Adding Your Client Tags to Reporting for Mobile SDK Integrations
        • Event Handlers for Real-Time Tracking in the Engine Mobile SDK
    • Native API (Build Your Own)
      • Financial Product Verticals
        • Loans
          • Personal Loans
            • Collecting User Information for Personal Loans
            • Displaying Personal Loan Offers
            • API Specifications
            • FAQs
          • Home Equity Line of Credit (HELOC)
            • Displaying Offers HELOC
            • Risk Factors & Requirements
            • Dos & Don’ts for All HELOC Supply Partners
            • Dos & Don’ts for HELOC Native Partners (API)
            • Our Embed/Partner Page Implementation
            • HELOC-specific disclosures
          • Auto Loan Refinancing (ALR)
            • Collecting User Information
            • Displaying Auto Loan Refinance Offers
            • API Specifications
            • FAQs
        • Savings
          • Collection User Information for Savings
          • Displaying Savings Offers
          • Marketplace Display Requirements
          • Reporting
          • API Specifications
        • 2nd Look Marketplace
          • 2nd Look Marketplace (Financial Services Providers)
          • 2nd Look Marketplace (Channel Partners)
            • Collecting User Information for 2LM
            • Displaying 2L Marketplace Offers
      • Adding Your Client Tags to Reporting for Native API Integrations
      • General Compliance Guidelines
        • Consumer Information Fields
          • Additional Compliance Recommendations & Best Practices
        • Disclosures
        • Consents
        • Offer Display Fields
    • Reporting Options for Channel Partners
      • Channel Partner Reporting - Looker
      • Channel Partner Reporting - Analytics API
  • Credit Cards Marketplace
    • Native API (Build Your Own)
      • Getting Started
      • Flow Design
      • Collecting User Information for Credit Cards
      • Displaying Credit Card Offers
      • API Specifications
      • Compliance Guidelines
  • New Marketplaces (Credit Builders, Earned Wage Access, Debt Relief)
    • Hosted Integrations
      • New Marketplaces Embeds
      • Adding Your Client Tags for Reporting Attribution
  • References
    • Brand Guidelines and Assets
    • Appendix
      • Appendix A - Notices
      • Appendix B - Disclosures
      • Appendix C - Consents
      • Appendix D: API Field to Offer Card Mappings
      • Appendix E: Appending Client Tags for Partner Page and Embed Integrations
Powered by GitBook
On this page
  • How to Structure Client Tags (for Either Hosted Integration Type)
  • Where to Place Client Tags (Different by Hosted Integration Type)
  • Partner Page
  • Embed
  • Supported Client Tag Keys

Was this helpful?

  1. References
  2. Appendix

Appendix E: Appending Client Tags for Partner Page and Embed Integrations

This page has instructions for appending your own Client Tags to leads coming through Engine's marketplace.

Partner Pages and Embeds support adding your unique Client Tags to track performance of specific campaigns or users. All Client Tag data is attributed to the lead level. The instructions here are the same regardless of the product vertical, as they all use the same underlying technical infrastructure.

How to Structure Client Tags (for Either Hosted Integration Type)

Regardless of the integration type, Client Tags can be added via query parameters at the end of the respective URL in the below format*:

tag.{key1}={value1}&tag.{key2}={value2}

where the {key} represents your general identifier, e.g. clientId or subId, and {value} represents the value for that specific individual, e.g. "client1" or "client2."

Where to Place Client Tags (Different by Hosted Integration Type)

In the below examples, tag.clientId=c1 means the lead will be stored with a clientId of "c1", and a source of "email", which can now be provided in reporting.

Partner Page

To add Client Tags in a Partner Page, append the parameters to the end of the {provided_moneylion_url} as follows:

{provided_moneylion_url}?tag.clientId=c1&tag.source=email

*The first query parameter appended at the end of a URL/path should start with a question mark ?; all subsequent parameters should start with an ampersand &

Embed

To add Client Tags in an Embed, use the following syntax in the tags attribute on the opening custom moneylion-{some-product} tag as follows:

*The first query parameter for Embeds should not include a question mark ?, but every key/value pair of tags must be separated by an ampersand &

Supported Client Tag Keys

These are the keys that are currently fully supported. If a different key is needed, please reach out to your partner manager - we may be able to accommodate, but adding nonstandard keys will increase the time it takes Engine to report Client Tag values back to you and is therefore not recommended. Please note that the keys below are case-sensitive.

  • agentId

  • campaignId

  • clientId

  • deviceid

  • medium

  • sourceId

  • subid

  • subid1

  • subid2

  • subid3

  • target

  • trafficsource

  • userid

PreviousAppendix D: API Field to Offer Card Mappings

Last updated 3 months ago

Was this helpful?