Interaction Upload API

curl --request POST \
  --url 'https://api.askmiso.com/v1/interactions?api_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": [
    {
      "type": "product_detail_page_view",
      "duration": 61.5,
      "product_ids": [
        "123ABC-BLACK"
      ],
      "product_group_ids": [
        "123ABC"
      ],
      "user_id": "user_1234",
      "anonymous_id": "86D51273AD8BF84217E1567B6CBE7152D7034404",
      "timestamp": "2023-11-07T05:31:56Z",
      "miso_id": "123e4567-e89b-12d3-a456-426614174000",
      "context": {
        "campaign": {
          "name": "spring_sale",
          "source": "Google",
          "medium": "cpc",
          "term": "running+shoes",
          "content": "textlink"
        },
        "truncated_ip": "1.1.1.0",
        "locale": "en-US",
        "region": "US East",
        "user_agent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0",
        "custom_context": {
          "session_variable_1": [
            "value_1",
            "value_2"
          ]
        }
      }
    }
  ]
}
'

import requests

url = "https://api.askmiso.com/v1/interactions?api_key="

payload = { "data": [
        {
            "type": "product_detail_page_view",
            "duration": 61.5,
            "product_ids": ["123ABC-BLACK"],
            "product_group_ids": ["123ABC"],
            "user_id": "user_1234",
            "anonymous_id": "86D51273AD8BF84217E1567B6CBE7152D7034404",
            "timestamp": "2023-11-07T05:31:56Z",
            "miso_id": "123e4567-e89b-12d3-a456-426614174000",
            "context": {
                "campaign": {
                    "name": "spring_sale",
                    "source": "Google",
                    "medium": "cpc",
                    "term": "running+shoes",
                    "content": "textlink"
                },
                "truncated_ip": "1.1.1.0",
                "locale": "en-US",
                "region": "US East",
                "user_agent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0",
                "custom_context": { "session_variable_1": ["value_1", "value_2"] }
            }
        }
    ] }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    data: [
      {
        type: 'product_detail_page_view',
        duration: 61.5,
        product_ids: ['123ABC-BLACK'],
        product_group_ids: ['123ABC'],
        user_id: 'user_1234',
        anonymous_id: '86D51273AD8BF84217E1567B6CBE7152D7034404',
        timestamp: '2023-11-07T05:31:56Z',
        miso_id: '123e4567-e89b-12d3-a456-426614174000',
        context: {
          campaign: {
            name: 'spring_sale',
            source: 'Google',
            medium: 'cpc',
            term: 'running+shoes',
            content: 'textlink'
          },
          truncated_ip: '1.1.1.0',
          locale: 'en-US',
          region: 'US East',
          user_agent: 'Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0',
          custom_context: {session_variable_1: ['value_1', 'value_2']}
        }
      }
    ]
  })
};

