Oggetto dati LocationAdExtension - Gestione campagna

Articolo
11/14/2024

Definisce un'estensione pubblicitaria che specifica un indirizzo aziendale e un numero di telefono da includere in un annuncio di testo.

Puoi associare un'estensione dell'annuncio della posizione all'account o alle campagne nell'account. Ogni entità (account o campagna) può essere associata a tutte le estensioni degli annunci di posizione che decidi tu, fino al numero totale di estensioni pubblicitarie per la posizione nel tuo account.

<xs:complexType name="LocationAdExtension" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdExtension">
      <xs:sequence>
        <xs:element minOccurs="0" name="Address" nillable="true" type="tns:Address" />
        <xs:element minOccurs="0" name="CompanyName" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="GeoCodeStatus" nillable="true" type="tns:BusinessGeoCodeStatus" />
        <xs:element minOccurs="0" name="GeoPoint" nillable="true" type="tns:GeoPoint" />
        <xs:element minOccurs="0" name="PhoneNumber" 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": "LocationAdExtension",
  "Version": IntValueHere,
  "Address": {
    "CityName": "ValueHere",
    "CountryCode": "ValueHere",
    "PostalCode": "ValueHere",
    "ProvinceCode": "ValueHere",
    "ProvinceName": "ValueHere",
    "StreetAddress": "ValueHere",
    "StreetAddress2": "ValueHere"
  },
  "CompanyName": "ValueHere",
  "GeoCodeStatus": "ValueHere",
  "GeoPoint": {
    "LatitudeInMicroDegrees": IntValueHere,
    "LongitudeInMicroDegrees": IntValueHere
  },
  "PhoneNumber": "ValueHere"
}

Elementi

L'oggetto LocationAdExtension include gli elementi seguenti: Address, CompanyName, GeoCodeStatus, GeoPoint, PhoneNumber.

Elemento	Descrizione	Tipo di dati
Indirizzo	Indirizzo dell'azienda. 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 Aggiornare: Obbligatorio	Indirizzo
CompanyName	Nome dell'azienda. Il nome può contenere un massimo di 80 caratteri. Aggiungere: Obbligatorio Aggiornare: Obbligatorio	corda
GeoCodeStatus	Valore di stato che indica se sono state determinate le coordinate di latitudine e longitudine aziendali. Se si specificano le coordinate, lo stato verrà impostato su Completa. in caso contrario, lo stato indicherà lo stato di determinazione delle coordinate dell'indirizzo aziendale specificato. Aggiungere: Non consentito Aggiornare: Non consentito	BusinessGeoCodeStatus
GeoPoint	Coordinate di latitudine e longitudine dell'elemento Address specificato. Le coordinate vengono usate per contrassegnare la posizione aziendale in Bing Mappe quando l'utente fa clic sull'indirizzo nell'annuncio. Se le coordinate specificate non rientrano nell'intervallo di valori validi, il servizio determina le coordinate in base all'indirizzo. Se si specificano le coordinate note, il servizio non verifica se le coordinate specificate corrispondono all'indirizzo aziendale specificato. Se non si specificano le coordinate, l'operazione AddAdExtensions usa l'indirizzo aziendale per determinare le coordinate. Quando si aggiungono più di 10 estensioni degli annunci di posizione, il servizio risolve le coordinate offline e in caso contrario risolve le coordinate in anticipo durante l'esecuzione dell'operazione del servizio. La posizione non verrà usata in un annuncio fino a quando non vengono determinate le coordinate, che possono richiedere da secondi a minuti a seconda del numero di estensioni degli annunci di posizione aggiunte e della domanda corrente. Per determinare se le coordinate sono state risolte, chiamare l'operazione GetAdExtensionsByIds e accedere all'elemento GeoCodeStatus . Per un elenco dei valori di stato possibili, vedere BusinessGeoCodeStatus. Aggiungere: Opzionale Aggiornare: Opzionale	GeoPoint
PhoneNumber	Numero di telefono aziendale da includere nell'annuncio. Il numero di telefono è selezionabile su dispositivi mobili hi-fi. 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 anche un'estensione di chiamata, il numero di telefono nell'estensione della chiamata sostituirà questo numero di telefono. Aggiungere: Opzionale Aggiornare: Opzionale. Se si imposta questo elemento null, l'impostazione precedente verrà eliminata.	corda

L'oggetto LocationAdExtension include elementi ereditati.

Elementi ereditati

Elementi ereditati da AdExtension

L'oggetto LocationAdExtension deriva dall'oggetto AdExtension ed eredita gli elementi seguenti: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Le descrizioni seguenti sono specifiche di LocationAdExtension 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 è LocationAdExtension quando recuperi un'estensione dell'annuncio della posizione. 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