Objeto de Dados CustomerList - Gestão de Campanhas
Define um objeto de dados CustomerList.
Importante
Antes de criar dados de lista de clientes através da API de Gestão de Campanhas, 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.
Sintaxe
<xs:complexType name="CustomerList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexContent mixed="false">
<xs:extension base="tns:Audience">
<xs:sequence />
</xs:extension>
</xs:complexContent>
</xs:complexType>
Elementos
O objeto CustomerList tem Elementos Herdados.
Elementos Herdados
Elementos Herdados da Audiência
O objeto CustomerList deriva do objeto Audiência e herda os seguintes elementos: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type. As descrições abaixo são específicas da CustomerList e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto Audiência .
| Elemento | Descrição | Tipo de Dados |
|---|---|---|
| AudienceNetworkSize | 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 |
long |
| CustomerShare | Determina a lista de clientes e contas que partilham a audiência. Os detalhes incluem contagens de associação de audiências. As etiquetas e audiências UET partilhadas só estão disponíveis para clientes piloto. Para obter uma descrição geral da partilha de audiências e etiquetas UET numa hierarquia de clientes, consulte o guia técnico Partilhar Audiências e Etiquetas UET . Adicionar: Opcional Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. Defina este elemento como nulo ou vazio para manter quaisquer partilhas de conta de cliente existentes. Para remover todas as partilhas de conta de cliente, defina o elemento CustomerAccountShares do objeto CustomerShare como nulo ou vazio. Para remover um subconjunto de partilhas de conta de cliente, especifique as partilhas de conta de cliente que pretende manter no elemento CustomerAccountShares do objeto CustomerShare . |
CustomerShare |
| Descrição | A descrição da audiência. Utilize uma descrição para o ajudar a lembrar-se da audiência que está a direcionar. 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. |
cadeia |
| ForwardCompatibilityMap | A lista de cadeias de chave e valor para compatibilidade de reencaminhamento para evitar alterações interruptivas quando novos elementos são adicionados na versão atual da API. As alterações de compatibilidade de reencaminhamento serão registadas aqui em versões futuras. Atualmente, não existem alterações de compatibilidade para o objeto Audiência . |
Matriz KeyValuePairOfstringstring |
| ID | O identificador do Microsoft Advertising da audiência. Adicionar: Só de leitura Atualização: Obrigatório e só de leitura |
long |
| MembershipDuration | Quando cria uma audiência, pode especificar até que ponto o Microsoft Advertising deve procurar ações que correspondam à definição da sua audiência. A duração mínima é de 1 dia e a duração máxima permitida é de 390 dias. Também pode definir a duração para -1 sem expiração. Adicionar: Opcional. Se não for especificado, a duração da associação será definida como 30 por predefinição. Atualização: Opcional. Se não estiver definido nenhum valor para a atualização, esta definição não será alterada. |
int |
| Nome | O nome da audiência. 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. |
cadeia |
| ParentId | O identificador do Microsoft Advertising da conta ou cliente. Se o Âmbito estiver definido como Conta, este é o ID da conta e, caso contrário, é o ID do cliente. Adicionar: Necessário Atualização: Só de leitura. Não pode alterar o ID principal. |
long |
| Âmbito | O âmbito define que contas podem utilizar esta audiência. Se o âmbito estiver definido como Conta, a audiência só pode ser associada a campanhas e grupos de anúncios numa conta, ou seja, através do ParentId. Se o âmbito estiver definido como Cliente, a audiência pode ser associada a campanhas e grupos de anúncios em todas as contas do cliente. Adicionar: Necessário Atualização: Opcional. Pode alterar o âmbito de Conta para Cliente, mas não pode alterar o âmbito de Cliente para Conta. |
EntityScope |
| SearchSize | 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é 48 horas enquanto a audiência estiver a ser criada, por exemplo, se adicionar ou atualizar a duração da associação à lista de clientes. Adicionar: Só de leitura Atualização: Só de leitura |
long |
| SupportedCampaignTypes | A lista de tipos de campanha que suportam esta audiência. 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 |
matriz de cadeia |
| Tipo | O tipo de audiência. Este valor é CustomerList quando obtém uma audiência da lista de clientes. Para obter mais informações sobre os tipos de audiência, veja Comentários sobre Objetos de Dados de Audiência. Adicionar: Só de leitura Atualização: Só de leitura |
AudienceType |
Requisitos
Serviço: CampaignManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/CampaignManagement/v13