# Testujte kreativy přes API

Nahrajte reklamy a další kreativy, otestujte je s digitálními dvojčaty svých zákazníků a čtěte výsledkovou tabulku z vlastního kódu.

Zdroj: https://point11.ai/cs/docs/mcp/creative-testing  
Aktualizováno: 2026-10-18

## Přehled

Test kreativ ukáže vaše reklamy, obrázky, videa nebo zvuk digitálním dvojčatům vašich zákazníků a požádá každé dvojče o hodnocení. Stejný test, který spouštíte z **Studio > Assets > Test existing assets**, můžete spustit z vlastního kódu, například hned poté, co grafik vyexportuje soubor z Canvy nebo Adobe.

Potřebujete [klíč API](/cs/docs/mcp/overview) s právem zápisu do Research a publikum nastavené v Point11: firemní profil a jeho zákazníky. Každý požadavek níže posílá klíč jako `Authorization: Bearer $POINT11_API_KEY` a každý požadavek, který něco mění, posílá nové UUID v `Idempotency-Key`.

## Nahrajte každou kreativu

Každý soubor nahrajte třemi požadavky. Nejprve nahrání zarezervujte: pošlete název souboru, typ, přesnou velikost v bajtech a SHA-256 (video SHA-256 neposílá):

```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>"}'
```

Potom pošlete soubor jako tělo požadavku `upload` z odpovědi, s přesně jeho metodou, URL a hlavičkami, dříve než o minutu později vyprší. Nakonec nahrání dokončete s `id` přílohy a `etag`, který nahrání vrátilo:

```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>"}'
```

Obrázky (PNG, JPEG, WebP) mohou mít až 3 750 000 bajtů, což je nejvíc, co jeden obrázek může přenést do každého modelu AI, na kterém může dvojče běžet; PDF a zvuk (MP3, WAV) až 4 MiB a videa (MP4, WebM) až 100 MiB a 3 minuty. Dvojčata vidí video jako časově označené snímky a jeho přepis, proto počkejte, až `GET /api/v1/research/study-attachments-v2/{id}` ukáže jeho storyboard jako připravený.

## Spusťte test

Uveďte nahrané soubory, co chcete zjistit, publikum a to, jak se dvojčata s kreativou setkají:

```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}
    ]
  }'
```

- **Publikum.** `audienceProfileId` je id vašeho firemního profilu z `GET /api/v1/business/profiles`. Nechte `targetedGroupIds` prázdné, chcete-li vybírat ze všech jeho zákazníků, nebo uveďte až 20 uložených publik.
- **První dojem nebo nákupní situace.** `first_impressions` ukáže kreativu každému dvojčeti takovému, jaké je. `buying_scenario` s `direction` nejprve každé dvojče zasadí do nákupní situace, kterou popíšete.
- **Metriky.** Každá metrika se stane jednou hodnoticí otázkou na kreativu na společné škále a jednou doplňující otázkou, takže test položí kreativy × (metriky + 1) otázek, nejvýše 100. Se 4 metrikami můžete otestovat až 20 kreativ. Vhodnost pro platformu vyžaduje alespoň jednu platformu.

Test hned odpoví `202`. Uschovejte si `Idempotency-Key`, který jste poslali: od teď test označuje.

## Sledujte test

Zatímco Point11 čte vaši kreativu a připravuje dvojčata, čtěte test podle tohoto klíče:

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

`status` je `preparing`, pak `launched`, `failed` nebo `unsupported` a `phase` říká, kam se test dostal. Takto může test číst jen klíč, který ho spustil. Jakmile je `launched`, `campaignId` a `runId` označují jeho rozhovory a výsledky.

Rozhovory trvají déle, takže místo čtení každého testu čtěte každých 30 až 60 sekund revizi aktivity své organizace. Mění se, když skončí jakákoli studie nebo se zveřejní její výsledky, takže jeden požadavek pokryje všechny vaše testy:

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

Když se `products.research` změní, přečtěte výsledky.

## Přečtěte výsledkovou tabulku

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

Výsledky uvádějí odpovědi na každou otázku, shrnutí s citacemi, počet dokončených rozhovorů a výsledkovou tabulku: každou metriku pro každou kreativu i celkově. Výsledky jsou simulovaný výzkum s digitálními dvojčaty vašich zákazníků, ne naměřená kliknutí, prodeje ani konverze.

## Náklady a limity

- Test kreativ se účtuje jako každá studie Research: každý dodaný rozhovor se započítá do vašeho tarifu za cenu rozhovoru Research a čtení kreativy a příprava dvojčat čerpají kredity Alpha v jejich přesné ceně.
- Každý klíč má 100 požadavků za minutu pro API a server MCP dohromady. Jeden klíč může spustit asi 6 testů za minutu a nahrát 128 souborů za minutu a 300 za den. Když se rozpočet vyčerpá, dostanete `429`; počkejte počet sekund z `Retry-After`.
- Chcete-li požadavek bezpečně zopakovat, pošlete ho znovu se stejným `Idempotency-Key`. Opakované spuštění vrátí stejný test a nic se nezaúčtuje dvakrát.