Registro de anuncios de instalación de aplicaciones: masiva

Define un anuncio de instalación de aplicaciones que se puede descargar y cargar en un archivo masivo.

Los anuncios de instalación de aplicaciones son similares a los anuncios de texto, pero proporcionan vínculos directos a las aplicaciones con un botón y envían a los clientes directamente a la tienda correspondiente para descargar la aplicación. Esta es una solución ideal para los anunciantes que desean administrar e impulsar las descargas de sus aplicaciones, en lugar del tráfico del sitio web.

App Install Ads detecta automáticamente el dispositivo móvil y el sistema operativo del cliente, enviándolos a la App Store de Apple o Google Play correspondiente. También puedes realizar un seguimiento de las conversiones con los mismos asociados de seguimiento de conversiones que Extensiones de aplicación: AppsFlyer, Kochava, Tune, Singular, Adjust y Branch.

Nota:

App Install Ads está disponible en Australia, Brasil, Canadá, Francia, Alemania, India, Reino Unido y el Estados Unidos solo en iOS y Android. Actualmente solo se admiten las aplicaciones disponibles en el Estados Unidos de Apple App Store y Google Play Store. No hay compatibilidad con Windows.

Todavía no todos tienen esta característica. Si no lo haces, no te preocupes. Se acerca pronto.

Nota:

Los anuncios de instalación de aplicaciones solo se pueden crear en campañas de búsqueda en las que el tipo de grupo de anuncios está establecido en "SearchStandard". Si el tipo de grupo de anuncios está establecido en "SearchDynamic", el grupo de anuncios no admite anuncios de instalación de aplicaciones.

Puede descargar todos los registros de App Install Ad de la cuenta incluyendo el valor DownloadEntity de AppInstallAds 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 un nuevo anuncio de instalación de la aplicación si se proporciona un valor de Id. primario válido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter
Format Version,,,,,,,,,,,,,,6.0,,,,,,,
App Install Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,Contoso Quick Setup,Find New Customers & Increase Sales!,,,,All,,Android,AppStoreIdGoesHere,FinalUrlGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer

Si usa los SDK de Bing Ads para .NET, Java o Python, puede ahorrar tiempo con BulkServiceManager para cargar y descargar el objeto BulkAppInstallAd , en lugar de llamar a las operaciones del 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 BulkAppInstallAd
var bulkAppInstallAd = new BulkAppInstallAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // AppInstallAd object of the Campaign Management service.
    AppInstallAd = new AppInstallAd
    {
        // 'App Platform' column header in the Bulk file
        AppPlatform = "Android",
        // 'App Id' column header in the Bulk file
        AppStoreId = "AppStoreIdGoesHere",
        // 'Device Preference' column header in the Bulk file
        DevicePreference = 0,
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "FinalUrlGoesHere"
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales!",
        // 'Title' column header in the Bulk file
        Title = "Contoso Quick Setup",
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
};

uploadEntities.Add(bulkAppInstallAd);

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 anuncio de instalación de aplicaciones, los siguientes campos de atributo están disponibles en el esquema de archivos masivos. La combinación de los campos Id. de aplicación, Plataforma de aplicación, Texto y Título hace que el anuncio de instalación de la aplicación sea único.

• Grupo de anuncios
• Id. de aplicación
• Plataforma de aplicaciones
• Campaña
• Id. de cliente
• Parámetro personalizado
• Preferencia de dispositivo
• Estado de la apelación editorial
• Ubicación editorial
• Código de motivo editorial
• Estado editorial
• Término editorial
• Final Url
• Sufijo de dirección URL final
• Id
• Tiempo de modificación
• Parent Id
• Países editores
• Estado
• Texto
• Title
• Plantilla de seguimiento

Grupo de anuncios

Nombre del grupo de anuncios que contiene el anuncio.

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 Grupo de anuncios .

Id. de aplicación

Identificador de aplicación proporcionado por el almacén de aplicaciones.

Si la aplicación es nueva, espere entre 4 y 7 días antes de que el anuncio sea apto para entregarse.

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

