Esquema de archivo masivo
El esquema masivo define el contenido del archivo para su descarga o carga con bulk API. Para la descarga y carga, el servicio bulk admite los tipos de archivo y los esquemas correspondientes en el conjunto de valores DownloadEntity .
Para obtener más información sobre el uso del servicio bulk para administrar las campañas, consulte Descarga y carga masivas. Para obtener más información sobre cómo comprender el contenido del archivo de datos, consulte las secciones siguientes.
- Esquema de archivo
- Formato de versiones
- Tipos de registro
- Jerarquía de tipos
- Claves de referencia
- Identificadores de cliente
- Errores
Esquema de archivo
Puede elegir descargar una pestaña o un conjunto delimitado por comas de registros (filas) y campos (columnas). El primer encabezado de columna se denomina Type. El resto de los nombres de columna se asignan a propiedades dentro o asociadas al tipo de registro correspondiente.
Importante
Los nuevos tipos de registro (filas) y campos (columnas) se pueden agregar en cualquier momento y no debe depender del orden de registros o campos en el archivo de resultados de carga masiva o descarga masiva. Del mismo modo, a menos que se indique lo contrario en la documentación de referencia, no debe depender de un conjunto fijo de valores devueltos en cada campo.
De forma similar durante la carga, puede enviar los campos en cualquier orden. El orden del registro de carga es importante al crear nuevas entidades, como se describe a continuación en Jerarquía de tipos.
Formato de versiones
La versión de formato masivo es independiente de la versión de Bing Ads API. La versión de formato permite una ruta de actualización flexible para adoptar las características admitidas más recientes sin interrumpir la aplicación. Como procedimiento recomendado, siempre debe actualizar a la versión de formato más reciente. Actualmente, la única versión de formato compatible es la 6.0.
Para especificar la versión del formato de archivo mediante la descarga masiva, establezca FormatVersion en 6.0 en la solicitud DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds .
Para especificar la versión mediante la carga masiva, establezca el campo Nombre del registro Formato de versión en 6.0.
Tipos de registro
En la tabla siguiente se detallan los registros disponibles para la carga y descarga con formato versión 6.0.
Importante
Los nuevos tipos de registro (filas) y campos (columnas) se pueden agregar en cualquier momento y no debe depender del orden de registros o campos en el archivo de resultados de carga masiva o descarga masiva.
Jerarquía de tipos
El archivo de descarga siempre incluirá un registro para los tipos de registro Versión de formato y Cuenta . Para la carga, se requiere la versión de formato y debe preceder al resto de tipos de registro en el archivo masivo.
Si se crea una entidad primaria en el mismo archivo, debe preceder a los registros secundarios dependientes en el archivo masivo. Por ejemplo, como se muestra en el diagrama siguiente, al asociar una extensión de anuncio de vínculo de sitio a una campaña, el registro Extensión de anuncio de vínculo de sitio de campaña debe incluirse en el archivo después de los registros Campaña y Extensión de anuncio de vínculo de sitio . Los campos Id e Parent Id del registro Extensión de anuncio de vínculo de sitio de campaña deben establecerse en el identificador de los registros Extensión de anuncio de vínculo de sitio y Extensión de campaña , respectivamente. Si los registros Extensión de anuncio de vínculo de sitio y Campaña también son nuevos y aún no tienen asignados identificadores de Microsoft Advertising, debe usar claves de referencia.
No es necesario incluir el registro de una entidad primaria a la que ya se ha asignado un identificador válido de Microsoft Advertising.
Se admite el éxito parcial al agregar, actualizar y eliminar registros de archivos masivos. Por ejemplo, si intenta agregar tres campañas y solo se especifican dos correctamente en el archivo, se agregarán dos. El archivo de resultados incluirá los detalles de los registros de campaña correctos, un registro de campaña intentado y un registro de error de campaña .
Si aún no se conoce el nuevo identificador de campaña, por ejemplo, al agregar una campaña, un grupo de anuncios, un anuncio de texto y una palabra clave en el mismo archivo, especifique el nombre de la campaña como clave de referencia lógica para los registros secundarios. No es necesario especificar un elemento primario existente en la carga.
Se admiten actualizaciones parciales para registros masivos, incluidas palabras clave negativas, sitios negativos y criterios de destino. Por ejemplo, puede actualizar la oferta de un criterio de ubicación única y no es necesario descargar y cargar todo el conjunto de criterios de destino para la campaña o el grupo de anuncios.
Al actualizar un registro, se requiere el campo Id para el registro actualizado. También es necesario el identificador primario o las claves de referencia del registro primario.
Al actualizar el nombre de la campaña o del grupo de anuncios, es opcional especificar el nuevo nombre para los registros secundarios si se proporciona el identificador primario correcto.
Si va a reemplazar un conjunto de registros por otro conjunto, debe especificar los registros eliminados antes del nuevo conjunto. Por ejemplo, para reemplazar todas las palabras clave negativas de campaña existentes para una campaña determinada, incluya primero una palabra clave negativa de campaña con el estado establecido en Eliminado y el identificador principal establecido en el identificador de campaña. Si no especifica ningún identificador , es decir, no intente eliminar una palabra clave camapaign negativa específica, eliminará de forma eficaz todas las palabras clave negativas de campaña de esa campaña. Debajo del registro "eliminar todo", puede incluir uno o varios registros de palabras clave negativas de campaña nuevos con todas las propiedades necesarias para la operación de adición de carga.
Si va a reemplazar un registro existente por un nuevo registro que tenga las mismas propiedades únicas, debe especificar el registro eliminado antes del nuevo registro. Por ejemplo, para reemplazar un grupo de anuncios dinámico Búsqueda destino de anuncio existente para un grupo de anuncios determinado, incluya primero un objeto Ad Group Dynamic Búsqueda Ad Target con Estado establecido en Eliminado, Id establecido en el id. de destino dinámico (criterio de página web) existente e Id. primario establecido en el identificador del grupo de anuncios. Debajo del registro eliminado, puede incluir un nuevo registro dinámico de grupo de anuncios Búsqueda de destino de anuncios (presumiblemente con nuevas condiciones de página web).
Nota:
En la mayoría de los casos, puede actualizar el registro existente en lugar de enviar registros de eliminación y adición independientes, por ejemplo, puede actualizar el campo Ajuste de puja de un criterio de género de campaña existente.
Al eliminar un registro, se requiere el campo Id . También se requiere una referencia a la entidad primaria, independientemente de si el valor es un identificador del sistema asignado por Microsoft Advertising o una clave de referencia para el registro primario. Por ejemplo, al eliminar un grupo de anuncios, el campo Id. primario del registro grupo de anuncios debe coincidir con el campo Id del registro Campaña o el campo Campaña del registro grupo de anuncios debe coincidir con el campo Campaña del registro Campaña . Si se proporcionan ambos, se omite el campo Id. primario del registro de grupo de anuncios (claves de referencia).
Con algunas excepciones, el archivo de resultados solo incluirá las columnas que cargó. Por ejemplo, si carga una nueva palabra clave negativa del grupo de anuncios sin el encabezado de columna Id , el archivo de resultados no incluirá el identificador asignado para la nueva palabra clave negativa. El archivo masivo debe contener la columna Id ; sin embargo, debe dejar el identificador vacío para cada nueva palabra clave negativa del grupo de anuncios. Las excepciones a esta regla son campañas, grupos de anuncios, anuncios y palabras clave, en cuyo caso el archivo de resultados contendrá todas las columnas independientemente de las columnas cargadas.
Actualización con delete_value
Para quitar una configuración existente, no debe escribir una cadena vacía ("") en el archivo masivo porque el servicio bulk omite dichas cadenas. Use la cadena reservada "delete_value" para eliminar o restablecer el valor de un campo opcional.
- Si usa la cadena reservada "delete_value" en un campo opcional, se eliminará la configuración anterior. Por ejemplo, si estableces el campo Parámetro personalizado del registro del grupo de anuncios en "delete_value", todos los parámetros personalizados anteriores se eliminarán del grupo de anuncios. Del mismo modo, si estableces el campo Plantilla de seguimiento del registro de grupo de anuncios en "delete_value", la plantilla de seguimiento anterior se eliminará del grupo de anuncios.
- Los SDK de Bing Ads para .NET, Java y Python escriben automáticamente "delete_value" cuando corresponda. Para obtener más información, consulte Service Manager masiva: actualización con delete_value.
Si usa "delete_value" en los campos necesarios, tenga en cuenta lo siguiente.
- Si usa la cadena reservada "delete_value" en lugar de un valor primitivo necesario, se omitirá. Aunque el campo no se actualizó, la cadena "delete_value" se pasará a través del archivo de resultados de carga. Por ejemplo, si estableces el campo Grupo de anuncios (nombre del grupo de anuncios) del registro del grupo de anuncios en "delete_value", el nombre del grupo de anuncios no se actualizaría.
- Si usa la cadena reservada "delete_value" en lugar de un conjunto de valores necesario, el campo se actualizará al valor predeterminado y el archivo de resultados reflejará ese cambio. Por ejemplo, si establece el campo Distribución de red del registro del grupo de anuncios en "delete_value", la distribución de red del grupo de anuncios se establecería en OwnedAndOperatedAndSyndicatedSearch y el archivo de resultados de carga reflejaría lo mismo.
Claves de referencia
Al hacer referencia a un registro anterior en el archivo masivo que aún no tiene asignado un identificador de Microsoft Advertising, puede usar una clave de referencia lógica o una clave de referencia negativa en función del tipo de registro.
Nota:
Si la entidad primaria se crea en el mismo archivo, debe preceder a los registros secundarios dependientes en el archivo masivo.
Clave de referencia negativa
Al hacer referencia a un registro anterior en el archivo masivo que aún no tiene asignado un identificador de Microsoft Advertising, puede establecer el campo Id . de la extensión en un número negativo de su elección. Este identificador personalizado se conoce como clave de referencia negativa. A continuación, puede usar la clave de referencia negativa dentro del campo Id de un registro dependiente.
En el primer ejemplo se muestra cómo crear un grupo de anuncios para una nueva campaña. Establezca el campo Id. primario del registro grupo de anuncios en la clave de referencia negativa de la campaña (-111). Si va a agregar registros adicionales en el mismo archivo que deben tener el grupo de anuncios como su elemento primario (por ejemplo, palabra clave o extensión de anuncio de llamada de grupo de anuncios), también debe establecer el campo Id en el grupo de anuncios en un valor negativo, por ejemplo , -1111 al que se puede hacer referencia desde los registros secundarios.
| Tipo | Id | Parent Id |
|---|---|---|
| Campaña | -111 | |
| Grupo de anuncios | -1111 | -111 |
En el segundo ejemplo se muestra cómo crear una extensión de anuncio de llamada de campaña para una nueva campaña y una nueva extensión de anuncio de llamada. En el ejemplo también se muestra cómo crear una extensión de anuncio de llamada de grupo de anuncios para un nuevo grupo de anuncios y otra nueva extensión de anuncio de llamada.
- Establezca el campo Id. primario del registro Extensión de anuncio de llamada de campaña en la clave de referencia negativa de la campaña (-111) y establezca el campo Id en el registro Extensión de anuncio de llamada de campaña en la clave de referencia negativa de la extensión de anuncio de llamada (-11).
- Establezca el campo Id. primario en el registro Extensión de anuncio de llamada de grupo de anuncios en la clave de referencia negativa del grupo de anuncios (-1111) y establezca el campo Id en el registro Extensión de anuncio de llamada de grupo de anuncios en la clave de referencia negativa de la extensión de anuncio de llamada (-12).
| Tipo | Id | Parent Id |
|---|---|---|
| Extensión de anuncio de llamada | -11 | |
| Extensión de anuncio de llamada | -12 | |
| Campaña | -111 | |
| Grupo de anuncios | -1111 | -111 |
| Extensión de anuncio de llamada de campaña | -11 | -111 |
| Extensión de anuncio de llamada de grupo de anuncios | -12 | -1111 |
Clave de referencia lógica
Al hacer referencia a un nuevo registro de campaña o grupo de anuncios , puedes usar el nombre de la campaña y del grupo de anuncios en lugar de establecer el campo Id. primario en una clave de referencia negativa dentro del registro secundario. Por ejemplo, para agregar un nuevo grupo de anuncios a una nueva campaña y agregar una nueva palabra clave al nuevo grupo de anuncios, establezca los campos Campaña y Grupo de anuncios en los registros secundarios, como se muestra en el ejemplo siguiente.
| Tipo | Campaña | Grupo de anuncios |
|---|---|---|
| Campaña | Zapatos de mujer | |
| Grupo de anuncios | Zapatos de mujer | Venta de zapatos rojos para mujeres |
Identificadores de cliente
Los identificadores de cliente se pueden usar para asociar registros de entrada en el archivo de carga masiva con registros de salida en el archivo de resultados. Por ejemplo, al agregar registros nuevos, puede establecer el campo Id. de cliente en un valor de cadena de su elección. El sistema de Microsoft Advertising no realiza modificaciones en los identificadores de cliente y los pasa al archivo de resultados para el registro correspondiente.
Errores
El archivo de descarga masiva o el archivo de resultados de carga masiva pueden contener registros en los que el campo Tipo correspondiente incluye el sufijo Error. Por ejemplo, un tipo de registro Error de anuncio de producto representa un error de anuncio de producto. Las columnas Error y Número de error contendrá detalles sobre el error.
Nota:
El archivo de resultados de carga puede incluir varios registros de error correspondientes a un registro cargado.
Los errores relacionados con las nuevas características, como las direcciones URL finales, incluirán detalles adicionales sobre dónde se produjo el error en la columna Ruta de acceso de campo . Cada nombre de ruta de acceso de campo corresponde a un elemento de uno de los objetos de datos del Servicio de administración de campañas. Por ejemplo, si el campo Plantilla de seguimiento de un registro de campaña no comienza por http:// o https://, {lpurl}o {unescapedlpurl}, el valor de este valor ruta de campo es TrackingTemplate. TrackingUrlTemplate es un elemento del objeto de datos Campaign disponible con el Servicio de administración de campañas.
| Tipo | Plantilla de seguimiento | Error | Número de error | Ruta de acceso de campo |
|---|---|---|---|---|
| Error de campaña | tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} | InvalidUrlScheme | 4600 | TrackingTemplate |
| Error de campaña | tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} | CampaignServiceInvalidUrl | 2611 | TrackingTemplate |
Importante
El valor ruta de acceso de campo está sujeto a cambios, por lo que no debe depender del formato de cadena actual. La ruta de acceso de campo no se admite para todos los errores. Se admite para los campos Url final móvil, Url final, Plantilla de seguimiento y Parámetro personalizado de los registros campaña, grupo de anuncios, anuncio de texto expandido, anuncio de producto, partición de producto del grupo de anuncios, palabra clave y extensión de anuncio de vínculo de sitio correspondientes. También se admite para errores relacionados con todos los campos de los registros Extensión de anuncio de llamada y Revisar extensión de anuncio .
Si el problema está relacionado con un error editorial, las columnas Ubicación editorial, Término editorial, Código de motivo editorial y Países editores también pueden contener más información sobre el error.