Oggetto dati CalloutAdExtension - Campaign Management

Articolo
11/14/2024

Definisce un oggetto che specifica testo aggiuntivo sull'azienda, i prodotti o i servizi da includere in un annuncio di testo.

Puoi associare un'estensione dell'annuncio dell'app all'account o alle campagne e ai gruppi di annunci nell'account. Devi associare tra 2 e 20 estensioni di annunci callout per entità (account, campagna o gruppo di annunci). Se associ una o meno estensioni callout al tuo account, campagna o gruppo di annunci, non verrà visualizzato alcun testo di callout con il tuo annuncio. Un annuncio può includere da 2 a 4 callout per impression.

Le estensioni pubblicitarie associate a livello di gruppo di annunci sostituiscono le estensioni pubblicitarie dello stesso tipo associate a livello di campagna. Ad esempio, se sono impostate 2 estensioni callout per Campaign A, zero estensioni callout associate ad Ad Group AA e un'estensione callout associata ad Ad Group AB, solo Ad Group AA è idonea per gli annunci di testo decorati con callout.

<xs:complexType name="CalloutAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
      </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": "CalloutAdExtension",
  "Version": IntValueHere,
  "Text": "ValueHere"
}

Elementi

L'oggetto CalloutAdExtension include gli elementi seguenti: Text.

Elemento	Descrizione	Tipo di dati
Testo	Testo del callout aggiuntivo sulla tua azienda, prodotti o servizi da includere in un annuncio di testo. Il testo dell'estensione del callout deve essere diverso dal testo dell'annuncio. La lunghezza di questa stringa deve essere compresa tra 1 e 25 caratteri. Si noti che per i caratteri cinesi tradizionali, la lunghezza di questa stringa deve essere compresa tra 1 e 12 caratteri. Aggiungere: Obbligatorio Aggiornare: Obbligatorio	corda

L'oggetto CalloutAdExtension include elementi ereditati.

Elementi ereditati

Elementi ereditati da AdExtension

L'oggetto CalloutAdExtension deriva dall'oggetto AdExtension e eredita gli elementi seguenti: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Le descrizioni seguenti sono specifiche di CalloutAdExtension 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 è CalloutAdExtension quando si recupera un'estensione per gli annunci callout. 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