Feed del perfil

Semántica del feed de perfil

Como se mencionó en las definiciones de categorías de feeds, las semánticas de un feed de instantáneas son las siguientes acciones:

  • Para cualquier proveedor de un feed de instantáneas, si el proveedor no existe en la base de datos del proveedor de LSA, se creará un perfil nuevo.
  • Para cualquier proveedor de un feed de instantáneas, si el proveedor existe actualmente en la base de datos del proveedor de LSA, se actualizará la información del perfil.
  • Si un proveedor no está en un feed de instantáneas, si el proveedor existe actualmente en la base de datos del proveedor de LSA, se borrará el perfil.

La semántica de un feed incremental genera las siguientes acciones:

  • Para cualquier proveedor de un feed incremental, si el proveedor no existe en la base de datos del proveedor de LSA, es una no-op.
  • Para cualquier proveedor de un feed incremental, si el proveedor existe actualmente en la base de datos del proveedor de LSA, se actualizará la información del perfil.
  • Para cualquier proveedor que no esté en un feed incremental, es una no-op.

Manejo de errores en los perfiles

Si un elemento del feed de perfil individual no es válido, no lo actualizaremos en la base de datos de LSA y, mientras tanto, lo pausaremos para evitar que se publiquen datos inactivos.

Si un feed de perfil no es válido (p.ej., no cumple con el esquema), dejaremos de procesar todo el feed. Compartiremos un informe que incluye un resumen del resultado del procesamiento de los feeds (p.ej., errores, estado de procesamiento de cada artículo, etcétera).

Protocolo y restricciones

  1. Constraints. Cada empresa (elemento del feed) de un feed debe tener un ID único.

  2. Límites. Las LSA imponen límites de tamaño en los campos de datos individuales, que se especifican en la siguiente tabla.

  3. Restricciones para el nombre de la empresa

    1. Longitud máxima: 100 caracteres, incluidos los espacios
    2. Requiere al menos un número o una letra
    3. Las codificaciones de letras que se admiten son UTF-8, UTF-16 y UTF-32 (UTF-8 recomendado)
    4. Se permiten caracteres especiales:
      1. Guion -, signo de unión &, punto ., coma ,, apóstrofo ', paréntesis ( )
    5. Inhabilitar TODO EN MAYÚSCULAS
    6. Inhabilitar palabras ofensivas
    7. Inhabilitar emoji

Campos de perfil

A continuación, se describen los campos establecidos para un proveedor determinado. Los campos que son opcionales están marcados como tales.

