# Creatives testen met de API

Upload advertenties en andere creatives, test ze met de digitale tweelingen van je klanten en lees de scorekaart vanuit je eigen code.

Bron: https://point11.ai/nl/docs/mcp/creative-testing  
Bijgewerkt: 2026-10-18

## Overzicht

Een creatieve test laat je advertenties, afbeeldingen, video’s of audio zien aan de digitale tweelingen van je klanten en vraagt elke tweeling ze te beoordelen. Je kunt dezelfde test die je vanuit **Studio > Assets > Test existing assets** start vanuit je eigen code uitvoeren, bijvoorbeeld direct nadat een ontwerper een bestand uit Canva of Adobe heeft geëxporteerd.

Je hebt een [API-sleutel](/nl/docs/mcp/overview) met schrijfrechten voor Research nodig, en een doelgroep die je in Point11 hebt ingesteld: een bedrijfsprofiel en de klanten ervan. Elk verzoek hieronder stuurt de sleutel als `Authorization: Bearer $POINT11_API_KEY`, en elk verzoek dat iets wijzigt stuurt een nieuwe UUID in `Idempotency-Key`.

## Upload elke creative

Upload elk bestand in drie verzoeken. Reserveer eerst de upload: stuur de bestandsnaam, het type, de exacte grootte in bytes en de SHA-256 (een video stuurt geen SHA-256):

```bash
curl https://point11.ai/api/v1/research/study-attachments/reserve-upload-v4 \
  -H "Authorization: Bearer $POINT11_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"filename": "summer-ad.png", "mediaType": "image/png", "byteLength": 482113, "sha256": "<hex sha-256>"}'
```

Stuur het bestand daarna als body van het `upload`-verzoek uit het antwoord, met precies de methode, URL en headers daarvan, voordat het een minuut later verloopt. Rond de upload ten slotte af met de `id` van de bijlage en de `etag` die de upload teruggaf:

```bash
curl https://point11.ai/api/v1/research/study-attachments/complete-upload-v3 \
  -H "Authorization: Bearer $POINT11_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"id": "<attachment id>", "etag": "<etag>"}'
```

Afbeeldingen (PNG, JPEG, WebP) mogen tot 3.750.000 bytes zijn, het maximum dat één afbeelding kan meedragen naar elk AI-model waarop een tweeling kan draaien; pdf’s en audio (MP3, WAV) tot 4 MiB, en video’s (MP4, WebM) tot 100 MiB en 3 minuten. Tweelingen zien een video als beelden met tijdstempel en de transcriptie ervan, dus wacht tot `GET /api/v1/research/study-attachments-v2/{id}` het storyboard als klaar toont.

## Start de test

Noem de geüploade bestanden, wat je wilt leren, de doelgroep en hoe tweelingen de creative moeten tegenkomen:

```bash
curl https://point11.ai/api/v1/research/creative-tests/start \
  -H "Authorization: Bearer $POINT11_API_KEY" \
  -H "Idempotency-Key: $TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Summer ads",
    "brief": "Which ad makes people want to book a visit, and why?",
    "sellerProfileId": null,
    "contentLanguage": "en",
    "audience": {
      "audienceProfileId": "<business profile id>",
      "targetedGroupIds": null,
      "targetedCustomerIds": null,
      "targetInterviewCount": 50
    },
    "studyMode": {"kind": "first_impressions"},
    "metrics": ["stopping_power", "clarity", "appeal", "intent_to_act"],
    "platforms": ["Facebook", "Instagram"],
    "attachments": [
      {"artifactId": "<attachment id>", "filename": "summer-ad.png", "mediaType": "image/png", "byteLength": 482113}
    ]
  }'
```

- **Doelgroep.** `audienceProfileId` is de id van je bedrijfsprofiel uit `GET /api/v1/business/profiles`. Laat `targetedGroupIds` leeg om uit al zijn klanten te kiezen, of noem tot 20 opgeslagen doelgroepen.
- **Eerste indruk of een koopsituatie.** `first_impressions` laat de creative aan elke tweeling zien zoals die is. `buying_scenario` met een `direction` plaatst elke tweeling eerst in de koopsituatie die je beschrijft.
- **Statistieken.** Elke statistiek wordt één beoordelingsvraag per creative op één gedeelde schaal, plus een vervolgvraag, dus een test stelt creatives × (statistieken + 1) vragen, maximaal 100. Met 4 statistieken kun je tot 20 creatives testen. Platformgeschiktheid heeft minstens één platform nodig.

De test antwoordt meteen met `202`. Bewaar de `Idempotency-Key` die je stuurde: die benoemt vanaf nu de test.

## Volg de test

Terwijl Point11 je creative leest en de tweelingen voorbereidt, lees je de test via die sleutel:

```bash
curl https://point11.ai/api/v1/research/creative-tests/$TEST_KEY \
  -H "Authorization: Bearer $POINT11_API_KEY"
```

`status` is `preparing`, daarna `launched`, `failed` of `unsupported`, en `phase` laat zien hoe ver hij is. Alleen de sleutel die een test startte, kan hem zo lezen. Zodra hij `launched` is, benoemen `campaignId` en `runId` de interviews en resultaten.

De interviews duren langer, dus lees in plaats van elke test de activiteitsrevisie van je organisatie elke 30 tot 60 seconden. Die verandert zodra een onderzoek klaar is of de resultaten worden gepubliceerd, zodat één verzoek al je tests dekt:

```bash
curl https://point11.ai/api/v1/campaigns/activity-revisions/organization \
  -H "Authorization: Bearer $POINT11_API_KEY"
```

Lees de resultaten zodra `products.research` verandert.

## Lees de scorekaart

```bash
curl "https://point11.ai/api/v1/research/results-v7/$CAMPAIGN_ID?runId=$RUN_ID" \
  -H "Authorization: Bearer $POINT11_API_KEY"
```

De resultaten geven de antwoorden op elke vraag, een samenvatting met citaten, hoeveel interviews klaar zijn en de scorekaart: elke statistiek voor elke creative en in totaal. De resultaten zijn gesimuleerd onderzoek met de digitale tweelingen van je klanten, geen gemeten klikken, verkopen of conversies.

## Kosten en limieten

- Een creatieve test wordt gefactureerd zoals elk Research-onderzoek: elk geleverd interview telt mee voor je abonnement tegen de prijs van een Research-interview, en het lezen van de creative en het voorbereiden van de tweelingen verbruiken Alpha-tegoed tegen de exacte kosten.
- Elke sleutel heeft 100 verzoeken per minuut voor de API en de MCP-server samen. Een sleutel kan ongeveer 6 tests per minuut starten en 128 bestanden per minuut en 300 per dag uploaden. Is een budget op, dan krijg je `429`; wacht het aantal seconden uit `Retry-After`.
- Wil je een verzoek veilig opnieuw proberen, stuur het dan opnieuw met dezelfde `Idempotency-Key`. Een herhaalde start geeft dezelfde test terug, en er wordt niets dubbel in rekening gebracht.