Condividi tramite

Oggetto dati parola chiave - Campaign Management

  • Articolo

Definisce una parola chiave.

Le parole chiave sono le parole o le frasi ricercate quando si cerca un prodotto o un servizio. Ad esempio, le parole chiave possono essere una delle seguenti:

  • Scarpe
  • Barche crociere vacanza
  • Lezioni di tennis a New York

Come illustrato in precedenza, una parola chiave può essere solo una singola parola, più parole o anche una frase. Nel contesto della pubblicità di ricerca, tutti questi sono semplicemente definiti come una parola chiave.

Importante

A partire da aprile 2021, non puoi impostare strategie di offerta per gruppi di annunci o parole chiave. Se tenti di impostare strategie di offerta per gruppi di annunci o parole chiave, la richiesta verrà ignorata senza errori. I gruppi di annunci e le parole chiave erediteranno la strategia di offerta della campagna.

Sintassi

<xs:complexType name="Keyword" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Bid" nillable="true" type="tns:Bid" />
    <xs:element minOccurs="0" name="BiddingScheme" nillable="true" type="tns:BiddingScheme" />
    <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:KeywordEditorialStatus" />
    <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
    <xs:element xmlns:q32="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q32:ArrayOfstring" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q33="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q33:ArrayOfstring" />
    <xs:element xmlns:q34="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q34:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="MatchType" nillable="true" type="tns:MatchType" />
    <xs:element minOccurs="0" name="Param1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Param2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Param3" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:KeywordStatus" />
    <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
  </xs:sequence>
</xs:complexType>

Elementi

L'oggetto Keyword include gli elementi seguenti: Bid, BiddingScheme, DestinationUrl, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, MatchType, Param1, Param2, Param3, Status, Text, TrackingUrlTemplate, UrlCustomParameters.

Elemento Descrizione Tipo di dati
Offerta L'importo massimo che vuoi pagare ogni volta che qualcuno fa clic sul tuo annuncio.

Fai offerte contro altri inserzionisti usando la stessa parola chiave, quindi, in generale, le offerte più elevate consentono di visualizzare il tuo annuncio in posizioni più desiderabili nella pagina dei risultati della ricerca.

Invece di usare l'offerta a livello di gruppo di annunci predefinito, puoi impostare offerte personalizzate per ogni parola chiave. Le offerte personalizzate per le parole chiave sostituiscono l'offerta predefinita del gruppo di annunci per tali parole chiave specifiche. Con le offerte personalizzate, puoi concentrare il tuo tempo e denaro sulle parole chiave più redditizie, ma dovrai dedicare più tempo alla gestione delle singole offerte.

Se l'offerta a livello di parola chiave non è impostata, viene usato il CpcBid del gruppo di annunci. Per altre informazioni, vedere Strategie di budget e offerte.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Per eliminare la parola chiave bid e usare l'offerta del tipo di corrispondenza predefinito AdGroup , impostare l'elemento Amount dell'oggetto Bid su Null.		 Offerta
BiddingScheme Tipo di strategia di offerta per la gestione delle offerte.

Per informazioni dettagliate sulle strategie di offerta supportate per tipo di campagna, vedere Strategie di budget e offerte.

NOTA: A partire da aprile 2021, non puoi impostare strategie di offerta per gruppi di annunci o parole chiave. Se tenti di impostare strategie di offerta per gruppi di annunci o parole chiave, la richiesta verrà ignorata senza errori. I gruppi di annunci e le parole chiave erediteranno la strategia di offerta della campagna.

Aggiungere: Opzionale. Se non si imposta questo elemento, per impostazione predefinita viene usato InheritFromParentBiddingScheme .
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.		 BiddingScheme
DestinationUrl URL della pagina Web a cui portare l'utente quando fa clic sull'annuncio. Se specificato, viene usato l'URL di destinazione della parola chiave. in caso contrario, viene usato l'URL di destinazione dell'annuncio.

