Баримт бичиг / API лавлах

Шинжилгээ

Нийт дүн, цагийн цуваа, задаргаа, экспорт, хуваалцсан самбар.

GET/v1/workspaces/{workspaceId}/analytics

Totals, timeseries and breakdowns of clicks, leads and sales.

Шаардлагатай API түлхүүрийн хамрах хүрээ: analytics.read

Параметр (43)
НэрБайрлалТөрөлЗаавалТайлбар
workspaceIdpathstringтийм
eventquerystring`clicks` (default), `leads`, `sales` or `composite`.
groupByquerystringSee the `groupBy` values of spec 06 4.1; default `count`.
domainquerystring
keyquerystring
linkIdquerystring
externalIdquerystringValue prefixed `ext_`.
tenantIdquerystring
tagIdquerystring
folderIdquerystring
rootqueryboolean`true`: root-domain links only; `false`: normal links only.
partnerIdquerystring
groupIdquerystring
partnerTagIdquerystring
customerIdquerystring
intervalquerystring`24h` (default), `7d`, `30d`, `90d`, `1y`, `mtd`, `qtd`, `ytd`, `all`.
startquerystringRFC 3339; overrides `interval`.
endquerystringRFC 3339, exclusive; defaults to now.
timezonequerystringIANA zone name, default `UTC`.
countryquerystring
regionquerystring
cityquerystring
continentquerystring
devicequerystring
browserquerystring
osquerystring
triggerquerystring`qr`, `link`, `pageview`, `deeplink`.
refererquerystring
refererUrlquerystring
urlquerystring
utm_sourcequerystring
utm_mediumquerystring
utm_campaignquerystring
utm_termquerystring
utm_contentquerystring
eventNamequerystring
saleTypequerystring`new` or `recurring`.
queryquerystring`metadata['field']:'value'` (leads and sales only).
pagequeryinteger (int32)Events list: page number, from 1.
limitqueryinteger (int32)Events list: page size, default 100, at most 1000.
sortOrderquerystring`asc` or `desc` (default).
sortByquerystringEvents list: `timestamp`. Breakdowns of sales: `saleAmount` ranks by revenue.
cursorquerystringEvents list keyset cursor (the `X-Next-Cursor` header of the previous page).

Хариу: 200 object

GET/v1/workspaces/{workspaceId}/analytics/customers

Customers, newest first, with lifetime value.

Шаардлагатай API түлхүүрийн хамрах хүрээ: analytics.read

Параметр (6)
НэрБайрлалТөрөлЗаавалТайлбар
workspaceIdpathstringтийм
countryquerystring
linkIdquerystring
searchquerystringMatches name, email and external id.
pagequeryinteger (int32)
pageSizequeryinteger (int32)

Хариу: 200

GET/v1/workspaces/{workspaceId}/analytics/customers/{customerId}

One customer with recent sales and activity.

Шаардлагатай API түлхүүрийн хамрах хүрээ: analytics.read

Параметр (2)
НэрБайрлалТөрөлЗаавалТайлбар
workspaceIdpathstringтийм
customerIdpathstringтийм

Хариу: 200

POST/v1/workspaces/{workspaceId}/analytics/exports

Queue a CSV export of the current dashboard or events view.

Шаардлагатай API түлхүүрийн хамрах хүрээ: analytics.read

Параметр (1)
НэрБайрлалТөрөлЗаавалТайлбар
workspaceIdpathstringтийм
Хүсэлтийн бие (ExportRequest)
НэрТөрөлЗаавалТайлбар
kindExportKindтийм
queryobjectтиймThe same parameters as `GET /analytics` (event, interval, filters, ...).

Хариу: 202 ExportJob

GET/v1/workspaces/{workspaceId}/analytics/exports/{exportId}

Status of an export and, once ready, its download link.

Шаардлагатай API түлхүүрийн хамрах хүрээ: analytics.read

Параметр (2)
НэрБайрлалТөрөлЗаавалТайлбар
workspaceIdpathstringтийм
exportIdpathstringтийм

Хариу: 200 ExportJob

GET/v1/workspaces/{workspaceId}/analytics/exports/{exportId}/download

Download the finished export (zip or CSV).

Шаардлагатай API түлхүүрийн хамрах хүрээ: analytics.read

Параметр (2)
НэрБайрлалТөрөлЗаавалТайлбар
workspaceIdpathstringтийм
exportIdpathstringтийм

Хариу: 200

GET/v1/workspaces/{workspaceId}/analytics/shares

Active shares, optionally of one link or folder.

Шаардлагатай API түлхүүрийн хамрах хүрээ: analytics.read

Параметр (3)
НэрБайрлалТөрөлЗаавалТайлбар
workspaceIdpathstringтийм
linkIdquerystring
folderIdquerystring

Хариу: 200 Share[]

POST/v1/workspaces/{workspaceId}/analytics/shares

Enable sharing of one link or folder.

Шаардлагатай API түлхүүрийн хамрах хүрээ: analytics.read

Параметр (1)
НэрБайрлалТөрөлЗаавалТайлбар
workspaceIdpathstringтийм
Хүсэлтийн бие (CreateShare)
НэрТөрөлЗаавалТайлбар
linkIdstring
folderIdstring
showConversionsboolean
allowIndexboolean
passwordstringAt least 6 characters; stored hashed.

