User Guide

๐Ÿ” Admitad Docs Assistant

Ask questions about Admitad advertiser documentation in natural language and get instant, accurate answers with source citations.

01 Access the Application

Application URL
paulopestana-admitad-docs-assistant.hf.space

Open the URL above in any modern browser (Chrome, Firefox, Safari, Edge). No installation, no login, no account required.

๐Ÿ’ก Tip

If the app shows "Building..." when you first access it, wait 2-3 minutes โ€” it's starting up. After that, it stays active.

02 Getting Started (No API Key)

The app works immediately in Search Only mode โ€” no API key needed. Just type your question and get relevant documentation excerpts.

  1. Open the app You'll see the chat interface with a sidebar on the left.
  2. Type your question Use the input field at the bottom: "Ask a question about Admitad documentation..."
  3. Read the results The system finds the most relevant documentation excerpts and shows them with the source file, section name, and a relevance score.
  4. Click "View original article" Each result links to the original article on the Admitad support website.
You ask:
What documents are required for cooperation with Admitad?
SEMANTIC SEARCH ยท relevance: 100%
๐Ÿ“„ documents-required-for-cooperation-with-admitad.md

To launch an affiliate program, you need to establish a partnership with Admitad. For that, provide the following: Supporting documents, Your company's payment details. Send all information to advsupport@admitad.com

03 Enable AI-Powered Answers (Free)

For more detailed, interpreted answers that combine information from multiple documents, you can enable AI mode with a free API key.

  1. Get a free Groq API key Go to console.groq.com/keys โ€” create a free account (no credit card), then click "Create API Key" and copy it.
  2. Paste the key in the sidebar In the app sidebar under "๐Ÿ”‘ API Key", paste your key. It starts with gsk_. The app will show "โœ… Detected: groq".
  3. Choose a query mode Switch from "Search Only" to one of the AI-powered modes (see section 04 below).
  4. Ask your question The AI will generate a natural-language answer combining information from multiple sources, with citations like [Source 1], [Source 2].
๐Ÿ’ก Privacy

Your API key is only used during your session and is never stored on our servers. It's sent directly from your browser to the AI provider (Groq).

You ask:
What is the difference between tracking code and postback integration?
CHAT RAG ยท groq (llama-3.3-70b-versatile)

The main difference is how target action data is transmitted to Admitad:

Tracking code places a JavaScript snippet on your website that sends data from the user's browser. [Source 1]

Postback integration sends data directly from your server to Admitad's server, making it more secure and unaffected by ad blockers or browser privacy settings. [Source 2]

Postback is generally recommended as the more reliable method, though it requires server-side access. [Source 3]

04 Query Modes Explained

Choose how your questions are processed using the mode selector in the sidebar.

๐Ÿ”
Search Only โ€” Free, no AI
Returns raw documentation excerpts. No AI interpretation. Works without an API key.
Cost: 0 AI calls
โšก
Smart Auto โ€” Best balance
The system analyzes your question with keyword patterns. Simple questions โ†’ search. Complex questions โ†’ AI answer.
Cost: 0โ€“1 AI calls
๐Ÿง 
AI Auto โ€” Most accurate
An AI model reads your question and picks the best approach. More accurate routing, but uses an extra AI call.
Cost: 1โ€“2 AI calls
๐Ÿ’ฌ
Always AI Answer
Every question gets a full AI-generated answer that combines multiple documents with source citations.
Cost: 1 AI call
โš ๏ธ Recommendation

Start with "Search Only" to explore the documentation. Switch to "Smart Auto" or "Always AI Answer" when you need the AI to explain, compare, or summarize information from multiple articles.

05 Sample Questions to Try

Simple lookups (work great in Search Only)

Complex questions (best with AI modes)

06 Supported AI Providers

The app supports multiple AI providers. You can use any of these API keys:

๐ŸŸข Groq
Free, fast. Key starts with gsk_
๐Ÿ”ด Google Gemini
Free tier available. Key starts with AI
๐Ÿ”ต OpenAI
Paid. Key starts with sk-
platform.openai.com
๐ŸŸ  Anthropic
Paid. Key starts with sk-ant-
console.anthropic.com

07 Tips for Best Results

Be specific

Instead of "How does integration work?", try "How to integrate via postback request?" โ€” the more specific, the better the results.

Use English

The documentation is in English. While the AI can respond in other languages, questions in English typically produce the most accurate results.

Check the sources

Always click "View original article" to verify the information in its full context. The AI is helpful but not infallible.

Clear conversation

If the AI seems confused or gives odd answers, click "๐Ÿ—‘๏ธ Clear conversation" in the sidebar to reset the chat history.