Skip to main content
Version: 3.x

Integrate Hosted Link with AI

Copy the prompt below into your AI assistant — Claude, ChatGPT, Cursor, Codex, or whatever you use. It points the agent at our full, always-current Hosted Link reference, so it works from the real documentation instead of guessing.

Copy this prompt into your AI assistant
I'm integrating TapResearch into my app using the Hosted Link. Read the full reference documentation at https://supply-docs.tapresearch.com/llms-hosted-link.txt first — it's the current, authoritative source — then help me implement it step by step, matching my project's existing structure and conventions. Follow the best-practices and testing guidance in the docs, and call out common mistakes as we go. If something isn't covered in the docs, tell me instead of guessing. Use placeholders like API_TOKEN for any credentials — don't ask me to paste real tokens or keys into this chat, and keep server-side keys out of client code and version control. Show me where to add my API token and placement tag from the TapResearch dashboard. When the integration is in place, help me write and run a smoke test for each step and debug anything that fails — I'll confirm each step is passing in the TapResearch dashboard.

Your agent reads the live docs bundle, so it always has the current integration steps — no stale copy, nothing to keep in sync.

Open in ClaudeOpen in ChatGPT

Using a terminal or IDE agent (Claude Code, Cursor, Codex)? The Add to AGENTS.md line drops into your repo so the agent picks it up automatically. No web access in your agent? Open the full docs bundle and paste it in directly.

Hosted Link is the low-code path, so there's not much to build — mostly templating the link per user and handling the reward callback. Your agent can walk you through both. Review what it writes, and reach for the rest of these docs whenever you want the details yourself.

After you integrate: verify it's working​

Hosted Link is low-code, so verification is quick. Complete your dashboard Account Setup first (currency, a placement with content, and a test device), then check the flow end-to-end on a test device. Your AI agent can help run and debug these steps, but it can't see your account — so your callback endpoint receiving the completion is what confirms the flow works.

Use a real test session

Open the link on a real test device — a test postback on its own won't exercise the flow. Add a test device first (More → Test devices).

  1. Link opens the survey wall — Open your templated Hosted Link on a test device; it should load the survey wall.
  2. Reward callback configured — Set your server-to-server postback URL in your app settings.
  3. Survey complete recorded — Complete a test survey through the link.
  4. Callback received & verified — Confirm your endpoint receives a signed GET (validate the HMAC sig) and redeems the reward.

(The dashboard's Integration tab shows only Account Setup for Hosted Link — there's no implementation checklist to watch, which is why the callback is your signal.) For deeper guidance, see Testing & QA.