usePlacement

usePlacement(__namedParameters): UsePlacementResult

React hook for loading a placement decision and managing interactions.

Handles registration, decision fetching, impression tracking, and exposes interaction methods (dismiss, remind me later, CTA click/complete).

Parameters

__namedParameters

UsePlacementOptions

Returns

UsePlacementResult

Example

const { visible, content, ctaClick, dismiss } = usePlacement({
  placement: { name: 'pricing_banner' },
  userId: 'user_123',
});

if (!visible) return null;
return (
  <div>
    <h2>{content?.header}</h2>
    <button onClick={() => ctaClick()}>{content?.cta_label}</button>
  </div>
);