Partilhar via

Registo da Lista de Clientes - Em massa

  • Artigo

Define uma lista de clientes que pode ser transferida e carregada num ficheiro em massa.

Importante

Antes de poder carregar os dados da lista de clientes através da API em Massa, primeiro tem de criar uma audiência da lista de clientes e aceitar os termos e condições na IU do Microsoft Advertising. A lista inicial de clientes não precisa de conter dados do cliente, mas tem de selecionar ACEITO. Ao selecionar "Aceito" o utilizador (1) concorda que pode divulgar legalmente os detalhes da audiência, que são dados pessoais, à Microsoft e (2) aceitar os Termos de Correspondência do Cliente, o Contrato de Publicidade da Microsoft e as políticas de Publicidade da Microsoft. A Microsoft utilizará os dados que carregar de acordo com os Termos de Correspondência do Cliente.

Uma lista de clientes é um conjunto de informações de contacto do cliente que compilou para permitir a correspondência do cliente. Cada lista pode incluir vários Email itens.

Pode adicionar ou atualizar um registo da Lista de Clientes sem registos de Itens da Lista de Clientes no mesmo ficheiro de carregamento em massa; no entanto, não pode carregar registos de Itens da Lista de Clientes sem o registo da Lista de Clientes principal que o acompanha.

Após 48 horas, verifique os campos Tamanho da Audiência, por exemplo, Tamanho da Pesquisa da Audiência para ver quantos destes clientes correspondemos na Rede Bing. Nessa altura, os seus anúncios podem começar a aparecer para esta nova audiência.

Sugestão

Para obter uma descrição geral e mais informações sobre audiências, veja o Guia técnico das APIs de Audiência .

Pode transferir todos os registos da Lista de Clientes na conta ao incluir o valor DownloadEntity de CustomerLists 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 adicionaria uma nova lista de clientes.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Action Type
Format Version,,,,,,6.0,,,,,,
Customer List,Active,-10,,ClientIdGoesHere,,,New customer list description,Customer,New Customer List,Add

Para um registo lista de clientes , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.

Tipo de Ação

Determina se pretende adicionar, remover ou substituir os registos do Item de Lista de Clientes que inclui no mesmo ficheiro de carregamento em massa.

Se o tipo de ação for "Adicionar", o serviço tentará adicionar os registos de Item da Lista de Clientes que inclui no mesmo ficheiro de carregamento em massa.

Se o tipo de ação estiver definido como "Remover", o serviço tentará remover os registos de Itens da Lista de Clientes que incluir no mesmo ficheiro de carregamento em massa.

Se o tipo de ação estiver definido como "Substituir", todos os dados anteriores da correspondência do cliente para esta lista serão removidos e o serviço tentará adicionar os registos de Itens da Lista de Clientes que incluir no mesmo ficheiro de carregamento em massa.

Adicionar: Opcional. Por predefinição, o tipo de ação "Adicionar" é utilizado para novas listas de clientes. Quer defina ou não um valor, este campo é ignorado para novas listas de clientes.
Atualização: Necessário se também estiver a incluir registos de Itens de Lista de Clientes para uma audiência existente no mesmo ficheiro de carregamento em massa e, caso contrário, este campo é opcional.
Eliminar: Só de leitura

Audiência

O nome da lista de clientes.

O nome pode conter um máximo de 128 carateres.

Adicionar: Necessário
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

Tamanho da Rede da Audiência

O número total de pessoas que são membros ativos desta audiência na rede audiência. Isto dá-lhe uma ideia do número de utilizadores de rede de Audiência que pode direcionar.

O público precisa de ter, pelo menos, 300 pessoas antes de o Microsoft Advertising o utilizar para otimizações.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

Tamanho da Pesquisa da Audiência

O número total de pessoas que são membros ativos desta audiência na rede de Pesquisa. Isto dá-lhe uma ideia do número de utilizadores de pesquisa que pode direcionar.

O público precisa de ter, pelo menos, 300 pessoas antes de o Microsoft Advertising o utilizar para otimizações.

Esta propriedade ficará vazia até 24 horas enquanto a audiência estiver a ser criada, por exemplo, se adicionar ou atualizar a duração da associação à lista de clientes, regra ou identificador de etiqueta.

Esta propriedade estará vazia se a etiqueta UET associada à lista de clientes tiver o estado Não Verificado ou Inativo, porque a lista de clientes não pode receber as informações do cliente do site de que precisa para criar a lista.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura

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
Atualização: Opcional
Eliminar: Só de leitura

Descrição

A descrição da lista de clientes. Utilize uma descrição para o ajudar a lembrar-se da audiência que está a filtrar com esta lista de clientes.

A descrição pode conter um máximo de 1024 carateres.

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Se definir este campo para a cadeia de delete_value , a definição anterior é removida.
Eliminar: Só de leitura

ID

O identificador gerado pelo sistema da lista de clientes.

Adicionar: Opcional. Tem de deixar este campo vazio ou especificar um identificador negativo. Um conjunto de identificador negativo para a lista de clientes pode, em seguida, ser referenciado no campo ID Principal de tipos de registo dependentes, como o item de lista de clientes. Isto é necessário se estiver a adicionar uma nova lista de clientes e novos itens de lista de clientes no mesmo Ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Atualização: Só de leitura e Obrigatório
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
Atualização: Só de leitura
Eliminar: Só de leitura

Duração da Associação

Quando cria uma lista de clientes, pode especificar durante quanto tempo os utilizadores permanecem nesse segmento.

A duração mínima é de 1 dia. Nota: Se um utilizador não tiver atividade durante 180 dias, será removido de todos os segmentos.

Se a duração da associação for "-1", não haverá expiração.

Se a duração da associação for nula, será utilizada a duração predefinida (30 dias).

Adicionar: Opcional
Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada.
Eliminar: Só de leitura

ID principal

O identificador do Microsoft Advertising do cliente que contém a lista de clientes.

Adicionar: Opcional
Atualização: Só de leitura. Não pode alterar o ID principal.
Eliminar: Só de leitura

Âmbito

O âmbito define que contas podem utilizar esta lista de clientes. Para uma lista de clientes, o único âmbito suportado é o Cliente e a lista de clientes pode ser associada a quaisquer campanhas e grupos de anúncios em todas as contas do cliente.

Adicionar: Necessário
Atualização: Só de leitura. Não pode alterar o âmbito.
Eliminar: Só de leitura

Estado

O estado da lista de clientes.

Os valores possíveis são Ativos ou Eliminados.

Adicionar: Opcional. O valor predefinido é Ativo.
Atualização: Só de leitura
Eliminar: Obrigatório. O Estado tem de ser definido como Eliminado.

Tipos de Campanha Suportados

A lista delimitada por ponto e vírgula de tipos de campanha que suportam esta lista de clientes.

Os valores suportados são Audience, DynamicSearchAds, Search e Shopping. Poderão ser adicionados novos tipos de campanha no futuro, pelo que não deve assumir qualquer dependência num conjunto fixo de valores.

Adicionar: Só de leitura
Atualização: Só de leitura
Eliminar: Só de leitura