Getting Started

Quickstart & SDK Installation

Integrate real-time conversational ad matching into your React / Next.js app or Python LLM pipeline in under 5 minutes.

1. Install Published Packages

React / Next.js (npm v1.0.1)

npm package

npm install matrixads-react

Python / LangChain (PyPI v1.0.2)

PyPI package

pip install matrixads

2. Quickstart Code Snippets

React Component (matrixads-react):

import { MatrixAdsCard } from 'matrixads-react';

export function ChatMessage({ message }) {
  return (
    <div className="chat-message">
      <p>{message.text}</p>
      
      {/* Native Conversational Ad Card */}
      <MatrixAdsCard 
        publisherKey="mtx_pk_live_your_key_here" 
        ad={message.ad}
        theme="dark"
      />
    </div>
  );
}

Python Async Backend (pip install matrixads):

import asyncio
from matrixads import MatrixAdsClient

async def main():
    client = MatrixAdsClient(publisher_key="mtx_pk_live_your_key_here")
    res = await client.amatch_ad("Best cloud database hosting for Node.js")
    
    if res.match and res.ad:
        print("Headline:", res.ad.headline)
        print("CTA URL:", res.ad.cta_url)

asyncio.run(main())