Compartir a través de

Registro de la asociación de audiencias de la campaña en el mercado: masiva

  • Artículo

Define una asociación de audiencia de campaña en el mercado que se puede cargar y descargar en un archivo masivo.

Nota:

Esta característica está disponible en Australia, Canadá, Francia, Alemania, Reino Unido y Estados Unidos.

Los objetivos de audiencia no se pueden establecer tanto a nivel de campaña como de grupo de anuncios. Si estableces los criterios de audiencia de nivel de campaña que se pueden pujar, no puedes establecer ningún criterio de audiencia de nivel de grupo de anuncios pujable. Las exclusiones de público se pueden establecer en el nivel de campaña y grupo de anuncios. Microsoft Advertising aplica una unión de exclusiones de nivel de campaña y grupo de anuncios.

Sugerencia

Para obtener información general y más información sobre las audiencias, consulte la Guía técnica de las API de audiencia .

Puede descargar todos los registros de Campaign In Market Audience Association en la cuenta incluyendo el valor DownloadEntity de CampaignInMarketAudienceAssociations 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 asociación de audiencia de campaña en el mercado si se proporciona un valor de id. primario válido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Audience Id,Audience
Format Version,,,,,,,,,6.0,,
Campaign In Market Audience Association,Paused,,-1111,,,ClientIdGoesHere,,10,,InMarketAudienceIdHere,My In Market Audience

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkCampaignInMarketAudienceAssociation , 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 BulkCampaignInMarketAudienceAssociation
var bulkCampaignInMarketAudienceAssociation = new BulkCampaignInMarketAudienceAssociation
{
    // Map properties in the Bulk file to the 
    // BiddableCampaignCriterion object of the Campaign Management service.
    BiddableCampaignCriterion = new BiddableCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new AudienceCriterion
        {
            // 'Audience Id' column header in the Bulk file
            AudienceId = inMarketAudienceIdKey,
        },
        // 'Bid Adjustment' column header in the Bulk file
        CriterionBid = new BidMultiplier
        {
            Multiplier = 10
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = CampaignCriterionStatus.Paused
    },
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Audience' column header in the Bulk file
    AudienceName = null,
};

uploadEntities.Add(bulkCampaignInMarketAudienceAssociation);

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 Campaign In Market Audience Association , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.

Público

Nombre de la audiencia en el mercado.

Este campo masivo se asigna al campo Audiencia del registro Audiencia en el mercado .

La descarga de API masiva devuelve todas las asociaciones de público del mercado, independientemente de si la audiencia en el mercado está activa o eliminada. Si la asociación es para una audiencia eliminada en el mercado, este campo se establecerá en el mismo valor que el campo Identificador de audiencia .

Añadir: Solo lectura y Obligatorio para algunos casos de uso. Debe especificar el campo Audiencia o Identificador de audiencia . Si va a agregar nuevas asociaciones de audiencia de campaña en el mercado con nuevas audiencias en el mercado en el mismo archivo masivo y no establece el campo Identificador de audiencia , este campo Audiencia debe establecerse como una clave lógica en el mismo valor que el campo Audiencia del registro Audiencia en el mercado . Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Actualizar: Solo lectura
Eliminar: Solo lectura

Identificador de audiencia

Identificador de Microsoft Advertising de la audiencia en el mercado asociada a la campaña.

Este campo masivo se asigna al campo Id del registro de audiencia en el mercado .

Añadir: Solo lectura y Obligatorio para algunos casos de uso. Debe especificar el campo Audiencia o Identificador de audiencia . Si establece el campo Identificador de audiencia , debe especificar un identificador de audiencia existente en el mercado o especificar un identificador negativo que sea igual al campo Id del registro principal de audiencia en el mercado . Si no se establece el campo Identificador de audiencia , debe establecer el campo Audiencia como clave lógica en el mismo valor que el campo Audiencia del registro Audiencia en el mercado . Cualquiera de estas opciones se recomienda si va a agregar nuevas asociaciones de audiencia de campaña en el mercado con nuevas audiencias en el mercado en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Actualizar: Solo lectura
Eliminar: Solo lectura

Ajuste de la oferta

El porcentaje que desea aumentar o reducir el importe de la oferta para la audiencia en el mercado.

Los valores admitidos son noventa negativos (-90,00) a través de noventacientos positivos (900,00).

Importante

Si no se especifica, el valor predeterminado del ajuste de puja es 0. El valor predeterminado está sujeto a cambios.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Solo lectura

Campaña

Nombre de la campaña asociada a la audiencia en el mercado.

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

Nota:

Para agregar, actualizar y eliminar, debe especificar el campo Id. primario o 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
Actualizar: Opcional
Eliminar: Solo lectura

Id

Identificador generado por el sistema para la asociación entre una campaña y la audiencia en el mercado.

Añadir: Solo lectura
Actualizar: Solo lectura y Obligatorio
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
Actualizar: Solo lectura
Eliminar: Solo lectura

Parent Id

Identificador generado por el sistema de la campaña que está asociada a la audiencia del mercado.

Este campo masivo se asigna al campo Id del registro Campaña .

Añadir: Solo lectura y Obligatorio. Debe especificar un identificador de campaña existente o especificar un identificador negativo que sea igual al campo Id del registro de campaña primario. Esto se recomienda si va a asociar audiencias en el mercado a una nueva campaña en el mismo archivo masivo. Para obtener más información, vea Claves de referencia de esquema de archivos masivos.
Actualizar: Solo lectura y Obligatorio
Eliminar: Solo lectura y Obligatorio

Nota:

Para agregar, actualizar y eliminar, debe especificar el campo Id. primario o Campaña .

Estado

Estado de la asociación.

Los valores posibles son Active, Paused o Deleted.

Añadir: Opcional. El valor de estado predeterminado es Active.
Actualizar: Opcional
Eliminar: Obligatorio. El estado debe establecerse en Eliminado.