experience

Get competitor reasons (v2)

Get why an Experience campaign's own website won and lost its matched pairs with one competitor from its Brands map, under the same window and segments: exactly the drivers experience_campaign_analytics_get_v9 counts against that competitor on the overview. Over the pairs whose visit of the website is dated in the 30 UTC days ending with the map's results.asOf and that went to a side (a pass beats a failure, and of two passes more stars win; a failure blamed on the shopper decides nothing), a win counts each strength the website's journey carried and a loss each issue, as the issue grouping recorded them from what the scorer wrote, or Not grouped yet for what no grouping run has grouped, counted in pairs. A pair carrying several reasons counts under each.

get/api/v1/experience/competitor-reasons-v2/{id}

Request

  • Base URL: https://point11.ai
  • URL: https://point11.ai/api/v1/experience/competitor-reasons-v2/{id}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.point11.ai/oauth2/authorize, token URL https://auth.point11.ai/oauth2/token)

Path parameters

idstring uuid required

The Experience campaign's id

Query parameters

fromstring date-time

The window's start; with to, or neither for all time

tostring date-time

The window's end; with from, or neither for all time

widenWhenEmptyboolean

When no day of the window has one of the campaign's interactions in its 30 days, read all time instead (dateScope.widenedToAllTime says so). Otherwise such a window reports dateScope.outOfRange.

segmentsstring[]

Customer-level entries as axis:id (ids from experience_campaign_segments_get), ANDed across axes; empty reads the whole cohort. Every customer attribute narrows by its own buckets, a store by its customers. An agent entry names one of point11, dots, spark, muse, grok_bot and narrows every figure to that agent's visits (scopeAgent states it); one at most, and with none every agent's visits are read together.

agent'point11' | 'dots' | 'spark' | 'muse' | 'grok_bot'

The segment scope's agent entry (the object form's {axis: agent}): every figure is of that agent's visits alone; absent reads every agent's

competitorstring required

A competitor's website id, from experience_brand_maps_get_v4's competitors[].id

Headers

Point11-Organizationstring uuid

Organization to act in. Required for OAuth bearers; an API key acts in the organization that owns it.

Response

Success.

datasetKeystring nullable required

Names what the reasons were read from, as experience.brand-maps.get's map.datasetKey does: equal while both describe the same window, website and segment scope. Null when the scope holds no interaction or website to read

Changes

No recorded changes to this operation across all 1 revision of this API.