App Install Ad Label Record - Bulk
Define um registo de associação entre um Anúncio de Instalação de Aplicações e uma Etiqueta que pode ser carregada e transferida num ficheiro em massa. Para carregar ou transferir o anúncio ou etiqueta de instalação da aplicação, utilize o registo Instalar Anúncio ou Etiqueta da Aplicação.
Pode transferir todos os registos da App Install Ad Label na conta ao incluir o valor DownloadEntity de AppInstallAdLabels no pedido de serviço DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . Além disso, o pedido de transferência tem de incluir o âmbito EntityData . Para obter mais detalhes sobre o Serviço em massa, incluindo as melhores práticas, veja Transferência e Carregamento em Massa.
O seguinte exemplo de CSV em Massa aplicaria uma etiqueta a um anúncio de instalação da aplicação se fossem fornecidos valores de ID e ID Principal válidos.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
App Install Ad Label,,-22,-11112,,,ClientIdGoesHere,,,,,
Se estiver a utilizar os SDKs de Anúncios do Bing para .NET, Java ou Python, pode poupar tempo com o BulkServiceManager para carregar e transferir o objeto BulkAppInstallAdLabel , em vez de chamar diretamente as operações do serviço e escrever código personalizado para analisar cada campo no ficheiro em massa.
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkAppInstallAdLabel
var bulkAppInstallAdLabel = new BulkAppInstallAdLabel
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// LabelAssociation object of the Campaign Management service.
LabelAssociation = new LabelAssociation
{
// 'Parent Id' column header in the Bulk file
EntityId = appInstallAdIdKey,
// 'Id' column header in the Bulk file
LabelId = labelIdKey
},
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkAppInstallAdLabel);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
Para um registo instalar etiqueta de anúncios da aplicação , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.
ID de Cliente
Utilizado para associar registos no ficheiro de carregamento em massa a registos no ficheiro de resultados. O valor deste campo não é utilizado ou armazenado pelo servidor; é simplesmente copiado do registo carregado para o registo de resultados correspondente. Pode ser qualquer cadeia válida até 100 de comprimento.
Adicionar: Opcional
Eliminar: Só de leitura
ID
O identificador da etiqueta que é aplicada ou removida do anúncio de instalação da aplicação.
Este campo em massa mapeia para o campo ID do registo etiqueta .
Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de etiqueta existente ou especificar um identificador negativo que seja igual ao campo ID do registo de Etiqueta principal. Isto é recomendado se estiver a aplicar novas etiquetas a anúncios de instalação de aplicações no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Eliminar: Só de leitura e Obrigatório
Hora da Modificação
A data e hora em que a entidade foi atualizada pela última vez. O valor está em Hora Universal Coordenada (UTC).
Nota
O valor de data e hora reflete a data e hora no servidor, não o cliente. Para obter informações sobre o formato da data e hora, veja a entrada dateTime em Tipos de Dados XML Primitivos.
Adicionar: Só de leitura
Eliminar: Só de leitura
ID principal
O identificador do anúncio de instalação da aplicação onde esta etiqueta é aplicada ou removida.
Este campo em massa mapeia para o campo ID do registo de Instalação de Anúncios da Aplicação .
Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de aplicação existente ou especificar um identificador negativo que seja igual ao campo ID do registo de Instalação do Ad da Aplicação principal. Isto é recomendado se estiver a aplicar etiquetas a um novo anúncio de instalação da aplicação no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Eliminar: Só de leitura e Obrigatório
Estado
Representa o estado aplicado entre o anúncio de instalação da aplicação e a etiqueta.
Os valores possíveis são Ativo e Eliminado. Se a etiqueta for aplicada ao anúncio de instalação da aplicação, o valor deste campo é Ativo.
Adicionar: Só de leitura
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.