Objeto de Dados StructuredSnippetAdExtension – Gestão de Campanhas

Artigo
12/21/2023

Define um objeto que emparelha um cabeçalho com valores de 3 a 10 fragmentos que informam os clientes mais sobre a sua empresa.

No exemplo seguinte, Cursos é o cabeçalho e .NET, Java, Python e PHP são exemplos de valores individuais.

Cursos: .NET, Java, Python, PHP

Pode associar uma extensão de fragmento estruturado ad com a conta ou com campanhas e grupos de anúncios na conta. Cada entidade (conta, campanha ou grupo de anúncios) pode ser associada a até 20 extensões de fragmentos estruturados. Um anúncio de texto expandido incluirá apenas um fragmento estruturado (um cabeçalho com 3 a 10 valores) por impressão.

Sintaxe

<xs:complexType name="StructuredSnippetAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Header" nillable="true" type="xs:string" />
        <xs:element xmlns:q53="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Values" nillable="true" type="q53:ArrayOfstring" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

O objeto StructuredSnippetAdExtension tem os seguintes elementos: Cabeçalho, Valores.

Elemento	Descrição	Tipo de Dados
Cabeçalho	O cabeçalho que é anexado com dois pontos (:) e precede os valores do fragmento. Os cabeçalhos de Fragmentos Estruturados têm de ser especificados no mesmo idioma que pretende que seja apresentado. Por exemplo, se pretender amenidades de cabeçalho em inglês, tem de especificar o cabeçalho como Amenidades. Se quiser o cabeçalho Ausstattung em alemão, tem de especificar o cabeçalho como Ausstattung (Mensidades em alemão). Para obter uma lista de cabeçalhos suportados por idioma, veja Idiomas de Cabeçalho da Extensão do Ad. Adicionar: Necessário Atualização: Necessário	cadeia
Valores	Os valores de fragmentos que se seguem após o componente Cabeçalho do anúncio apresentado. Cada valor de texto que escolher pode ter um comprimento máximo de 25 carateres. Tenha em atenção que, para os carateres chineses tradicionais, cada valor pode ter um comprimento máximo de 12 carateres. Adicionar: Necessário Atualização: Necessário	matriz de cadeia

O objeto StructuredSnippetAdExtension tem Elementos Herdados.

Elementos Herdados

Elementos Herdados do AdExtension

O objeto StructuredSnippetAdExtension deriva do objeto AdExtension e herda os seguintes elementos: DevicePreference, ForwardCompatibilityMap, ID, Scheduling, Status, Type, Version. As descrições abaixo são específicas de StructuredSnippetAdExtension e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto AdExtension .

Elemento	Descrição	Tipo de Dados
DevicePreference	Não é suportado para este tipo de extensão de anúncio.	long
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. Atualmente, não existem alterações de compatibilidade para o objeto AdExtension . Adicionar: Só de leitura Atualização: Só de leitura	Matriz KeyValuePairOfstringstring
ID	O identificador exclusivo do Microsoft Advertising da extensão de anúncios. Adicionar: Só de leitura Atualização: Só de leitura e Obrigatório	long
Agendamento	Determina os intervalos de dia e hora do calendário quando a extensão de anúncios é elegível para ser apresentada em anúncios. Adicionar: Opcional Atualização: Opcional. Se definir este elemento como nulo, qualquer conjunto de agendamento existente para a extensão de anúncio permanecerá inalterado. Se definir esta opção para qualquer objeto Schedule não nulo, está efetivamente a substituir as definições de agendamento existentes para a extensão de anúncios. Para remover todo o agendamento, defina este elemento para um objeto Schedule vazio.	Agenda
Estado	O estado da extensão de anúncios. O valor será sempre Ativo porque o serviço Gestão de Campanhas não devolve extensões de anúncios eliminadas. Adicionar: Só de leitura Atualização: Só de leitura	AdExtensionStatus
Tipo	O tipo da extensão de anúncios. Este valor é StructuredSnippetAdExtension quando obtém uma extensão de ad de fragmento estruturado. Adicionar: Só de leitura Atualização: Só de leitura Para obter mais informações sobre os tipos de extensão de anúncios, veja Comentários sobre Objetos de Dados da Extensão do Ad.	cadeia
Versão	Monitoriza o número de vezes que a extensão de anúncios foi atualizada. A versão é definida como 1 quando a extensão de anúncio é criada e incrementa um após cada atualização. Adicionar: Não permitido Atualização: Não permitido	int

Requisitos

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

Partilhar via