Хариу: 201 Share

PATCH/v1/workspaces/{workspaceId}/analytics/shares/{shareId}

Change options or the password of a share.

Шаардлагатай API түлхүүрийн хамрах хүрээ: analytics.read

Параметр (2)
НэрБайрлалТөрөлЗаавалТайлбар
workspaceIdpathstringтийм
shareIdpathstringтийм
Хүсэлтийн бие (UpdateShare)
НэрТөрөлЗаавалТайлбар
showConversionsboolean
allowIndexboolean
passwordstringSets a new password.
clearPasswordbooleanRemoves the password.

Хариу: 200 Share

DELETE/v1/workspaces/{workspaceId}/analytics/shares/{shareId}

Disable sharing: the public URL stops resolving at once and never works again.

Шаардлагатай API түлхүүрийн хамрах хүрээ: analytics.read

Параметр (2)
НэрБайрлалТөрөлЗаавалТайлбар
workspaceIdpathstringтийм
shareIdpathstringтийм

Хариу: 204

GET/v1/workspaces/{workspaceId}/events

Raw events, newest first (Business and above).

Шаардлагатай API түлхүүрийн хамрах хүрээ: analytics.read

Параметр (43)
НэрБайрлалТөрөлЗаавалТайлбар
workspaceIdpathstringтийм
eventquerystring`clicks` (default), `leads`, `sales` or `composite`.
groupByquerystringSee the `groupBy` values of spec 06 4.1; default `count`.
domainquerystring
keyquerystring
linkIdquerystring
externalIdquerystringValue prefixed `ext_`.
tenantIdquerystring
tagIdquerystring
folderIdquerystring
rootqueryboolean`true`: root-domain links only; `false`: normal links only.
partnerIdquerystring
groupIdquerystring
partnerTagIdquerystring
customerIdquerystring
intervalquerystring`24h` (default), `7d`, `30d`, `90d`, `1y`, `mtd`, `qtd`, `ytd`, `all`.
startquerystringRFC 3339; overrides `interval`.
endquerystringRFC 3339, exclusive; defaults to now.
timezonequerystringIANA zone name, default `UTC`.
countryquerystring
regionquerystring
cityquerystring
continentquerystring
devicequerystring
browserquerystring
osquerystring
triggerquerystring`qr`, `link`, `pageview`, `deeplink`.
refererquerystring
refererUrlquerystring
urlquerystring
utm_sourcequerystring
utm_mediumquerystring
utm_campaignquerystring
utm_termquerystring
utm_contentquerystring
eventNamequerystring
saleTypequerystring`new` or `recurring`.
queryquerystring`metadata['field']:'value'` (leads and sales only).
pagequeryinteger (int32)Events list: page number, from 1.
limitqueryinteger (int32)Events list: page size, default 100, at most 1000.
sortOrderquerystring`asc` or `desc` (default).
sortByquerystringEvents list: `timestamp`. Breakdowns of sales: `saleAmount` ranks by revenue.
cursorquerystringEvents list keyset cursor (the `X-Next-Cursor` header of the previous page).

Хариу: 200 object[]

GET/v1/workspaces/{workspaceId}/events/stream

Live click stream (Business and above).

Шаардлагатай API түлхүүрийн хамрах хүрээ: analytics.read

Параметр (44)
НэрБайрлалТөрөлЗаавалТайлбар
workspaceIdpathstringтийм
eventquerystring`clicks` (default), `leads`, `sales` or `composite`.
groupByquerystringSee the `groupBy` values of spec 06 4.1; default `count`.
domainquerystring
keyquerystring
linkIdquerystring
externalIdquerystringValue prefixed `ext_`.
tenantIdquerystring
tagIdquerystring
folderIdquerystring
rootqueryboolean`true`: root-domain links only; `false`: normal links only.
partnerIdquerystring
groupIdquerystring
partnerTagIdquerystring
customerIdquerystring
intervalquerystring`24h` (default), `7d`, `30d`, `90d`, `1y`, `mtd`, `qtd`, `ytd`, `all`.
startquerystringRFC 3339; overrides `interval`.
endquerystringRFC 3339, exclusive; defaults to now.
timezonequerystringIANA zone name, default `UTC`.
countryquerystring
regionquerystring
cityquerystring
continentquerystring
devicequerystring
browserquerystring
osquerystring
triggerquerystring`qr`, `link`, `pageview`, `deeplink`.
refererquerystring
refererUrlquerystring
urlquerystring
utm_sourcequerystring
utm_mediumquerystring
utm_campaignquerystring
utm_termquerystring
utm_contentquerystring
eventNamequerystring
saleTypequerystring`new` or `recurring`.
queryquerystring`metadata['field']:'value'` (leads and sales only).
pagequeryinteger (int32)Events list: page number, from 1.
limitqueryinteger (int32)Events list: page size, default 100, at most 1000.
sortOrderquerystring`asc` or `desc` (default).
sortByquerystringEvents list: `timestamp`. Breakdowns of sales: `saleAmount` ranks by revenue.
cursorquerystringEvents list keyset cursor (the `X-Next-Cursor` header of the previous page).
timeoutqueryinteger (int32)Close the stream after this many seconds (default and maximum 900); clients reconnect with `Last-Event-ID`.

Хариу: 200