Plataforma de aplicaciones

Plataforma de la aplicación.

Entre los valores posibles se incluyen iOS y Android.

Añadir: Obligatorio
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 que contiene el grupo de anuncios y el anuncio.

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

Parámetro personalizado

Colección personalizada de parámetros de clave y valor para el seguimiento de direcciones URL.

En un archivo masivo, la lista de parámetros personalizados tiene el formato siguiente.

• Dé formato a cada par de parámetros personalizado como Key=Value, por ejemplo{_promoCode}=PROMO1.

• Microsoft Advertising aceptará los 8 primeros pares de clave y valor de parámetro personalizados que incluya y, si incluye más de 8 parámetros personalizados, se devolverá un error. Cada par de clave y valor se delimita por un punto y coma y un espacio ("; "), por ejemplo {_promoCode}=PROMO1; {_season}=verano.

• Una clave no puede contener un punto y coma. Si un valor contiene un punto y coma, debe tener escape como '\;'. Además, si el valor contiene una barra diagonal inversa, también debe tener el carácter de escape '\'.

• La clave no puede superar los 16 bytes UTF-8 y el valor no puede superar los 250 bytes UTF-8. La clave es necesaria y el valor es opcional. El tamaño máximo de la clave no incluye las llaves y el carácter de subrayado, es decir, '{', '_' y '}'.

  Nota:

  Con el servicio bulk, la clave debe tener formato con llaves circundantes y un carácter de subrayado inicial, por ejemplo, si la clave es promoCode, debe tener el formato {_promoCode}. Con el servicio Administración de campañas no puede especificar las llaves y el carácter de subrayado circundantes.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Para quitar todos los parámetros personalizados, establezca este campo en delete_value. La palabra clave delete_value quita la configuración anterior. Para quitar un subconjunto de parámetros personalizados, especifique los parámetros personalizados que desea conservar y omita los que no desee conservar. El nuevo conjunto de parámetros personalizados reemplazará a cualquier conjunto de parámetros personalizados anterior.
Eliminar: Solo lectura

Preferencia de dispositivo

Este campo determina si la preferencia es que los anuncios de instalación de aplicaciones se muestren en dispositivos móviles y tabletas o solo en dispositivos móviles. (Los anuncios de instalación de aplicaciones no se admiten actualmente en equipos de escritorio).

Los valores posibles son All (dispositivos móviles y tabletas) y Mobile (es decir, excluyendo tabletas), que difieren de los valores utilizados en el servicio de administración de campañas.

SixMonths

En el archivo de resultados de carga y descarga masiva, este campo nunca estará vacío. Si no especificó una preferencia de dispositivo, se devolverá el valor predeterminado de Todo .

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo en la cadena delete_value , se quita la configuración anterior. Si establece este campo en delete_value, se restablecerá eficazmente al valor predeterminado de Todos.
Eliminar: Solo lectura

Estado de la apelación editorial

Determina si puede apelar los problemas encontrados por la revisión editorial.

Los valores posibles se describen en la tabla siguiente.

Valor	Description
Atractivo	El tema editorial es atractivo.
AppealPending	El tema editorial es apelable y se ha presentado una apelación.
NotAppealable	El tema editorial no es atractivo.

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

Ubicación editorial

Componente o propiedad del anuncio que no pudo revisar editorialmente.

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

Estado editorial

Estado editorial del anuncio.

Los valores posibles se describen en la tabla siguiente.

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

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

Final Url

Dirección URL donde un usuario de búsqueda llega y puede elegir instalar una aplicación.

Las siguientes reglas de validación se aplican a la dirección URL final para los anuncios de instalación de aplicaciones.

• La longitud de la dirección URL está limitada a 2048 caracteres. La cadena de protocolo HTTP o HTTPS cuenta para el límite de 2048 caracteres.
• Solo puede especificar una dirección URL en este campo.
• El uso de '{' y '}' solo puede delinear etiquetas, por ejemplo, "{lpurl}".
• Cada dirección URL debe ser una dirección URL bien formada a partir de http:// o https://.

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

