Aracılığıyla paylaş

AssetGroup Veri Nesnesi - Kampanya Yönetimi

  • Makale

Bir reklam kampanyasındaki varlık grubunu tanımlar.

Sözdizimi

<xs:complexType name="AssetGroup" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AssetGroupSearchThemes" nillable="true" type="tns:ArrayOfAssetGroupSearchTheme">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
    <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AssetGroupEditorialStatus" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
    <xs:element xmlns:q114="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q114:ArrayOfstring" />
    <xs:element xmlns:q115="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q115:ArrayOfstring" />
    <xs:element xmlns:q116="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q116:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AssetGroupStatus" />
  </xs:sequence>
</xs:complexType>

Öğe

AssetGroup nesnesi şu öğelere sahiptir: AssetGroupSearchThemes, BusinessName, CallToAction, Descriptions, EditorStatus, EndDate, FinalMobileUrls, FinalUrls, ForwardCompatibilityMap, Headlines, Id, Images, LongHeadlines, Name, Path1, Path2, StartDate, Status.

Öğe Açıklama Veri Türü
AssetGroupSearchThemes Ayrılmış. AssetGroupSearchTheme dizisi
BusinessName İşletmenin adı.

reklam yerleşiminize bağlı olarak işletmenizin adı reklamınızın içinde görünebilir.

Dizenin uzunluğu 25 karakterle sınırlıdır.

Eklemek: Gerekli. Sağlanmadıysa ve üst kampanya bir mağazayla ilişkilendirirse, mağaza adı işletme adı olarak kullanılır.
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.		 dize
CallToAction Müşterilerin şu anda reklamınızı tıklaması için kısa ve yumruklu bir neden.

Bu, eylem çağrısı düğmenizde görüntülenir.

Eklemek: Gerekli. Sağlanmadıysa ve üst kampanya bir mağazayla ilişkilendirilirse, varsayılan olarak LearnMore olur.
Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.		 CallToAction
Açıklama Reklamınızın yolunun altında gösterilen açıklamalar.

2-5 açıklama arasında ayarlamanız gerekir. Her açıklamanın Metni en az bir sözcük içermelidir. Metin yeni satır (\n) karakterini içeremez.

Üst kampanya bir mağazayla ilişkilendirildiyse ve Açıklamalar belirtirseniz Başlıklar, UzunBaşlıklar ve Görüntüler de belirtmeniz gerekir.

Ekle: Üst kampanya bir mağazayla ilişkilendirildiyse isteğe bağlı olarak, ana kampanyası bir mağazayla ilişkilendirilmiyorsa gereklidir.
Güncelleştirme: İsteğe bağlı. Var olan tüm varlık bağlantılarını korumak için bu öğeyi sıfır olarak ayarlayın veya bırakın. Bu öğe için bir değer ayarlarsanız, daha önce bu varlık grubuna bağlı olan tüm açıklamalar değiştirilir. Üst kampanya bir mağazayla ilişkilendirildiyse ve bu öğeyi boş bir listeye ayarlarsanız, önceki ayar silinir.		 AssetLink dizisi
EditoryalStatus Varlık grubunun gözden geçirmeyi beklemede olduğunu, onaylandığını veya onaylanmadığını gösteren varlık grubunun editoryal gözden geçirme durumu.

Ekle: Salt okunur
Güncelleştirme: Salt okunur		 AssetGroupEditorialStatus
Bitiş Tarihi Varlık grubunun süresinin dolacağı tarih.

Bitiş tarihi belirtmezseniz varlık grubunun süresi dolmaz. Bitiş tarihi, varlık grubunun süresi dolduktan sonra bile bir varlık grubunu teslime uygun hale getirmek için uzatılabilir.

Bitiş tarihi kapsayıcıdır. Örneğin EndDate değerini 31.12.2020 olarak ayarlarsanız reklam grubundaki reklamların süresi 31.12.2020 tarihinde saat 23:59'da sona erecektir. Saat, kampanya düzeyinde belirttiğiniz saat dilimine göre belirlenir.

Ekle: İsteğe bağlı. Varlık grubu eklerken bitiş tarihi ayarlamak için bu öğeyi null olarak ayarlayın.
Güncelleştirme: İsteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Mevcut bitiş tarihi ayarını silmek ve bir varlık grubunu güncelleştirirken bitiş tarihini etkili bir şekilde ayarlamak için bitiş tarihini 2 Ocak 2050'ye eşit veya daha sonra ayarlayın. Bir dahaki sefere varlık grubunu aldığınızda, bu öğe sıfır olur; örneğin 2 Ocak 2050 olarak ayarlanmaz.		 Tarih
FinalMobileUrls Mobil giriş sayfası URL'si.

Son URL'ler ve Son Mobil URL'ler için aşağıdaki doğrulama kuralları geçerlidir.
- URL'nin uzunluğu 2.048 karakterle sınırlıdır. HTTP veya HTTPS protokol dizesi 2.048 karakter sınırına doğru sayılır.
- Hem FinalUrls hem de FinalMobileUrls için en fazla 10 öğe belirtebilirsiniz; ancak, teslimat için her listedeki yalnızca ilk öğe kullanılır. Hizmet, olası ileriye dönük uyumluluk için en fazla 10'a kadar izin verir.
- '{' ve '}' kullanımının yalnızca etiketleri (örneğin{lpurl}) belirtmesine izin verilir.
- Son URL'lerin her biri http:// veya https:// ile başlayan iyi biçimlendirilmiş bir URL olmalıdır.
- FinalMobileUrls değerini belirtirseniz FinalUrls değerini de belirtmeniz gerekir.

Ekle: İsteğe bağlı
Güncelleştirme: İsteğe bağlı		 dize dizisi
FinalUrls Giriş sayfası URL'si.

URL'nin etki alanı bölümü, yol 1 ve yol 2 dizeleriyle birlikte 67 karakteri aşamaz.

Son URL'ler ve Son Mobil URL'ler için aşağıdaki doğrulama kuralları geçerlidir.
- URL'nin uzunluğu 2.048 karakterle sınırlıdır. HTTP veya HTTPS protokol dizesi 2.048 karakter sınırına doğru sayılır.
- Hem FinalUrls hem de FinalMobileUrls için en fazla 10 öğe belirtebilirsiniz; ancak, teslimat için her listedeki yalnızca ilk öğe kullanılır. Hizmet, olası ileriye dönük uyumluluk için en fazla 10'a kadar izin verir.
- '{' ve '}' kullanımının yalnızca etiketleri (örneğin{lpurl}) belirtmesine izin verilir.
- Son URL'lerin her biri http:// veya https:// ile başlayan iyi biçimlendirilmiş bir URL olmalıdır.
- FinalMobileUrls değerini belirtirseniz FinalUrls değerini de belirtmeniz gerekir.

Perakende kampanyaları için, son url'nin kampanyayla ilişkilendirilmiş mağazadaki etki alanıyla eşleşmesi gerekir.

Ekle: Gerekli. Sağlanmazsa ve üst kampanya bir mağazayla ilişkilendirirse, mağaza URL'si son URL olarak kullanılır.
Güncelleştirme: İsteğe bağlı		 dize dizisi
İ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.

İleriye dönük uyumluluk değişiklikleri gelecek sürümlerde burada not alınacaktır. Şu anda bu nesne için ileriye dönük uyumluluk değişikliği yok.		 KeyValuePairOfstringstring dizisi
Başlık Başlıklar, reklamınızda görünen en belirgin metindir, bu nedenle kullanılabilir karakterlerden en iyi şekilde yararlanmalısınız. Reklamın çeşitli yayıncılar ve yerleşimler arasında esnek bir şekilde görüntülenebilmesi için birden çok başlık gerekir.

Veri modeli açısından bakıldığında açıklamalar ve başlıkların her biri, AssetLink başına bir TextAsset gibi metin varlıkları olarak depolanır. Aynı varlık birden çok reklam tarafından kullanılabilir. Örneğin, "Sorunsuz Tümleştirme" bir metin varlığıysa, aynı Microsoft Advertising hesabındaki tüm reklamlarda aynı varlık tanımlayıcısı olur.

3-15 başlık arasında ayarlamanız gerekir. Her başlığın Metni en az bir sözcük içermelidir.

Metin yeni satır (\n) karakterini içeremez.

Üst kampanya bir mağazayla ilişkilendirildiyse ve Başlıklar belirtirseniz, LongHeadlines, Descriptions ve Images da belirtmeniz gerekir.

Ekle: Ana kampanyası bir mağazayla ilişkilendirildiyse isteğe bağlı, ana kampanyası bir mağazayla ilişkilendirilmiyorsa gereklidir.
Güncelleştirme: İsteğe bağlı. Var olan tüm varlık bağlantılarını korumak için bu öğeyi sıfır olarak ayarlayın veya bırakın. Bu öğe için bir değer ayarlarsanız, daha önce bu varlık grubuna bağlı olan tüm başlıklar değiştirilir. Üst kampanya bir mağazayla ilişkilendirildiyse ve bu öğeyi boş bir listeye ayarlarsanız, önceki ayar silinir.		 AssetLink dizisi
Kimlik Sistem tarafından oluşturulan varlık grubu kimliği.

Ekle: Salt okunur
Güncelleştirme: Salt okunur		 uzun
Görüntü Farklı boyutlara ve en boy oranlarına sahip görüntü varlıkları, çeşitli yayımcılar ve yerleştirmeler arasında esnek bir şekilde görüntülenebilir.

Her biri SubType içeren bir ImageAsset ve istenen en boy oranıyla eşleşen kırpma ayarları içeren bir veya daha fazla AssetLink nesnesi ekleyin.

ImageAsset; CropHeight, CropWidth, CropX, CropY ve SubType alanlarını içerir.

Olası alt tür değerleri Şunlardır: LandscapeImageMedia, SquareImageMedia, LandscapeLogoMedia, SquareLogoMedia, ImageMedia15X10, ImageMedia133X100, ImageMedia178X100, ImageMedia1X2 ve ImageMedia4X1.

En az 1 LandscapeImageMedia ve 1 SquareImageMedia sağlamanız gerekir. Toplam 20 resim ve toplam 5 logo kaydedilebilir.

Üst kampanya bir mağazayla ilişkilendirildiyse ve Görüntüler belirtirseniz Başlıklar, UzunBaşlıklar ve Açıklamalar'ı da belirtmeniz gerekir.

Ekle: Üst kampanya bir mağazayla ilişkilendirildiyse isteğe bağlı olarak, ana kampanyası bir mağazayla ilişkilendirilmiyorsa gereklidir.
Güncelleştirme: İsteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Güncelleştirme sırasında görüntü eklerseniz, önceden ayarlanmış tüm görüntüler değiştirilir. Üst kampanya bir mağazayla ilişkilendirildiyse ve bu öğeyi boş bir listeye ayarlarsanız, önceki ayar silinir.		 AssetLink dizisi
LongHeadlines 1-5 uzun başlık arasında ayarlamanız gerekir. Her başlığın Metni en az bir sözcük içermelidir. Metin yeni satır (\n) karakterini içeremez.

Üst kampanya bir mağazayla ilişkilendirildiyse ve LongHeadlines belirtirseniz Başlıklar, Açıklamalar ve Görüntüler de belirtmeniz gerekir.

Ekle: Üst kampanya bir mağazayla ilişkilendirildiyse isteğe bağlı olarak, ana kampanyası bir mağazayla ilişkilendirilmiyorsa gereklidir.
Güncelleştirme: İsteğe bağlı. Var olan tüm varlık bağlantılarını korumak için bu öğeyi sıfır olarak ayarlayın veya bırakın. Bu öğe için bir değer ayarlarsanız, daha önce bu varlık grubuna bağlı olan tüm başlıklar değiştirilir. Üst kampanya bir mağazayla ilişkilendirildiyse ve bu öğeyi boş bir listeye ayarlarsanız, önceki ayar silinir.		 AssetLink dizisi
Ad Varlık grubunun adı. Adlar bir kampanyada benzersiz olmalı ve büyük/küçük harfe duyarlı olmalıdır. Uzunluk 256 karakteri aşamaz.

