Gestión de pixels

Consideraciones

• Registra tu aplicación en https://developers.mercadolibre.com para obtener un application_id. (Se debe dar de alta la aplicación en Mshops).
• Usa Oauth para autorizar las peticiones, asegurando interacciones seguras y autenticadas con nuestra plataforma.
• Cada aplication_id se asocia a un único pixel_id. Para adquirir otro, debes dar de alta otra aplicación. A a su vez, un Pixel_id puede tener múltiples seller asociados.
• La asociación de scripts requiere que el vendedor tenga un dominio delegado en Mercado Shops. Si no se cumple este requisito, la API generará un error 401 (más info.)

Scripts

• El formato de los scripts debe ser un template de Handlebars tal que se pueda obtener un código de JavaScript al reemplazar la variable de usuario. El código de JavaScript obtenido del script debe poder ser ejecutado dentro de una condición.
• Mantén el script por debajo de 2kB. Si necesitas lógica adicional, haz un llamado a un archivo JavaScript externo almacenado en un CDN proporcionado por el Integrador.
• Asegúrate de que los nombres de archivo JSON sean simples, evitando espacios y caracteres especiales para garantizar la compatibilidad.
• Incluye la variable definida en el archivo .JSON en tu script. Esta variable puede nombrarse como VARIABLE.

Ejemplo de script correcto:

script.hbs

    
      if (/*condition*/) { 
      var 
      src="https://test-pixel.com/api/script/mercadoshops/onLoad.js?=shop123"; var script = document.createElement("script"); 
      script.setAttribute("src", src); 
      document.getElementsByTagName("head")[0].appendChild(script); 
      } 
    
  

Cómo se Verá en la Tienda:

    
      var src="https://test-pixel.com/api/script/mercadoshops/onLoad.js?={{VARIABLE}}"; var script = document.createElement("script"); 
      script.setAttribute("src", src); 
      document.getElementsByTagName("head")[0].appendChild(script);
    
  

Ejemplo de script incorrecto:

    
      <script 
      src="https://test-pixel.com/api/script/mercadoshops/onLoad.js?store
      ={{VARIABLE}} async defer></script>
    
  

Identificar el Dominio de la tienda

Antes de comenzar el proceso de configuración de píxeles, es importante contar con acceso a los datos del dominio de las tiendas en Mercado Shops. Esto permite, en primer lugar, identificar si el dominio está delegado o no, y también obtener la información necesaria para agregar scripts personalizados. Para facilitar esto, ponemos a disposición la información a través del siguiente recurso.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'
https://api.mercadolibre.com/shops/public-domains

Respuesta:

{
    "domain": "www.shop.domain.com",
    "shop_id": 123242154125,
    "status": "ACTIVE",
    "delegation_type": "PARTIAL",
    "site": "MCO"
}

Parámetros:

curl -X POST-H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
    {...}
https://api.mercadolibre.com/shops/custom-scripts/ext/integration

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
  "pixel_id": "XXXXX",
  "sections": ["home", "search", "vip", "cart", "contact"],
  "external_client_id": "XXXXX",
}
'
https://api.mercadolibre.com/shops/custom-scripts/ext/integration

{
  "id": "XXXXX",
  "pixel": {
    "id": "XXXXX",
    "description": "XXXXX"
  },
  "created_at": "XXXXX",
  "sections": ["home", "search", "vip", "cart", "contact"]
}

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shops/custom-scripts/ext/integration?integration_id={INTEGRATION_ID}

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/shops/custom-scripts/ext/integration?integration_id={INTEGRATION_ID}

{
  "updated_at": "XX/XX/XX",
  "status": "Disabled",
  "external_client_id": "XXXXX"
}