Offizielle APIVorproduktion
Technische Übersicht
Diese Seite beschreibt die technische Struktur, die heute real im Projekt steckt: offizieller Demo-Endpoint, Pull-basierter Sync, Mapping auf Shared-ID-Attribution und die offenen Punkte für den Live-Schritt.
Zuletzt aktualisiert: 20. März 2026
Architektur
Der aktuelle PU-Prime-Pilot nutzt einen generischen HTTP-Pull-Adapter. Der Connector liest eine geschützte JSON-Response, erkennt die Event-Zeilen und übergibt sie in den bestehenden UID- und Attributionspfad.
Aktueller Datenfluss
text
PU Prime demo endpoint
-> http-broker-sync
-> field mapping (sharedId, brokerUid, externalId, occurredAt)
-> UID checker / tracking attribution
-> operator review in GramGrowEndpoint-Struktur
Wichtig
Der aktuelle Projektstand dokumentiert bewusst den realen Demo-Endpoint, nicht spekulative Live-Endpunkte von PU Prime.
Pilot Request Shape
http
GET https://api.gramgrow.io/api/v1/demo/brokers/puprime/official-api/report
Authorization: Bearer <private-demo-token>
200 OK
Content-Type: application/jsonAktuelle Response-Form
json
{
"broker": "puprime",
"mode": "official_api",
"version": "demo-v1",
"generatedAt": "2026-03-20T09:39:09.122Z",
"data": [
{
"sharedId": "gg-shared-9f1a2",
"brokerUid": "PU-48291",
"externalId": "evt_puprime_0001",
"eventLabel": "first_deposit",
"occurredAt": "2026-03-20T09:23:00Z",
"country": "DE",
"campaign": "puprime-review"
}
]
}Feldmapping
Diese Tabelle zeigt die Zuordnung zwischen den aktuellen Demo-Feldern und den GramGrow-Attributionsfeldern.
Das Mapping dokumentiert den realen Projektpfad heute. Die finale Live-Zuordnung wird erst mit echten PU-Prime-Feldnamen bestätigt.
| Demo-Feld | GramGrow | Einordnung |
|---|---|---|
| sharedId | shared_id | Klick- / Shared-ID-Matching |
| brokerUid | broker_uid | Broker-seitige Identität |
| externalId | external_id | Event-Konsistenz über Imports |
| occurredAt | occurred_at | Zeitlicher Event-Anker |
| eventLabel | event_label | Registration vs. first_deposit |
| country | country | Review- und Reporting-Kontext |
| campaign | campaign | Attributionskontext |
Auth & Pull-Cadence
Heutiger Projektstand
Der Pilot-Endpoint ist token-geschützt. Der Token wird privat vergeben. Die Demo-Connector-Konfiguration ist für einen geplanten Pull-Betrieb ausgelegt; die finale Cadence wird pro Workspace festgelegt.
Für den Live-Schritt wird die Auth-Methode nicht geraten, sondern erst nach Freigabe durch PU Prime auf deren offizielles Verfahren gemappt.
Benötigte Inputs
Der letzte Schritt zur Live-Integration ist kein weiteres UI-Thema, sondern echtes Broker-Material von PU Prime.
- Offizielle Reporting- oder Partner-API-Dokumentation
- Beispiel-Response oder anonymisierter Export mit echten Feldnamen
- Bestätigung des erlaubten read-only Scopes und Auth-Verfahrens
- Klärung, ob nur Pull oder zusätzlich Webhook/Postback denkbar ist