Los siguientes elementos te ayudarán a poner a prueba nuestra REST API de Criteo, desde la línea de comandos o desde un navegador, utilizando Curl para simular diferentes llamadas GET y POST, que te permitirán recuperar tus primeros informes.
En naranja están destacados los elementos que deberás cambiar en tus llamadas.
Curl para autentificación
curl -X POST --header 'Content-Type: application/x-www-form-urlencoded' --header 'Accept: application/json' -d 'client_id=[clientId]&client_secret=[clientSecret]&grant_type=client_credentials' 'https://api.criteo.com/marketing/oauth2/token'
Respuesta de API: Token
Curl para portfolio
curl -X GET
--header 'Accept: application/json'
--header 'Authorization: Bearer [token]'
'https://api.criteo.com/marketing/v1/portfolio'
Respuesta de API: Advertiser_ID
Curl para recuperación de estadísticas
curl -X POST
--header 'Content-Type: application/json'
--header 'Accept: application/octet-stream'
--header 'Authorization: Bearer [token]
-d '{
"reportType": "CampaignPerformance",
"ignoreXDevice": true,
"startDate": "[startDate]",
"endDate": "[endDate]"
"dimensions": [ "Day", "CampaignId" ],
"metrics": [ "Clicks", "Displays"],
"format": "Csv",
"currency": "[Currency]",
"timezone": "GMT"
}'
'https://api.criteo.com/marketing/v1/statistics'
Respuesta de API: Link de descarga del informe
Curl para crear una audiencia de API
curl -X POST
--header 'Content-Type: application/json'
--header 'Accept: application/octet-stream'
--header 'Authorization: Bearer [token]
-d '{ "advertiser_id": 0,
"name": "string",
"description": "string"}'
'https://api.criteo.com/marketing/v1/audiences/userlist'
Respuesta de API: audience_id
Curl para actualizar una audiencia de API
curl -X PUT
--header 'Content-Type: application/json'
--header 'Accept: application/octet-stream'
--header 'Authorization: Bearer [token]
-d '{
"name": "string",
"description": "string"
}'
'https://api.criteo.com/marketing/v1/audiences/audience_ id'
Respuesta de API: OK/ERROR
curl -X GET
--header 'Accept: application/json'
--header 'Authorization: Bearer [token]'
Swagger
Swagger es la plataforma más grande del mundo de herramientas para desarrolladores de API, que permite la realización de pruebas y la implementación. También puedes utilizar nuestras herramientas de Swagger para realizar pruebas manuales de la API.
A la Swagger se puede acceder a través de esta url: https://api.criteo.com/marketing/swagger/
Nota: este enlace de Swagger te dirige al entorno de producción de Criteo. Cualquier prueba realizada allí tendrá un impacto en las campañas reales.
