Condividi tramite


Oggetto dati TextAd - Campaign Management

Definisce un annuncio di testo.

Importante

A partire da aprile 2020, la distribuzione di annunci di testo standart (STA) non è supportata.

Standard gli annunci di testo sono stati deprecati a favore degli annunci di testo espansi (EXTA). Il supporto per l'aggiunta e l'aggiornamento di annunci di testo standard è terminato il 31 luglio 2017. Ora, gli inserzionisti possono ottenere ed eliminare, ma non possono più aggiungere nuove autorità di sicurezza o aggiornare gli annunci di testo standard esistenti. Un'eccezione alla regola è che è comunque possibile aggiornare lo stato STA, ad esempio da Attivo a Sospeso. In caso contrario, i tentativi di aggiungere o aggiornare gli STA genereranno l'errore CampaignServiceAdTypeInvalid .

Sintassi

<xs:complexType name="TextAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="DisplayUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Title" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementi

L'oggetto TextAd include gli elementi seguenti: DestinationUrl, DisplayUrl, Text, Title.

Elemento Descrizione Tipo di dati
DestinationUrl URL della pagina Web a cui portare l'utente quando fa clic sull'annuncio.

L'URL può contenere parametri dinamici, ad esempio {MatchType}.

Per un elenco dei parametri supportati, vedere l'articolo della Guida di Microsoft Advertising Quali parametri di rilevamento o URL è possibile usare?.

L'URL può contenere un massimo di 1.024 caratteri. Se l'URL non specifica un protocollo, il sistema usa il protocollo HTTP quando un utente fa clic sull'annuncio. Se l'URL specifica il protocollo HTTP quando si aggiunge un annuncio, il servizio rimuoverà la stringa del protocollo http:// (la stringa del protocollo HTTP non viene conteggiata rispetto al limite di 1.024 caratteri); tuttavia, il servizio non rimuoverà una stringa di protocollo HTTPS (https://) dall'URL.

Importante: Se attualmente si usano gli URL di destinazione, è necessario sostituirli con URL finali. Per altre informazioni, vedere Rilevamento url con URL aggiornati.

Questo URL viene usato solo se la parola chiave non specifica un URL di destinazione.

Aggiungere: Non supportato
Aggiornare: Non supportato
corda
DisplayUrl URL da visualizzare nell'annuncio.

La sottodirectory dell'URL di visualizzazione può contenere stringhe di testo dinamico, ad esempio {parola chiave}; Tuttavia, il nome host DELL'URL non può contenere testo dinamico. Per altre informazioni, vedi l'articolo della Guida di Microsoft Advertising Personalizza automaticamente gli annunci con parametri di testo dinamico.

La lunghezza di input massima dell'URL è di 200 caratteri e può contenere stringhe di testo dinamico. L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza supera i 35 caratteri dopo la sostituzione dinamica del testo.

Aggiungere: Non supportato
Aggiornare: Non supportato
corda
Testo Copia dell'annuncio. La copia deve contenere almeno una parola. La copia e il titolo dell'annuncio combinati devono contenere almeno tre parole.

Il testo può contenere stringhe di testo dinamico, ad esempio {keyword}. Per altre informazioni, vedi l'articolo della Guida di Microsoft Advertising Personalizza automaticamente gli annunci con parametri di testo dinamico.

La lunghezza di input massima della copia è di 300 caratteri e può contenere stringhe di testo dinamiche. L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza supera i 71 caratteri dopo la sostituzione dinamica del testo. Si noti che per i gruppi di annunci che usano il cinese tradizionale, il testo è limitato a 38 caratteri dopo la sostituzione.

Il testo non può contenere il carattere di nuova riga (\n).

Aggiungere: Non supportato
Aggiornare: Non supportato
corda
Titolo Titolo dell'annuncio. Il titolo deve contenere almeno una parola. La copia e il titolo dell'annuncio combinati devono contenere almeno tre parole.

Il titolo può contenere stringhe di testo dinamico, ad esempio {keyword}. Per altre informazioni, vedi l'articolo della Guida di Microsoft Advertising Personalizza automaticamente gli annunci con parametri di testo dinamico.

