AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

configuring-experiment-analytics

Configures the analytics side of a PostHog experiment — exposure criteria (server-resolved default exposure event vs custom exposure events), primary and secondary metrics, the supported metric types (count, sum, ratio with `math` and `math_property`, retention with `retention_window_start` and `start_handling`), multivariate user handling ("Exclude from analysis" vs "Use first seen variant"), and how to read results once the experiment is live. Use when the user adds or edits a primary or secondary metric (e.g. "add a secondary metric tracking 'downloaded_file' per user"), sets up a ratio metric (e.g. "revenue from purchase_completed / pageviews"), sets up a retention metric (e.g. "$pageview → uploaded_file, 7-day window"), configures custom exposure (e.g. "only count users who hit /checkout"), changes multivariate handling, or asks "who is in the analysis?", "how do I measure impact?", "is this winning?", "what's the confidence level?", or "should I ship?".

Original source
posthog
License
MIT
Pinned revision
cac7c80a9e5b73484d18eda1bffb47297c938e0c

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

Ask your assistant

Use Agentic Memory skills to read posthog--configuring-experiment-analytics at revision cac7c80a9e5b73484d18eda1bffb47297c938e0c, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 4

references/metric-configuration.md · 24000

        {
          "type": "null"
        }
      ],
      "default": "in"
    },
    "type": {
      "const": "cohort",
      "default": "cohort",
      "title": "Type",
      "type": "string"
    },
    "value": {
      "title": "Value",
      "type": "integer"
    }
  },
  "required": [
    "value"
  ],
  "title": "CohortPropertyFilter",
  "type": "object"
},
"CountPerActorMathType": {
  "enum": [
    "avg_count_per_actor",
    "min_count_per_actor",
    "max_count_per_actor",
    "median_count_per_actor",
    "p75_count_per_actor",
    "p90_count_per_actor",
    "p95_count_per_actor",
    "p99_count_per_actor"
  ],
  "title": "CountPerActorMathType",
  "type": "string"
},
"CurrencyCode": {
  "enum": [
    "AED",
    "AFN",
    "ALL",
    "AMD",
    "ANG",
    "AOA",
    "ARS",
    "AUD",
    "AWG",
    "AZN",
    "BAM",
    "BBD",
    "BDT",
    "BGN",
    "BHD",
    "BIF",
    "BMD",
    "BND",
    "BOB",
    "BRL",
    "BSD",
    "BTC",
    "BTN",
    "BWP",
    "BYN",
    "BZD",
    "CAD",
    "CDF",
    "CHF",
    "CLP",
    "CNY",
    "COP",
    "CRC",
    "CVE",
    "CZK",
    "DJF",
    "DKK",
    "DOP",
    "DZD",
    "EGP",
    "ERN",
    "ETB",
    "EUR",
    "FJD",
    "GBP",
    "GEL",
    "GHS",
    "GIP",
    "GMD",
    "GNF",
    "GTQ",
    "GYD",
    "HKD",
    "HNL",
    "HRK",
    "HTG",
    "HUF",
    "IDR",
    "ILS",
    "INR",
    "IQD",
    "IRR",
    "ISK",
    "JMD",
    "JOD",
    "JPY",
    "KES",
    "KGS",
    "KHR",
    "KMF",
    "KRW",
    "KWD",
    "KYD",
    "KZT",
    "LAK",
    "LBP",
    "LKR",
    "LRD",
    "LTL",
    "LVL",
    "LSL",
    "LYD",
    "MAD",
    "MDL",
    "MGA",
    "MKD",
    "MMK",
    "MNT",
    "MOP",
    "MRU",
    "MTL",
    "MUR",
    "MVR",
    "MWK",
    "MXN",
    "MYR",
    "MZN",
    "NAD",
    "NGN",
    "NIO",
    "NOK",
    "NPR",
    "NZD",
    "OMR",
    "PAB",
    "PEN",
    "PGK",
    "PHP",
    "PKR",
    "PLN",
    "PYG",
    "QAR",
    "RON",
    "RSD",
    "RUB",
    "RWF",
    "SAR",
    "SBD",
    "SCR",
    "SDG",
    "SEK",
    "SGD",
    "SRD",
    "SSP",
    "STN",
    "SYP",
    "SZL",
    "THB",
    "TJS",
    "TMT",
    "TND",
    "TOP",
    "TRY",
    "TTD",
    "TWD",
    "TZS",
    "UAH",
    "UGX",
    "USD",
    "UYU",
    "UZS",
    "VES",
    "VND",
    "VUV",
    "WST",
    "XAF",
    "XCD",
    "XOF",
    "XPF",
    "YER",
    "ZAR",
    "ZMW"
  ],
  "title": "CurrencyCode",
  "type": "string"
},
"DataWarehousePersonPropertyFilter": {
  "additionalProperties": false,
  "properties": {
    "key": {
      "title": "Key",
      "type": "string"
    },
    "label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Label"
    },
    "operator": {
      "$ref": "#/$defs/PropertyOperator"
    },
    "type": {
      "const": "data_warehouse_person_property",
      "default": "data_warehouse_person_property",
      "title": "Type",
      "type": "string"
    },
    "value": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              },
              {
                "type": "boolean"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Value"
    }
  },
  "required": [
    "key",
    "operator"
  ],
  "title": "DataWarehousePersonPropertyFilter",
  "type": "object"
},
"DataWarehousePropertyFilter": {
  "additionalProperties": false,
  "properties": {
    "key": {
      "title": "Key",
      "type": "string"
    },
    "label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Label"
    },
    "operator": {
      "$ref": "#/$defs/PropertyOperator"
    },
    "type": {
      "const": "data_warehouse",
      "default": "data_warehouse",
      "title": "Type",
      "type": "string"
    },
    "value": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              },
              {
                "type": "boolean"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Value"
    }
  },
  "required": [
    "key",
    "operator"
  ],
  "title": "DataWarehousePropertyFilter",
  "type": "object"
},
"DurationType": {
  "enum": [
    "duration",
    "active_seconds",
    "inactive_seconds"
  ],
  "title": "DurationType",
  "type": "string"
},
"ElementPropertyFilter": {
  "additionalProperties": false,
  "properties": {
    "key": {
      "$ref": "#/$defs/Key10"
    },
    "label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Label"
    },
    "operator": {
      "$ref": "#/$defs/PropertyOperator"
    },
    "type": {
      "const": "element",
      "default": "element",
      "title": "Type",
      "type": "string"
    },
    "value": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              },
              {
                "type": "boolean"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Value"
    }
  },
  "required": [
    "key",
    "operator"
  ],
  "title": "ElementPropertyFilter",
  "type": "object"
},
"EmptyPropertyFilter": {
  "additionalProperties": false,
  "properties": {
    "type": {
      "const": "empty",
      "default": "empty",
      "title": "Type",
      "type": "string"
    }
  },
  "title": "EmptyPropertyFilter",
  "type": "object"
},
"ErrorTrackingIssueFilter": {
  "additionalProperties": false,
  "properties": {
    "key": {
      "title": "Key",
      "type": "string"
    },
    "label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Label"
    },
    "operator": {
      "$ref": "#/$defs/PropertyOperator"
    },
    "type": {
      "const": "error_tracking_issue",
      "default": "error_tracking_issue",
      "title": "Type",
      "type": "string"
    },
    "value": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              },
              {
                "type": "boolean"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Value"
    }
  },
  "required": [
    "key",
    "operator"
  ],
  "title": "ErrorTrackingIssueFilter",
  "type": "object"
},
"EventMetadataPropertyFilter": {
  "additionalProperties": false,
  "properties": {
    "key": {
      "title": "Key",
      "type": "string"
    },
    "label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Label"
    },
    "operator": {
      "$ref": "#/$defs/PropertyOperator"
    },
    "type": {
      "const": "event_metadata",
      "default": "event_metadata",
      "title": "Type",
      "type": "string"
    },
    "value": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              },
              {
                "type": "boolean"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Value"
    }
  },
  "required": [
    "key",
    "operator"
  ],
  "title": "EventMetadataPropertyFilter",
  "type": "object"
},
"EventPropertyFilter": {
  "additionalProperties": false,
  "properties": {
    "key": {
      "title": "Key",
      "type": "string"
    },
    "label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Label"
    },
    "operator": {
      "anyOf": [
        {
          "$ref": "#/$defs/PropertyOperator"
        },
        {
          "type": "null"
        }
      ],
      "default": "exact"
    },
    "type": {
      "const": "event",
      "default": "event",
      "description": "Event properties",
      "title": "Type",
      "type": "string"
    },
    "value": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              },
              {
                "type": "boolean"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "string"
        },
        {
          "type": "number"
        },
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Value"
    }
  },
  "required": [
    "key"
  ],
  "title": "EventPropertyFilter",
  "type": "object"
},
"EventsNode": {
  "additionalProperties": false,
  "properties": {
    "custom_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Custom Name"
    },
    "event": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "The event or `null` for all events.",
      "title": "Event"
    },
    "fixedProperties": {
      "anyOf": [
        {
          "items": {
            "oneOf": [
              {
                "$ref": "#/$defs/EventPropertyFilter"
              },
              {
                "$ref": "#/$defs/PersonPropertyFilter"
              },
              {
                "$ref": "#/$defs/PersonMetadataPropertyFilter"
              },
              {
                "$ref": "#/$defs/ElementPropertyFilter"
              },
              {
                "$ref": "#/$defs/EventMetadataPropertyFilter"
              },
              {
                "$ref": "#/$defs/SessionPropertyFilter"
              },
              {
                "$ref": "#/$defs/CohortPropertyFilter"
              },
              {
                "$ref": "#/$defs/RecordingPropertyFilter"
              },
              {
                "$ref": "#/$defs/LogEntryPropertyFilter"
              },
              {
                "$ref": "#/$defs/GroupPropertyFilter"
              },
              {
                "$ref": "#/$defs/FeaturePropertyFilter"
              },
              {
                "$ref": "#/$defs/FlagPropertyFilter"
              },
              {
                "$ref": "#/$defs/HogQLPropertyFilter"
              },
              {
                "$ref": "#/$defs/EmptyPropertyFilter"
              },
              {
                "$ref": "#/$defs/DataWarehousePropertyFilter"
              },
              {
                "$ref": "#/$defs/DataWarehousePersonPropertyFilter"
              },
              {
                "$ref": "#/$defs/ErrorTrackingIssueFilter"
              },
              {
                "$ref": "#/$defs/LogPropertyFilter"
              },
              {
                "$ref": "#/$defs/MetricPropertyFilter"
              },
              {
                "$ref": "#/$defs/SpanPropertyFilter"
              },
              {
                "$ref": "#/$defs/RevenueAnalyticsPropertyFilter"
              },
              {
                "$ref": "#/$defs/AccountCustomPropertyFilter"
              },
              {
                "$ref": "#/$defs/WorkflowVariablePropertyFilter"
              },
              {
                "$ref": "#/$defs/BehavioralPropertyFilter"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Fixed properties in the query, can't be edited in the interface (e.g. scoping down by person)",
      "title": "Fixedproperties"
    },
    "kind": {
      "const": "EventsNode",
      "default": "EventsNode",
      "title": "Kind",
      "type": "string"
    },
    "limit": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Limit"
    },
    "math": {
      "anyOf": [
        {
          "$ref": "#/$defs/BaseMathType"
        },
        {
          "$ref": "#/$defs/FunnelMathType"
        },
        {
          "$ref": "#/$defs/PropertyMathType"
        },
        {
          "$ref": "#/$defs/CountPerActorMathType"
        },
        {
          "$ref": "#/$defs/GroupMathType"
        },
        {
          "$ref": "#/$defs/ExperimentMetricMathType"
        },
        {
          "$ref": "#/$defs/CalendarHeatmapMathType"
        },
        {
          "const": "hogql",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Math"
    },
    "math_group_type_index": {
      "anyOf": [
        {
          "$ref": "#/$defs/MathGroupTypeIndex"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "math_hogql": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Math Hogql"
    },
    "math_multiplier": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Math Multiplier"
    },
    "math_property": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Math Property"
    },
    "math_property_revenue_currency": {
      "anyOf": [
        {
          "$ref": "#/$defs/RevenueCurrencyPropertyConfig"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "math_property_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Math Property Type"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "optionalInFunnel": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Optionalinfunnel"
    },
    "orderBy": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Columns to order by",
      "title": "Orderby"
    },
    "properties": {
      "anyOf": [
        {
          "items": {
            "oneOf": [
              {
                "$ref": "#/$defs/EventPropertyFilter"
              },
              {
                "$ref": "#/$defs/PersonPropertyFilter"
              },
              {
                "$ref": "#/$defs/PersonMetadataPropertyFilter"
              },
              {
                "$ref": "#/$defs/ElementPropertyFilter"
              },
              {
                "$ref": "#/$defs/EventMetadataPropertyFilter"
              },
              {
                "$ref": "#/$defs/SessionPropertyFilter"
              },
              {
                "$ref": "#/$defs/CohortPropertyFilter"
              },
              {
                "$ref": "#/$defs/RecordingPropertyFilter"
              },
              {
                "$ref": "#/$defs/LogEntryPropertyFilter"
              },
              {
                "$ref": "#/$defs/GroupPropertyFilter"
              },
              {
                "$ref": "#/$defs/FeaturePropertyFilter"
              },
              {
                "$ref": "#/$defs/FlagPropertyFilter"
              },
              {
                "$ref": "#/$defs/HogQLPropertyFilter"
              },
              {
                "$ref": "#/$defs/EmptyPropertyFilter"
              },
              {
                "$ref": "#/$defs/DataWarehousePropertyFilter"
              },
              {
                "$ref": "#/$defs/DataWarehousePersonPropertyFilter"
              },
              {
                "$ref": "#/$defs/ErrorTrackingIssueFilter"
              },
              {
                "$ref": "#/$defs/LogPropertyFilter"
              },
              {
                "$ref": "#/$defs/MetricPropertyFilter"
              },
              {
                "$ref": "#/$defs/SpanPropertyFilter"
              },
              {
                "$ref": "#/$defs/RevenueAnalyticsPropertyFilter"
              },
              {
                "$ref": "#/$defs/AccountCustomPropertyFilter"
              },
              {
                "$ref": "#/$defs/WorkflowVariablePropertyFilter"
              },
              {
                "$ref": "#/$defs/BehavioralPropertyFilter"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Properties configurable in the interface",
      "title": "Properties"
    },
    "response": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Response"
    },
    "version": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "version of the node, used for schema migrations",
      "title": "Version"
    }
  },
  "title": "EventsNode",
  "type": "object"
},
"ExperimentDataWarehouseNode": {
  "additionalProperties": false,
  "properties": {
    "custom_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "def