API | Coffee Pie Ads

Documentación
Coffee Pie® Ads API/MCP

Políticas del Contenido Publicitario

Todos los anuncios, campañas y creatividades enviados a través de nuestra API están sujetos a revisión para asegurar el cumplimiento de estos lineamientos y garantizar una experiencia segura y positiva para nuestra comunidad. Nos reservamos el derecho de rechazar, pausar o eliminar cualquier anuncio a nuestra entera discreción.

1. Contenido Prohibido

Se prohíbe estrictamente la promoción de lo siguiente:

Contenido Ilegal: Incluyendo, pero no limitado a, drogas ilícitas, productos falsificados y servicios que violen la ley.
Odio y Discriminación: Contenido que ataque o degrade a grupos basados en raza, religión, género, orientación sexual o discapacidad.
Violencia y Contenido Perturbador: Incitación a la violencia, terrorismo, crueldad animal o imágenes gráficas de daño.
Armas y Explosivos: Promoción de la venta de armas de fuego, munición o material explosivo.
Prácticas Engañosas: Estafas, malware, phishing o promesas financieras fraudulentas.

2. Contenido Restringido

Las siguientes categorías están sujetas a revisión estricta y pueden requerir autorización previa, licencias o segmentación específica (geográfica y de edad):

Contenido político y religioso.
Juegos de azar y apuestas.
Productos de salud y farmacéuticos.
Servicios financieros y criptoactivos.
Sustancias psicoactivas como licor, tabaco, cannabis y productos relacionados.
Contenido sexual explícito como pornografía, desnudez explícita o servicios sexuales.

3. Proceso de Revisión y Cumplimiento

La revisión puede ser tanto automatizada (mediante filtros) como manual. El incumplimiento repetido o grave de estas políticas resultará en la suspensión o terminación del acceso del anunciante a nuestra API.

Datos de Seguimiento de Patrones de Consumo (Capa de Servicio Gratuito):

*Aviso: Nunca venderemos ni compartiremos con terceros no autorizados datos sensibles del usuario como su nombre real, ni su identificación, ni sus números telefónicos, ni su correo electrónico, ni su dirección física, ni su dirección IP, ni su código postal completo, etc. En nuestra API sólo se comparte un modelo anónimo auditable con información genérica de segmentación de mercado, para que la capa gratuita del servicio sea transparente sin llegar a ser invasiva Ver Política de Privacidad. Si eres parte de una Agencia de Marketing, contáctanos directamente para agendar un Demo con uno de nuestros Ejecutivos de Cuenta que les muestre las ventajas y beneficios de pautar en nuestra plataforma masiva y altamente segmentada, usando la API o el Protocolo de Modelo de Contexto (MCP).

1. Demográficos

Edad, Género, Estado Civil, etc: Esto es fundamental para personalizar las campañas.
Nivel Educativo, Ingreso Anual, Ocupación: Ayuda a crear un perfil más detallado del usuario.
Allegados: Se segmenta si hay allegados en el entorno del usuario (como hijos, sobrinos, vecinos, mascotas, etc) sin datos sensibles de los allegados, sólo su edad, género y relación para propósitos de segmentación, como navidad, halloween, san valentin, etc.

2. Intereses

Categorías y Específicos: Se incluyen categorías amplias (como "tecnología" o "moda") y específicos ("Samsung Galaxy", "Zapatos Nike", "Tesla Model 3", etc).

3. Comportamiento

Frecuencia de Compras, Preferencia de Dispositivo: Información sobre cómo el usuario interactúa online y con qué dispositivos.
Tiempo en Plataformas y Frecuencia de Compra: Es útil para saber qué tipo de contenido le interesa al usuario.
Historial de Compras: Importante para campañas de remarketing.

4. Psicográficos

Estilo de Vida y Valores: Información clave para personalizar anuncios según valores, intereses y comportamientos.

5. Afinidad de Marca y Lealtad

Marcas Preferidas y Puntos de Lealtad: Ayuda a crear campañas personalizadas con descuentos, beneficios o anuncios de productos de marcas que el usuario ya sigue.

6. Dispositivos y Localización Aproximada

Geolocalización, Dispositivos, Sistemas Operativos y Navegador: Utilizado para segmentar a nivel geográfico o por tipo de dispositivo, importante para la personalización de los anuncios.

7. Suscripciones y Perfil Financiero

Suscripciones a servicios como Netflix™, Spotify™, Amazon™ Prime, etc permiten realizar segmentaciones por el tipo de contenido que consumen.
Marcas de Tarjetas y Score Crediticio: Para poder hacer ofertas o descuentos con base en alianzas de las diferentes marcas de tarjetas de crédito o débito (MasterCard™, Visa™, Amex™, Nequi™, Daviplata™, etc), sólo se comparten el nombre de las marcas a las que tiene acceso el usuario en nuestra API, pero nunca los datos sensibles asociados a estas, ya que por seguridad del usuario y responsabilidad ética, nos abstenemos de guardar ese tipo de datos.

Estructura de Petición (JSON):

