Oggetto dati ResponsiveSearchAd - Gestione campagna

Articolo
11/14/2024

Formato di annuncio reattivo per gli annunci di testo nella rete di ricerca.

Nota

Gli annunci di ricerca reattivi duplicati sono consentiti nello stesso gruppo di annunci.

Gli annunci di ricerca reattivi consentono di impostare tra 3-15 titoli pubblicitari univoci (ad esempio "titoli") e descrizioni di annunci da 2 a 4 all'interno di un singolo annuncio. Da qui, Bing selezionerà la combinazione di titolo e descrizione più rilevante per ogni query specificata e l'utente di ricerca corrispondente. Consentendo a Bing AI di selezionare il titolo e la descrizione più rilevanti per ogni query, ci assicuriamo che il messaggio giusto atterra per ognuno dei potenziali clienti, al momento giusto, attraverso tutti i possibili segnali di finalità.

Gli annunci reattivi visualizzati agli utenti appaiono identici agli annunci di testo espansi, ad esempio fino a 3 titoli (parti del titolo tramite annunci di testo espansi) e 2 descrizioni (parti di testo tramite annunci di testo espansi). Per ottimizzare le impressioni in tutti i formati degli annunci, le descrizioni potrebbero non essere sempre visualizzate nell'annuncio.

Quando crei annunci di ricerca reattivi, gli elenchi Descrizioni e Titoli vengono archiviati come asset di testo che possono essere condivisi da qualsiasi annuncio di ricerca reattivo all'interno dell'account. Ad esempio, se "Seamless Integration" è un asset di testo, si noterà che ha lo stesso identificatore di asset in tutti gli annunci che si collegano a "Seamless Integration" nello stesso account Microsoft Advertising. Gli identificatori di asset non sono inclusi nella risposta AddAds o UpdateAds . Con il servizio Campaign Management, l'unico modo per ottenere gli identificatori di asset consiste nel recuperare gli annunci creati. È possibile ottenere gli identificatori di asset per descrizioni e titoli recuperando gli annunci in una chiamata al servizio successiva, ad esempio tramite GetAdsByAdGroupId. Con il servizio bulk gli identificatori di asset sono inclusi nel file dei risultati del caricamento bulk.

Nota

Gli annunci di ricerca reattivi possono essere creati solo nelle campagne di ricerca in cui AdGroupType è impostato su "SearchStandard". Se AdGroupType è impostato su "SearchDynamic", il gruppo di annunci non supporta gli annunci di ricerca reattivi.

<xs:complexType name="ResponsiveSearchAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Domain" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
        <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path2" 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": "ResponsiveSearch",
  "UrlCustomParameters": {
    "Parameters": [
      {
        "Key": "ValueHere",
        "Value": "ValueHere"
      }
    ]
  },
  "Descriptions": [
    {
      "Asset": {
        "Id": "LongValueHere",
        "Name": "ValueHere",
        "Type": "ImageAsset",
        "CropHeight": IntValueHere,
        "CropWidth": IntValueHere,
        "CropX": IntValueHere,
        "CropY": IntValueHere,
        "SubType": "ValueHere",
        "TargetHeight": IntValueHere,
        "TargetWidth": IntValueHere
      },
      "AssetPerformanceLabel": "ValueHere",
      "EditorialStatus": "ValueHere",
      "PinnedField": "ValueHere"
    }
  ],
  "Domain": "ValueHere",
  "Headlines": [
    {
      "Asset": {
        "Id": "LongValueHere",
        "Name": "ValueHere",
        "Type": "ImageAsset",
        "CropHeight": IntValueHere,
        "CropWidth": IntValueHere,
        "CropX": IntValueHere,
        "CropY": IntValueHere,
        "SubType": "ValueHere",
        "TargetHeight": IntValueHere,
        "TargetWidth": IntValueHere
      },
      "AssetPerformanceLabel": "ValueHere",
      "EditorialStatus": "ValueHere",
      "PinnedField": "ValueHere"
    }
  ],
  "Path1": "ValueHere",
  "Path2": "ValueHere"
}

Elementi

L'oggetto ResponsiveSearchAd include gli elementi seguenti: Descriptions, Domain, Headlines, Path1, Path2.

