Servicio de Cómputo
Coffee Pie®
Documentación
Coffee Pie® Ads API/MCP
*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 el Protocolo de Modelo de Contexto (MCP).
Datos de Seguimiento de Patrones de Consumo (Capa de Servicio Gratuito):
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™", 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), se comparten sólo nombre de las marcas a las que tiene acceso el usuario de manera anónima, 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 del Perfil Público de Usuario (JSON):
{
"public_uid": "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,
"occupation": "ingeniero de software"
},
"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},
]
},
"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
}
],
"deviceData": {
"deviceType": "Android",
"operatingSystem": "Android 13",
"browser": "Chrome",
"geolocation": {
"latitude": 6.25,
"longitude": -75.56
}
},
"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:
Respuesta:
Contáctanos
Suscríbete al boletín para novedades y promociones