Core concepts
Ad formats
Formats share the same API. Timing follows the saved project and real generation lifecycle, not a separate Clip API.
Native
Structured creative rendered by the official renderer. Do not rebuild media, clicks or tracking from the response in the default package path.
Clip
A video ad, not model video generation. Let the renderer handle playback, natural completion and cleanup. The final frame must not become a permanent static ad. Early Stop or removal is not natural completion.
The selected size must fit the actual slot. A 320 px Clip does not fit a 275 px slot inside a padded mobile chat. In that case no_fit leaves the slot empty. Use a wider placement or another supported size; do not force the video beyond the available width.
During and After
During is tied to active generation. A late placement may be discarded once the generation window closes. Never delay model completion to make an ad appear.
After begins only after model completion and output presentation. Connect onPresented or resolve the consumer after displaying the result. Keep all callbacks bound to the same turn.
The published package controls format-specific cleanup. Verify the selected format on your actual output surface. A layout must not prolong a Clip or send a completion event after cancellation.
Conversation changes and privacy
Rebind when the user or conversation changes. Dispose on unmount, propagate Stop and clear stale placements. Denial, withdrawal or unavailable required consent prevents further unauthorized ad activity.
Need help with your integration?
Share the affected endpoint, request ID, and the behavior you expected. Leave out keys and user content.