How to connect my data to the video

Blings MP5 experiences render in real time from the data you provide. The same project can be delivered through a CRM link, spreadsheet batch, hosted landing page, custom web page, SDK call, API-backed app, or mobile WebView as long as the data keys match the project's Dynamic Data schema.

Start in Platform Integration when you need project-specific delivery instructions:

Integration

Use Platform Simulation separately to validate representative viewer profiles and rendered personalization.

Simulation

Use this page to choose the integration pattern and open the correct implementation guide.

Integration Options

Option	Best for	How data reaches the MP5
CRM merge fields in URL parameters	Email, SMS, push, and lifecycle campaigns managed in tools such as Salesforce, Braze, HubSpot, Klaviyo, Marketo, Iterable, Mailchimp, or Adobe Journey Optimizer.	The generated video URL contains query parameters whose values are CRM merge tags.
Dynamic thumbnail	Email or messaging campaigns that need a personalized preview image or GIF.	The thumbnail URL uses the same or related parameters as the video link.
Spreadsheet or CSV	Manual campaigns, demos, controlled test batches, and one-time sends.	A CSV row provides the values for a viewer or record.
CRM-hosted landing page	CRM or ESP teams that need the page to live on their domain or inside their landing-page system.	The CRM injects merge-tag values into JavaScript or page variables before the player loads.
Custom HTML page	Web teams that want to host the MP5 player inside their own web property without relying on a CRM page.	The page initializes the Blings SDK and passes data from the page, URL, or web app.
SDK with custom API	Product, authenticated web, CDP, warehouse, or backend-driven flows.	Your code fetches or assembles JSON data, then passes it into BlingsPlayer.create.
Mobile WebView	Native iOS or Android apps.	The app opens a Blings-hosted or custom MP5 page and passes data through URL parameters, page state, or SDK logic.

How to Choose

Requirement	Choose
You need the fastest no-code campaign launch from a CRM or ESP.	CRM merge fields in URL parameters.
The message should show a personalized thumbnail before the click.	CRM merge fields plus Dynamic Thumbnail.
You are testing, running a proof of concept, or sending to a fixed list.	Spreadsheet or CSV.
The CRM must own the page URL, consent layer, template, or analytics wrapper.	CRM-hosted landing page.
Data should not appear in the URL.	CRM-hosted landing page, custom HTML page, or SDK with custom API.
Personalization depends on backend logic, authentication, product state, or multiple data sources.	SDK with custom API.
The MP5 is part of an app experience instead of a campaign click.	SDK with custom API or Mobile WebView.
You need custom JavaScript on the hosted page.	Platform Integration custom code or a custom HTML page.

The integration method can change by channel. A project can use CRM URLs for email, SDK/API for an authenticated web app, and a WebView URL for mobile as long as each path provides the same expected data fields.

Get the Correct Project Instructions

Before building the integration, collect these values from Platform:

1. Project and environment: Confirm you are using the correct project, account, and published or draft state.

2. Dynamic Data schema: Open Settings -> Dynamic Data and record the exact field names, types, and required values.

3. Simulation profiles: Create representative profiles and confirm the MP5 renders correctly before copying delivery instructions.

4. Landing page settings: Open Integration -> Landing Page, confirm the selected lineup, URL alias, page metadata, and social thumbnail, then save.

5. Integration method output: Open the correct Integration Methods tab and copy the generated CRM, Spreadsheet, or SDK instructions.

6. Thumbnail output: If email needs a dynamic thumbnail, copy the thumbnail URL after the video URL and parameter mapping are stable.

7. Fallback rules: Document what should happen when fields are missing, invalid, too long, or unavailable.

8. End-to-end test path: Test from the CRM, CSV upload, web app, API page, or mobile app using values that match a Simulation profile.

Do not copy example code or URLs from another project. Platform-generated outputs include project-specific URLs, IDs, lineup references, and field names.

Data Shape

The MP5 data keys must match the project schema. Values can come from CRM merge tags, query parameters, CSV columns, JavaScript variables, or a JSON payload.

{
  "first_name": "Jordan",
  "plan": "Premium",
  "account_balance": 1250,
  "profile_image": "https://example.com/jordan.jpg",
  "renewal_date": "2026-12-31"
}

Common field types include text, numbers, dates, image URLs, audio URLs, colors, booleans, category values, catalog IDs, CTA links, and internal routing values.

Open the Relevant Guide

CRM data integrationEmbedding GIF with Blings Dynamic ThumbnailSpreadsheet Data IntegrationCustom API IntegrationGetting Started with Blings.io Dynamic Video SDK