Activation growth data

Authorizations

SessionCookie

Parameters

Path Parameters

projectId

required

string

Query Parameters

startDate

string format: date

Inclusive window start (YYYY-MM-DD). Parsed with parseDateRangeParams; when either startDate or endDate is missing/invalid the route falls back to a rolling default window (30 days for events/visits/attribution, 7 days for growth).

endDate

string format: date

Inclusive window end (YYYY-MM-DD). See startDate for fallback behavior.

Responses

200

Activation data. histogram always has exactly 4 entries in fixed order with the literal bucket labels “<1h”, “1h-24h”, “1d-7d”, “>7d” (analytics.ts:626-631). trend[].count is a CONVERSION PERCENTAGE (1 decimal), not a count — the key name is misleading but that is what the code produces. _meta.activationEvents is the configured activation-stage successEvents array (may be empty when the project has no growth definition). Error path (500): {error, detail}.

application/json

object

histogram

required

Array<object>

>= 4 items <= 4 items

object

bucket

required

string

Allowed values: <1h 1h-24h 1d-7d >7d

count

required

integer

trend

required

Array<object>

object

date

required

UTC YYYY-MM-DD

string

count

required

Conversion rate percent (1 decimal), NOT a count.

number

_meta

required

object

scope

required

string

Allowed values: EVENT SESSION VISITOR IDENTIFIED_USER ACCOUNT

scopeLabel

required

string

activationEvents

required

Array<string>

500

Load failed.

application/json

object

key

additional properties

any

Example^generated

1
{}

GET

/api/projects/{projectId}/growth/activation

1
curl --request GET \
2
  --url https://retidal.com/api/projects/%3Cstring%3E/growth/activation \
3
  --cookie trackly_session=%3CYOUR_API_KEY%3E

1
const url = 'https://retidal.com/api/projects/%3Cstring%3E/growth/activation';
2
const options = {method: 'GET', headers: {cookie: 'trackly_session=%3CYOUR_API_KEY%3E'}};
3

4
try {
5
  const response = await fetch(url, options);
6
  const data = await response.json();
7
  console.log(data);
8
} catch (error) {
9
  console.error(error);
10
}

1
import requests
2

3
url = "https://retidal.com/api/projects/%3Cstring%3E/growth/activation"
4

5
headers = {"cookie": "trackly_session=%3CYOUR_API_KEY%3E"}
6

7
response = requests.get(url, headers=headers)
8

9
print(response.json())

1
import httpx
2

3
url = "https://retidal.com/api/projects/%3Cstring%3E/growth/activation"
4

5
cookies = {"trackly_session": "<YOUR_API_KEY>"}
6

7
response = httpx.get(url, cookies=cookies)
8

9
print(response.json())

1
package main
2

3
import (
4
  "fmt"
5
  "net/http"
6
  "io"
7
)
8

9
func main() {
10

11
  url := "https://retidal.com/api/projects/%3Cstring%3E/growth/activation"
12

13
  req, _ := http.NewRequest("GET", url, nil)
14

15
  req.Header.Add("cookie", "trackly_session=%3CYOUR_API_KEY%3E")
16

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

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

22
  fmt.Println(res)
23
  fmt.Println(string(body))
24

25
}

200Activation data. histogram always has exactly 4 entries in fixed order with the literal bucket labels “<1h”, “1h-24h”, “1d-7d”, “>7d” (analytics.ts:626-631). trend[].count is a CONVERSION PERCENTAGE (1 decimal), not a count — the key name is misleading but that is what the code produces. _meta.activationEvents is the configured activation-stage successEvents array (may be empty when the project has no growth definition). Error path (500): {error, detail}.

1
{
2
  "histogram": [
3
    {
4
      "bucket": "<1h"
5
    }
6
  ],
7
  "_meta": {
8
    "scope": "EVENT"
9
  }
10
}

Activation growth data

Authorizations

Parameters

Path Parameters

Query Parameters

Responses

200

500

Examplegenerated

Example^generated