Importante: A partire da novembre 2018 non è possibile aggiungere o aggiornare l'URL di destinazione della parola chiave. È invece possibile usare gli URL finali . Per altri dettagli, vedere Migrazione degli URL di destinazione delle parole chiave agli URL finali.

Aggiungere: Non consentito
Aggiornamento: Non consentito		 Stringa
EditorialStatus Stato della revisione editoriale della parola chiave, che indica se la parola chiave è in sospeso, è stata approvata o non è stata approvata.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura		 KeywordEditorialStatus
FinalAppUrls Parametro riservato per utilizzi futuri. Matrice AppUrl
FinalMobileUrls URL della pagina di destinazione per dispositivi mobili. Se specificato, viene usato l'URL per dispositivi mobili finale della parola chiave; in caso contrario, viene usato l'URL per dispositivi mobili finale dell'annuncio.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.		 matrice di stringhe
FinalUrls URL della pagina di destinazione. Se specificato, viene usato l'URL finale della parola chiave. in caso contrario, viene usato l'URL finale dell'annuncio.

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 se gli elementi TrackingUrlTemplate o UrlCustomParameters sono impostati, è necessario almeno un URL finale. Per altre informazioni, vedere Rilevamento url con URL aggiornati.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.		 matrice di stringhe
FinalUrlSuffix Il suffisso URL finale può includere parametri di rilevamento che verranno aggiunti alla fine dell'URL della pagina di destinazione. È consigliabile inserire parametri di rilevamento richiesti dalla pagina di destinazione in un suffisso URL finale in modo che i clienti vengano sempre inviati alla pagina di destinazione. Per altri dettagli e regole di convalida, vedere Suffisso URL finale nelle guide tecniche.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su una stringa vuota ("",), l'impostazione precedente verrà eliminata.		 Stringa
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 generato dal sistema della parola chiave .

Aggiungere: Sola lettura
Aggiornamento: Obbligatorio		 long
Matchtype Tipo di corrispondenza per confrontare la parola chiave e il termine di ricerca dell'utente.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.		 Matchtype
Param1 Stringa da usare come valore di sostituzione in un annuncio se il titolo, il testo, l'URL visualizzato o l'URL di destinazione dell'annuncio contiene la stringa di sostituzione dinamica {Param1}.

Sebbene sia possibile usare {Param1} per specificare l'URL di destinazione di un annuncio, è consigliabile non usarlo. È invece necessario impostare l'elemento DestinationUrl della parola chiave.

La stringa può contenere un massimo di 1.022 caratteri. Il limite effettivo dipende dalla lunghezza dell'elemento che fa riferimento alla stringa di sostituzione. Ad esempio, la lunghezza del titolo di un annuncio di testo può contenere un massimo di 25 caratteri.

Quando si implementa testo dinamico nella copia dell'annuncio, è necessario specificare una stringa predefinita, ad esempio {Param1:default}, che verrà usata dal sistema se Param1 per una parola chiave è null o vuota oppure se l'inclusione del valore di sostituzione Param1 causerà il superamento del limite dell'elemento da parte della stringa espansa; in caso contrario, l'annuncio non verrà pubblicato con questa parola chiave. Per altre informazioni, vedi l'articolo della Guida di Microsoft Advertising Personalizza automaticamente gli annunci con parametri di testo dinamico.

Si noti inoltre che se il gruppo di annunci ha un solo annuncio e se l'annuncio usa {Param1} ma non fornisce una stringa predefinita, ad esempio {Param1:default}, devi fornire un valore Param1 valido per tale sostituzione. In caso contrario, questa parola chiave non può essere aggiunta o aggiornata.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su una stringa vuota ("",), l'impostazione precedente verrà eliminata.		 Stringa
Param2 Stringa da usare come valore di sostituzione in un annuncio se il titolo, il testo, l'URL visualizzato o l'URL di destinazione contiene la stringa di sostituzione dinamica {Param2}.

