Utilice fuentes para obtener entidades importadas en Adobe Target Recommendations. Las entidades se pueden enviar utilizando archivos CSV, el formato de fuente de Google Product Search y Adobe Analytics clasificaciones de productos.
Las fuentes le permiten pasar Entidades o aumente 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, como margen, COGS, etc.
Las fuentes permiten pasar información detallada del artículo 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 de Target o del archivo de Búsqueda de productos de Google que desea enviar al servidor de Recommendations.
Estos datos sobre cada elemento se pueden utilizar para lo siguiente:
Las descripciones de los elementos se pueden pasar a Target uso de fuentes o mboxes. Si los datos son recopilados tanto por una fuente de entidades como por 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.
El Fuentes list ( Recommendations > Fuentes) proporciona información sobre cualquier fuente que haya creado.
El Fuentes Esta página contiene las siguientes columnas:
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 de puntos suspensivos para acceder a las siguientes acciones: Desactivar, Edit, Copiar, y Eliminar.
Las entidades y atributos de entidad cargados caducan al cabo de 61 días. Esto implica lo siguiente:
Las entidades se pueden enviar utilizando archivos CSV, el formato de fuente de Google Product Search y Adobe Analytics clasificaciones de productos.
Puede crear un archivo .csv con la variable Adobe formato de carga CSV propiedad de. 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 sobre el formato de Google Feed:
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 Analytics La fuente de clasificación de productos 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.
No escriba los valores entre comillas dobles (") en el archivo .csv a menos que sean deliberadas. Si coloca los valores entre comillas dobles, debe escaparlos escribiendo otro par de comillas dobles. Las comillas dobles sin escape evitan que la fuente de recomendaciones no se cargue correctamente.
Por ejemplo, la sintaxis siguiente es incorrecta:
"Apples "Bananas" Grapes"",
La sintaxis correcta sería esta:
"Apples ""Bananas"" Grapes""",
No se puede sobrescribir un valor existente con un valor en blanco. Pase otro valor en su lugar para sobrescribirlo. 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.
El siguiente es un código de muestra de un archivo .csv:
## RECSRecommendations Upload File
## RECS''## RECS'' indicates a Recommendations pre-process header. Please do not remove these lines.
## RECS
## RECSUse this file to upload product display information to Recommendations. Each product has its own row. Each line must contain 19 values and if not all are filled a space should be left.
## RECSThe last 100 columns (entity.custom1 - entity.custom100) are custom. The name 'customN' can be replaced with a custom name such as 'onSale' or 'brand'.
## RECSIf the products already exist in Recommendations then changes uploaded here will override the data in Recommendations. Any new attributes entered here will be added to the product''s entry in Recommendations.
## RECSentity.id,entity.name,entity.categoryId,entity.message,entity.thumbnailUrl,entity.value,entity.pageUrl,entity.inventory,entity.margin,entity.last_updated_by,entity.multi_english,entity.availability,entity.tax_country,entity.tax_region,entity.tax_rate,entity.product_type,entity.item_group_id,entity.color,entity.size,entity.brand,entity.gtin
na3456,RipCurl Watch with Titanium Dial,Watches & Sport,Cutting edge titanium with round case,https://example.com/s7/na3456_Viewer,425,https://example.com/shop/en-us/na3456_RipCurl,24,0.25,csv,"[""New"",""Web"",""Sales"",""[1,2,34,5]""]",in stock,US,CA,9.25,Shop by Category > Watches,dz1,Titanium,44mm,RipCurl,"075380 01050 5"
na3457,RipCurl Watch with Black Dial,Watches & Sport,Cutting edge matte black with round case,https://example.com/s7/na3457_Viewer,275,https://example.com/shop/en-us/na3457_RipCurl,24,0.27,csv,"[""New"",""Web"",""Sales"",""[1,2,34,5]""]",in stock,US,CA,9.25,Shop by Category > Watches,dz1,Black,44mm,RipCurl,"075340 01060 7"
El tipo de fuente de Búsqueda de productos de Google utiliza el formato de Google. Esto es diferente a la Adobe formato de carga CSV propiedad de.
Si tiene una fuente de productos de Google existente, puede usarla como su archivo de importación.
No es obligatorio usar datos de Google. Recommendations utiliza el mismo formato que Google. Puede usar este método para cargar los datos que tenga y utilizar las funciones de programación disponibles. No obstante, debe conservar los nombres de atributo predefinidos de Google al configurar el archivo.
La mayoría de los minoristas cargan productos en Google, por lo que cuando un visitante utiliza la búsqueda de productos de Google, se muestran sus productos. Recommendations sigue exactamente la especificación de Google para las fuentes de entidades. Las fuentes de entidades se pueden enviar a Recommendations mediante .xml, .txt o .tsv, y puede utilizar el atributos definidos por Google. Los resultados se pueden buscar en las páginas de compra de Google.
El método POST debe estar permitido en el servidor que hospeda el contenido de las fuentes de Google.
Porque Recommendations Los usuarios de ya configuran las fuentes .xml o .txt para enviarlas a Google a través de una dirección URL o FTP. Las fuentes de entidades aceptan esos datos de productos y los utilizan para crear el catálogo de Recommendations. Especifique si la fuente existe y si el servidor de Recommendations recupera los datos.
Si utiliza la búsqueda de productos de Google para cargar la fuente de la entidad, aún debe tener un mbox de página de producto en la página si desea mostrar recomendaciones o rastrear vistas de productos para la entrega de algoritmos basados en vistas.
Las fuentes de Google no admiten valores múltiples para un atributo personalizado.
La fuente se ejecuta en el momento en que la guarda y activa. Se ejecuta en el momento en que se guarda la fuente y, a continuación, todos los días una hora después.
El siguiente es un código de muestra para un archivo .xml de una fuente de Google Product Search:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<feed xmlns="https://www.w3.org/2005/Atom" xmlns:ns2="https://base.google.com/ns/1.0" xmlns:ns3="https://base.google.com/cns/1.0">
<title>Product Feed</title>
<link href="https://example.com"/>
<updated>2017-12-13T08:45:04.918-08:00</updated>
<author>
<name>Product Feed Author</name>
</author>
<id>https://example.com</id>
<entry>
<title>RipCurl Watch with Titanium Dial</title>
<description>Cutting edge Titanium with Round case</description>
<ns2:id>na3452</ns2:id>
<ns2:link>https://example.com/shop/en-us/na3452_RipCurl</ns2:link>
<ns2:availability>in stock</ns2:availability>
<ns2:condition>NEW</ns2:condition>
<ns2:google_product_category>Watches & Sport</ns2:google_product_category>
<ns2:gtin>075380 01050 5</ns2:gtin>
<ns2:image_link>https://example.com/s7/na3452_Viewer</ns2:image_link>
<ns2:mobile_link>https://m.example.com/s7/na3452_Viewer</ns2:mobile_link>
<ns2:mpn>71050</ns2:mpn>
<ns2:price>425</ns2:price>
<ns2:product_review_average>5.0</ns2:product_review_average>
<ns2:product_review_count>30</ns2:product_review_count>
<ns2:product_type>Shop by Category > Watches </ns2:product_type>
<ns2:brand>RipCurl</ns2:brand>
<ns2:sale_price>375</ns2:sale_price>
<ns2:tax>
<ns2:country>US</ns2:country>
<ns2:region>CA</ns2:region>
<ns2:rate>9.25</ns2:rate>
<ns2:tax_ship>y</ns2:tax_ship>
</ns2:tax>
<ns2:is_bundle>N</ns2:is_bundle>
</entry>
<entry>
<title>RipCurl Watch with Black Dial</title>
<description>Cutting edge matte black with Round case</description>
<ns2:id>na3453</ns2:id>
<ns2:link>https://example.com/shop/en-us/na3453_RipCurl</ns2:link>
<ns2:availability>in stock</ns2:availability>
<ns2:condition>NEW</ns2:condition>
<ns2:google_product_category>Watches & Sport</ns2:google_product_category>
<ns2:gtin>075380 013450 5</ns2:gtin>
<ns2:image_link>https://example.com/s7/na3453_Viewer</ns2:image_link>
<ns2:mobile_link>https://m.example.com/s7/na3453_Viewer</ns2:mobile_link>
<ns2:mpn>71050</ns2:mpn>
<ns2:price>275</ns2:price>
<ns2:product_review_average>4.8</ns2:product_review_average>
<ns2:product_review_count>23</ns2:product_review_count>
<ns2:product_type>Shop by Category > Watches </ns2:product_type>
<ns2:brand>RipCurl</ns2:brand>
<ns2:sale_price>249</ns2:sale_price>
<ns2:tax>
<ns2:country>US</ns2:country>
<ns2:region>CA</ns2:region>
<ns2:rate>9.25</ns2:rate>
<ns2:tax_ship>y</ns2:tax_ship>
</ns2:tax>
<ns2:is_bundle>N</ns2:is_bundle>
</entry>
</feed>
El siguiente es un código de muestra para un archivo .tsv de una fuente de Google Product Search:
id title description link price condition availability image_link tax shipping_weight shipping google_product_category product_type item_group_id color size gender age_group pattern brand gtin mpn
na3454 RipCurl Watch with Titanium Dial Cutting edge titanium with round case https://example.com/shop/en-us/na3454_RipCurl 425 new in stock https://example.com/s7/na3452_Viewer US:CA:9.25:y 1.5 oz US:::0.00 USD Watches & Sport Shop by Category > Watches dz1 Black 44mm male adult Solid RipCurl 075380 01050 5 DZ1437
na3455 RipCurl Watch with Black Dial Cutting edge matte black with round case https://example.com/shop/en-us/na3455_RipCurl 275 new in stock https://example.com/s7/na3452_Viewer US:CA:9.25:y 1.5 oz US:::0.00 USD Watches & Sport Shop by Category > Watches dz1 Black 44mm male adult Solid RipCurl 075340 01060 7 DZ1446
El Analytics La clasificación de productos es la única clasificación disponible para Recommendations. Para obtener más información sobre este archivo de clasificación, consulte Acerca de las clasificaciones en el Componentes de Analytics guía. 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.
Antes de importar datos de entidad en Recommendations usando Analytics clasificaciones de productos, tenga en cuenta que este no es el método preferido.
Tenga en cuenta las siguientes advertencias:
entity.id
. Personalizado Analytics Las clasificaciones se pueden diseñar mediante Servicios de consultoría de Adobe. Póngase en contacto con el Administrador de cuentas si tiene alguna pregunta.Cree una fuente para incluir información sobre sus productos o servicios en Recommendations.
En la interfaz de Target, haga clic en Recomendaciones > Fuentes > Crear fuente.
Elija un nombre descriptivo para la fuente.
Seleccione un Tipo de fuente.
Para obtener más información sobre CSV y Fuente de productos de Google tipos de fuentes, consulte Resumen de fuentes. También puede descargar una guía CSV como modelo para ayudarle a dar formato a la fuente correctamente.
(Condicional) Si ha seleccionado CSV o Fuente de productos de Google, especifique la ubicación donde se puede acceder 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.
Configuración del servidor FTP admitida:
ftp://ftp.yoursite.com:2121
). Si no especifica un puerto, se utilizará el puerto FTP o FTPS predeterminado.URL: Si selecciona URL, especifique la dirección URL.
(Condicional) Si ha seleccionado Clasificaciones de Analytics, elija el grupo de informes en la lista desplegable.
Haga clic en la flecha Siguiente para mostrar las opciones de Programar.
Seleccione una opción de actualización:
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 quiere 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. A continuación, la fuente se actualiza según los parámetros que haya establecido. La información tarda un poco en estar disponible. Primero es necesario sincronizar la fuente, después debe procesarse e indizarse para poder publicarla y ponerla a disposición del público. El estado actual aparece bajo Estado de fuente en la lista Fuentes. Puede cerrar Target antes de que el proceso se haya completado y el proceso seguirá su curso.
Mientras la indización está en curso, se muestran los encabezados de la fuente y los productos antes de indizar los valores individuales. Esto le permite buscar y ver productos para poder crear colecciones, exclusiones, diseños y actividades antes de completar la indexación.
Cuando el estado indica “Correcto”, significa que el archivo se ha encontrado y se ha analizado correctamente. La información no está disponible para su uso en Recommendations hasta que se indexa el archivo. La tarea de indexación puede tardar bastante, en función del tamaño del archivo. Si el proceso falla, significa que no se encontró el archivo. Por ejemplo: ha utilizado una dirección URL incorrecta, la información de FTP era incorrecta o había un error de análisis.
Información sobre los posibles estados de alimentación y sus indicadores.
Estos son los posibles estados de una fuente:
Estado | Descripción |
---|---|
Sincronización | Los detalles de configuración de la fuente se están guardando en Target. |
Error en la sincronización | No se pudieron guardar los detalles de configuración de fuente en Target. Intentarlo de nuevo. |
Sin ejecución de fuente | Ha creado una fuente, pero no se ha programado (la frecuencia se establece en Nunca). |
Programado para fecha y hora | La fuente no se ha ejecutado, pero está programada para ejecutarse en la fecha y la hora establecidas. |
Esperando descarga | Target se está preparando para descargar el archivo de fuente. |
Descargando del archivo de fuente | Target está descargando el archivo de fuente. |
Importando elementos | Target está importando elementos del archivo de fuente. |
Fuente importada correctamente a las horas | Target ha importado el archivo de fuente en el 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, inténtelo de nuevo y actualice la página que contenga recomendaciones. Notas:
|
Error en la indexación | Se ha producido un error en la operación de indexación. Intentarlo de nuevo. |
Servidor no encontrado | Las ubicaciones FTP o URL no son válidas o bien no se pueden encontrar. |
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. Esto significa que el archivo de fuentes debe cargarse 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 infiere que el elemento ya no es relevante y lo elimina del catálogo.
En la columna Estado se muestran los siguientes indicadores de estado de fuente:
Indicador de estado | Descripción |
---|---|
Indicador de estado verde | Cuando una fuente termina de indexarse correctamente, aparece un punto de estado verde que indica que la fuente tiene un estado correcto. |
Indicador de estado amarillo | Cuando una fuente o índice de fuente tiene un retraso de un 25 % de la frecuencia de la fuente, se muestra un punto de estado amarillo. Por ejemplo, el punto amarillo aparece en una fuente configurada para ejecutarse a diario si el índice aún no se ha completado pasadas seis horas de la hora programada. Nota: Una vez que el estado de la fuente es “Esperando a la cola de índice”, los valores recién actualizados ya están disponibles para su publicación y el procesamiento de criterios. |
Indicador de estado blanco | Cuando una fuente no está programada, un punto de estado blanco indica que aún no se ha ejecutado. |
Indicador de estado rojo | Si la fuente no puede cargar datos en el servidor, se muestra un indicador de estado rojo. |
Veamos los siguientes ejemplos:
Ejemplo 1:
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:
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.
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:
Este vídeo contiene la información siguiente: