Aracılığıyla paylaş

LocationAdExtension Veri Nesnesi - Kampanya Yönetimi

  • Makale

Metin reklamına eklenecek iş adresini ve telefon numarasını belirten bir reklam uzantısı tanımlar.

Bir konum reklam uzantısını hesapla veya hesaptaki kampanyalarla ilişkilendirebilirsiniz. Her varlık (hesap veya kampanya), karar verdikçe hesabınızdaki toplam konum reklamı uzantısı sayısına kadar birçok konum reklamı uzantısıyla ilişkilendirilebilir.

Sözdizimi

<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>

Öğe

LocationAdExtension nesnesi şu öğelere sahiptir: Address, CompanyName, GeoCodeStatus, GeoPoint, PhoneNumber.

Öğe Açıklama Veri Türü
Adres İş adresi.

Desteklenen ülke kodu değerleri 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 ve VN'dir.

Ekle: Gerekli
Güncelleştirme: Gerekli		 Adres
Şirketadı İşletmenin adı. Ad en fazla 80 karakter içerebilir.

Ekle: Gerekli
Güncelleştirme: Gerekli		 Dize
GeoCodeStatus İş enlem ve boylam koordinatlarının belirlenip belirlenmediğini gösteren bir durum değeri.

Koordinatları sağlarsanız, durum Tamamlandı olarak ayarlanır; aksi takdirde, durum belirtilen iş adresinin koordinatlarını belirleme işleminin ilerleme durumunu gösterir.

Ekle: İzin verilmiyor
Güncelleştirme: İzin verilmiyor		 BusinessGeoCodeStatus
GeoPoint Belirtilen Address öğesinin enlem ve boylam koordinatları. Koordinatlar, kullanıcı reklamdaki adrese tıkladığında iş konumunu Bing Haritalar işaretlemek için kullanılır. Belirtilen koordinatlar geçerli değerler aralığında değilse, hizmet koordinatları adrese göre belirler.

Bilinen koordinatları belirtirseniz, hizmet belirtilen koordinatların belirtilen iş adresiyle eşleşip eşleşmediğini onaylamaz. Koordinatları sağlamazsanız , AddAdExtensions işlemi koordinatları belirlemek için iş adresini kullanır.

10'dan fazla konum reklam uzantısı eklerken hizmet, koordinatları çevrimdışı olarak çözer ve hizmet işleminin yürütülmesi sırasında koordinatları önceden çözer. Konum, koordinatlar belirlenene kadar bir reklamda kullanılmaz ve eklenen konum reklam uzantılarının sayısına ve geçerli talebe bağlı olarak saniyeler ile dakikalar arasında sürebilir.

Koordinatların çözümlenip çözümlenmediğini belirlemek için GetAdExtensionsByIds işlemini çağırın ve GeoCodeStatus öğesine erişin. Olası durum değerlerinin listesi için bkz . BusinessGeoCodeStatus.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı		 GeoPoint
Phonenumber Reklama eklenecek iş telefon numarası. Telefon numarası hi-fi mobil cihazlarda tıklanabilir.

Telefon numarası en fazla 35 karakter içerebilir ve belirtilen ülke veya bölge için geçerli olmalıdır.

Kampanya bir arama uzantısı da içeriyorsa, arama uzantısındaki telefon numarası bu telefon numarasını geçersiz kılar.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı. Bu öğeyi null ayarlarsanız, önceki ayar silinir.		 Dize

LocationAdExtension nesnesininDevralınan Öğeleri vardır.

Devralınan Öğeler

AdExtension'dan Devralınan Öğeler

LocationAdExtension nesnesi AdExtension nesnesinden türetilir ve şu öğeleri devralır: DevicePreference, ForwardCompatibilityMap, Id, Scheduling, Status, Type, Version. Aşağıdaki açıklamalar LocationAdExtension'a özeldir ve AdExtension nesnesinden aynı öğeleri devralan diğer nesneler için geçerli olmayabilir.

Öğe Açıklama Veri Türü
DevicePreference Bu reklam uzantısı türü için desteklenmez. Uzun
İletme Uyumluluğu Haritası Geçerli API sürümüne yeni öğeler eklendiğinde başka değişikliklerden kaçınmak için ileriye dönük uyumluluk için anahtar ve değer dizelerinin listesi.

Şu anda AdExtension nesnesi için ileriye dönük uyumluluk değişikliği yoktur.

Ekle: Salt okunur
Güncelleştirme: Salt okunur		 KeyValuePairOfstringstring dizisi
Kimlik Reklam uzantısının benzersiz Microsoft Advertising tanımlayıcısı.

Ekle: Salt okunur
Güncelleştirme: Salt okunur ve Gerekli		 Uzun
Zamanlama Reklam uzantısının reklamlarda gösterilmeye uygun olduğu takvim gününü ve zaman aralıklarını belirler.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı. Bu öğeyi null olarak ayarlarsanız, reklam uzantısı için mevcut zamanlama kümeleri değişmeden kalır. Bunu null olmayan bir Schedule nesnesine ayarlarsanız, reklam uzantısı için mevcut zamanlama ayarlarını etkili bir şekilde değiştirirsiniz. Tüm zamanlamaları kaldırmak için bu öğeyi boş bir Schedule nesnesine ayarlayın.		 Zamanlama
Durum Reklam uzantısının durumu. Kampanya Yönetimi hizmeti silinen reklam uzantılarını döndürmediğinden değer her zaman Etkin olur.

Ekle: Salt okunur
Güncelleştirme: Salt okunur		 AdExtensionStatus
Tür Reklam uzantısının türü. Konum reklam uzantısını aldığınızda bu değer LocationAdExtension değeridir.

Ekle: Salt okunur
Güncelleştirme: Salt okunur

Reklam uzantısı türleri hakkında daha fazla bilgi için bkz. Ad Uzantısı Veri Nesnesi Açıklamaları.		 Dize
Sürüm Reklam uzantısının kaç kez güncelleştirildiğini izler.

Reklam uzantısı oluşturulduğunda sürüm 1 olarak ayarlanır ve her güncelleştirmeden sonra bir artırılır.

Ekle: İzin verilmiyor
Güncelleştirme: İzin verilmiyor		 Int

Gereksinimler

Hizmet: CampaignManagementService.svc v13
Ad alanı: https://bingads.microsoft.com/CampaignManagement/v13