Testujte kreativy přes API

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 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á):

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:

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í:

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:

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:

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#

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.