Oggetto dati ActionAdExtension - Campaign Management

Articolo
11/14/2024

Definisce un'estensione dell'annuncio azione con un pulsante call-to-action.

Sintassi

XML
JSON

<xs:complexType name="ActionAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element name="ActionType" type="tns:ActionAdExtensionActionType" />
        <xs:element xmlns:q52="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q52:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q53="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q53:ArrayOfstring" />
        <xs:element minOccurs="0" name="Language" 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:extension>
  </xs:complexContent>
</xs:complexType>

{
  "DevicePreference": "LongValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "Scheduling": {
    "DayTimeRanges": [
      {
        "Day": "ValueHere",
        "EndHour": IntValueHere,
        "EndMinute": "ValueHere",
        "StartHour": IntValueHere,
        "StartMinute": "ValueHere"
      }
    ],
    "EndDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "StartDate": {
      "Day": IntValueHere,
      "Month": IntValueHere,
      "Year": IntValueHere
    },
    "UseSearcherTimeZone": "ValueHere"
  },
  "Status": "ValueHere",
  "Type": "ActionAdExtension",
  "Version": IntValueHere,
  "ActionType": "ValueHere",
  "FinalMobileUrls": [
    "ValueHere"
  ],
  "FinalUrls": [
    "ValueHere"
  ],
  "FinalUrlSuffix": "ValueHere",
  "Language": "ValueHere",
  "TrackingUrlTemplate": "ValueHere",
  "UrlCustomParameters": {
    "Parameters": [
      {
        "Key": "ValueHere",
        "Value": "ValueHere"
      }
    ]
  }
}

Elementi

L'oggetto ActionAdExtension include gli elementi seguenti: ActionType, FinalMobileUrls, FinalUrls, FinalUrlSuffix, Language, TrackingUrlTemplate, UrlCustomParameters.

Elemento	Descrizione	Tipo di dati
ActionType	Il tipo di azione scelto qui, nonché la lingua impostata, determina il testo visualizzato nel pulsante di chiamata all'azione. Microsoft Advertising non supporta tutti i tipi di azione per tutte le lingue. Se si tenta di usare un tipo di azione non supportato e una combinazione di lingua, verrà restituito un errore. Per informazioni dettagliate, vedere Testo azione per le estensioni dell'annuncio azione. Aggiungere: Obbligatorio Aggiornare: Obbligatorio	ActionAdExtensionActionType
FinalMobileUrls	Si tratta di un URL della pagina di destinazione ottimizzato per i dispositivi mobili quando vengono fornite estensioni di azione nei dispositivi mobili. Se si specificano gli URL finali per dispositivi mobili, è necessario specificare anche FinalUrls. 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. Aggiungere: Opzionale Aggiornare: Opzionale. Se si imposta questo elemento null, l'impostazione precedente verrà eliminata.	matrice di stringhe
FinalUrls	Si tratta del collegamento alla pagina Web o al modulo specifico che corrisponde al testo dell'azione. Quando non viene specificato un URL dell'azione, verrà usato l'URL finale dell'annuncio. 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. Anche se il tipo di dati è un elenco di stringhe, microsoft Advertising usa solo la prima voce di elenco. Aggiungere: Opzionale Aggiornare: Opzionale. Se si imposta questo elemento null, l'impostazione precedente verrà eliminata.	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. Questa funzionalità è disponibile solo per i clienti nel progetto pilota Final URL Suffix Phase 3 (GetCustomerPilotFeatures restituisce 636). Se non si è nel progetto pilota, questa proprietà verrà ignorata e non verrà restituito alcun errore. Aggiungere: Opzionale Aggiornare: Opzionale. Se si imposta questo elemento null, l'impostazione precedente verrà eliminata.	corda
Lingua	Lingua in cui verrà servita l'estensione dell'annuncio. L'estensione verrà sempre fornita in questa lingua, indipendentemente dalle impostazioni della lingua della campagna o del gruppo di annunci. Le stringhe di lingua supportate sono: danese, olandese, inglese, finlandese, francese, tedesco, italiano, norvegese, portoghese, spagnolo, svedese e tradizionaleChinese. Microsoft Advertising non supporta tutti i tipi di azione per tutte le lingue. Se si tenta di usare un tipo di azione non supportato e una combinazione di lingua, verrà restituito un errore. Per informazioni dettagliate, vedere Testo azione per le estensioni dell'annuncio azione. Aggiungere: Obbligatorio Aggiornare: Obbligatorio	corda
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 Aggiornare: Opzionale. Se si imposta questo elemento null, l'impostazione precedente verrà eliminata.	corda
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 . Per i clienti del progetto pilota Custom Parameters Limit Increase Phase 3 (GetCustomerPilotFeatures restituisce 635), Microsoft Advertising accetterà le prime 8 coppie di parametri personalizzati e valore incluse e, se si includono più di 8 parametri personalizzati, verrà restituito un errore. Aggiungere: Opzionale Aggiornare: Opzionale. Se si imposta questo elemento null, l'impostazione precedente verrà eliminata.	CustomParameters

L'oggetto ActionAdExtension include elementi ereditati.

Elementi ereditati

Elementi ereditati da AdExtension

L'oggetto ActionAdExtension deriva dall'oggetto AdExtension e eredita gli elementi seguenti: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Le descrizioni seguenti sono specifiche di ActionAdExtension 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 Aggiornare: Sola lettura	Matrice KeyValuePairOfstringstring
Id	Identificatore univoco di Microsoft Advertising dell'estensione dell'annuncio. Aggiungere: Sola lettura Aggiornare: 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 Aggiornare: 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 Aggiornare: Sola lettura	AdExtensionStatus
Tipo	Tipo di estensione dell'annuncio. Questo valore è ActionAdExtension quando recuperi un'estensione dell'annuncio azione. Aggiungere: Sola lettura Aggiornare: Sola lettura Per altre informazioni sui tipi di estensione degli annunci, vedi le osservazioni sull'oggetto dati dell'estensione per gli annunci.	corda
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 Aggiornare: Non consentito	int

Requisiti

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

Condividi tramite