Sync Data

Personalizando los datos del producto #

Enviando atributos simples desde el Admin de Magento 2 #

Si los atributos que deseas enviar ya están disponibles como atributos simples en tu admin de Magento 2, se pueden agregar fácilmente en la página de Extensiones.

1. Comienza yendo a Stores -> Product

Aquí puedes ver todos los atributos disponibles en tu tienda. Encuentra los códigos de atributo de los que deseas enviar a Clerk.io:

2. Asegúrate de que tu atributo sea tanto Visible como utilizado en Listados de Productos. Puedes verificar esto haciendo clic en el atributo y yendo a Propiedades de la Tienda:

3. Ve a Stores->Configuration->Clerk->Configuration

4. En Sincronización -> Campos Adicionales, escribe los códigos de atributo separados por comas :

5. Haz clic en Guardar Configuración en la esquina derecha.

(*Si no puedes encontrar la extensión Clerk, asegúrate de seleccionar la tienda correcta, haciendo clic en " Ámbito" en la parte superior izquierda.)

6. Ve a System -> Cache Management

7. Limpia las diversas cachés aquí:

8. Después de implementar tus atributos, ve a my.clerk.io->Data y haz clic en Iniciar Nueva Sincronización de Datos en la esquina superior derecha.

Si los atributos que deseas enviar ya están disponibles como parte de los datos de tus productos configurables/grupales en tu admin de Magento2, se pueden sincronizar fácilmente en la última versión de tu complemento. Aparecerán como child_attribute, por ejemplo, child_color, child_skus, etc.

Enviando atributos personalizados #

Los atributos personalizados se pueden agregar a través de la extensión en FTP.

Este archivo maneja los atributos del producto:

vendor->clerk->magento2->Model->Adapter->Product.php

Cada atributo tiene su propio fieldHandler, en la función addFieldHandlers()

Simplemente agrega tu atributo aquí, con la siguiente sintaxis:

$this->addFieldHandler('CLERK_ATTRIBUTE_NAME', function($item) {
   return MAGENTO2_LOGIC;
});

Donde CLERK_ATTRIBUTE_NAME define el nombre que deseas que tenga en Clerk.io, y MAGENTO2_LOGIC es el código para extraer el atributo de Magento 2.

Importando Datos de Productos Simples para Productos Configurables #

El siguiente código se puede usar para obtener cualquier dato que desees de productos simples dentro de un producto configurable, para que Clerk.io pueda recibirlo como un array de datos.

Esto es especialmente útil para atributos como SKUs, tamaños o colores, para hacer que estos sean buscables y filtrables en Clerk.io.

Al igual que el script de atributo personalizado anterior, los datos del producto para productos configurables se pueden agregar a través de la extensión en FTP.

Este archivo maneja los atributos del producto:

vendor->clerk->magento2->Model->Adapter->Product.php

Agrega el siguiente código al archivo:

{%raw%}
$this->addFieldHandler('CLERK_ATTRIBUTE_NAME', function ($item) {
 $simple_products_array = [];
 if ($item->getTypeId() === Configurable::TYPE_CODE) {
  $simple_products = $item->getTypeInstance()->getUsedProducts($item);
   foreach ($simple_products as $product) {
    array_push($simple_products_array, $product->getATTRIBUTE_TEXT());
         }
       }
  return array_values(array_unique($simple_products_array));
            });
{%endraw%}

Donde CLERK_ATTRIBUTE_NAME define el nombre que deseas que tenga en Clerk.io, y getATTRIBUTE_TEXT es la función get con el texto para el atributo que estás llamando, por ejemplo $product->getSKU().

Por último, incluye tus nuevos atributos en la extensión de Clerk.io en el admin de Magento 2, bajo Sincronización -> Campos Adicionales.(Como se explicó en el punto 4)

Después de implementar tus atributos, ve a my.clerk.io->Data y haz clic en Iniciar Nueva Sincronización de Datos en la esquina superior derecha.

Personalizando los datos del cliente #

Al igual que con los Productos, los Clientes están representados con atributos en Clerk.io.

Al enviar atributos de Cliente, puedes usar Audience como una Plataforma de Datos de Clientes(CDP) y crear Audiencias basadas en cualquier atributo que envíes, como región, género, códigos fiscales y así sucesivamente.

Puedes leer más sobre la forma en que Magento2 maneja los Atributos de Cliente aquí.

1. Comienza por averiguar qué atributos tienes disponibles y cuáles son sus Códigos de Atributo. Puedes encontrar esto en el backend de Magento2 en Stores > Attributes > Customer.

2. Una vez que tengas los códigos de atributo que deseas, ve a:

Stores > Settings > Configuration > Clerk > Configuration > Customer Synchronization

3. En Atributos Adicionales de Cliente, agrega una lista separada por comas de atributos que deseas sincronizar.

4. Haz clic en Guardar Config.

5. Ve a my.clerk.io > Data y haz clic en Iniciar Nueva Sincronización de Datos para sincronizar los nuevos atributos:

Elegir productos para importar #

Por defecto, la extensión de Magento 2 solo importa productos que están en stock y son vendibles.

Esto se puede cambiar si es necesario.

Incluir productos fuera de stock o con visibilidades específicas #

En el backend de Magento 2, ve a Stores->Configuration->Clerk->Configuration.

Bajo Sincronización de Productos tienes dos opciones para elegir los productos a importar:

• Solo sincronizar productos vendibles te permite elegir si enviar productos que no se pueden comprar, pero que aún se muestran.

• Solo sincronizar productos con visibilidad te permite elegir una visibilidad específica que deben tener los productos.

Después de realizar tus cambios, haz clic en Guardar Config.

Si haces esto, te recomendamos que también agregues un atributo adicional a Magento 2, que indique cuándo un producto no es vendible, para que puedas mostrarlo en tu Diseño.

Suponiendo que creas un atributo llamado is_saleable que es true o false, puedes usarlo así en Diseños:

{% raw %}
{% if product.is_saleable %}
   <div class="in-stock">En Stock</div>
{% else %}
  <div class="not-in-stock">No En Stock</div>
{% endif %}
{% endraw %}

Luego ve a my.clerk.io -> Data Sync y haz clic en Iniciar Sincronización para sincronizar con las nuevas reglas.

Agregar reglas personalizadas #

El siguiente archivo controla qué productos se importan a Clerk.io:

vendor->clerk->magento2->Model->Adapter->Product.php

En la parte inferior de este archivo, localiza la función llamada prepareCollection().

Si es necesario, puedes agregar reglas avanzadas a esta función, para controlar qué productos enviar:

Luego ve a my.clerk.io -> Data y haz clic en Iniciar Sincronización Completa de Datos para sincronizar con las nuevas reglas.

Desactivar la sincronización de pedidos #

Después de que la primera sincronización de datos se haya ejecutado con éxito, la sincronización de pedidos desde Magento2 se puede desactivar ya que el seguimiento de ventas de la extensión toma el control.

Para desactivar la sincronización de pedidos, ingresa a tu backend de Magento2, haz clic en STORES y luego en CONFIGURACIÓN:

A continuación, desplázate hacia abajo y encuentra la pestaña llamada CLERK, haz clic y presiona CONFIGURACIÓN:

Haz clic en SINCRONIZACIÓN, cambia el campo DESACTIVAR SINCRONIZACIÓN DE PEDIDOS a NO y presiona GUARDAR en la parte superior de la página:

Los cambios entran en efecto de inmediato.