En esta página: Obtenga información sobre cómo las fuentes importan entidades en Adobe Target Recommendations, qué tipos de origen están disponibles y cómo crear y supervisar una fuente.
Utilice fuentes para obtener entidades importadas en Adobe Target Recommendations. Las entidades se pueden enviar mediante archivos CSV, el formato de fuente Google Product Search y Adobe Analytics clasificaciones de productos.
Resumen de fuentes concept_D1E9C7347C5D4583AA69B02E79607890
Las fuentes le permiten pasar entidades o ampliar los datos de mbox con información que, o bien no está disponible en la página, o bien no es seguro enviar directamente desde la página. Por ejemplo, margen, Coste de productos vendidos (COGS), etc. Las fuentes también le permiten pasar información detallada del elemento a Recommendations, como el ID del producto, la categoría, el nombre, el mensaje y otros atributos.
Puede seleccionar las columnas de su archivo de clasificaciones de productos Target o del archivo Google Product Search que desea enviar al servidor Recommendations.
Estos datos sobre cada elemento se pueden utilizar para lo siguiente:
- Mostrar valores en diseños
- Definir reglas de inclusión de criterios
- Ordenar elementos en diferentes colecciones
- Aplicación de exclusiones a recomendaciones
Las descripciones de los elementos se pueden pasar a Target mediante fuentes o mboxes. Si Target recopila datos mediante una fuente de entidades y un mbox, prevalecerán los datos más recientes. Normalmente, los datos más recientes proceden de un mbox, ya que su visualización es más frecuente. En el caso improbable de que los datos de una fuente de entidades y los datos de un mbox se visiten al mismo tiempo, se utilizarán los datos del mbox.
Las entidades y atributos de entidad cargados caducan al cabo de 61 días. Esto implica lo siguiente:
-
La fuente debe ejecutarse al menos una vez al mes para garantizar que el contenido del catálogo no caduque.
-
Al eliminar un elemento del archivo de fuentes, no se elimina del catálogo. Para quitar el elemento del catálogo, elimínelo manualmente mediante la interfaz de usuario o la API de Target. O bien, modifique los atributos del artículo (como el inventario) para asegurarse de que el artículo se excluye de la consideración.
-
Cargue el archivo de fuentes al menos cada 60 días para evitar interrupciones en las actividades de Recommendations. Si un elemento no se incluye en un archivo de fuentes (u otro método de actualización de entidad) al menos una vez cada 60 días, Target deduce que el elemento ya no es relevante y lo elimina del catálogo.
Lista de fuentes
La lista Fuentes (Recomendaciones > Fuentes) proporciona información sobre cualquier fuente que haya creado. Contiene las siguientes columnas:
- Haga clic en el icono Personalizar tabla (
) para seleccionar o anular la selección de las columnas que desee mostrar. - Haga clic en el icono Información (
) para mostrar una tarjeta con la última fecha de carga y la dirección URL de la fuente. - Haga clic en el icono Más acciones (
) para obtener acceso a las siguientes acciones: Desactivar, Edit, Copiar y Eliminar.
Tipos de Source source-types
En las siguientes secciones se describen los tipos de origen que se pueden utilizar para enviar entidades.
CSV section_65CC1148C7DD448FB213FDF499D35FCA
Puede crear un archivo .csv utilizando el formato de carga CSV propiedad de Adobe. El archivo contiene información de visualización sobre los atributos reservados y personalizados para sus productos. Para cargar atributos específicos de su implementación, reemplace CustomN en la fila del encabezado con el nombre del atributo que desea utilizar. En el ejemplo siguiente, entity.Custom1 ha sido reemplazado por entity.availability. A continuación, puede subir de forma masiva el archivo al servidor de Recommendations.
El uso del formato .csv tiene las siguientes ventajas con respecto al formato de fuente Google:
- El formato .csv no requiere asignaciones de campos.
- El formato .csv admite atributos de varios valores (consulte el ejemplo siguiente).
- El formato .csv admite hasta 100 atributos personalizados. Si necesita más de 100 atributos personalizados, puede crear un segundo archivo de fuente con un conjunto diferente de atributos personalizados específicos.
Utilice el método de carga masiva para enviar información de visualización si no tiene mboxes en la página o si desea complementar la información de visualización con elementos que no están disponibles en el sitio. Por ejemplo, es posible que desee enviar la información del inventario de que no esté publicada en el sitio.
Cualquier dato cargado con el archivo .csv, fuente de producto de Google o fuente de clasificación de producto Analytics sobrescribe el valor de atributo de entidad existente en la base de datos. Si envía información de precios mediante solicitudes mbox y, a continuación, envía valores de precios diferentes en el archivo, los valores del archivo sobrescriben los valores establecidos en la solicitud mbox. Una excepción a esto es el atributo de entidad categoryId donde los valores de categoría se anexan en lugar de sobrescribirse hasta el límite de 250 caracteres.
Por ejemplo, la sintaxis siguiente es incorrecta:
"Apples "Bananas" Grapes"",
La sintaxis correcta sería esta:
"Apples ""Bananas"" Grapes""",
Tenga en cuenta que no puede sobrescribir un valor existente con un valor en blanco. Pase otro valor en su lugar para sobrescribir el valor existente. En el caso de un precio de venta, una solución común es pasar un “NULL” real o algún otro mensaje. A continuación, puede escribir una regla de plantilla para excluir los artículos con el valor en cuestión.
El producto está disponible en la interfaz de administración de aproximadamente dos horas después de cargar su entidad correctamente.
| code language-none |
|---|
|
Google section_8EFA98B5BC064140B3F74534AA93AFFF
El tipo de fuente Google Product Search usa el formato Google en lugar del formato CSV propiedad de Adobe. Puede reutilizar un(a) Google Product Feed existente para importar datos de producto en Recommendations.
Recommendations acepta archivos .xml, .txt y .tsv que siguen la especificación de fuente Google y utilizan los atributos definidos por Google. Especifique la dirección URL o la ubicación FTP de la fuente para que el servidor Recommendations pueda recuperar el archivo y generar el catálogo.
Tenga en cuenta que el servidor que aloja la fuente Google debe permitir el método POST.
Tenga en cuenta los siguientes requisitos y limitaciones:
- El mbox de una página de producto sigue siendo necesario para mostrar recomendaciones en esa página o rastrear vistas de productos para algoritmos basados en vistas.
- Google fuentes no admiten varios valores para un atributo personalizado.
La fuente se ejecuta cuando la guarda y activa, y luego diariamente una hora más tarde que el tiempo de ejecución inicial.
| code language-xml |
|---|
|
| code language-none |
|---|
|
Analytics clasificaciones de productos section_79E430D2C75443BEBC9AA0916A337E0A
La clasificación de producto Adobe Analytics es la única clasificación disponible para Recommendations. Para obtener más información acerca de este archivo de clasificación, consulte Acerca de las clasificaciones en la guía de Componentes de Analytics. Es posible que su implementación actual de no incluya toda la información que necesita en Recommendations. Por lo tanto, si desea agregar información a su archivo de clasificaciones, consulte esta guía del usuario.
- Las actualizaciones de los atributos de la entidad incurren en un retraso adicional de hasta 24 horas.
- Target solo admite Clasificaciones de productos. La SKU del producto Analytics debe asignarse al mismo nivel que Recommendations
entity.id. Las clasificaciones personalizadas Analytics se pueden diseñar con Adobe Consulting Services. Póngase en contacto con el Administrador de cuentas si tiene alguna pregunta.
Crear una fuente steps
Cree una fuente para incluir información sobre sus productos o servicios en Recommendations.
El origen determina dónde Recommendations recupera los datos de entidad que crea el catálogo.
-
Desde la interfaz de Target, haga clic en Recommendations > Fuentes > Crear fuente.
-
Elija un nombre descriptivo para la fuente.
-
Seleccione un tipo Source.
- CSV
- Fuente de productos Google
- Clasificaciones de Analytics
Para obtener información sobre los tipos de fuente CSV y Fuente de productos Google, consulte tipos de Source. También puede descargar una guía de CSV como modelo para ayudarle a dar formato a la fuente correctamente.
-
(Condicional) Si seleccionó CSV o Fuente de productos de Google, especifique la ubicación donde se puede obtener acceso a la fuente.
-
FTP: Si ha seleccionado la ubicación FTP, indique los datos del servidor FTP, las credenciales de inicio de sesión, el nombre de archivo y el directorio de FTP. Puede utilizar FTP con SSL (FTPS) para que las cargas sean más seguras.
accordion Configuración de servidor FTP admitida - FTP y FTPS deben estar configurados para utilizar FTP pasivo.
- En FTPS, configure el servidor para que acepte conexiones de FTPS explícitas.
- Puede especificar manualmente un puerto en el que iniciar la conexión (por ejemplo,
ftp://ftp.yoursite.com:2121). Si no especifica un puerto, se utilizará el puerto FTP o FTPS predeterminado.
-
SFTP: Escriba el nombre de host o la dirección IP, el puerto (predeterminado: 22), el nombre de usuario, el directorio y el nombre de archivo del servidor SFTP. Para la autenticación, proporcione una contraseña, una clave privada SSH o ambas.
accordion Configuración y limitaciones del servidor SFTP admitidas - La autenticación utiliza una contraseña, una clave privada SSH o ambas. Se requiere al menos uno.
- El cliente genera y posee el par de claves. Instale la clave pública en el archivo
authorized_keysdel usuario SFTP y pegue la clave privada en Target como texto PEM. Los tipos de clave aceptados son RSA, Ed25519 y ECDSA, en formato PEM (-----BEGIN RSA PRIVATE KEY-----), PKCS#8 (-----BEGIN PRIVATE KEY-----) u OpenSSH (-----BEGIN OPENSSH PRIVATE KEY-----). - No se admiten claves privadas protegidas con frase de contraseña; no se puede guardar una fuente con una.
- Target almacena la clave privada cifrada y no la vuelve a mostrar. Para girarla, edite la fuente e introduzca la nueva clave.
- Escriba un nombre de host o una dirección IP sin formato, sin un prefijo, puerto o ruta de acceso de
sftp://. Utilice el campo Port para un puerto no predeterminado. - La clave de host del servidor se acepta en la primera conexión y no se necesita intercambio de huellas digitales con Adobe.
- El SFTP está disponible en la interfaz de Target y en la API de Recommendations, pero no en la interfaz de administración heredada de Recommendations Classic. Adobe no aloja un extremo SFTP; utilice un servidor alojado por el cliente.
- El servidor SFTP debe ser accesible desde Internet y permitir conexiones entrantes desde las direcciones de descarga de Adobe Target.
-
URL: Si selecciona URL, especifique la URL.
-
-
(Condicional) Si seleccionó Clasificaciones de Analytics, elija el grupo de informes en la lista desplegable.
-
Haga clic en la flecha Siguiente para mostrar las opciones de Programar y seleccione una opción de actualización:
- Diario
- Semanalmente
- Cada 2 Semanas
- Nunca: No programar una actualización. Seleccione esta opción si no quiere que se ejecute esta fuente.
-
Especifique a qué hora desea que se ejecute la fuente.
Esta opción está basada en la zona horaria establecida en el navegador. Si quiere usar una hora de otra zona horaria, tiene que calcularla según su propia zona horaria.
-
Haga clic en la flecha Siguiente para mostrar las opciones de Asignación y, a continuación, especifique cómo desea asignar los datos a las definiciones de Target.
-
(Opcional) Si quiere que la fuente pertenezca a un entorno (grupo de hosts), seleccione el grupo de hosts.
De manera predeterminada, la fuente pertenece a todos los grupos de hosts. De este modo se garantiza que los elementos de la fuente estén disponibles en cualquier entorno. Para obtener más información, consulte Hosts.
-
Haga clic en Guardar.
Después de crear o editar una fuente, esta se ejecuta inmediatamente y luego se actualiza según la configuración. La fuente debe sincronizarse, procesarse e indexarse antes de que sus datos estén disponibles. El procesamiento continúa aunque cierre Target y puede seguir el progreso de la lista Fuentes con el estado de la fuente.
Durante la indexación, los productos y los encabezados de fuente aparecen antes de los valores individuales, por lo que ya puede buscar productos y crear colecciones, exclusiones, diseños y actividades.
El estado “Correcto” significa que el archivo se encontró y analizó correctamente. Sus datos solo están disponibles después de la indexación, lo que tarda más en archivos más grandes. Un error puede deberse a una dirección URL o información de FTP incorrecta, a la falta de un archivo o a un error de análisis.
Estados e indicadores de fuente concept_E475986720D1400999868B3DFD14A7A0
En esta sección se describen los posibles estados de las fuentes y sus indicadores.
Estados de fuente status
Estos son los posibles estados de una fuente:
Target ha importado el archivo de fuente en su sistema de entrega de contenido. Se han realizado cambios en los atributos del elemento en el sistema de entrega de contenido, y estos se reflejarán próximamente en las recomendaciones enviadas. Si no ve los cambios esperados, vuelva a intentarlo y actualice la página que contiene recomendaciones.
Notas:
- Si los cambios realizados en los atributos de un elemento resultan en la exclusión de un elemento de las recomendaciones, la exclusión se refleja inmediatamente. Si se agrega un elemento nuevo o los cambios en los atributos hacen que el elemento ya no se excluya de las recomendaciones, esto no se reflejará hasta la siguiente actualización del algoritmo, que se producirá en un plazo de 24 horas.
- Cuando se muestra este estado, es posible que las actualizaciones aún no se reflejen en la interfaz de usuario de Catalog Search. Aparece un estado separado en Búsqueda en el catálogo que indica la última vez que se actualizó el catálogo en el que se puede buscar.
Error de importación parcial partial-import-failed
Anteriormente, cuando no se cargaban todas las filas, la fuente se marcaba como correcta. Esto daba la falsa impresión de que todas las filas se habían cargado. El mensaje ahora indica lo que ha sucedido: la fuente se marca como importación parcial fallida en lugar de correcta.
El siguiente escenario muestra por qué se puede producir una importación parcial de fuentes:
- Ha cargado un archivo de fuente para el entorno de producción; por ejemplo, 100 filas.
- Se ejecutó la fuente, se cargaron 80 de esas filas y se perdieron 20 debido a un formato incorrecto, a que el campo superaba los caracteres, etc.
- La fuente se marcó como correcta en la interfaz de usuario, lo que da la impresión de que se han cargado las 100 filas.
- Está esperando algunos de esos 20 productos en el envío de una actividad, pero no está ocurriendo.
- La fuente que ha cargado contiene los detalles del producto para los productos en cuestión, pero no los ve en el back-end cuando realiza una consulta a través de la API de entidad, lo que muestra que no están en el back-end.
Para actualizar una fuente (por ejemplo, si quiere hacer cambios en la configuración o el archivo de la fuente), ábrala, aplique los cambios y haga clic en Guardar. Las entidades cargadas caducan al cabo de 61 días. Consulte la nota en Resumen de fuentes para ver la frecuencia de carga.
Indicadores de estado de fuente section_3C8A236C5CB84C769A9E9E36B8BFABA4
En la columna Estado se muestran los siguientes indicadores de estado de fuente:
Veamos los siguientes ejemplos:
Ejemplo 1:
- Día uno: procesos diarios de alimentación a las 9:00 a.m. PST.
- Día dos: son las 3:30 p.m. y la fuente no ha funcionado desde ayer a las 9:00 a.m.
El estado tendría que ser amarillo, ya que el índice se debe de haber ejecutado, más o menos, hace 6 horas y media. 6,5 horas + 24 es un 127 % del plazo de la fuente.
Ejemplo 2:
- 1 de enero: procesos mensuales de alimentación a las 9:00 a.m. PST.
- 3 de febrero: son las 10:00 a.m. y la fuente no ha funcionado durante un mes, un día y una hora atrás.
El estado tendría que ser amarillo, ya que el índice se debe de haber ejecutado, más o menos, hace un día y una hora. Aunque esto es solo [31 + (1/25)]/30 = 1,03 % de la configuración de frecuencia, se ha superado el retraso máximo de un día.
Vídeos de formación
Los siguientes vídeos contienen más información sobre los conceptos mencionados en este artículo.
Este vídeo contiene la información siguiente:
- Explicación del objetivo de las fuentes
- Explicación del valor de las fuentes
| embed |
|---|
| https://video.tv.adobe.com/v/33945?captions=spa&learn=on |
Este vídeo contiene la información siguiente:
- Configuración de una fuente
- Qué tipo de fuente utilizar
| embed |
|---|
| https://video.tv.adobe.com/v/33944?captions=spa&learn=on |