Placement metrics sources

Every placement syncs metrics from one integration setting in its publication. By default, it uses the first active setting, ordered by when the setting was created. New settings do not change that default. You can assign another setting to an individual placement.

This works for every publication type. For example, one social publication can use Instagram for Stories and TikTok for Videos. A Display publication can keep Google Ad Manager for banners and use Klaviyo forms for its popup.

Choose a source from a placement

1. Configure the connections you need in the publication's Integration settings.
2. Edit a placement and find the Metrics source card. It always shows the effective setting.
3. With two or more settings, choose Choose source. Select an integration, then save. The integration marked Publication default restores inheritance.

With one setting, the card shows that setting and the selector is disabled. With no settings, it explains that an integration needs to be configured first. The setting's timezone, URL matching rules, and automatic sync preference apply to every placement assigned to it. Editing the setting updates all those placements without copying its configuration.

Assign placements from an integration

Open a configured integration in the publication and scroll to Placement metrics. If the connection has several settings in this publication, choose the setting at the top of the page first. Select the placements that should use this setting, then choose Save placements. Selecting a placement moves it from its previous source. Removing an assignment restores the publication default. To move a placement away from the default, select it under another setting or change its source in the placement editor.

Both screens edit the same assignment. Manual fetches, scheduled jobs, automations, and backfills all use the selected setting. A queued job for an older source cannot overwrite metrics after the assignment changes. Social totals come only from the selected platform; they do not add previously fetched metrics from other platforms.

Disconnecting, deactivating, or deleting an explicitly selected setting shows a source error. Sponsy does not switch to another source. Inherited placements skip inactive settings and use the next active setting. Deactivating or deleting the first active setting changes the default for placements that inherit it; explicit assignments to that deleted setting remain unavailable.

Configure Klaviyo forms

In the publication's Klaviyo settings, select Signup forms under Metrics report and choose the Klaviyo account's reporting timezone. Keep Email campaigns for email reporting. Assign the popup placement to the signup-form setting.

Klaviyo forms reuse your connected private API key. It needs forms:read, in addition to the accounts:read access used to identify your Klaviyo account. Update the key permissions in Klaviyo if Sponsy reports a permission error. Form reporting is excluded from publication subscriber statistics.

How forms are matched

Add the form's redirect destination to the slot's existing links or link-containing content fields. Sponsy uses the booking dates to look for likely forms first, then searches the form catalog if needed. The slot URL must match the form’s current destination. Once matched, Sponsy imports the form’s lifetime totals, including activity outside the booking dates and earlier form versions. Form names are not used, and there is no manual form selection.

URL matching uses Sponsy's usual normalization, including protocol and trailing-slash differences. With query matching off, query parameters are ignored. With it on, the slot's parameters must match when the source URL supplies parameters, following the existing integration matching rules.

Sponsy requires one unambiguous form. It saves the matching evidence with the report and checks the current connection, URLs, dates, and definitions on each refresh. The current destination identifies the form; historical version definitions are not required.

Metrics and dates

The slot's Klaviyo form metrics section uses the labels Impressions, Clicks, and CTR. The info icons explain what each form metric means. CTR is displayed with up to three decimal places, for example 0.895%.

On the customer portal's slot Metrics tab, Impressions, CTR, and Clicks appear together. Impressions are not separated into a Website section. The portal's metric visibility settings still apply. Submits are not unique clicks or email clicks, and form sync does not recalculate slot pricing from submits.

Reports cover the form’s creation day through today in the Klaviyo account timezone. Slot dates help find the form but do not limit its metrics. Klaviyo allows at most one year per request, so Sponsy splits longer histories into consecutive periods and adds the views and submits. A single-period report uses Klaviyo’s native submit rate; across multiple periods the rate is total submits divided by total views. The original values and date ranges are kept with the report. A successful refresh replaces the totals. If any request fails, the previous metrics are kept.

Use Get slot metrics for an older booking outside the automatic sync window. Automatic sync normally considers bookings starting in the last 14 days. Discovery is cached for five minutes and reports for one hour, so repeated requests can return the same report while that cache is valid.

Troubleshooting

• No matching destination: check the slot URL against the form's current redirect destination, including query parameters if strict matching is enabled. Booking dates help narrow the search but do not require a historical destination definition.
• Multiple forms match: check whether several forms use the same destination. Sponsy needs one matching form and will not guess between ambiguous candidates.
• API key rejected (401): update the private API key on the workspace connection. This is an authentication failure, not missing form data.
• Permission or connection error: restore the required key permissions or select an available connection in placement settings.
• Rate limit: wait for the retry time in the error. Klaviyo allows two form reports per minute and 225 per day. Sponsy coordinates requests across workers and retries temporary failures; requests from other tools using the same account can also use that allowance.

This integration fetches metrics. It does not send creative copy, images, or destination URLs into Klaviyo.