Skip to main content

Custom Conversions

How to extract data from your custom conversions on ad platforms

spyne automatically extracts data from standard conversions. In addition, to extract data from your custom conversions, you need to set up some rules to help spyne identify those you’d like to extract data from.

The custom conversion will be created along with related metrics : Conversion value, CR, CPA, AOV, ROAS & COS.

GA4 Conversions
Spyne now supports GA4 conversions, with the ability to create custom conversions based on them.

  • GA4 conversions linked to campaigns from advertising platforms. The conversion name starts with 'Analytics - ' (+ conversion name). The source shown is the originating platform (e.g., Meta, TikTok, etc.).

  • GA4 conversions from Organic or Direct traffic. The conversion name is displayed directly without any specific prefix.

How to access Custom Conversion?

  1. Click your avatar at the bottom of the page, then select Workspace Settings

  2. From the navigation bar, select Metrics in the Workspace section.

How to create a custom conversion?

  1. Click Create metric

2. Configure the custom conversion details:

  • Name the conversion, e.g. Purchase Meta

  • Add a description to provide essential context for other users and for SpyneAI

  • Enter a prefix, e.g. $,€,£

  • Enter a suffix, e.g. %, kg

  • Enter decimal places. The number of decimal places to display by default is 2.

3. Select Custom Conversions

How to set up rules?

  1. Specify the channel or channels (Meta, Google, Tiktok, etc.) to which the rule should be applied. You can create different rules for each channel or use the same across multiple channels.

  2. Set up the conditions the rules apply to. Below is the detail of each condition:

Field value

  • Rules are applied to the field values. Several ways to identify the values that you want the system to extract.

    • Contain

      • It checks if a part of the text is found within the value.

    • Does not contain

      • It checks if the text is not found within the value.

    • Is in

      • It checks if the value matches any of the listed options.

    • Is not in

      • It checks if the value does not match any of the listed options.

    • Equals

      • It checks if the value is exactly the same as what is specified.

    • Matches regex

      • You can use advanced text extraction and value setting with a full regex integration, for more information about regex please visit : source.

  • For exemple,

    You want to create the conversion “Purchase Meta” that extract data from all custom conversions whose names contain “Achat”.

Text operations (modifiers)

  • Not case sensitive

    • The system ignores the distinction between uppercase and lowercase letters.

    • For example, "Hello" would be considered the same as "hello"

  • No accents

    • This option removes accents or diacritical marks from characters in the text.

    • For example, "é" would be converted to "e"

  • Trim

    • Trimming removes any leading or trailing whitespace characters (such as spaces or tabs) from the text. This ensures that the text doesn't have any unnecessary whitespace at the beginning or end.

    • For example, “ e “ would be converted to “e”

  • None of them

    • This option indicates that none of the aforementioned text operations will be applied. The text will remain unchanged regarding case sensitivity, accents, and leading/trailing whitespace.

    • For example, “ Thé “ would be converted to “ Thé “

Split

  • Split a name by a specific delimiter (e.g. “_” or “|” or “-”) to extract a sub text and match it to the dimension. To do this, use ‘split by’ to provide a delimiter.

  • For example,

    Your custom conversion name is Ventes_Soldes_Chaussures. You want to extract the 1st segment, which is “Ventes”.

Multiple conditions

  • You can combine multiple conditions with the “+ Add condition” button. Conditions can be combined as AND (both conditions must be true), OR (one of the condition must be true).

  • For exemple,

    You want to create the conversion “Purchase” that extract data from all custom conversions whose names contain “Achat” and "Purchase".

Date filter

You can now filter conversions by date directly within a rule.

  • The main use case: you changed your conversion tracking setup on a specific date.

    For example, you renamed your conversion events on May 1st 2026. Before that date, the conversion was called Achat_v1 — after, it's Achat_v2. With date filters, you can create two rules that each cover the right period, so Spyne picks up the correct conversions throughout your entire history.

  • How to set it up: Add a date condition to your rule using "+ Add condition", then select Date as the field and choose a comparison (before, after, between, etc.).

Example: same conversion, two tracking periods:

  • Rule 1 → Conversion name is Achat_v1 AND date is before May 1st 2026

  • Rule 2 → Conversion name is Achat_v2 AND date is after April 30th 2026

This way, spyne correctly aggregates your conversion data across both periods under a single custom conversion.

📌 Keep in mind

  • Each rule can have at most one date condition. For multiple date periods, create one rule per period.

  • Each rule should have at least one condition on "Conversion Name"

  • Date filters are optional — existing rules without a date filter work exactly as before.

Select calculated metrics to generate

You need to select at least one metric to continue (e.g. ROAS, CPA, CPC). Pick the metrics that matter most to you. Other calculated metrics won’t be shown right away, but you can add them anytime.

Please ensure all required fields are filled out correctly, and there are no validation errors. You need to select at least one calculated metric to continue (e.g., ROAS, CPA, CPC).

How to test rules and check the results?

You can check how the rules will apply to your existing custom conversions over the last 30 days.

Click the button Test at the top right of the page. The test results will appear above the rules section.

It will show you which conversions are applied, their sources, and the number of conversions in the last 30 days.

Publish custom conversion

Click on the 'Create custom metric' button at the top right of the page.

The custom conversion will be created along with related metrics: CPA, ROAS, COS, etc.

📌 Keep in mind

  • If you want to use this custom conversion instead of the default conversion metric, you can turn off the old one in Metric Settings.

  • If you’ve already created reports, don’t forget to update them with your new metric and KPIs.

How to manage a custom conversion ?

After the custom conversion is published, it will appear in the table under the Custom Metrics section. To edit it, click the metric name in the table.

Or by selecting the ‘…’ menu in the header, you can edit, delete or duplicate the metric.

How to update custom conversion in case of changes?

Click on "Update conversion" if you have made changes. Or, click on "Discard changes" if you do not want to save the changes.


Platform specificities

Meta

⚠️ Some Meta pixel events may not appear in spyne — here's why.

Meta treats pixel events as two separate categories:

  • Standard events (e.g., Purchase, Lead, AddToCart) are natively recognized by Meta and fully accessible through their API — which is how spyne pulls your data.

  • Custom events (e.g., NewCustomer - Purchase) are received by your pixel and visible in your Meta Events Manager, but Meta does not expose them through their API. As a result, spyne has no way to retrieve them directly.

How to fix it:

You need to register your custom event as a Custom Conversion in Meta Events Manager. Once set up, Meta will make it available via the API, and it will automatically appear in spyne.

  1. Go to Meta Events ManagerCustom Conversions section.

  2. Create a new Custom Conversion based on your custom event (e.g., NewCustomer - Purchase).

  3. Once saved, the conversion will be accessible via the Meta API and can be set up in spyne following the steps above.

Did this answer your question?