Registo de Itens da Lista de Clientes - Em Massa
Define um item de lista de clientes que pode ser carregado num ficheiro em massa.
Nota
A transferência em massa de itens de lista de clientes não é suportada.
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.
- Inclua o registo Lista de Clientes no ficheiro carregamento em massa e defina o campo Tipo de Ação como "Adicionar", "Remover" ou "Substituir".
- Inclua um ou mais registos de Item de Lista de Clientes no mesmo ficheiro de carregamento em massa e defina os campos ID Principal, Subtipo e Texto .
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 de Itens 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 um novo item de lista de clientes.
Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Action Type,Sub Type,Text
Format Version,,,,,,6.0,,,,,,
Customer List,Active,-10,,ClientIdGoesHere,,,New customer list description,Customer,New Customer List,Add,,
Customer List Item,,,-10,ClientIdGoesHere,,,,,,,Email,HashedValue
Para um registo de Item de Lista de Clientes , os seguintes campos de atributo estão disponíveis no Esquema de Ficheiro em Massa.
Audiência
O nome da audiência da lista de clientes principal.
O nome pode conter um máximo de 128 carateres.
Adicionar: Necessário. Tem de especificar o campo ID Principal ou Audiência .
Eliminar: Necessário. Tem de especificar o campo ID Principal ou Audiência .
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: Opcional
ID principal
O identificador da audiência da lista de clientes principal.
Tem de especificar o campo ID Principal ou Audiência .
Adicionar: Só de leitura e Obrigatório. Tem de especificar um identificador de lista de clientes existente ou especificar um identificador negativo que seja igual ao campo ID do registo da Lista de Clientes principal. Isto é necessário se estiver a adicionar novos itens de lista de clientes a uma nova lista de clientes no mesmo ficheiro em massa. Para obter mais informações, veja Chaves de Referência do Esquema de Ficheiro em Massa.
Eliminar: Necessário.
Subtipo
Determina se o campo Texto representa um valor de Email com hash.
Atualmente, o único valor suportado é "Email".
Adicionar: Necessário
Eliminar: Necessário
Text
O hash Email como texto.
Se o Sub-Tipo for "Email", este campo não pode conter texto simples. A cadeia tem de ser hash através do algoritmo SHA-256. O hash Email tem de ser uma cadeia hexadecimal de comprimento 64. Por exemplo, tem de carregar uma cadeia hash, como "f25ad364d33972379a7a4f4df33db142205f5c40eb19cfdb2fc5aaf117e10101" em vez de "test@contoso.com".
Adicionar: Necessário
Eliminar: Necessário