Oggetto dati DynamicSearchAd - Gestione campagna

Articolo
11/13/2024

Definisce un annuncio di ricerca dinamica.

Con gli annunci di ricerca dinamica, il titolo e l'URL di visualizzazione vengono generati automaticamente in base al dominio del sito Web e alla lingua di destinazione. La combinazione degli elementi Path1, Path2 e Text rende univoco l'annuncio di ricerca dinamica. Facoltativamente, è possibile fornire un titolo statico usando i feed di pagina.

Nota

Questa funzionalità è attualmente disponibile nei seguenti paesi o aree geografiche: Albania (AL), Andorra (AD), Argentina (AR), Aruba, Australia (AU), Austria (AT), Bahamas (BS), Bangladesh(BD), Belgio (BE), Bolivia(BO), Bosnia ed Erzegovina (BA), Brasile (BR), Brunei(BN), Bulgaria (BG), Canada (CA), Isole Cayman(KY), Cile(CL), Colombia(CO), Costa Rica(CR), Croazia (HR), Cipro (CY), Repubblica Ceca (CZ), Danimarca (DK), Dominica (DM), Repubblica Dominicana (DO), Ecuador(EC), El Salvador(SV), Estonia (EE), Figi (FJ), Finlandia (FI), Francia (FR), Guyana francese (GF), Polinesia francese (PF), Germania (DE), Grecia (GR), Guam (GU), Guatemala (GT), Guyana (GY), Haiti (HT), Honduras (HN), Ungheria (HU), Islanda (IS), India (IN), Indonesia (ID), Irlanda (IE), Italia (IT), Lettonia (LV), Liechtenstein (LI), Lituania (LT), Lussemburgo (LU), Malaysia (MY), Maldive (MV), Malta (MT), Martinica (MQ), Messico (MX), Monaco (MC), Mongolia (MN), Montenegro (ME), Montserrat (MS), Nepal (NP), Paesi Bassi (NL), Nuova Caledonia (NC), Nuova Zelanda (NZ), Repubblica di Macedonia del Nord (MK), Norvegia (NO), Panama (PA), Paraguay (PY), Papua Nuova Guinea (PG), Perù (PE), Filippine (PH), Polonia (PO), Portogallo (PT), Portorico, Romania (RO), San Marino (SM), Serbia (RS), Singapore(SG), Slovacchia (SK), Slovenia (SI), Sudafrica (ZA), Spagna (ES), Spagna(ES), Sri Lanka(LK), Svezia (SE), Svizzera (CH), Thailandia (TH), Trinidad e Tobago(TT), Turchia (TR), Città del Vaticano (VA), Vietnam (VN), Regno Unito (Regno Unito), Stati Uniti (STATI Uniti), Uruguay (UY) e Venezuela(VE).

Gli annunci di ricerca dinamica possono essere creati solo all'interno di campagne di ricerca con DynamicSearchAdsSetting. L'elemento ExperimentId della campagna non può essere impostato e AdGroupType deve essere impostato su "SearchDynamic".

Nota

Non è più possibile aggiungere, aggiornare o recuperare campagne che supportano solo gli annunci di ricerca dinamica. Il tipo di campagna delle campagne esistenti è stato aggiornato da "DynamicSearchAds" a "Search". I gruppi di annunci sono ora considerati gruppi di annunci "dinamici", ma non ci sono modifiche strutturali, ad esempio contengono gli stessi obiettivi automatici e gli annunci di ricerca dinamica di prima.

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

{
  "AdFormatPreference": "ValueHere",
  "DevicePreference": "LongValueHere",
  "EditorialStatus": "ValueHere",
  "FinalAppUrls": [
    {
      "OsType": "ValueHere",
      "Url": "ValueHere"
    }
  ],
  "FinalMobileUrls": [
    "ValueHere"
  ],
  "FinalUrls": [
    "ValueHere"
  ],
  "FinalUrlSuffix": "ValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Status": "ValueHere",
  "TrackingUrlTemplate": "ValueHere",
  "Type": "DynamicSearch",
  "UrlCustomParameters": {
    "Parameters": [
      {
        "Key": "ValueHere",
        "Value": "ValueHere"
      }
    ]
  },
  "Path1": "ValueHere",
  "Path2": "ValueHere",
  "Text": "ValueHere",
  "TextPart2": "ValueHere"
}

Elementi

L'oggetto DynamicSearchAd include gli elementi seguenti: Path1, Path2, Text, TextPart2.