Sufijo de dirección URL final

El sufijo de dirección URL final puede incluir parámetros de seguimiento que se anexarán al final de la dirección URL de la página de aterrizaje. Se recomienda colocar los parámetros de seguimiento que requiere la página de aterrizaje en un sufijo de dirección URL final para que los clientes siempre se envíen a la página de aterrizaje. Para obtener más detalles y reglas de validación, consulte Sufijo de dirección URL final en las guías técnicas.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo en la cadena delete_value , se quita la configuración anterior.
Eliminar: Solo lectura

Id

Identificador generado por el sistema del anuncio.

Añadir: Opcional. Debe dejar este campo vacío o especificar un identificador negativo. A continuación, se puede hacer referencia a un identificador negativo establecido para el anuncio en el campo Id. primario de tipos de registro dependientes, como App Install Ad Label. Esto se recomienda si va a agregar nuevos anuncios y nuevos registros dependientes 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

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 del grupo de anuncios que contiene el 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 agregar nuevos anuncios 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: Solo lectura
Eliminar: Solo lectura

Nota:

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

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

Estado

Estado del anuncio.

Los valores posibles son Active, Paused o Deleted.

Añadir: Opcional. El valor predeterminado es Active.
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Eliminar: Obligatorio. El estado debe establecerse en Eliminado.

Texto

La copia del anuncio. La copia debe contener al menos una palabra. La copia y el título combinados del anuncio deben totalizar al menos tres palabras.

La copia del anuncio no puede contener cadenas de texto dinámicas como {keyword}.

La longitud máxima de entrada de la copia es de 71 caracteres. Tenga en cuenta que para los grupos de anuncios que usan chino tradicional, el texto está limitado a 38 caracteres.

La copia del anuncio no puede contener el carácter de nueva línea (\n).

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

Título

El título del anuncio. El título debe contener al menos una palabra. La copia y el título combinados del anuncio deben totalizar al menos tres palabras.

El título no puede contener cadenas de texto dinámicas como {keyword}.

La longitud máxima de entrada del título es de 25 caracteres. Tenga en cuenta que para los grupos de anuncios que usan chino tradicional, el título está limitado a 15 caracteres.

El título no puede contener el carácter de nueva línea (\n).

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

Plantilla de seguimiento

Plantilla de seguimiento que se va a usar como valor predeterminado para la dirección URL especificada con FinalUrls.

Las siguientes reglas de validación se aplican a las plantillas de seguimiento. Para obtener más información sobre las plantillas y los parámetros admitidos, consulte el artículo de ayuda de Microsoft Advertising ¿Qué parámetros de seguimiento o dirección URL puedo usar?

• Las plantillas de seguimiento definidas para entidades de nivel inferior, por ejemplo, los anuncios, reemplazan a las establecidas para entidades de nivel superior, por ejemplo, campaña. Para obtener más información, vea Límites de entidad.

• La longitud de la plantilla de seguimiento está limitada a 2048 caracteres. La cadena de protocolo HTTP o HTTPS cuenta para el límite de 2048 caracteres.

• La plantilla de seguimiento debe ser una dirección URL bien formada que comience por una de las siguientes: http://, https://, {lpurl}o {unescapedlpurl}.

• Microsoft Advertising no valida si existen parámetros personalizados. Si usa parámetros personalizados en la plantilla de seguimiento y no existen, la dirección URL de la página de aterrizaje incluirá los marcadores de posición de clave y valor de los parámetros personalizados sin sustitución. Por ejemplo, si la plantilla de seguimiento es https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}y no se definen {_season} ni {_promocode} en el nivel de campaña, grupo de anuncios, criterio, palabra clave o anuncio, la dirección URL de la página de aterrizaje será la misma.

Añadir: Opcional
Actualizar: Opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia. Si establece este campo en la cadena delete_value , se quita la configuración anterior.
Eliminar: Solo lectura