Compartilhar via


Objeto de Dados LocationCriterion - Gestão de Campanhas

Define um critério que pode ser utilizado para mostrar anúncios aos utilizadores numa localização específica.

Com os critérios de localização, pode optar por mostrar anúncios a potenciais clientes em, procurar ou ver páginas sobre:

  • Todos os países/regiões disponíveis
  • Cidades selecionadas, códigos postais, áreas metropolitanas Área de Mercado da Microsoft na Estados Unidos), condados, estados/províncias e países/regiões

Cada critério de localização define um código de localização para o ajuste da oferta de critério que o acompanha.

O número máximo de critérios de localização combinados e negativos que pode especificar por campanha ou grupo de anúncios é 10 000.

Nota

Só pode ter um LocationIntentCriterion por campanha ou grupo de anúncios para determinar a opção de intenção de localização que se aplica a todos os critérios geográficos da campanha ou do grupo de anúncios (localização, localização negativa e critérios de raio). Quando cria o primeiro critério da campanha ou do grupo de anúncios, também será adicionado automaticamente um LocationIntentCriterion com o IntentOption predefinido definido como PeopleInOrSearchingForOrViewingPages. Pode adicionar ou atualizar uma campanha ou o LocationIntentCriterion de um grupo de anúncios, quer a campanha ou o grupo de anúncios tenha outros critérios. Não é possível eliminar um LocationIntentCriterion, embora não tenha qualquer finalidade sem critérios de localização ou raio.

O LocationCriterion pode ser incluído nos objetos BiddableAdGroupCriterion, NegativeAdGroupCriterion, BiddableCampaignCriterion e NegativeCampaignCriterion . Se forem especificados critérios de localização ao nível do grupo de anúncios (positivos ou negativos), os critérios de localização ao nível da campanha são ignorados para esse grupo de anúncios. Por outras palavras, os critérios de localização do grupo de anúncios substituem os critérios de localização da campanha e não são aplicados como uma união.

Tenha também em atenção que tem de considerar a localização, a localização negativa e os critérios radius como um conjunto de critérios geográficos. Se o grupo de anúncios tiver critérios geográficos, nenhum dos critérios geográficos da campanha é herdado. Se o grupo de anúncios não tiver critérios geográficos, todos os critérios geográficos da campanha serão herdados. Os critérios geográficos podem ser herdados da campanha, mesmo que o grupo de anúncios tenha um critério de intenção de localização. Se forem utilizados os critérios geográficos do grupo de anúncios, será utilizado o critério de intenção de localização do grupo de anúncios; se os critérios geográficos da campanha forem herdados, será utilizado o critério de intenção de localização da campanha e o critério de intenção de localização do grupo de anúncios será ignorado. Não pode eliminar um critério de intenção de localização de uma campanha ou grupo de anúncios, embora não tenha qualquer finalidade sem critérios de localização ou raio.

Sintaxe

<xs:complexType name="LocationCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Criterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="DisplayName" nillable="true" type="xs:string" />
        <xs:element xmlns:q80="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="EnclosedLocationIds" nillable="true" type="q80:ArrayOflong" />
        <xs:element minOccurs="0" name="LocationId" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="LocationType" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

O objeto LocationCriterion tem os seguintes elementos: DisplayName, EnclosedLocationIds, LocationId, LocationType.

Elemento Descrição Tipo de Dados
DisplayName O nome a apresentar da localização.

Adicionar: Só de leitura
Atualização: Só de leitura
cadeia
EnclosedLocationIds Reservado para utilização interna.

Adicionar: Só de leitura
Atualização: Só de leitura
matriz longa
LocationId O identificador exclusivo do Microsoft Advertising para a localização onde pretende mostrar os anúncios.

Para obter valores possíveis, veja o campo ID de Localização do ficheiro de localizações geográficas. Pode chamar a operação GetGeoLocationsFileUrl para transferir o ficheiro.

IMPORTANTE: Verifique o campo Estado no ficheiro de localizações geográficas antes de adicionar ou atualizar um critério de localização. Se o estado for PendingDeprecation, o critério de localização já não é utilizado para filtragem ou exclusões. Os critérios de localização preteridos ainda podem ser obtidos, mas não pode adicionar ou atualizar critérios de localização preteridos.

Adicionar: Necessário
Atualização: Não permitido. Se especificar este elemento, este tem de corresponder à definição existente.
long
LocationType O tipo de localização.

Os valores possíveis incluem, mas não estão limitados a Cidade, País, MetroArea, Bairro, Código Postal e Estado.

Podem ser adicionados novos subtipos de localização em qualquer altura. Raramente o tipo de localização será alterado para um determinado ID de localização.

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

O objeto LocationCriterion tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do Critério

O objeto LocationCriterion deriva do objeto Critério e herda os seguintes elementos: Tipo. As descrições abaixo são específicas de LocationCriterion e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto Critério .

Elemento Descrição Tipo de Dados
Tipo O tipo de critério. Este valor é Localização quando obtém um critério de localização. Para obter mais informações sobre os tipos de critério, veja Critérios de Observação de Objetos de Dados.

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

Requisitos

Serviço: CampaignManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/CampaignManagement/v13