Oggetto dati CallAdExtension - Campaign Management

Articolo
12/21/2023

Definisce un oggetto che specifica un numero di telefono click-to-call da includere in un annuncio di testo.

Puoi associare un'estensione dell'annuncio di chiamata alle campagne nell'account. Ogni entità (campagna) può essere associata a un'estensione dell'annuncio di chiamata.

Sintassi

<xs:complexType name="CallAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="CountryCode" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="IsCallOnly" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="IsCallTrackingEnabled" nillable="true" type="xs:boolean" />
        <xs:element minOccurs="0" name="PhoneNumber" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="RequireTollFreeTrackingNumber" nillable="true" type="xs:boolean" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementi

L'oggetto CallAdExtension include gli elementi seguenti: CountryCode, IsCallOnly, IsCallTrackingEnabled, PhoneNumber, RequireTollFreeTrackingNumber.

Elemento	Descrizione	Tipo di dati
CountryCode	Codice del paese in cui è registrato il numero di telefono. Il codice paese deve contenere un codice paese di 2 caratteri. I valori di codice paese supportati includono AR, AT, AU, BR, CA, CH, CL, CO, DE, DK, ES, FI, FR, GB, HK, ID, IE, IN, IT, MX, MY, NL, NZ, NO, PE, PH, SE, SG, TH, TW, US, VE e VN. Aggiungere: Obbligatorio Aggiornamento: Obbligatorio	Stringa
IsCallOnly	L'opzione per mostrare sia il tuo numero di telefono che il tuo sito web, o solo il tuo numero di telefono, alle persone che vedono i tuoi annunci su uno smartphone. È possibile visualizzare solo il numero di telefono se l'azienda richiede di comunicare con ogni cliente. Imposta questa proprietà su true se vuoi che l'estensione dell'annuncio mostri solo il numero di telefono senza un collegamento al tuo sito Web e in caso contrario, se vuoi che l'estensione dell'annuncio includa un collegamento al tuo sito Web oltre al numero di telefono impostato su false. Aggiungere: Opzionale. Se non specifichi questo elemento o lo lasci vuoto, verrà impostato il valore predefinito false e l'estensione dell'annuncio includerà un collegamento al tuo sito Web oltre al numero di telefono. Aggiornamento: Opzionale	Boolean
IsCallTrackingEnabled	Determina se il rilevamento delle chiamate è abilitato per l'estensione dell'annuncio di chiamata. Il rilevamento delle chiamate è supportato solo nel Stati Uniti e nel Regno Unito. Impostare questa proprietà su true per abilitare il rilevamento delle chiamate e impostarla in caso contrario su false. Aggiungere: Opzionale. Se non si specifica questo elemento o lo si lascia vuoto, verrà impostato il valore predefinito false . Aggiornamento: Opzionale	Boolean
Phonenumber	Numero di telefono selezionabile da includere nell'annuncio. Il numero di telefono può contenere un massimo di 35 caratteri e deve essere valido per il paese o l'area geografica specificati. Se la campagna include estensioni di annunci di chiamata e posizione, questo numero di telefono sostituirà il numero di telefono specificato nelle estensioni dell'annuncio di posizione. Si noti che il numero di telefono può essere riformattato. Ad esempio, se si imposta il numero di telefono su 4255551212, verrà riformattato su (425) 555-1212. Aggiungere: Obbligatorio Aggiornamento: Obbligatorio	Stringa
RequireTollFreeTrackingNumber	È possibile usare il proprio numero di telefono o un numero di telefono di inoltro di Microsoft Advertising. Un numero di telefono di inoltro di Microsoft Advertising è un numero di telefono univoco che viene instradato al numero di telefono dell'azienda. Con un numero di inoltro di Microsoft Advertising, puoi tenere traccia di tutte le chiamate dall'annuncio in modo da poter analizzare le prestazioni dell'annuncio. Questo elemento determina se è necessario creare un numero di telefono di inoltro di Microsoft Advertising gratuito per il rilevamento delle chiamate. Questo elemento può essere impostato solo se anche IsCallTrackingEnabled è true. Prima di agosto 2017, i client potevano impostare questa proprietà su true se è necessario creare un numero di telefono di inoltro di Microsoft Advertising per il rilevamento delle chiamate. Da agosto 2017, i client non possono più creare un nuovo numero di telefono per l'inoltro di Microsoft Advertising gratuito. Se si imposta questo valore true , l'operazione avrà esito positivo; tuttavia, non verrà creato un numero verde e quando recuperi l'estensione dell'annuncio di chiamata questa proprietà verrà impostata su false. Se è stato effettuato il provisioning di un numero di inoltro gratuito prima di agosto 2017, questa proprietà sarà vera se il numero è ancora attivo quando recuperi l'estensione dell'annuncio di chiamata. Aggiungere: Opzionale. Se non si specifica questo elemento o lo si lascia vuoto, verrà impostato il valore predefinito false . Aggiornamento: Opzionale	Boolean

L'oggetto CallAdExtension include elementi ereditati.

Elementi ereditati

Elementi ereditati da AdExtension

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

Requisiti

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

Condividi tramite