Elemento	Descrizione	Tipo di dati
Percorso1	La prima parte del percorso facoltativo che verrà aggiunta alla parte di dominio dell'URL visualizzato. L'URL di visualizzazione, ad esempio www.contoso.com , verrà generato dal dominio dell'URL visualizzato. Quindi, se è stato specificato un valore per Path 1 , verrà aggiunto all'URL di visualizzazione. Se è stato specificato anche un valore per Path 2, verrà aggiunto anche all'URL di visualizzazione dopo Path 1. Ad esempio, se il dominio è contoso.com, path 1 è impostato su subdirectory1 e Path 2 è impostato su subdirectory2, l'URL visualizzato verrà www.contoso.com/subdirectory1/subdirectory2. La lunghezza massima di input del percorso è di 15 caratteri. Si noti che per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale, la lunghezza massima di input del percorso è di 7 caratteri. Il percorso può contenere funzioni IF e countdown . Indipendentemente dalla lunghezza totale di tutti i parametri del conto alla rovescia non sostitutivi, il conto alla rovescia visualizzato finale userà sempre 8 caratteri dei caratteri totali disponibili. Per altri dettagli, vedere Personalizzazione del conto alla rovescia. Il percorso non può contenere i caratteri barra (/) o nuova riga (\n). Se il percorso include uno spazio, verrà sostituito con un carattere di sottolineatura (_) quando viene visualizzato l'annuncio. Aggiungere: Opzionale Aggiornare: Opzionale	corda
Percorso2	La seconda parte del percorso facoltativo che verrà aggiunta alla parte del dominio dell'URL visualizzato. L'URL visualizzato, ad esempio www.contoso.com verrà generato dal dominio delle impostazioni a livello di campagna degli annunci di ricerca dinamica. Quindi, se è stato specificato un valore per Path 1 , verrà aggiunto all'URL di visualizzazione. Se è stato specificato anche un valore per Path 2, verrà aggiunto anche all'URL di visualizzazione dopo Path 1. Ad esempio, se il dominio è contoso.com, path 1 è impostato su subdirectory1 e Path 2 è impostato su subdirectory2, l'URL visualizzato verrà www.contoso.com/subdirectory1/subdirectory2. È possibile specificare Path2 solo se è impostato anche Path1 . La lunghezza massima di input del percorso è di 15 caratteri. Si noti che per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale, la lunghezza massima di input del percorso è di 7 caratteri. Il percorso può contenere funzioni IF e countdown . Indipendentemente dalla lunghezza totale di tutti i parametri del conto alla rovescia non sostitutivi, il conto alla rovescia visualizzato finale userà sempre 8 caratteri dei caratteri totali disponibili. Per altri dettagli, vedere Personalizzazione del conto alla rovescia. Il percorso non può contenere i caratteri barra (/) o nuova riga (\n). Se il percorso include uno spazio, verrà sostituito con un carattere di sottolineatura (_) quando viene visualizzato l'annuncio. Aggiungere: Opzionale Aggiornare: Opzionale	corda
Testo	La prima parte della descrizione dell'annuncio. Il testo deve contenere almeno una parola. La lunghezza massima di input della copia è di 90 caratteri. Si noti che per i gruppi di annunci che usano il cinese tradizionale la lunghezza di input massima della copia è di 45 caratteri. Il testo può contenere funzioni IF e countdown . Indipendentemente dalla lunghezza totale di tutti i parametri del conto alla rovescia non sostitutivi, il conto alla rovescia visualizzato finale userà sempre 8 caratteri dei caratteri totali disponibili. Per altri dettagli, vedere Personalizzazione del conto alla rovescia. Il testo non può contenere il carattere di nuova riga (\n). Aggiungere: Obbligatorio Aggiornare: Opzionale	corda
TextPart2	Seconda parte della descrizione dell'annuncio. Il testo deve contenere almeno una parola. La lunghezza massima di input della copia è di 90 caratteri. Si noti che per i gruppi di annunci che usano il cinese tradizionale la lunghezza di input massima della copia è di 45 caratteri. Il testo può contenere funzioni IF e countdown . Indipendentemente dalla lunghezza totale di tutti i parametri del conto alla rovescia non sostitutivi, il conto alla rovescia visualizzato finale userà sempre 8 caratteri dei caratteri totali disponibili. Per altri dettagli, vedere Personalizzazione del conto alla rovescia. Il testo non può contenere il carattere di nuova riga (\n). Aggiungere: Opzionale Aggiornare: Opzionale	corda

L'oggetto DynamicSearchAd include elementi ereditati.

Elementi ereditati

Elementi ereditati da Ad

L'oggetto DynamicSearchAd 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 DynamicSearchAd e potrebbero non essere applicabili ad altri oggetti che ereditano gli stessi elementi dall'oggetto Ad .

Elemento	Descrizione	Tipo di dati
AdFormatPreference	Non supportato per questo tipo di annuncio.	corda
DevicePreference	Non supportato per questo tipo di annuncio.	long
EditorialStatus	Lo stato di revisione editoriale dell'annuncio, che indica se l'annuncio è in sospeso, è stato approvato o non è stato approvato. Aggiungere: Sola lettura Aggiornare: Sola lettura	AdEditorialStatus
FinalAppUrls	Non supportato per questo tipo di annuncio.	Matrice AppUrl
FinalMobileUrls	Non supportato per questo tipo di annuncio.	matrice di stringhe
FinalUrls	Non supportato per questo tipo di annuncio.	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 Aggiornare: 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.	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. Attualmente non sono supportate coppie chiave e valore per la mappa di compatibilità per gli annunci di ricerca dinamica.	Matrice KeyValuePairOfstringstring
Id	Identificatore univoco di Microsoft Advertising dell'annuncio. Aggiungere: Sola lettura Aggiornare: Obbligatorio e Read-Only	long
Stato	Stato dell'annuncio. Puoi impostare lo stato dell'annuncio su Attivo o In pausa. Aggiungere: Opzionale 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: Opzionale Aggiornare: 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.	corda
Tipo	Tipo di annuncio. Questo valore è DynamicSearch quando si recupera un annuncio di ricerca dinamica. Per altre informazioni sui tipi di annunci, vedi Le osservazioni sull'oggetto ad data. Aggiungere: Sola lettura Aggiornare: Sola lettura	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

Condividi tramite