fetch('https://api.askmiso.com/v1/interactions?api_key=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.askmiso.com/v1/interactions?api_key=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'data' => [
        [
                'type' => 'product_detail_page_view',
                'duration' => 61.5,
                'product_ids' => [
                                '123ABC-BLACK'
                ],
                'product_group_ids' => [
                                '123ABC'
                ],
                'user_id' => 'user_1234',
                'anonymous_id' => '86D51273AD8BF84217E1567B6CBE7152D7034404',
                'timestamp' => '2023-11-07T05:31:56Z',
                'miso_id' => '123e4567-e89b-12d3-a456-426614174000',
                'context' => [
                                'campaign' => [
                                                                'name' => 'spring_sale',
                                                                'source' => 'Google',
                                                                'medium' => 'cpc',
                                                                'term' => 'running+shoes',
                                                                'content' => 'textlink'
                                ],
                                'truncated_ip' => '1.1.1.0',
                                'locale' => 'en-US',
                                'region' => 'US East',
                                'user_agent' => 'Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0',
                                'custom_context' => [
                                                                'session_variable_1' => [
                                                                                                                                'value_1',
                                                                                                                                'value_2'
                                                                ]
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.askmiso.com/v1/interactions?api_key="

	payload := strings.NewReader("{\n  \"data\": [\n    {\n      \"type\": \"product_detail_page_view\",\n      \"duration\": 61.5,\n      \"product_ids\": [\n        \"123ABC-BLACK\"\n      ],\n      \"product_group_ids\": [\n        \"123ABC\"\n      ],\n      \"user_id\": \"user_1234\",\n      \"anonymous_id\": \"86D51273AD8BF84217E1567B6CBE7152D7034404\",\n      \"timestamp\": \"2023-11-07T05:31:56Z\",\n      \"miso_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n      \"context\": {\n        \"campaign\": {\n          \"name\": \"spring_sale\",\n          \"source\": \"Google\",\n          \"medium\": \"cpc\",\n          \"term\": \"running+shoes\",\n          \"content\": \"textlink\"\n        },\n        \"truncated_ip\": \"1.1.1.0\",\n        \"locale\": \"en-US\",\n        \"region\": \"US East\",\n        \"user_agent\": \"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0\",\n        \"custom_context\": {\n          \"session_variable_1\": [\n            \"value_1\",\n            \"value_2\"\n          ]\n        }\n      }\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.askmiso.com/v1/interactions?api_key=")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": [\n    {\n      \"type\": \"product_detail_page_view\",\n      \"duration\": 61.5,\n      \"product_ids\": [\n        \"123ABC-BLACK\"\n      ],\n      \"product_group_ids\": [\n        \"123ABC\"\n      ],\n      \"user_id\": \"user_1234\",\n      \"anonymous_id\": \"86D51273AD8BF84217E1567B6CBE7152D7034404\",\n      \"timestamp\": \"2023-11-07T05:31:56Z\",\n      \"miso_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n      \"context\": {\n        \"campaign\": {\n          \"name\": \"spring_sale\",\n          \"source\": \"Google\",\n          \"medium\": \"cpc\",\n          \"term\": \"running+shoes\",\n          \"content\": \"textlink\"\n        },\n        \"truncated_ip\": \"1.1.1.0\",\n        \"locale\": \"en-US\",\n        \"region\": \"US East\",\n        \"user_agent\": \"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0\",\n        \"custom_context\": {\n          \"session_variable_1\": [\n            \"value_1\",\n            \"value_2\"\n          ]\n        }\n      }\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.askmiso.com/v1/interactions?api_key=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"data\": [\n    {\n      \"type\": \"product_detail_page_view\",\n      \"duration\": 61.5,\n      \"product_ids\": [\n        \"123ABC-BLACK\"\n      ],\n      \"product_group_ids\": [\n        \"123ABC\"\n      ],\n      \"user_id\": \"user_1234\",\n      \"anonymous_id\": \"86D51273AD8BF84217E1567B6CBE7152D7034404\",\n      \"timestamp\": \"2023-11-07T05:31:56Z\",\n      \"miso_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n      \"context\": {\n        \"campaign\": {\n          \"name\": \"spring_sale\",\n          \"source\": \"Google\",\n          \"medium\": \"cpc\",\n          \"term\": \"running+shoes\",\n          \"content\": \"textlink\"\n        },\n        \"truncated_ip\": \"1.1.1.0\",\n        \"locale\": \"en-US\",\n        \"region\": \"US East\",\n        \"user_agent\": \"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0\",\n        \"custom_context\": {\n          \"session_variable_1\": [\n            \"value_1\",\n            \"value_2\"\n          ]\n        }\n      }\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "message": "success"
}

{
  "message": "invalid api key."
}

{
  "message": "Request is denied due to bot blocking. Please only access this API from a real browser or use Secret API Key instead."
}

{
  "errors": true,
  "message": "None of the records were inserted because at least one of them contained schema errors. Please see the `data` field for details.",
  "data": [
    "data.0.product_ids is invalid. The attribute was expected to be of type ''array', 'null'' but type 'string' was given.",
    "data.0.timestamp is invalid. The attribute should match the 'date-time' format."
  ]
}

Interaction APIs

Interaction Upload API

Miso’s Interaction APIs let you manage your Interaction records stored with Miso.

Interaction records

Your Interaction records tell Miso about user interactions with products and content on your site or application. From these interactions, Miso understands how users move through your conversion funnels: which products or content assets attract the attention of each individual user, and which products or content ultimately will be purchased or consumed by each of them. With these insights, Miso makes real-time tailored recommendations for each user, and responds to each of their clicks and views on the site (even for anonymous users).

Interaction records share some common attributes, but are distinguished by their type. Miso captures 23 different interaction types, divided into the following 6 groups:

Core click-streams

product_detail_page_view: a user viewed the detail page for a product
search: a user made a search request with keywords and (optionally) filters

The above interactions are the core fuel for Miso’s personalization Engines, because they happen in a much higher frequency than other interactions and provide an unbiased and high-fidelity view of users’ interests on the site. The collection of these interactions is highly important for Miso’s personalization performance. At the minimum, you should implement the product_detail_page_view interaction to start with.

Conversion (eCommerce)

add_to_cart: a user added a product to the shopping cart
remove_from_cart: a user removed a product from the shopping cart
checkout: a user checked out and started the payment process
refund: a user refunded the product
subscribe: a user subscribed to a product

The above interactions are the main revenue drivers for eCommerce sites. It’s important to collect them so that Miso can not only drive click-through rates, but actually improve the revenue in a targeted way. To start with, you should at least implement the add_to_cart interaction.

Consumption (content media)

read, watch, and listen interactions capture how and for how long a user consumed a piece of content.
add_to_collection: a user added an product to their personal collection
remove_from_collection: a user removed an product from their personal collection

If you are a content site, the above interactions are the main drivers to users’ satisfaction on the site. Collecting these interactions allows Miso to drive consumption rates and consumption durations for the content on your site. If you run a content site, you should implement at least one of these interactions.

Feedback signals

like, dislike, share, rate, and bookmark are common ways users express their interests.

These are strong signals for Miso to understand each user’s preferences regarding your products or content. You should send these signals to Miso if you have any of these UI patterns on your site.

Performance Checking

impression: a user saw or was presented with a product or content asset (but didn’t yet interact with it)
viewable_impression: the product or content presented is actually viewed by the user (for example, minimum of 50% of the pixels were in viewable space for at least one continuous second.)
click: a user clicked on something (for example, a product item)

Additional click-streams

home_page_view: user viewed your home page
category_page_view: a user viewed the page for a specific “group” or “family” or products or content in your catalog
promo_page_view: user viewed the promotion pages about certain products
product_image_view: user clicked on or otherwise interacted with the product image (e.g. enlarged the image)

The above interactions are additional signals for Miso to understand users’ behavior on the site.

Custom

custom interaction types are reserved for you to define your own business-specific interaction types.

Miso will analyze any custom interactions you define to infer users’ interests and preferences.

Bulk API to insert Interaction records. This endpoint accepts POST requests with JSON data containing an array of Interaction records wrapped in a dictionary:

POST /v1/interactions

{"data": [interaction_1, interaction_2, interaction_3]}

For real-time tracking, we recommend sending the interaction records to this API as soon as the interactions take place. This API is also ideal for bulk-inserting historical records that your site collected before using Miso. Miso can analyze the historical records and provide personalization for your users from the get-go. We recommend limiting your calls to around 10,000 records at a time to avoid memory issues or timeout risks.

Anonymous users

For users who did not sign in, we can still make recommendations for them by tracking their anonymous_id, which is a pseudo-unique substitute for the user_id. The personalization and search APIs all accept anonymous_id in the place of user_id to return tailored results for anonymous users.

When an anonymous user later signs in and the user_id and anonymous_id are both present, the anonymous_id will be linked to the user_id along with the past interactions associated with it.

The typical mechanism to generate an anonymous_id is to use cookies or the browser localStorage. However, if you don’t collect such information in your historical records, a hash of the IP address, optionally combined with the User-Agent string, is also a reasonable substitute for anonymous_id, and is most likely collected by your web server logs already.

Schema validation

The Interaction Upload API will validate the inserted records against the API schema. Any schema errors will cause the whole request to fail, and none of the records will be inserted (status_code=422). You should check the response.errors field to see if there are any errors.

For example, the response below means there are no errors (status_code=200):

{
    "message": "success"
}

Any schema error will cause the whole request to fail: the API will return status_code=422, and none of the records will be inserted. You should check data field in the response to see where the errors are located. For example, the response below means there are schema errors in the interaction record at index 0:

{
    "errors": true, // there are errors. please check!
    "message": "None of the records were inserted because at least one of them contained schema errors. Please see the `data` field for details.",
    "data": [
        "data.0.product_ids is invalid. The attribute was expected to be of type ''array', 'null'' but type 'string' was given.",
        "data.0.timestamp is invalid. The attribute should match the 'date-time' format."
    ]
}

POST

interactions

Interaction Upload API

curl --request POST \
  --url 'https://api.askmiso.com/v1/interactions?api_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": [
    {
      "type": "product_detail_page_view",
      "duration": 61.5,
      "product_ids": [
        "123ABC-BLACK"
      ],
      "product_group_ids": [
        "123ABC"
      ],
      "user_id": "user_1234",
      "anonymous_id": "86D51273AD8BF84217E1567B6CBE7152D7034404",
      "timestamp": "2023-11-07T05:31:56Z",
      "miso_id": "123e4567-e89b-12d3-a456-426614174000",
      "context": {
        "campaign": {
          "name": "spring_sale",
          "source": "Google",
          "medium": "cpc",
          "term": "running+shoes",
          "content": "textlink"
        },
        "truncated_ip": "1.1.1.0",
        "locale": "en-US",
        "region": "US East",
        "user_agent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0",
        "custom_context": {
          "session_variable_1": [
            "value_1",
            "value_2"
          ]
        }
      }
    }
  ]
}
'

import requests

url = "https://api.askmiso.com/v1/interactions?api_key="

payload = { "data": [
        {
            "type": "product_detail_page_view",
            "duration": 61.5,
            "product_ids": ["123ABC-BLACK"],
            "product_group_ids": ["123ABC"],
            "user_id": "user_1234",
            "anonymous_id": "86D51273AD8BF84217E1567B6CBE7152D7034404",
            "timestamp": "2023-11-07T05:31:56Z",
            "miso_id": "123e4567-e89b-12d3-a456-426614174000",
            "context": {
                "campaign": {
                    "name": "spring_sale",
                    "source": "Google",
                    "medium": "cpc",
                    "term": "running+shoes",
                    "content": "textlink"
                },
                "truncated_ip": "1.1.1.0",
                "locale": "en-US",
                "region": "US East",
                "user_agent": "Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0",
                "custom_context": { "session_variable_1": ["value_1", "value_2"] }
            }
        }
    ] }
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    data: [
      {
        type: 'product_detail_page_view',
        duration: 61.5,
        product_ids: ['123ABC-BLACK'],
        product_group_ids: ['123ABC'],
        user_id: 'user_1234',
        anonymous_id: '86D51273AD8BF84217E1567B6CBE7152D7034404',
        timestamp: '2023-11-07T05:31:56Z',
        miso_id: '123e4567-e89b-12d3-a456-426614174000',
        context: {
          campaign: {
            name: 'spring_sale',
            source: 'Google',
            medium: 'cpc',
            term: 'running+shoes',
            content: 'textlink'
          },
          truncated_ip: '1.1.1.0',
          locale: 'en-US',
          region: 'US East',
          user_agent: 'Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0',
          custom_context: {session_variable_1: ['value_1', 'value_2']}
        }
      }
    ]
  })
};