La lunghezza massima di input del titolo è di 80 caratteri e può contenere stringhe di testo dinamiche. L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza supera i 25 caratteri dopo la sostituzione dinamica del testo. Si noti che per i gruppi di annunci che usano il cinese tradizionale, il titolo è limitato a 15 caratteri dopo la sostituzione.

Il titolo non può contenere il carattere di nuova riga (\n).

Aggiungere: Non supportato
Aggiornare: Non supportato
corda

L'oggetto TextAd include elementi ereditati.

Elementi ereditati

Elementi ereditati da Ad

L'oggetto TextAd deriva dall'oggetto Ad ed eredita gli elementi seguenti: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Le descrizioni seguenti sono specifiche di TextAd e potrebbero non essere applicabili ad altri oggetti che ereditano gli stessi elementi dall'oggetto Ad .

Elemento Descrizione Tipo di dati
AdFormatPreference La preferenza per il formato degli annunci viene usata per indicare se preferisci o meno che la copia dell'annuncio venga visualizzata agli utenti come annuncio di ricerca o di pubblico. Gli annunci di ricerca tendono a essere scritti come un invito all'azione, mentre gli annunci del pubblico devono essere scritti in uno stile più informativo. Anche se hai la possibilità di usare gli annunci di testo di ricerca come annunci per il pubblico, la designazione di un annuncio come formato preferito per gli annunci audience ti consente di ottimizzare la messaggistica per la distribuzione nativa.

IMPORTANTE: Devi definire almeno un annuncio di testo per gruppo di annunci che non preferisce gli annunci del pubblico, altrimenti la copia dell'annuncio di tutti gli annunci di testo sarà idonea sia per gli annunci di ricerca che per gli annunci del pubblico.

I valori possibili sono AudienceAd e All. Se impostato su Tutto, l'annuncio sarà idoneo per i formati di annunci sia di ricerca che di pubblico. Se impostato su AudienceAd, l'annuncio sarà idoneo solo per il formato degli annunci del pubblico.

Aggiungere: Non supportato
Aggiornare: Non supportato
corda
DevicePreference Questo elemento determina se la preferenza è per gli annunci di testo da visualizzare nei dispositivi mobili o in tutti i dispositivi.

Per specificare una preferenza per i dispositivi mobili, impostare questo elemento su 30001.

Per specificare tutti i dispositivi, impostare questo elemento su 0 (zero) o lasciare l'elemento nil. Per impostazione predefinita, questo elemento sarà nil. Devi definire almeno un annuncio di testo per gruppo di annunci non preferito per dispositivi mobili, altrimenti l'annuncio sarà idoneo per tutti i dispositivi.

Aggiungere: Non supportato
Aggiornare: Non supportato
long
EditorialStatus Lo stato di revisione editoriale dell'annuncio, che indica se l'annuncio è in sospeso, è stato approvato o non è stato approvato.

Aggiungere: Non supportato
Aggiornare: Non supportato
AdEditorialStatus
FinalAppUrls Non supportato per gli annunci di testo. Matrice AppUrl
FinalMobileUrls URL della pagina di destinazione per dispositivi mobili.

Questo URL viene usato solo se la parola chiave non specifica un URL per dispositivi mobili finale.

Le regole di convalida seguenti si applicano agli URL finali e agli URL finali per dispositivi mobili.
- La lunghezza dell'URL è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri.
- È possibile specificare fino a 10 elementi sia per FinalUrls che per FinalMobileUrls; tuttavia, per il recapito viene usato solo il primo elemento di ogni elenco. Il servizio consente fino a 10 per una potenziale compatibilità in avanti.
- L'utilizzo di '{' e '}' è consentito solo per delineare i tag, ad esempio {lpurl}.
- Gli URL finali devono essere ognuno un URL ben formato che inizia con http:// o https://.
- Se si specifica FinalMobileUrls, è necessario specificare anche FinalUrls.
- Non è possibile specificare FinalMobileUrls se la preferenza del dispositivo è impostata su mobile. Si noti inoltre che per gli oggetti TextAd non è possibile specificare FinalMobileUrls se DevicePreference è impostato su 30001 (mobile).

Aggiungere: Non supportato
Aggiornare: Non supportato
matrice di stringhe
FinalUrls URL della pagina di destinazione.