Ekle: Gerekli
Güncelleştirme: İsteğe bağlı		 dize
Yol1 İsteğe bağlı yolun, görüntüleme URL'nizin etki alanı bölümüne eklenecek ilk bölümü. Görünen URL'nizin etki alanı bölümü( örneğin, https://www.contoso.com Son URL'nizin (FinalUrls öğesi) etki alanından oluşturulur. Ardından Path1 için bir değer belirttiyseniz, bu değer görünen URL'ye eklenir. Path2 için de bir değer belirttiyseniz, bu değer Path1'in ardından görünen URL'ye de eklenir. Örneğin, FinalUrls'ınız içeriyorsa https://www.contoso.com, Yol1 alt dizin1, Yol2 ise alt dizin2 olarak ayarlanırsa, görüntülenen URL olur https://www.contoso.com/subdirectory1/subdirectory2.

En fazla 15 karakter giriş yapılabilir. Son URL etki alanının uzunluğu ve birleştirilen yollar 67 karakteri aşarsa reklam görüntülenmez.

Çift genişlikli karakterlere sahip diller için (ör. Geleneksel Çince en fazla 7 son karakter giriş yapılabilir). Son URL etki alanının uzunluğu ve birleştirilen yollar 33 karakteri aşarsa reklam görüntülenmez. Çift genişlikli karakterler, kampanya dili ayarlarının karakter kümesi yerine kullandığınız karakterler tarafından belirlenir. Çift genişlikli karakterler Arasında Korece, Japonca ve Çince dil karakterlerinin yanı sıra Emojiler bulunur.

Yol eğik çizgi (/) veya yeni satır (\n) karakterlerini içeremez.

Yol bir boşluk içeriyorsa, reklam gösterildiğinde bir alt çizgi (_) ile değiştirilir.

Ekle: İsteğe bağlı
Güncelleştirme: İsteğe bağlı		 dize
Yol2 İsteğe bağlı yolun, görüntüleme URL'nizin etki alanı bölümüne eklenecek ikinci bölümü. Görünen URL'nizin etki alanı bölümü( örneğin, https://www.contoso.com Son URL'nizin (FinalUrls öğesi) etki alanından oluşturulur. Ardından Path1 için bir değer belirttiyseniz, bu değer görünen URL'ye eklenir. Path2 için de bir değer belirttiyseniz, bu değer Path1'in ardından görünen URL'ye de eklenir. Örneğin, FinalUrls'ınız içeriyorsa https://www.contoso.com, Yol1 alt dizin1, Yol2 ise alt dizin2 olarak ayarlanırsa, görüntülenen URL olur https://www.contoso.com/subdirectory1/subdirectory2.

Yol2'nin belirtilmesi için Yol1'in de ayarlanmış olması gerekir.

En fazla 15 karakter giriş yapılabilir. Son URL etki alanının uzunluğu ve birleştirilen yollar 67 karakteri aşarsa reklam görüntülenmez.

Çift genişlikli karakterlere sahip diller için (ör. Geleneksel Çince en fazla 7 son karakter giriş yapılabilir). Son URL etki alanının uzunluğu ve birleştirilen yollar 33 karakteri aşarsa reklam görüntülenmez. Çift genişlikli karakterler, kampanya dili ayarlarının karakter kümesi yerine kullandığınız karakterler tarafından belirlenir. Çift genişlikli karakterler Arasında Korece, Japonca ve Çince dil karakterlerinin yanı sıra Emojiler bulunur.

Yol eğik çizgi (/) veya yeni satır (\n) karakterlerini içeremez.

Yol bir boşluk içeriyorsa, reklam gösterildiğinde bir alt çizgi (_) ile değiştirilir.

Ekle: İsteğe bağlı
Güncelleştirme: İsteğe bağlı		 dize
BaşlangıçTarihi Varlık grubunun sunuma başlayabildiği tarih; aksi takdirde hizmet, varlık grubunun etkin olduğu gün reklam yayınlamaya başlayabilir.

Başlangıç tarihi dahil. Örneğin başlangıç tarihini 5/5/2021 olarak ayarlarsanız varlık grubundan oluşturulan reklamlar 5/5/2021 tarihinde saat 12:00'de başlar. Saat, kampanya düzeyinde belirttiğiniz saat dilimine göre belirlenir.

Ekle: İsteğe bağlı. Başlangıç tarihini ayarlamazsanız, varsayılan olarak bugünün tarihi olur ve varlık grubu durumu etkin olduğunda hizmet reklam yayınlamaya başlayabilir.
Güncelleştirme: İsteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Varlık grubu gönderildikten sonra (örneğin, başlangıç tarihi geldikten sonra) başlangıç tarihi güncelleştirilemez.		 Tarih
Durum Varlık grubunun durumu. Olası değerler Etkin, Süresi Dolmuş ve Duraklatılmış değerlerdir. Süresi dolan durum salt okunurdur.

Ekle: İsteğe bağlı. Varsayılan olarak Duraklatıldı'dır.
Güncelleştirme: İsteğe bağlı		 AssetGroupStatus

Gereksinimler

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

Kullanan

AddAssetGroups
GetAssetGroupsByCampaignId
GetAssetGroupsByIds
UpdateAssetGroups