Elemento	Descrizione	Tipo di dati
Descrizioni	Elenco di descrizioni che Bing può usare per ottimizzare il layout degli annunci. Per ottimizzare le impressioni in tutti i formati degli annunci, le descrizioni potrebbero non essere sempre visualizzate nell'annuncio. A meno che non si apporti una delle descrizioni a una posizione specifica, Bing ottimizzi dinamicamente il layout degli annunci con i titoli e le descrizioni migliori per la query di ricerca dell'utente. Dal punto di vista del modello di dati, le desriptions e i titoli vengono archiviati come asset di testo, ad esempio un TextAsset per AssetLink. Lo stesso asset può essere usato da più annunci. Ad esempio, se "Seamless Integration" è un asset di testo, avrà lo stesso identificatore di asset in tutti gli annunci nello stesso account Microsoft Advertising. È necessario impostare tra 2 e 4 descrizioni. Il testo di ogni descrizione deve contenere almeno una parola. Per un uso efficiente delle risorse, è consigliabile usare stringhe di testo dinamico come {keyword} invece di creare una nuova copia pubblicitaria per ogni parola chiave. 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 testo di ogni descrizione è di 1.000 caratteri, incluse le stringhe di testo dinamiche, e di questi 1.000 non sono consentiti più di 90 caratteri finali dopo la sostituzione. L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza supera i 90 caratteri dopo la sostituzione dinamica del testo. Per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale, la lunghezza massima di input è di 500 caratteri, incluse le stringhe di testo dinamiche, e di questi 500 non sono consentiti più di 45 caratteri finali dopo la sostituzione. L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza supera i 45 caratteri dopo la sostituzione dinamica del testo. I caratteri a larghezza doppia sono determinati dai caratteri usati anziché dal set di caratteri delle impostazioni della lingua della campagna o del gruppo di annunci. I caratteri a doppia larghezza includono i caratteri delle lingue coreano, giapponese e cinese, nonché emoji. Il testo non può contenere il carattere di nuova riga (\n). Il testo può contenere funzioni IF . Aggiungere: Obbligatorio Aggiornare: Opzionale. Per conservare tutti i collegamenti di asset esistenti, impostare o lasciare l'elemento nil. Se imposti questo elemento, tutte le descrizioni precedentemente collegate a questo annuncio verranno sostituite.	Matrice AssetLink
Dominio	URL che verrà visualizzato anziché l'URL finale. L'URL finale verrà comunque usato per l'URL della pagina di destinazione. Riservato per un utilizzo pilota limitato, ad esempio clienti farmaceutici. La parte di dominio dell'URL in combinazione con le stringhe path 1 e path 2 non può superare i 67 caratteri. 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
Titoli	Elenco di titoli di annunci che Bing può usare per ottimizzare il layout degli annunci. A meno che non si apporti uno dei titoli a una posizione specifica, Bing ottimizzi dinamicamente il layout degli annunci con i titoli e le descrizioni migliori per la query di ricerca dell'utente. Dal punto di vista del modello di dati, le desriptions e i titoli vengono archiviati come asset di testo, ad esempio un TextAsset per AssetLink. Lo stesso asset può essere usato da più annunci. Ad esempio, se "Seamless Integration" è un asset di testo, avrà lo stesso identificatore di asset in tutti gli annunci nello stesso account Microsoft Advertising. È necessario impostare tra 3 e 15 titoli. Il testo di ogni titolo deve contenere almeno una parola. Per un uso efficiente delle risorse, è consigliabile usare stringhe di testo dinamico come {keyword} invece di creare una nuova copia pubblicitaria per ogni parola chiave. 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 testo di ogni titolo è di 1.000 caratteri, incluse le stringhe di testo dinamiche, e di questi 1.000 non sono consentiti più di 30 caratteri finali dopo la sostituzione. L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza supera i 30 caratteri dopo la sostituzione dinamica del testo. Per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale, la lunghezza massima di input è di 500 caratteri, incluse le stringhe di testo dinamiche, e di questi 500 non sono consentiti più di 15 caratteri finali dopo la sostituzione. L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza supera i 15 caratteri dopo la sostituzione dinamica del testo. I caratteri a larghezza doppia sono determinati dai caratteri usati anziché dal set di caratteri delle impostazioni della lingua della campagna o del gruppo di annunci. I caratteri a doppia larghezza includono i caratteri delle lingue coreano, giapponese e cinese, nonché emoji. Il testo non può contenere il carattere di nuova riga (\n). Il testo può contenere funzioni IF . Aggiungere: Obbligatorio Aggiornare: Opzionale. Per conservare tutti i collegamenti di asset esistenti, impostare o lasciare l'elemento nil. Se imposti questo elemento, tutti i titoli precedentemente collegati a questo annuncio verranno sostituiti.	Matrice AssetLink
Percorso1	La prima parte del percorso facoltativo che verrà aggiunta alla parte di dominio dell'URL visualizzato. La parte del dominio dell'URL visualizzato, ad esempio https://www.contoso.com , verrà generata dal dominio dell'URL finale (elemento FinalUrls ). Quindi, se è stato specificato un valore per Path1 , verrà aggiunto all'URL di visualizzazione. Se è stato specificato anche un valore per Path2, verrà aggiunto anche all'URL di visualizzazione dopo Path1. Ad esempio, se FinalUrls contiene https://www.contoso.com, Path1 è impostato su subdirectory1 e Path2 è impostato su subdirectory2, l'URL visualizzato sarà https://www.contoso.com/subdirectory1/subdirectory2. Il percorso 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?. La lunghezza massima di input è di 1.000 caratteri se si includono stringhe di testo dinamiche. Non è possibile immettere più di 15 caratteri finali (non di testo dinamico). L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza del dominio URL finale e dei percorsi combinati supera i 67 caratteri. Per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale, la lunghezza massima di input è di 1.000 caratteri se si includono stringhe di testo dinamiche. Non è possibile inserire più di 7 caratteri finali (non di testo dinamico). L'annuncio non verrà visualizzato o verrà usato il testo predefinito se la lunghezza del dominio URL finale e i percorsi combinati superano i 33 caratteri. I caratteri a larghezza doppia sono determinati dai caratteri usati anziché dal set di caratteri delle impostazioni della lingua della campagna o del gruppo di annunci. I caratteri a doppia larghezza includono i caratteri delle lingue coreano, giapponese e cinese, nonché emoji. 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. Il percorso può contenere funzioni IF . 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
Percorso2	La seconda parte del percorso facoltativo che verrà aggiunta alla parte del dominio dell'URL visualizzato. La parte del dominio dell'URL visualizzato, ad esempio https://www.contoso.com , verrà generata dal dominio dell'URL finale (elemento FinalUrls ). Quindi, se è stato specificato un valore per Path1 , verrà aggiunto all'URL di visualizzazione. Se è stato specificato anche un valore per Path2, verrà aggiunto anche all'URL di visualizzazione dopo Path1. Ad esempio, se FinalUrls contiene https://www.contoso.com, Path1 è impostato su subdirectory1 e Path2 è impostato su subdirectory2, l'URL visualizzato sarà https://www.contoso.com/subdirectory1/subdirectory2. È possibile specificare Path2 solo se è impostato anche Path1 . Il percorso 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?. La lunghezza massima di input è di 1.000 caratteri se si includono stringhe di testo dinamiche. Non è possibile immettere più di 15 caratteri finali (non di testo dinamico). L'annuncio non verrà visualizzato o il testo predefinito verrà usato se la lunghezza del dominio URL finale e dei percorsi combinati supera i 67 caratteri. Per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale, la lunghezza massima di input è di 1.000 caratteri se si includono stringhe di testo dinamiche. Non è possibile inserire più di 7 caratteri finali (non di testo dinamico). L'annuncio non verrà visualizzato o verrà usato il testo predefinito se la lunghezza del dominio URL finale e i percorsi combinati superano i 33 caratteri. I caratteri a larghezza doppia sono determinati dai caratteri usati anziché dal set di caratteri delle impostazioni della lingua della campagna o del gruppo di annunci. I caratteri a doppia larghezza includono i caratteri delle lingue coreano, giapponese e cinese, nonché emoji. 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. Il percorso può contenere funzioni IF . 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

L'oggetto ResponsiveSearchAd include elementi ereditati.

Elementi ereditati

Elementi ereditati da Ad

L'oggetto ResponsiveSearchAd 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 ResponsiveSearchAd 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	URL della pagina di destinazione per dispositivi mobili. 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. Questo URL viene usato solo se la parola chiave non specifica un URL per dispositivi mobili finale. Aggiungere: Opzionale Aggiornare: Opzionale	matrice di stringhe
FinalUrls	URL della pagina di destinazione. La parte di dominio dell'URL in combinazione con le stringhe path 1 e path 2 non può superare i 67 caratteri. 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. Questo URL viene usato solo se la parola chiave non specifica un URL finale. Aggiungere: Obbligatorio Aggiornare: Opzionale	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. 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 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 è ResponsiveSearch quando recuperi un annuncio di ricerca reattivo. 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

Usato da

CreateResponsiveSearchAdRecommendation
RefineResponsiveSearchAdRecommendation

Condividi tramite