Compartir a través de


Registro de extensión de anuncio de imagen de grupo de anuncios: masiva

Define un registro de asociación entre un grupo de anuncios y una extensión de anuncio de imagen que se puede cargar y descargar en un archivo masivo. Para cargar o descargar el grupo de anuncios o la extensión de anuncio de imagen, use el registro Grupo de anuncios o Extensión de anuncio de imagen .

Puede descargar todos los registros de extensión de anuncio de imagen de grupo de anuncios de la cuenta incluyendo el valor DownloadEntity de AdGroupImageAdExtensions 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 asociaría una extensión de anuncio de imagen a un grupo de anuncios si se proporcionan valores válidos id . e Id. primario .

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name
Format Version,,,,,,,,6.0
Ad Group Image Ad Extension,Active,-11,-1111,,,ClientIdGoesHere,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupImageAdExtension
var bulkAdGroupImageAdExtension = new BulkAdGroupImageAdExtension
{
    // Map properties in the Bulk file to the 
    // AdExtensionIdToEntityIdAssociation object of the Campaign Management service.
    AdExtensionIdToEntityIdAssociation = new AdExtensionIdToEntityIdAssociation
    {
        // 'Id' column header in the Bulk file
        AdExtensionId = imageAdExtensionIdKey,
        // 'Parent Id' column header in the Bulk file
        EntityId = adGroupIdKey,
    },
                
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active,
};

uploadEntities.Add(bulkAdGroupImageAdExtension);

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 extensión de anuncio de imagen de grupo de anuncios , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.

Grupo de anuncios

Nombre del grupo de anuncios donde se asocia o quita esta extensión de anuncio.

Añadir: Solo lectura y Obligatorio
Eliminar: Solo lectura y Obligatorio

Nota:

Para agregar y eliminar, debe especificar el Identificador primario o los campos Grupo de anuncios y Campaña .

Campaña

Nombre de la campaña que contiene el grupo de anuncios donde se asocia o quita esta extensión de anuncio.

Añadir: Solo lectura
Eliminar: Solo lectura

Nota:

Para agregar y eliminar, debe especificar el Identificador primario o los campos Grupo de anuncios y Campaña .

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
Eliminar: Solo lectura

Ubicación editorial

Componente o propiedad de la extensión de anuncio que produjo un error en la revisión editorial.

Añadir: Solo lectura
Eliminar: Solo lectura

Código de motivo editorial

Código que identifica el motivo del error. Para obtener una lista de posibles códigos de motivo, consulte Códigos de motivo editoriales.

Añadir: Solo lectura
Eliminar: Solo lectura

Estado editorial

Estado editorial de la extensión del anuncio.

Los valores posibles se describen en la tabla siguiente.

Valor Descripción
Activo La extensión del anuncio superó la revisión editorial.
ActiveLimited La extensión de anuncio superó la revisión editorial en uno o varios mercados, y uno o varios elementos de la extensión del anuncio están siendo revisados editorialmente en otro mercado. Por ejemplo, la extensión de anuncio pasó la revisión editorial para Canadá y todavía está pendiente de revisión en el Estados Unidos.
Desaprobó No se pudo revisar la extensión del anuncio.
Inactivo Uno o varios elementos de la extensión del anuncio se están revisando editorialmente.

Añadir: Solo lectura
Eliminar: Solo lectura

Término editorial

El término que falló en la revisión editorial.

Este campo no se establecerá si una combinación de términos produjo el error o si el error se basó en una infracción de directiva.

Añadir: Solo lectura
Eliminar: Solo lectura

Id

Identificador de la extensión de anuncio asociada o eliminada del grupo de anuncios.

Este campo masivo se asigna al campo Id del registro Extensión de anuncio de imagen .

Añadir: Solo lectura y Obligatorio. Debe especificar un identificador de extensión de anuncio existente o especificar un identificador negativo que sea igual al campo Id del registro de extensión de anuncio de imagen primario. Esto se recomienda si va a agregar nuevas extensiones y asociaciones de anuncios en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Eliminar: Solo lectura y Obligatorio

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
Eliminar: Solo lectura

Parent Id

Identificador del grupo de anuncios donde se asocia o quita esta extensión de anuncio.

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 asociar extensiones de anuncio 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.
Eliminar: Solo lectura y Obligatorio

Nota:

Para agregar y eliminar, debe especificar el Identificador primario o los campos Grupo de anuncios y Campaña .

Países editores

Lista de países o regiones del publicador cuyas directrices editoriales no permiten el término especificado.

En un archivo masivo, la lista de países o regiones del publicador se delimita con un punto y coma (;).

Añadir: Solo lectura
Eliminar: Solo lectura

Estado

Representa el estado de asociación entre el grupo de anuncios y la extensión del anuncio.

Los valores posibles son Active y Deleted. Si la extensión del anuncio está asociada al grupo de anuncios, el valor de este campo es Activo.

Añadir: Solo lectura
Eliminar: Obligatorio. El estado debe establecerse en Eliminado.