[Saltar al contenido principal](https://es.t-mobile.com#content-main)
[](https://es.t-mobile.com/advertising-solutions)
[](https://es.t-mobile.com/advertising-solutions)
- [Datos de audiencia](https://es.t-mobile.com/advertising-solutions/audience-insights)
- [Soluciones de medios](https://es.t-mobile.com) Soluciones de medios
- [Medios móviles](https://es.t-mobile.com/advertising-solutions/mobile-media#INTNAV=tNAV:MediaSolutions:MobileMedia)
- [Instalación de apps](https://es.t-mobile.com/advertising-solutions/app-install#INTNAV=tNAV:MediaSolutions:AppInstall)
- [Publicidades en viajes compartidos](https://es.t-mobile.com/advertising-solutions/rideshare-advertising#INTNAV=tNav:MediaSolutions:RideshareAdvertising)
- [Medios en tiendas](https://es.t-mobile.com) Medios en tiendas
- [Anunciantes](https://es.t-mobile.com/advertising-solutions/in-store-retail-media-advertisers)
- [Minoristas](https://es.t-mobile.com/advertising-solutions/in-store-retail-media-retailers)
- [Plataformas](https://es.t-mobile.com) Plataformas
- [Blis](https://blis.com/us/)
- [Vistar Media](https://www.vistarmedia.com/)
[Contáctanos](https://es.t-mobile.com/advertising-solutions/contact-us.html?INTNAV=tNav%3AContactUs)
[](https://es.t-mobile.com)
## DOCUMENTACIÓN
- [Para comenzar con la Plataforma Magenta Advertising](https://es.t-mobile.com/advertising-solutions/map/developer/documentation/getting-started-with-magenta-advertising-platform.html)
- [Requisitos de cumplimiento para la recopilación de datos del editor](https://es.t-mobile.com/advertising-solutions/map/developer/documentation/publisher-data-collection-compliance-requirements.html)
## CONSOLA
- [Cargar audiencias](https://es.t-mobile.com/advertising-solutions/map/developer/console/uploading-audiences.html)
## API DE MARKETPLACE DE DATOS
- [Información general](https://es.t-mobile.com/advertising-solutions/map/developer/data-marketplace-api/overview.html)
- [Atributos](https://es.t-mobile.com/advertising-solutions/map/developer/data-marketplace-api/attributes.htm)
- [Importar](https://es.t-mobile.com/advertising-solutions/map/developer/data-marketplace-api/import.html)
- [Formato de archivo de datos](https://es.t-mobile.com/advertising-solutions/map/developer/data-marketplace-api/data-file-format.html)
- [Formato de archivo taxonómico](https://es.t-mobile.com/advertising-solutions/map/developer/data-marketplace-api/taxonomy-file-format.html)
## TRASFERENCIA E INTEGRACIÓN DE DATOS
- [](https://es.t-mobile.com)[Acceso a AWS S3](https://es.t-mobile.com/advertising-solutions/map/developer/data-transfer-and-integration/aws-s3-access.html)
# Importar
El endpoint Importar te permite indicar a la plataforma Magenta Advertising que importe un archivo con identificadores de publicidad y los atributos asociados desde S3. Cuando la Plataforma Publicitaria Magenta te aprovisione, recibirás un conjunto de credenciales de S3 en Amazon Web Services y un prefijo de bucket/ruta. A continuación, crearás los archivos de datos que se importarán, cargarás cada archivo en Amazon S3 y, luego, publicarás en el endpoint de importación de API para indicar a Magenta Advertising Platform que ponga en cola el trabajo de importación. También puedes solicitar registros de importación a través de la API para comprobar el estado de cada archivo que pongas en cola para importar.
La plataforma Magenta Advertising también admite la incorporación desde su propio bucket de S3. Al ejecutar el endpoint «/v1/marketplace/import», puedes proporcionar opcionalmente un bucket y las credenciales que se utilizarán para la importación. En caso contrario, Magenta Advertising Platform intentará realizar la incorporación desde el bucket y la ruta que te asignamos durante la configuración del socio.
Una importación es una sustitución completa de todos los atributos presentes en la plataforma. Una importación no es una adición, es una eliminación seguida de una inserción. Cada vez que realices una importación tendrás que enviar una lista completa de todos los identificadores asociados a cada atributo. Esto no significa que todos los datos deban estar en un único archivo. En realidad, es mejor que los datos estén divididos en varios archivos, ya que nos permite procesarlos con mayor rapidez. No realices una petición a la API de importación para cada archivo; en cambio, sube todos los archivos a un prefijo/directorio común y especifica el prefijo como parte de la petición a la API de importación. Cargaremos todos los archivos con el mismo prefijo en paralelo.
Las importaciones se ponen en cola y se completarán en el orden en que se envíen.
## Destino
[https://api.magentamarketing.com/v1/marketplace/import](https://api.magentamarketing.com/v1/marketplace/import)
## Listar registros de importación
Muestra las últimas 100 tareas de importación en orden inverso a su creación.
__cURL__
```
curl -X GET -H "Authorization: Bearer
" "https://api.magentamarketing.com/v1/marketplace/import"
```
## Response
__JSON__
```
[
{
"import_log_id":3,
"file_path":"export1.csv",
"path_type": 0,
"key_type": 0,
"status":0,
"log_type": 0,
"keys":null,
"unique_devices":"1234",
"total_rows":"1300",
"errors":null,
"created_at":"2016-09-16T15:49:01.437Z",
"updated_at":"2016-09-16T15:49:01.437Z"
},
{
"import_log_id":4,
"file_path":"export2.csv",
"path_type": 0,
"key_type": 1,
"status":0,
"log_type": 0,
"keys":null,
"unique_devices":"4321",
"total_rows":"5000",
"errors":null,
"created_at":"2016-09-1T5:49:01.437Z",
"updated_at":"2016-09-1T5:49:01.437Z"
}
]
```
| | |
|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Estado | Significado |
| 0 | Pendiente. Todas las solicitudes se manejan por orden de recepción. Si tu proceso de importación muestra este código de status, está en espera detrás de otros procesos de importación. |
| 1 | Importando. |
| 2 | Listo |
| 3 | Error. Ha ocurrido algo durante la importación |
## Obtener registro de importación
Obtiene una única entrada del registro de importación
__cURL__
```
curl -X GET -H "Authorization: Bearer " "https://api.magentamarketing.com/v1/marketplace/import/3"
```
## Response
__JSON__
```
[
{
"import_log_id":3,
"file_path":"export1.csv",
"path_type": 0,
"key_type": 1,
"status":0,
"log_type": 0,
"keys":null,
"unique_devices":"1234",
"total_rows":"1300",
"errors":null,
"created_at":"2016-09-16T15:49:01.437Z",
"updated_at":"2016-09-16T15:49:01.437Z"
}
]
```
## Importar
Pone en cola un archivo para su importación.
## Parámetros
Field (Campo) Obligatorio Tipo Descripción
file\_path Y cadena Una ruta de archivo relativa. No incluyas s3://import-pushspring-com o tu prefijo de ruta asignado. Si cargaste un archivo en s3://import-pushspring-com//export.csv la ruta relativa sería «export.csv».
If you specify a path\_type of 1 below this should be a absolute path of the form s3:///.
También puede representar un prefijo de ruta. Si se utiliza un prefijo de ruta, se cargarán todos los archivos que se encuentren bajo ese prefijo. Si necesitas cargar varios archivos al día, este método es más recomendable que las peticiones de importación individuales.
key\_type Y Número entero Indica los tipos de claves del archivo que se importa.
0 = MAP assigned attribute\_id
1 = partner\_foreign\_key associated with attribute
Make sure the partner\_foreign\_key is associated with an attribute before importing the file.
path\_type N
compressed
N boolean If not specified and path\_type includes a single file we will look at the file extension and if it is ".gz" we will assume the file is compressed.
If you are using a path prefix for the file\_path you must specify this as there is no file extension to look at to determine if the file is compressed.
El valor predeterminado es Falso.
credenciales N objeto Para un bucket de S3 propiedad de un socio, las credenciales deben incluir:
{
"accessKeyId": "XXXXX",
"secretAccessKey":"YYYY",
"region":"ZZZZZ"
}
La región debe ser la región de AWS en la que se encuentra el bucket, por ejemplo, "us-west-2".
file\_path can be either a file i.e. export.csv OR a path prefix like 2020/09/15/. Si se trata de un prefijo de ruta, cargaremos todos los archivos en paralelo.
## Muestra
__cURL__
```
curl -X POST -H "Authorization: Bearer " -H "Content-Type: application/json"
-d '{
"file_path":"export.csv",
"key_type":0
}' "https://api.magentamarketing.com/v1/marketplace/import"
```
## Response
__JSON__
```
{
"import_log_id":4
}
```
## Borrar
Ocasionalmente puede ser necesario eliminar los datos asociados a un atributo. NOTA: Estos datos se borran permanentemente y no se pueden restaurar.
Field (Campo) Obligatorio Descripción
key\_type Y Indica los tipos de claves del archivo que se importa.
0 = MAP assigned attribute\_id
1 = partner\_foreign\_key associated with attribute
Make sure the partner\_foreign\_key is associated with an attribute before importing the file.
teclas Y Either the attribute\_ids or partner\_foreign\_keys you wish to delete.
## Muestra
__cURL__
```
curl -X POST -H "Authorization: Bearer " -H "Content-Type: application/json"
-d '{
"file_path":"export.csv",
"key_type":0
}' "https://api.magentamarketing.com/v1/marketplace/import"
```
## Response
__JSON__
```
{
"import_log_id":4
}
```
## ¡Hola! ¿Deseas mantener la sesión abierta?
Para mantener la seguridad de tus cuentas, se cerrará automáticamente tu sesión en:
Sí, mantener la sesión abierta
No, cerrar la sesión
## Comparte tu pantalla mientras estás en una llamada o en la tienda
__Recibe ayuda personalizada de un experto en tiempo real__
- Por tu seguridad, la información personal, las pestañas y las notificaciones se ocultan automáticamente.
- Puedes dejar de compartir la pantalla en cualquier momento.
- Los expertos solo pueden ver lo que hay en T-Mobile.com.
- No uses la función para compartir pantalla mientras conduces o en cualquier situación en la que no sea seguro concentrarte en la pantalla.
Al hacer clic en "Aceptar y continuar", das tu consentimiento para que el experto vea tu pantalla con el fin de ayudarte con la navegación. Esta sesión puede ser grabada. Para conocer más, visita el [__Aviso de privacidad de T-Mobile__](https://es.t-mobile.com/privacy-center/privacy-notices/t-mobile-privacy-notice).
Aceptar y continuar
No, gracias
__Siguiente:__ genera un código para compartir con el experto
## Comparte este código con el Experto
code
Una vez que el experto haya ingresado correctamente tu código, esta ventana se cerrará y se continuará con la sesión.
## ¿Permitir compartir pantalla con tu experto?
Los datos personales y confidenciales se ocultan por tu seguridad y privacidad.
Permitir
No permitir
## ¿Finalizar tu sesión?
Al finalizar la sesión, dejarás de compartir la pantalla, pero no finalizarás la llamada.
Terminar sesión
Continuar sesión
## Tu sesión ha terminado
Tu pantalla ya no se comparte con tu Experto.
Aceptar
Volver a compartir
## Ya estás en una sesión activa
OK
## Tu código ha caducado
Genera uno nuevo para compartirlo con tu experto.
Generar nuevo código
Soluciones de Publicidad de T-Mobile
- [English](https://es.t-mobile.com)
- [Español](https://es.t-mobile.com)
- ### Legal
Legal
- [Aviso de privacidad de T-Mobile](https://es.t-mobile.com/privacy-center/privacy-notices/t-mobile-privacy-notice)
- [Centro de Privacidad](https://es.t-mobile.com/privacy-center)
- ### Contáctanos
Contáctanos
- [Comunícate con Soluciones de Publicidad](https://es.t-mobile.com/advertising-solutions/contact-us)
[](https://es.t-mobile.com/)
- [Acerca de](https://es.t-mobile.com/our-story)
- [Relaciones con inversionistas](https://investor.t-mobile.com/default.aspx?INTNAV=fNav%3AInvestorRelations)
- [Prensa](https://es.t-mobile.com/news)
- [Empleos](https://careers.t-mobile.com?INTNAV=fNav%3ACareers)
- [Deutsche Telekom](https://www.telekom.com/en?INTNAV=fNav%3ADeutscheTelekom)
- [Puerto Rico](https://www.t-mobilepr.com/?INTNAV=fNav%3APuertoRico)
- [Aviso de Privacidad](https://es.t-mobile.com/privacy-center/privacy-notices/t-mobile-privacy-notice)
- [Centro de confianza](https://security.t-mobile.com/?INTNAV=fNav%3ATrustCenter)
- [Centro de Privacidad](https://es.t-mobile.com/privacy-center)
- [Información para el cliente](https://es.t-mobile.com/responsibility/consumer-info)
- [Seguridad pública/911](https://es.t-mobile.com/responsibility/consumer-info/safety/9-1-1)
- [Términos y condiciones](https://es.t-mobile.com/responsibility/legal/terms-and-conditions)
- [Términos de uso](https://es.t-mobile.com/responsibility/consumer-info/policies/terms-of-use)
- [Accesibilidad](https://es.t-mobile.com/responsibility/consumer-info/accessibility-policy)
- [Internet abierta](https://es.t-mobile.com/responsibility/consumer-info/policies/internet-service)
- [No venda, ni comparta mis Datos Personales](https://es.t-mobile.com)
- [Licencias y patentes](https://es.t-mobile.com/responsibility/legal/licenses-and-patents)
- [Aviso de privacidad de datos de salud del consumidor](https://es.t-mobile.com/privacy-center/privacy-notices/t-mobile-privacy-notice.html?INTNAV=fNav%3AConsumerHealthDataPrivacyNotice#health-data-privacy-notice)
- T-Mobile, el logotipo de la T, Magenta y el color magenta son marcas comerciales registradas de Deutsche Telekom AG.
- [Instagram](https://www.instagram.com/tmobilelatino/)
- [Facebook](https://www.facebook.com/TMobileLatino?ref=ts&fref=ts)
- [X](https://twitter.com/TMobileLatino)
- [You Tube](https://www.youtube.com/user/TMobile/custom)
© 2026 T‑Mobile USA, Inc.
## Mantente actualizado con las notificaciones
Entérate de lo último de T-Mobile cuando uses Internet. Puedes excluirte en cualquier momento.
Permitir notificaciones No permitir
## Conoce lo último de T-Mobile
Mantente actualizado con notificaciones que incluyen ofertas solo para ti
Permitir notificaciones No permitir notificaciones
## Mantente actualizado con las notificaciones
Entérate de lo último de T-Mobile cuando uses Internet. Puedes excluirte en cualquier momento.
Permitir notificaciones No permitir
## Conoce lo último de T-Mobile
Mantente actualizado con notificaciones que incluyen ofertas solo para ti
Permitir notificaciones No permitir notificaciones