Registro de palabras clave negativas del grupo de anuncios: masiva

Define una palabra clave negativa asignada a un grupo de anuncios que se puede cargar y descargar en un archivo masivo.

En el esquema masivo, cada una de las palabras clave negativas asociadas a un grupo de anuncios se representa individualmente mediante su propia fila. Por ejemplo, si un grupo de anuncios tiene dos palabras clave negativas, se representan mediante dos registros de palabras clave negativas de grupo de anuncios en el archivo masivo con estado establecido en Activo.

Nota:

La palabra clave negativa del grupo de anuncios se puede agregar y eliminar, pero no se puede actualizar.

Puede descargar todos los registros de palabras clave negativas de grupo de anuncios de la cuenta incluyendo el valor DownloadEntity de AdGroupNegativeKeywords en la solicitud de servicio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Además, la solicitud de descarga debe incluir el ámbito EntityData . Para obtener más información sobre el servicio masivo, incluidos los procedimientos recomendados, consulte Descarga y carga masivas.

En el siguiente ejemplo de CSV masivo se agregaría una nueva palabra clave negativa del grupo de anuncios si se proporciona un valor de Id. primario válido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Keyword,Match Type,Name
Format Version,,,,,,,,,,6.0
Ad Group Negative Keyword,Active,,-1111,,,ClientIdGoesHere,,shoes,Exact,

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkAdGroupNegativeKeyword , en lugar de llamar a las operaciones de servicio directamente y escribir código personalizado para analizar cada campo del archivo masivo.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupNegativeKeyword
var bulkAdGroupNegativeKeyword = new BulkAdGroupNegativeKeyword
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // NegativeKeyword object of the Campaign Management service.
    NegativeKeyword = new NegativeKeyword
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Match Type' column header in the Bulk file
        MatchType = MatchType.Exact,
        // 'Text' column header in the Bulk file
        Text = "shoes"
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkAdGroupNegativeKeyword);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Para un registro de palabra clave negativa de grupo de anuncios , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.

• Grupo de anuncios
• Campaña
• Id. de cliente
• Id
• Palabra clave
• Tipo de coincidencia
• Tiempo de modificación
• Parent Id
• Estado

Grupo de anuncios

Nombre del grupo de anuncios que contiene la palabra clave negative.

Añadir: Solo lectura y Obligatorio
Actualizar: No aplicable. Se puede agregar y eliminar una palabra clave negativa, pero no se puede actualizar.
Eliminar: Solo lectura y Obligatorio

Nota:

Para agregar y eliminar, debe especificar el campo Id. primario o Grupo de anuncios .

Campaña

Nombre de la campaña que contiene el grupo de anuncios y la palabra clave negativa.

Añadir: Solo lectura
Actualizar: No aplicable. Se puede agregar y eliminar una palabra clave negativa, pero no se puede actualizar.
Eliminar: Solo lectura

Identificador de cliente

Se usa para asociar registros en el archivo de carga masiva con registros en el archivo de resultados. El servidor no usa ni almacena el valor de este campo; simplemente se copia del registro cargado en el registro de resultados correspondiente. Puede ser cualquier cadena válida de hasta 100 en longitud.

Añadir: Opcional
Actualizar: No aplicable. Se puede agregar y eliminar una palabra clave negativa, pero no se puede actualizar.
Eliminar: Solo lectura

Id

Identificador generado por el sistema de la palabra clave negativa.

Añadir: Solo lectura
Actualizar: No aplicable. Se puede agregar y eliminar una palabra clave negativa, pero no se puede actualizar.
Eliminar: Solo lectura y Obligatorio

Palabra clave

Texto de palabra clave negativa.

El texto puede contener un máximo de 100 caracteres.

Añadir: Obligatorio
Actualizar: No aplicable. Se puede agregar y eliminar una palabra clave negativa, pero no se puede actualizar.
Eliminar: Solo lectura

Tipo de coincidencia

Tipo de coincidencia para comparar la palabra clave negativa y el término de búsqueda del usuario.

Los valores de tipo de coincidencia admitidos para una palabra clave negativa son Phrase y Exact.

Añadir: Obligatorio
Actualizar: No aplicable. Se puede agregar y eliminar una palabra clave negativa, pero no se puede actualizar.
Eliminar: Solo lectura

Tiempo de modificación

Fecha y hora en que se actualizó por última vez la entidad. El valor se encuentra en la hora UTC (hora universal coordinada).

Nota:

El valor de fecha y hora refleja la fecha y hora en el servidor, no en el cliente. Para obtener información sobre el formato de la fecha y hora, vea la entrada dateTime en Tipos de datos XML primitivos.

Añadir: Solo lectura
Actualizar: No aplicable. Se puede agregar y eliminar una palabra clave negativa, pero no se puede actualizar.
Eliminar: Solo lectura

Parent Id

Identificador generado por el sistema del grupo de anuncios que contiene la palabra clave negativa.

Este campo masivo se asigna al campo Id del registro del grupo de anuncios .

Añadir: Solo lectura y Obligatorio. Debe especificar un identificador de grupo de anuncios existente o especificar un identificador negativo que sea igual al campo Id del registro del grupo de anuncios primario. Esto se recomienda si va a agregar nuevas palabras clave negativas a un nuevo grupo de anuncios en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Actualizar: No aplicable. Se puede agregar y eliminar una palabra clave negativa, pero no se puede actualizar.
Eliminar: Solo lectura

Nota:

Para agregar y eliminar, debe especificar el campo Id. primario o Grupo de anuncios .

Estado

Representa el estado de asociación entre el grupo de anuncios y la palabra clave negativa.

Si la palabra clave negativa está asociada al grupo de anuncios, el valor de este campo es Active.

Los valores posibles son Active o Deleted.

Añadir: Opcional. El valor predeterminado es Active.
Actualizar: No aplicable. Se puede agregar y eliminar una palabra clave negativa, pero no se puede actualizar.
Eliminar: Obligatorio. El estado debe establecerse en Eliminado. Para eliminar una palabra clave negativa específica, debe cargar el estado, el identificador y el identificador primario. Para eliminar todas las palabras clave negativas del grupo de anuncios, solo es necesario cargar el estado y el identificador primario en un único registro. A continuación, opcionalmente puede agregar nuevos registros de palabras clave negativas para reemplazar el conjunto eliminado.