In genere, usa la stringa di sostituzione {Param2} negli elementi titolo o testo (descrizione della copia pubblicitaria) di un annuncio.

La stringa può contenere un massimo di 70 caratteri. Il limite effettivo dipende dalla lunghezza dell'elemento che fa riferimento alla stringa di sostituzione. Ad esempio, la lunghezza del titolo di un annuncio di testo può contenere un massimo di 25 caratteri.

Quando si implementa il testo dinamico nella copia dell'annuncio, è necessario specificare una stringa predefinita, ad esempio {Param2:default}, che verrà usata dal sistema se Param2 per una parola chiave è null o vuota oppure se l'inclusione del valore di sostituzione Param2 causerà il superamento del limite dell'elemento da parte della stringa espansa; in caso contrario, l'annuncio non verrà pubblicato con questa parola chiave. Per altre informazioni, vedi l'articolo della Guida di Microsoft Advertising Personalizza automaticamente gli annunci con parametri di testo dinamico.

Si noti inoltre che se il gruppo di annunci ha un solo annuncio e se l'annuncio usa {Param2} ma non fornisce una stringa predefinita, ad esempio {Param2:default}, devi fornire un valore Param2 valido per tale sostituzione. In caso contrario, questa parola chiave non può essere aggiunta o aggiornata.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su una stringa vuota ("",), l'impostazione precedente verrà eliminata.		 Stringa
Param3 Stringa da usare come valore di sostituzione in un annuncio se il titolo, il testo, l'URL visualizzato o l'URL di destinazione contiene la stringa di sostituzione dinamica {Param3}.

In genere, usa la stringa di sostituzione {Param3} negli elementi titolo o testo (descrizione della copia pubblicitaria) di un annuncio.

La stringa può contenere un massimo di 70 caratteri. Il limite effettivo dipende dalla lunghezza dell'elemento che fa riferimento alla stringa di sostituzione. Ad esempio, la lunghezza del titolo di un annuncio di testo può contenere un massimo di 25 caratteri.

Quando si implementa testo dinamico nella copia dell'annuncio, è necessario specificare una stringa predefinita, ad esempio {Param3:default}, che verrà usata dal sistema se Param3 per una parola chiave è null o vuota oppure se l'inclusione del valore di sostituzione Param3 causerà il superamento del limite dell'elemento da parte della stringa espansa; in caso contrario, l'annuncio non verrà pubblicato con questa parola chiave. Per altre informazioni, vedi l'articolo della Guida di Microsoft Advertising Personalizza automaticamente gli annunci con parametri di testo dinamico.

Si noti inoltre che se il gruppo di annunci ha un solo annuncio e se l'annuncio usa {Param3} ma non fornisce una stringa predefinita, ad esempio {Param3:default}, è necessario fornire un valore Param3 valido per tale sostituzione. In caso contrario, questa parola chiave non può essere aggiunta o aggiornata.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su una stringa vuota ("",), l'impostazione precedente verrà eliminata.		 Stringa
Stato Stato della parola chiave. Per impostazione predefinita, lo stato è impostato su Attivo.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.		 KeywordStatus
Testo Testo della parola chiave. Il testo può contenere un massimo di 100 caratteri. Devi specificare la parola chiave nelle impostazioni locali del valore Language specificato per il gruppo di annunci a cui appartiene la parola chiave.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura		 Stringa
TrackingUrlTemplate Modello di rilevamento da usare come impostazione predefinita per tutti gli FinalUrl e FinalMobileUrls.

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: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su una stringa vuota ("",), l'impostazione precedente verrà eliminata.		 Stringa
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
Aggiornamento: 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

Usato da

AddKeywords
GetKeywordsByAdGroupId
GetKeywordsByEditorialStatus
GetKeywordsByIds
UpdateKeywords