Condividi tramite


Oggetto dati StructuredSnippetAdExtension - Campaign Management

Definisce un oggetto che associa un'intestazione a valori compresi tra 3 e 10 frammenti di codice che indicano ai clienti maggiori informazioni sull'azienda.

Nell'esempio seguente Courses è l'intestazione e .NET, Java, Python e PHP sono esempi di singoli valori.

Corsi: .NET, Java, Python, PHP

Puoi associare un'estensione di annuncio frammento strutturato all'account o alle campagne e ai gruppi di annunci nell'account. Ogni entità (account, campagna o gruppo di annunci) può essere associata a un massimo di 20 estensioni di annunci frammenti strutturati. Un annuncio di testo espanso includerà solo un frammento strutturato (un titolo con 3-10 valori) per impressione.

Sintassi

<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>

Elementi

L'oggetto StructuredSnippetAdExtension include gli elementi seguenti: Intestazione, Valori.

Elemento Descrizione Tipo di dati
Intestazione Intestazione aggiunta con due punti (:) e che precede i valori del frammento di codice.

Le intestazioni dei frammenti strutturati devono essere specificate nello stesso linguaggio in cui si intende visualizzarle. Ad esempio, se si desidera intestazione Servizi in inglese, è necessario specificare l'intestazione come Servizi. Se si desidera l'intestazione Ausstattung in tedesco, è necessario specificare l'intestazione come Ausstattung (Servizi in tedesco). Per un elenco delle intestazioni supportate per lingua, vedere Lingue di intestazione dell'estensione ad.

Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
Stringa
Valori Valori del frammento di codice che seguono il componente Intestazione dell'annuncio visualizzato.

Ogni valore di testo scelto può avere una lunghezza massima di 25 caratteri. Si noti che per i caratteri cinesi tradizionali, ogni valore può avere una lunghezza massima di 12 caratteri.

Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio
matrice di stringhe

L'oggetto StructuredSnippetAdExtension include elementi ereditati.

Elementi ereditati

Elementi ereditati da AdExtension

L'oggetto StructuredSnippetAdExtension deriva dall'oggetto AdExtension ed eredita gli elementi seguenti: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Le descrizioni seguenti sono specifiche di StructuredSnippetAdExtension e potrebbero non essere applicabili ad altri oggetti che ereditano gli stessi elementi dall'oggetto AdExtension .

Elemento Descrizione Tipo di dati
DevicePreference Non supportato per questo tipo di estensione dell'annuncio. long
ForwardCompatibilityMap Elenco di stringhe di chiave e valore per la compatibilità con l'inoltro per evitare modifiche che altrimenti causano un'interruzione quando vengono aggiunti nuovi elementi nella versione corrente dell'API.

Attualmente non sono presenti modifiche di compatibilità per l'oggetto AdExtension .

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Matrice KeyValuePairOfstringstring
Id Identificatore univoco di Microsoft Advertising dell'estensione dell'annuncio.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura e Obbligatorio
long
Pianificazione Determina il giorno e gli intervalli di tempo del calendario quando l'estensione dell'annuncio è idonea per essere visualizzata negli annunci.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se imposti questo elemento null, qualsiasi set di pianificazione esistente per l'estensione dell'annuncio rimarrà invariato. Se imposti questo valore su qualsiasi oggetto Schedule non Null, sostituisci in modo efficace le impostazioni di pianificazione esistenti per l'estensione dell'annuncio. Per rimuovere tutta la pianificazione, impostare questo elemento su un oggetto Schedule vuoto.
Schedule
Stato Stato dell'estensione dell'annuncio. Il valore sarà sempre attivo perché il servizio Campaign Management non restituisce le estensioni pubblicitarie eliminate.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
AdExtensionStatus
Digitare Tipo di estensione dell'annuncio. Questo valore è StructuredSnippetAdExtension quando si recupera un'estensione di annuncio frammento strutturato.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura

Per altre informazioni sui tipi di estensione degli annunci, vedi le osservazioni sull'oggetto dati dell'estensione per gli annunci.
Stringa
Versione Tiene traccia del numero di volte in cui l'estensione dell'annuncio è stata aggiornata.

La versione è impostata su 1 quando viene creata l'estensione dell'annuncio e viene incrementato di uno dopo ogni aggiornamento.

Aggiungere: Non consentito
Aggiornamento: Non consentito
int

Requisiti

Servizio: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13