PICO kennenlernen: Entdecke die Oberfläche in der Produkttour oder beginne mit dem Schnellstart.

Ziele

GET https://pico-analytics.com/api/goals/
curl --request GET \
--url 'https://pico-analytics.com/api/goals/' \
--header 'Authorization: Bearer {api_key}' \
Parameter Details Beschreibung
website_id Optional Ganzzahl
type Optional Zeichenfolge Erlaubte Werte: pageview, custom, scroll, scroll_element, click_element, webhook
search Optional Zeichenfolge Der Suchtext.
search_by Optional Zeichenfolge Das Feld, in dem gesucht wird. Erlaubte Werte: name, path, key.
datetime_field Optional Zeichenfolge Erlaubte Werte: datetime, last_datetime
datetime_start Optional Zeichenfolge Ergebnisse ab diesem Zeitpunkt filtern. Format: Y-m-d H:i:s.
datetime_end Optional Zeichenfolge Ergebnisse bis zu diesem Zeitpunkt filtern. Format: Y-m-d H:i:s.
order_by Optional Zeichenfolge Das Feld, nach dem die Ergebnisse sortiert werden. Erlaubte Werte: goal_id, last_datetime, datetime, name, path, key, scroll_percentage.
order_type Optional Zeichenfolge Die Sortierreihenfolge der Ergebnisse. Erlaubte Werte: ASC für aufsteigend und DESC für absteigend.
page Optional Ganzzahl Die Seitenzahl, für die du Ergebnisse abrufen möchtest. Standardmäßig 1.
results_per_page Optional Ganzzahl Anzahl der Ergebnisse pro Seite. Erlaubte Werte: 10, 25, 50, 100, 250, 500, 1000. Standardmäßig 25.
{
    "data": [
        {
            "id": 1,
            "website_id": 1,
            "user_id": 1,
            "key": "123456789",
            "type": "custom",
            "path": null,
            "scroll_percentage": null,
            "scroll_selector": null,
            "click_selector": null,
            "value": null,
            "webhook_url": null,
            "name": "Example",
            "last_datetime": null,
            "datetime": "2026-11-19 22:33:30"
        }
    ],
    "meta": {
        "page": 1,
        "total_pages": 1,
        "results_per_page": 25,
        "total_results": 1
    },
    "links": {
        "first": "https://pico-analytics.com/api/goals?page=1",
        "last": "https://pico-analytics.com/api/goals?page=1",
        "next": null,
        "prev": null,
        "self": "https://pico-analytics.com/api/goals?page=1"
    }
}
GET https://pico-analytics.com/api/goals/{goal_id}
curl --request GET \
--url 'https://pico-analytics.com/api/goals/{goal_id}' \
--header 'Authorization: Bearer {api_key}' \
{
    "data": {
        "id": 1,
        "website_id": 1,
        "user_id": 1,
        "key": "123456789",
        "type": "custom",
        "path": null,
        "scroll_percentage": null,
        "scroll_selector": null,
        "click_selector": null,
        "value": null,
        "webhook_url": null,
        "name": "Example",
        "last_datetime": null,
        "datetime": "2026-11-19 22:33:30"
    }
}
POST https://pico-analytics.com/api/goals
Parameter Details Beschreibung
website_id Erforderlich Ganzzahl -
type Erforderlich Zeichenfolge Erlaubte Werte: pageview, custom, scroll, scroll_element, click_element, webhook
name Erforderlich Zeichenfolge -
path Optional Zeichenfolge Verfügbar, wenn: type = pageview, scroll, scroll_element, click_element
scroll_percentage Optional Ganzzahl Verfügbar, wenn: type = scroll
scroll_selector Erforderlich Zeichenfolge Verfügbar, wenn: type = scroll_element. Das Ziel wird erreicht, sobald das erste passende Element im sichtbaren Bereich erscheint – auch wenn es bereits beim Laden der Seite sichtbar ist. Gib einen gültigen CSS-Selektor mit höchstens 1024 Zeichen ein.
click_selector Erforderlich Zeichenfolge Verfügbar, wenn: type = click_element. Das Ziel wird erreicht, sobald ein Besucher auf ein passendes Element klickt. Auch Klicks auf Symbole oder Text innerhalb des Elements zählen. Gib einen gültigen CSS-Selektor mit höchstens 1024 Zeichen ein.
value Optional Gleitkommazahl Optionaler Betrag, der mit jeder neuen Conversion gespeichert wird. Lass das Feld leer, um Conversions ohne Wert zu erfassen. Verwende für diese Website immer dieselbe Einheit oder Währung. Gib einen Wert zwischen 0 und unter 10000000000000 mit höchstens 2 Nachkommastellen ein.
key Optional Zeichenfolge -
curl --request POST \
--url 'https://pico-analytics.com/api/goals' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'website_id=1' \
--form 'name=Example' \
--form 'type=click_element' \
--form 'path=blog/*' \
--form 'click_selector=.buy-button' \
{
    "data": {
        "id": 1,
        "website_id": 1,
        "user_id": 1,
        "key": "123456789",
        "type": "click_element",
        "path": "/blog/*",
        "scroll_percentage": null,
        "scroll_selector": null,
        "click_selector": ".buy-button",
        "value": null,
        "webhook_url": null,
        "name": "Example",
        "last_datetime": null,
        "datetime": "2026-11-19 22:33:30"
    }
}
POST https://pico-analytics.com/api/goals/{goal_id}
Parameter Details Beschreibung
website_id Optional Ganzzahl -
type Optional Zeichenfolge Erlaubte Werte: pageview, custom, scroll, scroll_element, click_element, webhook
name Optional Zeichenfolge -
path Optional Zeichenfolge Verfügbar, wenn: type = pageview, scroll, scroll_element, click_element
scroll_percentage Optional Ganzzahl Verfügbar, wenn: type = scroll
scroll_selector Optional Zeichenfolge Verfügbar, wenn: type = scroll_element. Das Ziel wird erreicht, sobald das erste passende Element im sichtbaren Bereich erscheint – auch wenn es bereits beim Laden der Seite sichtbar ist. Gib einen gültigen CSS-Selektor mit höchstens 1024 Zeichen ein.
click_selector Optional Zeichenfolge Verfügbar, wenn: type = click_element. Das Ziel wird erreicht, sobald ein Besucher auf ein passendes Element klickt. Auch Klicks auf Symbole oder Text innerhalb des Elements zählen. Gib einen gültigen CSS-Selektor mit höchstens 1024 Zeichen ein.
value Optional Gleitkommazahl Optionaler Betrag, der mit jeder neuen Conversion gespeichert wird. Lass das Feld leer, um Conversions ohne Wert zu erfassen. Verwende für diese Website immer dieselbe Einheit oder Währung. Gib einen Wert zwischen 0 und unter 10000000000000 mit höchstens 2 Nachkommastellen ein.
key Optional Zeichenfolge -
curl --request POST \
--url 'https://pico-analytics.com/api/goals/{goal_id}' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: multipart/form-data' \
--form 'name=Example' \
--form 'type=scroll' \
--form 'path=blog/*' \
--form 'scroll_percentage=75' \
{
    "data": {
        "id": 1,
        "website_id": 1,
        "user_id": 1,
        "key": "123456789",
        "type": "scroll",
        "path": "/blog/*",
        "scroll_percentage": 75,
        "scroll_selector": null,
        "click_selector": null,
        "value": null,
        "webhook_url": null,
        "name": "Example",
        "last_datetime": "2026-11-19 22:33:30",
        "datetime": "2026-11-19 22:33:30"
    }
}

Sende eine POST-Anfrage an die private Webhook-URL, die beim Bearbeiten des Ziels angezeigt wird. JSON und Formulardaten werden unterstützt. Auch eine leere POST-Anfrage erfasst eine Conversion.

Webhook-Ziele geben eine private webhook_url in der Antwort zurück. Über diese URL kannst du Conversions ohne API-Schlüssel übermitteln.

Übermittle einen Wert, um einen tatsächlichen Betrag zu erfassen, oder lasse ihn weg, um den eingestellten Conversion-Wert zu verwenden. Gespeichert werden nur Zeitpunkt und Wert der Conversion. Jede akzeptierte POST-Anfrage zählt einzeln, auch bei wiederholten Anfragen. Webhook-Conversions werden keinem Besucher, keiner Sitzung und keinem Seitenereignis zugeordnet.

POST https://pico-analytics.com/pixel-webhook/{webhook_key}
curl --request POST \
--url 'https://pico-analytics.com/pixel-webhook/{webhook_key}' \
--header 'Content-Type: application/json' \
--data '{"value":49.90}'
{"message":"","status":"success","details":[]}
DELETE https://pico-analytics.com/api/goals/{goal_id}
curl --request DELETE \
--url 'https://pico-analytics.com/api/goals/{goal_id}' \
--header 'Authorization: Bearer {api_key}' \