Questo URL viene usato solo se la parola chiave non specifica un URL finale.

Le regole di convalida seguenti si applicano agli URL finali e agli URL finali per dispositivi mobili.
- La lunghezza dell'URL è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri.
- È possibile specificare fino a 10 elementi sia per FinalUrls che per FinalMobileUrls; tuttavia, per il recapito viene usato solo il primo elemento di ogni elenco. Il servizio consente fino a 10 per una potenziale compatibilità in avanti.
- L'utilizzo di '{' e '}' è consentito solo per delineare i tag, ad esempio {lpurl}.
- Gli URL finali devono essere ognuno un URL ben formato che inizia con http:// o https://.
- Se si specifica FinalMobileUrls, è necessario specificare anche FinalUrls.
- Non è possibile specificare FinalMobileUrls se la preferenza del dispositivo è impostata su mobile. Si noti anche che se l'elemento TrackingUrlTemplate o UrlCustomParameters di questo annuncio è impostato, è necessario almeno un URL finale.

Aggiungere: Non supportato
Aggiornare: Non supportato
matrice di stringhe
FinalUrlSuffix Non supportato per gli annunci di testo. corda
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.

Le modifiche di compatibilità forward verranno annotate qui nelle versioni future. Attualmente non sono presenti modifiche di compatibilità per questo oggetto.
Matrice KeyValuePairOfstringstring
Id Identificatore univoco di Microsoft Advertising per l'annuncio.

Aggiungere: Non supportato
Aggiornare: Obbligatorio e di sola lettura
long
Stato Stato dell'annuncio.

Puoi impostare lo stato dell'annuncio su Attivo o In pausa.

Aggiungere: Non supportato
Aggiornare: Opzionale
AdStatus
TrackingUrlTemplate Modello di rilevamento da usare come impostazione predefinita per tutti gli URL della pagina di destinazione.

Le regole di convalida seguenti si applicano ai modelli di rilevamento. Per altre informazioni sui modelli e i parametri supportati, vedere l'articolo della Guida di Microsoft Advertising Quali parametri di rilevamento o URL è possibile usare?
- Modelli di rilevamento definiti per entità di livello inferiore, ad esempio gli annunci sostituiscono quelli impostati per le entità di livello superiore, ad esempio la campagna. Per altre informazioni, vedere Limiti delle entità.
- La lunghezza del modello di rilevamento è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri.
- Il modello di rilevamento deve essere un URL ben formato che inizia con uno dei seguenti: http://, https://, {lpurl} o {unescapedlpurl}.
- Microsoft Advertising non convalida l'esistenza di parametri personalizzati. Se si usano parametri personalizzati nel modello di rilevamento e non esistono, l'URL della pagina di destinazione includerà i segnaposto chiave e valore dei parametri personalizzati senza sostituzione. Ad esempio, se il modello di rilevamento non è https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} e {_season} o {_promocode} non sono definiti a livello di campagna, gruppo di annunci, criterio, parola chiave o annuncio, l'URL della pagina di destinazione sarà lo stesso.

Aggiungere: Non supportato
Aggiornare: Non supportato
corda
Tipo Tipo di annuncio. Questo valore è Testo quando recuperi un annuncio di testo. Per altre informazioni sui tipi di annunci, vedi Le osservazioni sull'oggetto ad data.

Aggiungere: Non supportato
Aggiornare: Non supportato
AdType
UrlCustomParameters Raccolta personalizzata di parametri chiave e valore per il rilevamento url.

Microsoft Advertising accetterà i primi 8 oggetti CustomParameter inclusi nell'oggetto CustomParameters e, se si includono più di 8 parametri personalizzati, verrà restituito un errore. Ogni CustomParameter include elementi Key e Value .

Aggiungere: Opzionale
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Impostare l'elemento UrlCustomParameters su null o vuoto per mantenere eventuali parametri personalizzati esistenti. Per rimuovere tutti i parametri personalizzati, impostare l'elemento Parameters dell'oggetto CustomParameters su null o vuoto. Per rimuovere un subset di parametri personalizzati, specificare i parametri personalizzati che si desidera mantenere nell'elemento Parameters dell'oggetto CustomParameters .
CustomParameters

Requisiti

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