{
"request_id": "123e4567-e89b-12d3-a456-426614174000",
"demographics": {

"languages": [
{ "language": "spanish", "isPreferred": true },
{ "language": "english", "isPreferred": false },
{ "language": "portuguese", "isPreferred": false },
{ "language": "french", "isPreferred": false }
],

"currencies": [

{"currency": "COP", "isPreferred": true },

{"currency": "USD", isPreferred": false },

{"currency": "CNY", isPreferred: false }

],
"age": 32,
"biologicalGender": "femenino",

"mentalGender": "femenino",

"sexualOrientation": "bisexual",
"location": {
"country": "Colombia",
"city": "Medellín",
"postalCode": "050012"
},
"maritalStatus": "casado",
"educationLevel": "universidad",
"annualIncomeUSD": 20000,
"occupations": ["ingeniero de software", "contador"]
},

"relatives": [

{"relativeAge":33, "relativeGender:"masculino", "relation": "pareja"},

{"relativeAge":5, "relativeGender:"femenino", "relation": "hija"},

{"relativeAge":12, "relativeGender": "masculino", "relation": "hijo"},

{"relativeAge":100, "relativeGender": "tortuga", "relation": "mascota"},

],

"recentInterests": [
"zapatos nike",
"reloj rolex",
"cine medellin",
"tecnología",
"viajes",
"deportes",
"cocina",
"videojueos"
],
"onlineBehavior": {
"onlineShoppingFrequency": "mensual",
"favoriteShoppingCategories": [
"electronica",
"ropa",
"libros"
],
"averageMinutesOnSocialMedia": 120,
"preferredSocialNetworks": [
"Facebook",
"Instagram",
"YouTube",

"TikTok"
],
"frequentlyVisitedWebsites": [
"Amazon",
"Wikipedia",
"YouTube"
],
"devices": [

{"device": "mobile phone", "isPreferred": true},

{"device": "tablet", "isPreferred": false},

{"device": "laser projector", "isPreferred": false},

]

"favDeviceData": {
    "deviceType": "Android",
    "operatingSystem": "Android 13",
    "browser": "Chrome",
    "geolocation": {
      "latitude": 6.25,
      "longitude": -75.56
    }
},
"psychographics": {
"lifestyle": "urbano",
"values": [
"innovación",
"sostenibilidad",
"comunidad"
],
"personality": "extrovertido",
"leisureActivities": [
"ir a cines",
"ir a cenar",
"hacer deporte"
]
},
"purchaseHistory": [
{
"product": "Samsung Galaxy Smartphone",
"category": "electronica",
"date": "2023-10-26",
"price": 800,

"purchaseCurrency": "USD"
},
{
"product": "zapatos deportivos Nike",
"category": "ropa",
"date": "2023-11-15",
"price": 120
}
]
},
"subscriptions": [
{"subscription": "Netflix", "amount": 15, "currency: "USD", "periodicity": "month"},

{"subscription": "Spotify Premium", "amount": 10, "currency": "USD", "periodicity": "month"},

{"subscription": "Amazon Prime", "amount": 30, "currency": "USD", "periodicity": "month"}
],

"brandAffinity": [
"Apple",
"Nike",
"Samsung"
],
"historicalLocationData": [
{
"date": "2023-11-20",
"location": {
"city": "Bogotá",
"country": "Colombia"
}
},
{
"date": "2023-11-20",
"location": {
"city": "Cartagena",
"country": "Colombia"
}
}
],
"travelFrequency": "ocasional",

"brandLoyalty":[

{"brandName": "Samsung", "loyaltyPoints1000": 250, "amountSpentLastYear": 3000000, currencySpent: "COP"},

{"brandName": "Nike", "loyaltyPoints1000": 500, "amountSpentLastYear": 600000, currencySpent: "COP"},

{"brandName": "Frisby", "loyaltyPoints1000": 750, "amountSpentLastYear": 500000, currencySpent: "COP"},

],

"financialData": {
"creditCardsAmount": 3,
"creditCardsBrand": [
"Visa",
"Amex",
"MasterCard"
],
"averageCreditHistoryScore100": 75
}
}

---

Manifiesto MCP (https://api.coffeepie.org/.well-known/manifest.json):

{
"tools": [
{
"name": "segment_audience",
"description": "Segmenta el público objetivo según edad, intereses y ubicación.",
"input_schema": {
"type": "object",
"properties": {
"age_range": { "type": "string", "description": "Rango de edad (ej: '18-24')" },
"interests": { "type": "array", "items": { "type": "string" }, "description": "Lista de intereses" },
"location": { "type": "string", "description": "Ubicación geográfica" }
},
"required": ["age_range", "interests", "location"]
},
"output_schema": {
"type": "object",
"properties": {
"segment_id": { "type": "string" },
"estimated_users": { "type": "number" },
"conversion_score": { "type": "number" }
}
},
"handler": {
"type": "http",
"url": "https://api.coffeepie.org/ads/segment",
"method": "POST",
"headers": {
"Authorization": "Bearer {{API_KEY}}",
"Content-Type": "application/json"
}
}
}
]
}

Endpoints:

Estructura de la Respuesta (Status 200)

grant_type

Authorization

Content-Type

Respuesta:

Curl

URL de la Solicitud

Cuerpo de la Respuesta

Código de la Respuesta

Encabezados de la Respuesta

Contáctanos

Suscríbete al boletín para novedades y promociones

Documentación Coffee Pie® Ads API/MCP

Estructura de Petición (JSON):

Contáctanos

Documentación
Coffee Pie® Ads API/MCP