Data Dictionary
Start typing to search…

Use Cases for Data-In Endpoints

Triple Whale's Data-In API lets you add new data or enhance existing records to centralize your business insights. Use it to:

  • Create New Records: Upload data like ads, orders, products, or surveys from platforms Triple Whale doesn’t integrate with.
  • Enrich Existing Records: Add details like shipping costs or custom tags to data from platforms Triple Whale integrates with.

📘

Note on Processing Time

  • Data from the last 2 days will be available approximately 1 minute after sending it.
  • Data older than 2 days may take up to 15 minutes to process.

To check which platforms are supported, visit the Integrations Page. Below is an overview of the data-in endpoints, their use cases, and workflows:

Supported Endpoints

Creating New Records

1. Ads

  • Use Case: Upload ad data (spend, clicks, impressions) from non-integrated channels.
  • Example Workflow:
    1. Identify ad campaigns missing performance data.
    2. Send a POST request with Channel Name, Campaign ID, and Spend Amount.
    3. View updated metrics like ROAS and CPA.

2. Orders

  • Use Case: Upload orders (customer details, items, totals) from non-integrated platforms.
  • Example Workflow:
    1. Identify orders to add from external platforms.
    2. Send a POST request with Order ID, Customer Details, Line Items, and Transaction Totals.
    3. Metrics like Order Revenue and AOV update automatically.

3. Subscriptions

  • Use Case: Upload subscription data (billing schedules, customers) from non-integrated platforms.
  • Example Workflow:
    1. Collect subscription records to upload.
    2. Send a POST request with Subscription ID, Customer Details, and Subscription Items.
    3. Track metrics like New Subscribers and Churn.

4. Products

  • Use Case: Upload product data (details, variants) from external sources.
  • Example Workflow:
    1. Gather product details to upload.
    2. Send a POST request with Product ID, Product Title, Tags, and Variants.
    3. Analyze product performance trends.

5. Post-Purchase Surveys (PPS)

  • Use Case: Upload survey responses from non-integrated systems.
  • Example Workflow:
    1. Collect survey data linked to orders.
    2. Send a POST request with Order ID, Survey Question, and Customer Response.
    3. Link survey insights to order metrics.

Enriching Existing Records

1. Order Enrichment

  • Use Case: Add data like shipping costs or custom tags to existing orders.
  • Example Workflow:
    1. Find orders missing shipping cost data.
    2. Send a POST request with Shop, Order ID, and Shipping Costs.
    3. View updated metrics like Net Profit and POAS.

Best Practices

  • Check Data Sources: Confirm if the platform is integrated with Triple Whale before uploading data.
  • Map Fields Properly: Ensure your data matches the API schema for seamless uploads.
  • Refer to Documentation: Use API docs for detailed examples and best practices.

With the Data-In API, you can centralize your data in Triple Whale and gain better insights to drive your business forward.