SamCart

Set Up Webhooks

Follow the instructions below to pull your sales data in real time. Optionally, follow the instructions below to connect with the SamCart API to enrich your webhook data for better data quality.

Note that webhooks and optionally the SamCart API connection must be set up first before importing historical sales data to avoid gaps in your data.

  1. Log into LTV Numbers

  2. In LTV Numbers’ side navigation bar, go to the "Settings" tab

  3. Click the "Copy" button for your Webhook URL in the “SamCart Integrations” section. You will paste this into SamCart at a later step

  4. In a separate browser window or tab, log into SamCart

  5. Confirm you are in the appropriate SamCart Marketplace dashboard

  6. In SamCart’s top right navigation bar, click on the Settings gear

  7. In the left menu, click Integrations

  8. In the Integrations Setup tab, click the New Integration

  9. Select Notify URL in the dropdown of the popup window and click Next Step

  10. In the Name this Integration field, type “LTV Numbers”

  11. Paste the Webhook URL you copied from LTV Numbers earlier into SamCart's Notify URL field

  12. Click Save Integration to create the webhook connection

    • Note: this only creates the connection. The next steps define what that integration is used for

Optional: Connect With SamCart Via API

Connecting with SamCart via API enriches the SamCart webhook data for better quality. If you have the ability to connect to SamCart via API, you should.

Note that the API cannot create webhooks so follow the instructions above for setting up webhooks first before connecting with the SamCart API and importing historical sales data to avoid gaps in your data.

  1. In LTV Numbers’ side navigation bar, go to the "Settings" tab

  2. Log into LTV Numbers

  3. Click the "Connect With SamCart" button in the integrations list

  4. Fill in the required information, following the on screen instructions:

    • API Key: Follow the on screen instructions. Note that the SamCart API is in closed beta and requires a personal request to generate an API key.

    • Account ID: This is the ID seen in the browser URL when logged in that comes that looks like "ACCOUNTID.samcart.com".

    • Marketplace Name: The Marketplace Name can be found by clicking on the Settings gear in the top right, then looking for GENERAL MARKETPLACE SETTINGS > Marketplace Name.

  5. Click "Submit" to create the integration and be taken into it's settings

    • Note: no data is synced until you complete the steps below

  6. Select an appropriate date range to import your existing data to import your data

  7. Click "Sync Data" to sync your data

    • Note: this process may take some time to complete

Create A Rule For Order Completed

  1. Go to the Global Rules tab of the SamCart integration rules engine

  2. Click New Rule

  3. In the Webhook Rule popup box, select eCommerce as the trigger type and Order Completed as the trigger, then click Next Step

  4. In the Integration dropdown, select the LTV Numbers integration created in the previous section and select Send Notify URL POST in the Action dropdown

  5. Click Next Step then click Submit to finish setting up the product purchased rule

Create A Rule For Subscription Charged

  1. Go to the Global Rules tab of the SamCart integration rules engine

  2. Click New Rule

  3. In the Webhook Rule popup box, select eCommerce as the trigger type and Subscription Charged as the trigger, then click Next Step

  4. In the Integration dropdown, select the LTV Numbers integration created in the previous section and select Send Notify URL POST in the Action dropdown

  5. Click Next Step then click Submit to finish setting up the subscription charged rule

Historical Sales Data

After setting up webhooks to pull in real time sales data, import your one time orders, indefinite recurring subscriptions, and limited subscriptions for a complete picture of your data

Export SamCart Recurring Subscriptions Data

  1. In SamCart’s top navigation bar go to Activity > Subscriptions

  2. In the Recurring Subscriptions section, click Export CSV File

  3. In the Export Report popup, set the Export Time Range to All Time

  4. In the Email field, enter your email address you would like the export sent to and click Confirm

    • Note: this process may take some time to complete but you can continue to the next steps

  5. Check your email for the export file and save it to your computer

Export SamCart Limited Subscriptions Data

  1. In SamCart’s top navigation bar go to Activity > Subscriptions

  2. In the Limited Subscriptions section, click Export CSV File

  3. In the Export Report popup, set the Export Time Range to All Time

  4. In the Email field, enter your email address you would like the export sent to and click Confirm

    • Note: this process may take some time to complete but you can continue to the next steps

  5. Check your email for the export file and save it to your computer

Export SamCart Order Data

  1. In SamCart’s top navigation bar go to Activity > Orders

  2. In the lower right, click Export CSV File

  3. In the Export Report popup, set the Export Time Range to All Time

  4. In the Email field, enter your email address you would like the export sent to and click Confirm

    • Note: this process may take some time to complete but you can continue to the next steps

  5. Check your email for the export file and save it to your computer

Import SamCart Historical Data Into LTV Numbers

  1. Follow the instructions for Uploading Data into LTV Numbers to upload your Samcart Recurring Subscriptions, SamCart Limited Subscriptions, and SamCart Orders

    • Note: be sure to upload each data type separately

Enable UTM Tracking

If you have not already done so, follow the steps below to enable UTM tracking, which will enable even more analysis

  1. In SamCart’s top right navigation bar, click on the Settings gear

  2. In the General tab, scroll to the Marketing Analytics (Optional) section

  3. Enter each UTM parameter into their corresponding fields, i.e. "utm_medium" in the Medium URL Parameter field

  4. Click Save Changes

SamCart Limitations And Notes

  • Comparing SamCart and LTV Numbers UIs is not apples to apples:

    • SamCart's date range only selects orders that were made during the date range selected

    • LTV Numbers' date range selects payments made during the date range selected, regardless of when the original order was placed

    • This difference comes into play most notably with rebill payments (subscription payments after the initial charge) as SamCart will not include these payments while LTV Numbers will

PreviousPayPalNextShopify

Last updated