Can I use a production app ID locally?

No. Use dev app IDs for local and dev builds.

Is no-placement an error?

No. It means no approved recommendation should render for that context.

No. Clear the container and leave the answer flow unchanged.

After the recommendation is visible to the user.

When the user activates the sponsored recommendation.

Yes, but publisher policy should suppress them.

On or immediately next to the recommendation before click.

This page defines common implementation terms and answers the questions that usually come up during SDK setup and placement testing.

Question	Answer
Which backend should local builds use?	`https://api.dev.conversaic.io`
Can I use a production app ID locally?	No. Use dev app IDs for local and dev builds.
Is no-placement an error?	No. It means no approved recommendation should render for that context.
Should the sponsor slot stay visible on no-placement?	No. Clear the container and leave the answer flow unchanged.
When should impression be reported?	After the recommendation is visible to the user.
When should click be reported?	When the user activates the sponsored recommendation.
Can blocked categories still be commercially eligible?	Yes, but publisher policy should suppress them.
Where should disclosure appear?	On or immediately next to the recommendation before click.

Term	Meaning
App ID	Public identifier used by the SDK to identify the publisher app.
Placement key	Identifier for a specific sponsor surface in the publisher UI.
Context	Prompt, topic, language, geography, or workflow data used for matching.
Placement payload	Response object used to render a sponsored recommendation.
No-placement	A valid response where no recommendation should render.
Impression	Event recorded when a recommendation becomes visible.
Click	Event recorded when a user activates the recommendation.
Conversion	Downstream action imported from an affiliate or partner source.

Symptom	Likely cause	Check
No card renders	No-placement response, blocked category, or weak match	Inspect response and policy configuration.
Empty sponsor frame appears	UI did not clear the container	Clear sponsor container on no-placement.
Clicks are not attributed	Missing placement, offer, or publisher metadata	Verify click redirect payload.
Production card appears in dev	Wrong app ID or base URL	Check environment variables and script attributes.