Feed del perfil

Semántica del feed de perfil

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

  • En el caso de cualquier proveedor en un feed de instantáneas, si el proveedor no existe actualmente en la base de datos de proveedores de la LSA, se creará un perfil nuevo.
  • En el caso de cualquier proveedor en un feed de instantáneas, si el proveedor existe actualmente en la base de datos de proveedores de LSA, se actualizará la información del perfil.
  • En el caso de los proveedores que no se encuentren en un feed de instantáneas, si el proveedor existe actualmente en la base de datos de proveedores de LSA, se borrará el perfil.

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

  • Para cualquier proveedor en un feed incremental, si el proveedor no existe actualmente en la base de datos de proveedores de LSA, no se realiza ninguna operación.
  • En el caso de cualquier proveedor en un feed incremental, si el proveedor existe actualmente en la base de datos de proveedores de LSA, se actualizará la información del perfil.
  • Para cualquier proveedor que no esté en un feed incremental, no se realiza ninguna operación.

Control de errores en los perfiles

Si un elemento del feed de perfil individual no es válido, no actualizaremos ese elemento en la base de datos de LSA y, mientras tanto, pausaremos el elemento para evitar publicar datos obsoletos.

Si un feed de perfil no es válido (p.ej., no cumple con el esquema), detendremos el procesamiento de 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 elemento, etcétera).

Protocolo y restricciones

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

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

  3. Restricciones sobre el nombre de la empresa

    1. Longitud máxima: 100 caracteres, incluidos los espacios
    2. Se requiere al menos un número o una letra
    3. Las codificaciones de letras admitidas son UTF-8, UTF-16 y UTF-32 (se recomienda UTF-8).
    4. Caracteres especiales permitidos:
      1. Guion -, et &, punto ., coma ,, apóstrofe ', paréntesis ( )
    5. No permitir el uso de MAYÚSCULAS
    6. No permitir palabras ofensivas
    7. No permitir emojis

Campos del perfil

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

Nombre del campo Descripción Tipo de campo Ejemplo Obligatorio Limitaciones
serviceProviderId Identificador único de una ficha de la empresa (un proveedor de servicios) número 12345 Sí Es un ID único para cada proveedor de servicios. Se convertirá en un valor int64. Mantén el mismo ID cuando actualices un proveedor
serviceProviderName Nombre de la empresa string "King David Garage Doors, Inc." Sí Máximo de 100 caracteres. Sujeto a la política de restricciones de nombres.
serviceProviderWebsiteUrl URL del sitio web de la empresa string https://abc.xyz No Comienza con http o https
dirección Dirección de la empresa objeto "addressLine1":"847 Oliver Avenue", "city":"Valley Stream", "region":"NY", "postalCode":"11581", "country": "US" Sí addressLine1 debe completarse con la dirección cuando esté disponible. El código de país no se puede cambiar después de la configuración inicial de la empresa.
aggregatorProfileUrl Es la URL del perfil que vincula a la página de perfil en el sitio del socio. string http://aggregator.com/joes-plumbing/ No Comienza con http o https
yearBusinessStarted Año de fundación de la empresa integer 2015 No Formato AAAA
businessHours Horario de atención de la empresa Array de objetos Consulta “Ejemplo de feed de perfil”. Sí Consulta la definición del objeto para conocer las restricciones
businessPhoneNumber Número de teléfono de la empresa individual en formato E.164. 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" Sí El número de teléfono debe estar en formato E.164.
contacto Información de contacto que se usa para varios métodos de contacto Es un array de objetos. "{ “type”: “PHONE”, “address”: “+16501112222” }" Sí El tipo puede ser “PHONE” o “MESSAGE”. En el caso del tipo “PHONE”, la dirección debe contener un número de teléfono con formato E.164. La dirección “MESSAGE” no debe completarse. Se requiere un elemento con el tipo PHONE, pero un elemento con el tipo MESSAGE es opcional.
targetingLanguages 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, 2 letras). Es un array de cadenas. "en", "fr" Sí Si no se proporciona, el valor predeterminado es “en”.
geoCovered Es la ubicación geográfica en la que la empresa publica el contenido. objeto No
geoCovered ->criteriaIds Es una lista de los IDs de criterios que corresponden a las áreas (región, condado, ciudad, código postal) en las que se presta el servicio. Array de números enteros No El ID de criterio geográfico debe ser válido en la lista de objetivos geográficos de Google Ads.
categorías Es una lista de las categorías que ofrece la empresa. Es un array de objetos. Consulta “Ejemplo de feed de perfil”. Sí Se debe seleccionar de la lista de categorías proporcionada por Google. Debe contener exactamente una categoría.
categories->tasks Es una lista de tareas que se ofrecen en una categoría determinada. Es un array de objetos. Sí Se debe seleccionar de la lista de tareas proporcionada por Google.
tasks ->geoCovered Ubicación geográfica en la que se publicó la tarea objeto Sí
tasks ->geoCovered->postalCodeCriteriaIds Es una lista de IDs de criterios que corresponden a los códigos postales a los que se presta servicio. Es un array de cadenas. Es el ID del criterio geográfico de una lista de códigos postales publicados. El ID del criterio debe ser válido en la lista de objetivos geográficos de Google Ads con el tipo de objetivo PostalCode.
tasks ->geoCovered->cityCriteriaIds Es una lista de los IDs de los criterios que corresponden a las ciudades en las que se presta el servicio. Es un array de cadenas. Es el ID del 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 objetivos geográficos de Google Ads con el tipo de objetivo Ciudad.
activo Es una marca que indica si esta empresa debe estar activa o detenida. booleano verdadero/falso Sí
monthlyBudget Es el presupuesto mensual de este proveedor en monthlyBudgetCurrency. integer 100 Sí Debe ser mayor o igual que el valor máximo de la oferta o el precio de reserva del cliente potencial.
monthlyBudgetCurrency Es la moneda del presupuesto mensual y las ofertas. Consulta Códigos de moneda. string "USD" Sí No se puede cambiar después de la configuración inicial de la empresa.
textos destacados Es un array de textos destacados para cada categoría. Es un array de objetos. Sí Se debe seleccionar de la lista de textos destacados proporcionada por Google.
biddingStrategy Es la estrategia de ofertas para esta empresa en la subasta. Afecta el precio por cliente potencial. string "MANUAL_CPA" o "MAX_CONVERSION" No Se debe seleccionar de la lista proporcionada por Google . Si no se configura, esta estrategia se establecerá de forma predeterminada en MANUAL_CPA.
biddingConfiguration Es una lista de configuraciones de ofertas por categoría. Solo se aplica a la estrategia de ofertas MANUAL_CPA. Es un array de objetos. Consulta el ejemplo de feed de perfil N Si no se proporciona ninguna configuración y biddingStrategy es MANUAL_CPA, establece cada categoría en la oferta mínima.
biddingConfiguration->categoryId Es el ID de categoría en la taxonomía de LSA. Estas categorías deben coincidir con las que se mencionaron anteriormente. Se requiere si se declara la configuración de ofertas. string No Se debe seleccionar de la lista proporcionada por Google.
biddingConfiguration->manualCostPerLead Configuración manual del costo por cliente potencial Se debe proporcionar si biddingStrategy es “MANUAL_CPA”. objeto No
manualCostPerLead->bid Es el costo por cliente potencial de la oferta manual. El precio principal nunca superará el valor de esta oferta. Se requiere si se declara manualCostPerLead. número No Debe ser mayor o igual que el precio de reserva.