fetch('https://api.askmiso.com/v1/interactions?api_key=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.askmiso.com/v1/interactions?api_key=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'data' => [
        [
                'type' => 'product_detail_page_view',
                'duration' => 61.5,
                'product_ids' => [
                                '123ABC-BLACK'
                ],
                'product_group_ids' => [
                                '123ABC'
                ],
                'user_id' => 'user_1234',
                'anonymous_id' => '86D51273AD8BF84217E1567B6CBE7152D7034404',
                'timestamp' => '2023-11-07T05:31:56Z',
                'miso_id' => '123e4567-e89b-12d3-a456-426614174000',
                'context' => [
                                'campaign' => [
                                                                'name' => 'spring_sale',
                                                                'source' => 'Google',
                                                                'medium' => 'cpc',
                                                                'term' => 'running+shoes',
                                                                'content' => 'textlink'
                                ],
                                'truncated_ip' => '1.1.1.0',
                                'locale' => 'en-US',
                                'region' => 'US East',
                                'user_agent' => 'Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0',
                                'custom_context' => [
                                                                'session_variable_1' => [
                                                                                                                                'value_1',
                                                                                                                                'value_2'
                                                                ]
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.askmiso.com/v1/interactions?api_key="

	payload := strings.NewReader("{\n  \"data\": [\n    {\n      \"type\": \"product_detail_page_view\",\n      \"duration\": 61.5,\n      \"product_ids\": [\n        \"123ABC-BLACK\"\n      ],\n      \"product_group_ids\": [\n        \"123ABC\"\n      ],\n      \"user_id\": \"user_1234\",\n      \"anonymous_id\": \"86D51273AD8BF84217E1567B6CBE7152D7034404\",\n      \"timestamp\": \"2023-11-07T05:31:56Z\",\n      \"miso_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n      \"context\": {\n        \"campaign\": {\n          \"name\": \"spring_sale\",\n          \"source\": \"Google\",\n          \"medium\": \"cpc\",\n          \"term\": \"running+shoes\",\n          \"content\": \"textlink\"\n        },\n        \"truncated_ip\": \"1.1.1.0\",\n        \"locale\": \"en-US\",\n        \"region\": \"US East\",\n        \"user_agent\": \"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0\",\n        \"custom_context\": {\n          \"session_variable_1\": [\n            \"value_1\",\n            \"value_2\"\n          ]\n        }\n      }\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.askmiso.com/v1/interactions?api_key=")
  .header("Content-Type", "application/json")
  .body("{\n  \"data\": [\n    {\n      \"type\": \"product_detail_page_view\",\n      \"duration\": 61.5,\n      \"product_ids\": [\n        \"123ABC-BLACK\"\n      ],\n      \"product_group_ids\": [\n        \"123ABC\"\n      ],\n      \"user_id\": \"user_1234\",\n      \"anonymous_id\": \"86D51273AD8BF84217E1567B6CBE7152D7034404\",\n      \"timestamp\": \"2023-11-07T05:31:56Z\",\n      \"miso_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n      \"context\": {\n        \"campaign\": {\n          \"name\": \"spring_sale\",\n          \"source\": \"Google\",\n          \"medium\": \"cpc\",\n          \"term\": \"running+shoes\",\n          \"content\": \"textlink\"\n        },\n        \"truncated_ip\": \"1.1.1.0\",\n        \"locale\": \"en-US\",\n        \"region\": \"US East\",\n        \"user_agent\": \"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0\",\n        \"custom_context\": {\n          \"session_variable_1\": [\n            \"value_1\",\n            \"value_2\"\n          ]\n        }\n      }\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.askmiso.com/v1/interactions?api_key=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"data\": [\n    {\n      \"type\": \"product_detail_page_view\",\n      \"duration\": 61.5,\n      \"product_ids\": [\n        \"123ABC-BLACK\"\n      ],\n      \"product_group_ids\": [\n        \"123ABC\"\n      ],\n      \"user_id\": \"user_1234\",\n      \"anonymous_id\": \"86D51273AD8BF84217E1567B6CBE7152D7034404\",\n      \"timestamp\": \"2023-11-07T05:31:56Z\",\n      \"miso_id\": \"123e4567-e89b-12d3-a456-426614174000\",\n      \"context\": {\n        \"campaign\": {\n          \"name\": \"spring_sale\",\n          \"source\": \"Google\",\n          \"medium\": \"cpc\",\n          \"term\": \"running+shoes\",\n          \"content\": \"textlink\"\n        },\n        \"truncated_ip\": \"1.1.1.0\",\n        \"locale\": \"en-US\",\n        \"region\": \"US East\",\n        \"user_agent\": \"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:47.0) Gecko/20100101 Firefox/47.0\",\n        \"custom_context\": {\n          \"session_variable_1\": [\n            \"value_1\",\n            \"value_2\"\n          ]\n        }\n      }\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "message": "success"
}

{
  "message": "invalid api key."
}

{
  "message": "Request is denied due to bot blocking. Please only access this API from a real browser or use Secret API Key instead."
}

{
  "errors": true,
  "message": "None of the records were inserted because at least one of them contained schema errors. Please see the `data` field for details.",
  "data": [
    "data.0.product_ids is invalid. The attribute was expected to be of type ''array', 'null'' but type 'string' was given.",
    "data.0.timestamp is invalid. The attribute should match the 'date-time' format."
  ]
}

Authorizations

api_key

string

query

required

Your secret API key is used to access every Miso API endpoint. You should secure this key and only use it on a backend server. Never leave this key in your client-side JavaScript code. If the private key is compromised, you can revoke it in Dojo and get a new one.

Specify your secret key in the api_key query parameter. For example:

POST /v1/users?api_key=039c501ac8dfcac91c6f05601cee876e1cc07e17

Body

application/json

data

required

Show child attributes

Response

Successful Response

message

string

required

Human-readable message

Example:

"success"

Authentication Interaction Delete API

⌘I

Overview

Authentication

DATA APIs

Engine APIs

Experiment APIs

Q&A APIs

Interaction Upload API

Interaction records

Core click-streams

Conversion (eCommerce)

Consumption (content media)

Feedback signals

Performance Checking

Additional click-streams

Custom

Anonymous users

Schema validation

Authorizations

Body

Response