Nombre del campo Descripción Tipo de campo Ejemplo Obligatorio Limitaciones
ID de serviceProvider Identificador único de una ficha de la empresa (un proveedor de servicios) número 12345 Este es un ID único para cada proveedor de servicios. Esto se convertirá en un número entero 64. Mantener el mismo ID cuando se actualiza un proveedor
serviceProviderName. Nombre de la empresa string &King David David Doors, Inc." El límite es de 100 caracteres. Sujeto a la política de restricciones de nombres.
URL del sitio web del proveedor de servicios URL del sitio web de la empresa string https://abc.xyz No Comience con http o https.
address Dirección de la empresa objeto "addressLine1":"847 Oliver Avenue" "city":"Valley Stream", "region":"NY"postalCode""" addressLine1 debe completarse con la dirección postal cuando esté disponible. No se puede cambiar el código de país después de la configuración inicial de la empresa.
URLdelperfildelagregador URL del perfil que vincula a la página del perfil del sitio del socio. string http://aggregator.com/joes-plumbing/ No Comience con http o https.
añoBusinessStarted Año de fundación de la empresa integer 2015 No Formato AAAA
horario de atención Horario en el que la empresa está abierta Arreglo de objetos Consulta el "Ejemplo de feed de perfil". Consulta la definición del objeto para ver las restricciones
Número de teléfono de la empresa El número de teléfono de una empresa individual en formato e164 debe estar vacío o ser propiedad de la empresa, en lugar de un número de centro de llamadas o un número de seguimiento asignado por el socio. string "+16501112222" El formato del número de teléfono debe ser E.164
contact información de contacto utilizada para varios métodos de contacto Arreglo de objetos &{ "type": "PHONE", "address": "+16501112222" }" El tipo puede ser "PHONE" o "MESSAGE". Para el tipo "PHONE", la dirección debe contener un número de teléfono con formato E.164. Para la dirección "MESSAGE", no se debe completar. El elemento con el tipo PHONE es obligatorio, pero el elemento con el tipo MESSAGE es opcional.
Idiomas de orientación Es una lista de los idiomas en los que se publicará el anuncio. Los idiomas se definen en el código de idioma ISO 639-1 (en minúsculas, de dos letras). Arreglo de string "en", "fr" Si no se proporciona, el valor predeterminado es "en".
con cobertura geográfica Ubicación geográfica proporcionada por la empresa. objeto No
geoCovered ->criteriaIds Una lista de ID de criterios que corresponden a las áreas (región, condado, ciudad, código postal) publicadas. Arreglo de número entero No El ID de criterio geográfico debe ser válido en la lista de orientaciones geográficas de Google Ads.
categorías Una lista de las categorías que ofrece la empresa. Arreglo de objetos Consulta el "Ejemplo de feed de perfil". Deben ser seleccionados de la lista de categorías que proporciona Google. Debe contener exactamente una categoría.
Categorías >tareas Una lista de tareas entregadas en una categoría determinada. Arreglo de objetos Para ser seleccionado de la lista de tareas proporcionadas por Google
tareas -gt;geoCovered Ubicación geográfica de la tarea objeto
Tasks ->geoCovered>postalCodeCriterioIds' Una lista de ID de criterios que corresponden a los códigos postales publicados. Arreglo de string ID de criterio geográfico de una lista de códigos postales publicados, el ID de criterio debe ser válido en la lista de orientaciones geográficas de Google Ads con el tipo de código postal de orientación
Tasks ->geoCovered>cityCriterioIds Una lista de los ID de criterios que corresponden a las ciudades en que se publicaron. Arreglo de string ID de criterio geográfico de una lista de ciudades en las que se publica el anuncio, el ID del criterio debe ser válido en la lista de orientaciones geográficas de Google Ads con el tipo de ciudad objetivo
activo Marca que indica si esta empresa debe permanecer activa o detenida boolean verdadero/falso
presupuesto mensual Presupuesto mensual de este proveedor enmonthlyBudgetCurrency integer 100 Debe ser mayor o igual que la oferta máxima o el precio de reserva del cliente potencial.
Moneda del presupuesto mensual Moneda del presupuesto y las ofertas mensuales Consulta Códigos de moneda. string "USD" No se puede cambiar después de la configuración inicial de la empresa.
textos destacados Un arreglo de textos destacados para cada categoría Arreglo de objetos Para ser seleccionado de la lista de textos destacados proporcionada por Google
estrategiadeofertas Es la estrategia de oferta de esta empresa para la subasta. Afecta el precio por cliente potencial. string “MANUAL_CPA” / “MAX_CONVERSION” No Para ser seleccionado de la lista proporcionada por Google . Si no la estableces, la estrategia predeterminada será MANUAL_CPA.
configuracióndeofertas Una lista de configuraciones de ofertas por categoría. Solo se aplica a la estrategia de oferta MANUAL_CPA. Arreglo de objetos Ver un ejemplo de feed de perfil N Si no se proporciona ninguna configuración y BidStrategy es MANUAL_CPA, establezca la oferta mínima para cada categoría en la configuración predeterminada.
BidConfiguration>categoryId ID de categoría en la taxonomía de LSA. Estas categorías deben coincidir con las categorías mencionadas anteriormente. Es obligatorio si se declara la configuración de ofertas. string No Se seleccionará de la lista proporcionada por Google.
ofertaConfiguration>manualCostPerLead Configuración manual del costo por cliente potencial. Se debe proporcionar si la estrategia de oferta es “MANUAL_CPA”. objeto No
oferta de costo manual por cliente potencial Oferta de costo por cliente potencial manual El precio de cliente potencial nunca superará el valor de esta oferta. Es obligatorio si se declara manualCostPerLead. número No Debe ser mayor o igual que el precio de reserva.