Varlık Grubu Kaydı - Toplu

Makale
02/08/2024

Toplu bir dosyada indirilebilen ve karşıya yüklenebilecek bir varlık grubu tanımlar.

Hesaptaki tüm Varlık Grubu kayıtlarını, DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine AssetGroups'unDownloadEntity değerini ekleyerek indirebilirsiniz. Ayrıca indirme isteğinin EntityData kapsamını içermesi gerekir. En iyi yöntemler de dahil olmak üzere Toplu hizmet hakkında daha fazla ayrıntı için bkz. Toplu İndirme ve Karşıya Yükleme.

.NET, Java veya Python için Bing Ads SDK'larını kullanıyorsanız, hizmet işlemlerini doğrudan çağırmak ve toplu dosyadaki her alanı ayrıştırmak için özel kod yazmak yerine BulkServiceManager kullanarak BulkAssetGroup nesnesini karşıya yükleyip indirebilirsiniz.

Varlık Grubu kaydı için, Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları kullanılabilir.

Varlık Grubu
İş Adı
Eyleme Çağır
Kampanya
İstemci Kimliği
Açıklama
Editoryal İtiraz Durumu
Editoryal Konum
Editoryal Neden Kodu
Editoryal Durum
Editoryal Terim
Bitiş Tarihi
Son Url
Başlık
Kimlik
Görüntü
Uzun Başlıklar
Mobil Son Url
Değiştirme Zamanı
Üst Kimlik
Yol 1
Yol 2
Durum
Başlangıç Tarihi:

Varlık Grubu

Varlık grubunun adı.

Ekle: Gerekli
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Silmek: Salt okunur ve Gerekli

İş Adı

İşletmenin adı.

Hedef kitle reklamınızın yerleşimlerine 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.

Ekle: Gerekli
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Eyleme Çağır

Müşterilerin şu anda reklamınızı tıklaması için kısa ve yumruklu bir neden.

Olası değerler Şunlardır: ActNow, AddToCart, ApplyNow, Automated, BetNow, BidNow, BookACar, BookHotel, BookNow, BookTravel, Browse, BuildNow, Buy, BuyNow, ChatNow, Compare, ContactUs, Coupon, Dealers, Default, Directions, Donate, Download, EmailNow, EnrollNow, Explore, FileNow, FindJob, FindStore, FreePlay, FreeQuote, FreeTrial, GetDeals, GetDemo, GetNow, GetOffer, GetQuote, GoToDemo, Install, JoinNow, LearnMore, ListenNow, LogIn, Message, NewCars, NoButton, OpenLink, OrderNow, PlayGame, PlayNow, PostJob, Register, RegisterNow, RenewNow, RentACar, RentNow, Reorder, Reserve, Sale, SaveNow, Schedule, SeeDemo, SeeMenu, SeeModels, SeeMore, SeeOffer, SeeOffers, SellNow, ShopNow, Showtimes, SignIn, SignUp, StartFree, StartNow, Subscribe, SwitchNow, TestDrive, TryNow, Unknown, UsedCars, ViewCars, ViewDemo, ViewNow, ViewPlans, VisitSite, VisitStore, VoteNow, Watch, WatchMore, WatchNow.

Ekle: Gerekli.
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Kampanya

Varlık grubunu içeren kampanyanın adı.

Ekle: Salt okunur ve Gerekli
Güncelleştirme: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

Not

Ekleme, güncelleştirme ve silme için Üst Kimlik veya Kampanya alanını belirtmeniz gerekir.

İstemci Kimliği

Toplu karşıya yükleme dosyasındaki kayıtları sonuç dosyasındaki kayıtlarla ilişkilendirmek için kullanılır. Bu alanın değeri sunucu tarafından kullanılmaz veya depolanmaz; yalnızca karşıya yüklenen kayıttan ilgili sonuç kaydına kopyalanır. Uzunluğu 100'e kadar olan geçerli bir dize olabilir.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Tüm özel parametreleri kaldırmak için bu alanı delete_value olarak ayarlayın. delete_value anahtar sözcüğü önceki ayarı kaldırır. Özel parametrelerin bir alt kümesini kaldırmak için, saklamak istediğiniz özel parametreleri belirtin ve saklamak istemediğiniz parametreleri atlarsınız. Yeni özel parametre kümesi, önceki özel parametre kümelerinin yerini alır.
Silmek: Salt okunur

Açıklama

Bing'in reklam düzenini iyileştirmek için kullanabileceği açıklamaların listesi.

Tüm reklam biçimlerindeki gösterimleri en üst düzeye çıkarmak için, açıklamalar her zaman reklamınızda gösterilmeyebilir.

Veri modeli açısından açıklamalar 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.

2-5 açıklama arasında ayarlamanız gerekir. Açıklamalar toplu dosyada JSON dizesi olarak gösterilir. Aşağıdaki örnek JSON'a iki açıklama eklenmiştir ve ilk açıklama belirli bir konuma sabitlenir. id ve text değeri varlığın özellikleri, editorialStatus ve assetPerformanceLabel ise varlık bağlantısının özellikleridir; örneğin, varlık ile reklam arasındaki ilişkidir. Daha fazla ayrıntı için aşağıdaki assetPerformanceLabel, editorStatus, id ve metne bakın.

[{
	"text": "Find New Customers & Increase Sales!",
},
{
	"text": "Start Advertising on Contoso Today."
}]

Not

Virgülle ayrılmış toplu dosyada varlık bağlantıları listesini, her öznitelik anahtarını ve her öznitelik dizesi değerini fazladan bir çift tırnak kümesiyle çevrelemeniz gerekir. Örneğin, yukarıdaki JSON dizesi "[{""text"":""Yeni Müşteri Bul & Satışları Artır!""},{""text"":"Contoso Today'de Reklama Başla.""}]" olarak yazılır.

Aşağıda, örneğin salt okunur öznitelikleri id de alabileceğiniz toplu indirme örneği verilmiştir editorialStatus:

[{
	"id": 1,
	"text": "Contoso",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

Ekle: Ana kampanya bir mağazayla ilişkilendirilmiyorsa gereklidir, isteğe bağlı olarak, üst kampanya bir mağazayla ilişkilendirildiyse. Ü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. Yalnızca metin kabul edilir. Varlık hesabınızda zaten mevcut olsa bile, dahil ederseniz id, assetPerformanceLabel ve editorialStatus yoksayılır.
Güncelleştirme: Isteğe bağlı. Var olan tüm varlık bağlantılarını korumak için bu alanı boş bırakın veya ayarlayın. Bu alanı ayarlarsanız, daha önce bu reklama bağlı olan tüm açıklamalar değiştirilir. Bu alanı belirtirseniz, 2-5 açıklama listesi gerekir. Yalnızca metin kabul edilir. Varlık hesabınızda zaten mevcut olsa bile, dahil ederseniz id, assetPerformanceLabel ve editorialStatus yoksayılır.
Silmek: Salt okunur

assetPerformanceLabel

Bu sayede varlığın ne kadar iyi performans sergilediğiniz hakkında bilgi edinebilirsiniz.

Duyarlı assetPerformanceLabel arama reklamını indirdiğinizde özniteliği salt okunurdur. Olası değerler aşağıdaki tabloda açıklanmıştır.

Değer	Açıklama
Düşük	Bu varlığın performansı düşük ve reklam performansınızı geliştirmek için bu varlığı değiştirmenizi öneririz.
İyi	Bu varlık iyi performans sergiliyor. Reklam performansınızı geliştirmek için bu varlığı tutmanızı ve daha fazla varlık eklemenizi öneririz.
En iyi	Bu varlığın performansı en iyileri arasındadır ve daha benzer varlıklar eklemenizi öneririz.
Unrated	Bu varlık için herhangi bir performans derecelendirmemiz yok. Bunun nedeni, varlığın etkin olmaması, performansını belirlemek için yeterli bilgiye sahip olmaması veya bununla karşılaştırılacak kadar benzer varlık olmaması olabilir.
Öğrenim	Varlığın performansı etkin bir şekilde değerlendiriliyor. Değerlendirme tamamlandıktan sonra varlık derecelendirmesi Düşük, İyi, En İyi veya Derecelendirilmemiş olur.

editorstatus

Duyarlı editorialStatus arama reklamını indirdiğinizde özniteliği salt okunurdur. Olası değerler aşağıdaki tabloda açıklanmıştır.

Değer	Açıklama
Etkin	Varlık, editoryal incelemeden geçti.
ActiveLimited	Varlık bir veya daha fazla pazarda editoryal incelemeden geçmiştir ve varlığın bir veya daha fazla öğesi başka bir pazarda editoryal incelemeden geçirilir. Örneğin varlık, Kanada için editoryal incelemeden geçmiştir ve Birleşik Devletler hala gözden geçirmeyi bekliyor.
Onaylanmadı	Varlık, editoryal incelemede başarısız oldu.
Etkin olmayan	Varlığın bir veya daha fazla öğesi editoryal incelemeden geçiriliyor.
Unknown	Gelecekte kullanılmak üzere ayrılmıştır.

Kimliği

id özniteliği, bir Microsoft Advertising hesabındaki varlık için benzersiz bir Microsoft Advertising tanımlayıcısıdı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. Bir metin varlığını karşıya yükledikten sonra sonuç dosyası, varlığın yeni olup olmadığı veya hesabın varlık kitaplığında zaten var olup olmadığı gibi ""id:""123varlık tanımlayıcısını içerir.

Metin

Her açıklamanın text özniteliği en az bir sözcük içermelidir. Her açıklamanın text özniteliğinin giriş uzunluğu üst sınırı 90 karakterdir. Çift genişlikli karakterlere sahip diller için (ör. Geleneksel Çince) giriş uzunluğu üst sınırı 45 karakterdir. Çift genişlikli karakterler, kampanya veya reklam grubu dil 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.

Özniteliği yeni text satır (\n) karakterini içeremez.

Editoryal İtiraz Durumu

Editör incelemesinde bulunan sorunlara itiraz edip etmeyeceğinizi belirler.

Olası değerler aşağıdaki tabloda açıklanmıştır.

Değer	Açıklama
Çekici	Editörlük sorunu caziptir.
AppealPending	Editörlük sorunu itiraz edilebilir ve bir itirazda bulundu.
NotAppealable	Editörlük sorunu cazip değildir.

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

Editoryal Konum

Editoryal incelemede başarısız olan reklamın bileşeni veya özelliği.

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

Editoryal Neden Kodu

Hatanın nedenini tanımlayan bir kod. Olası neden kodlarının listesi için bkz . Editoryal Neden Kodları.

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

Editoryal Durum

Varlık grubunun editoryal durumu.

Olası değerler aşağıdaki tabloda açıklanmıştır.

Değer	Açıklama
Etkin	Varlık grubu, editör incelemesini geçti.
ActiveLimited	Varlık grubu bir veya daha fazla pazarda editoryal incelemeden geçti ve varlık grubunun bir veya daha fazla öğesi başka bir pazarda editoryal incelemeden geçiyor. Örneğin varlık grubu Kanada için editör incelemesini geçmiştir ve Birleşik Devletler hala gözden geçirmeyi bekliyor.
Onaylanmadı	Varlık grubu, editör incelemesi başarısız oldu.
Etkin olmayan	Varlık grubunun bir veya daha fazla öğesi editoryal incelemeden geçiriliyor.

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

Editoryal Terim

Editoryal incelemede başarısız olan terim.

Hataya bir terim birleşimi neden olursa veya hata bir ilke ihlaline dayandıysa bu alan ayarlanmaz.

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

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, Bitiş Tarihi'ni 31.12.2020 olarak ayarlarsanız varlık grubunun süresi 31.12.2020 tarihinde saat 23:59'da dolar. Saat, kampanya düzeyinde belirttiğiniz saat dilimine göre belirlenir.

Ekle: Isteğe bağlı. Varlık grubu eklerken bitiş tarihi ayarlamak için bu alanı ayarlamayın.
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Geçerli bitiş tarihini silmek ve geçerli bitiş tarihini etkili bir şekilde ayarlamak için bu alanı "delete_value" dizesi olarak ayarlayın. Bir dahaki sefere varlık grubunu aldığınızda, bu alan ayarlanmaz.
Silmek: Salt okunur

Son Url

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 Son URL'ler hem de Son Mobil URL'ler 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.
Her URL noktalı virgül ve boşluk ("; ") ile sınırlandırılır.
'{' ve '}' kullanımı yalnızca etiketlerin (örneğin, "{lpurl}") çizgisini belirlemeye izin verilir.
Her URL, http:// veya https:// ile başlayan iyi biçimlendirilmiş bir URL olmalıdır.
Son Mobil URL'leri belirtirseniz Son Url'yi de belirtmeniz gerekir.

Ekle: Gerekli
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Başlık

Bing'in reklam düzenini iyileştirmek için kullanabileceği başlık listesi.

Tüm reklam biçimlerinde performansı en üst düzeye çıkarmak için başlıklar her zaman reklamınızda gösterilmeyebilir.

Veri modeli açısından bakıldığında, başlıklar 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. Başlıklar toplu dosyada JSON dizesi olarak gösterilir. Aşağıdaki örnek JSON'a iki başlık eklenmiştir. id ve text değeri varlığın özellikleri, editorialStatus ve assetPerformanceLabel ise varlık bağlantısının özellikleridir; örneğin, varlık ile reklam arasındaki ilişkidir. Daha fazla ayrıntı için aşağıdaki assetPerformanceLabel, editorStatus, id ve metne bakın.

[{
	"text": "Contoso",
},
{
	"text": "Seamless Integration"
}]

Not

Aşağıda, örneğin salt okunur öznitelikleri id de alabileceğiniz toplu indirme örneği verilmiştir editorialStatus:

[{
	"id": 1,
	"text": "Contoso",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

Ekle: Ana kampanya bir mağazayla ilişkilendirilmiyorsa gereklidir, isteğe bağlı olarak, üst kampanya bir mağazayla ilişkilendirildiyse. Üst kampanya bir mağazayla ilişkilendirildiyse ve Başlıklar belirtirseniz, LongHeadlines, Descriptions ve Images da belirtmeniz gerekir. Yalnızca metin kabul edilir. Varlık hesabınızda zaten mevcut olsa bile, dahil ederseniz id, assetPerformanceLabel ve editorialStatus yoksayılır.
Güncelleştirme: Isteğe bağlı. Var olan tüm varlık bağlantılarını korumak için bu alanı boş bırakın veya ayarlayın. Bu alanı ayarlarsanız, daha önce bu reklama bağlı olan tüm başlıklar değiştirilir. Bu alanı belirtirseniz, 3-15 başlık listesi gerekir. Yalnızca metin kabul edilir. Varlık hesabınızda zaten mevcut olsa bile, dahil ederseniz id, assetPerformanceLabel ve editorialStatus yoksayılır.
Silmek: Salt okunur

assetPerformanceLabel

Bu sayede varlığın ne kadar iyi performans sergilediğiniz hakkında bilgi edinebilirsiniz.

Duyarlı assetPerformanceLabel arama reklamını indirdiğinizde özniteliği salt okunurdur. Olası değerler aşağıdaki tabloda açıklanmıştır.

Değer	Açıklama
Düşük	Bu varlığın performansı düşük ve reklam performansınızı geliştirmek için bu varlığı değiştirmenizi öneririz.
İyi	Bu varlık iyi performans sergiliyor. Reklam performansınızı geliştirmek için bu varlığı tutmanızı ve daha fazla varlık eklemenizi öneririz.
En iyi	Bu varlığın performansı en iyileri arasındadır ve daha benzer varlıklar eklemenizi öneririz.
Unrated	Bu varlık için herhangi bir performans derecelendirmemiz yok. Bunun nedeni, varlığın etkin olmaması, performansını belirlemek için yeterli bilgiye sahip olmaması veya bununla karşılaştırılacak kadar benzer varlık olmaması olabilir.
Öğrenim	Varlığın performansı etkin bir şekilde değerlendiriliyor. Değerlendirme tamamlandıktan sonra varlık derecelendirmesi Düşük, İyi, En İyi veya Derecelendirilmemiş olur.

editorstatus

Özniteliği editorialStatus , duyarlı arama reklamını indirdiğinizde salt okunur bir dizedir. Olası değerler aşağıdaki tabloda açıklanmıştır.

Değer	Açıklama
Etkin	Varlık, editoryal incelemeden geçti.
ActiveLimited	Varlık bir veya daha fazla pazarda editoryal incelemeden geçmiştir ve Varlığın bir veya daha fazla öğesi başka bir pazarda editoryal incelemeden geçiriliyor. Örneğin Varlık, Kanada için editoryal incelemeden geçmiştir ve Birleşik Devletler hala gözden geçirmeyi bekliyor.
Onaylanmadı	Varlık, editoryal incelemede başarısız oldu.
Etkin olmayan	Varlığın bir veya daha fazla öğesi editoryal incelemeden geçiriliyor.
Unknown	Gelecekte kullanılmak üzere ayrılmıştır.

Kimliği

id özniteliği, bir Microsoft Advertising hesabındaki varlık için benzersiz bir Microsoft Advertising tanımlayıcısıdır.

Metin

Her başlığın text özniteliği en az bir sözcük içermelidir. Her başlığın text özniteliğinin giriş uzunluğu üst sınırı 30 karakterdir. Çift genişlikli karakterlere sahip diller için (ör. Geleneksel Çince) giriş uzunluğu üst sınırı 15 karakterdir. Çift genişlikli karakterler, kampanya veya reklam grubu dil 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.

Özniteliği yeni text satır (\n) karakterini içeremez.

Kimlik

Varlık grubunun sistem tarafından oluşturulan tanımlayıcısı.

Ekle: Isteğe bağlı. Bu alanı boş bırakmanız veya negatif bir tanımlayıcı belirtmeniz gerekir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Güncelleştirme: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

Görüntü

Farklı boyutlarda ve en boy oranlarında birden çok görüntü varlığı oluşturarak çeşitli yayımcılar ve yerleşimlerde esnek bir şekilde görüntülenebilmelerini sağlayın.

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

Görüntü varlıkları toplu dosyada JSON dizesi olarak temsil edilir. Aşağıdaki örnek JSON'a dokuz görüntü eklenmiştir ve yalnızca LandscapeImageMedia subType kırpılmaz. id, varlığın cropHeightbir özelliğiyken , cropWidth, cropX, cropYve subType varlık bağlantısının özellikleridir; örneğin, varlık ile reklam arasındaki ilişkidir. Daha fazla ayrıntı için aşağıdaki cropHeight, cropWidth, cropX, cropY, id ve subType'a bakın.

[{
	"id": 1234567890000,
	"subType": "LandscapeImageMedia"
},
{
	"id": 1234567890000,
	"subType": "SquareImageMedia",
	"cropX": 286,
	"cropY": 0,
	"cropWidth": 628,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "LandscapeLogoMedia",
	"cropX": 70,
	"cropY": 0,
	"cropWidth": 200,
	"cropHeight": 50
},
{
	"id": 1234567890000,
	"subType": "SquareLogoMedia",
	"cropX": 308,
	"cropY": 0,
	"cropWidth": 120,
	"cropHeight": 120
},
{
	"id": 1234567890000,
	"subType": "ImageMedia15X10",
	"cropX": 129,
	"cropY": 0,
	"cropWidth": 942,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia133X100",
	"cropX": 183,
	"cropY": 0,
	"cropWidth": 835,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia178X100",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 1118,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia1x2",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 500,
	"cropHeight": 1000
},
{
	"id": 1234567890000,
	"subType": "ImageMedia4x1",
	"cropX": 60,
	"cropY": 0,
	"cropWidth": 1000,
	"cropHeight": 250
}]

Not

Virgülle ayrılmış toplu dosyada varlık bağlantıları listesini, her öznitelik anahtarını ve her öznitelik dizesi değerini fazladan bir çift tırnak kümesiyle çevrelemeniz gerekir. Örneğin, Yukarıdaki JSON dizesi "[{""id"":1234567890000,""subType"":""LandscapeImageMedia""},{""id"":1234567890000,"subType"":"SquareImageMedia olarak yazılabilir",""cropX"":286,""cropY"":0,""cropWidth"":628,""cropHeight"":628},{""id"":1234567890000, ""subType"":""LandscapeLogoMedia"",""cropX"":70,""cropY"":0,""cropWidth"":200,""cropHeight"":50},{""id"":1234567890000,"""subType"":""SquareLogoMedia"",""cropX"":308,""cropY"":0,""cropWidth"":120,""cropHeight"":120},{"id"":1234567890000,""subType"":""ImageMedia15X10"",""cropX"":129,""cropY"":0,""cropWidth"":942,""cropHeight"":628},{""id"":1234567890000,""subType":""ImageMedia133X100"",""cropX"":183,"cropY"":0,""cropWidth"":835,""cropHeight"" :628},{""id"":1234567890000,""subType"":""ImageMedia178X100"",""cropX"":41,""cropY"":0,""cropWidth"":1118,""cropHeight"":628},{""id"":1234567890000,""subType"":""ImageMedia1X2",""cropX""::41,""cropY"":0,""cropWidth"":500,""cropHeight"":1000},{""id"":1234567890000,""subType"":"""ImageMedia4X1"",""cropX"":60,""cropY"":0,""cropWidth"":1000,""cropHeight"":250}]"".

Ekle: Ana kampanya bir mağazayla ilişkilendirilmiyorsa gereklidir, isteğe bağlı olarak, üst kampanya bir mağazayla ilişkilendirildiyse. Ü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. Her varlık bağlantısı için yalnızca kimlik ve alt Tür gereklidir.
Güncelleştirme: Isteğe bağlı. Var olan tüm varlık bağlantılarını korumak için bu alanı boş bırakın veya ayarlayın. Bu alanı ayarlarsanız, daha önce bu reklama bağlı olan tüm resimler değiştirilir. Bu alanı ayarlarsanız, her varlık bağlantısı için yalnızca kimlik ve alt Tür gereklidir.
Silmek: Salt okunur

cropHeight

Kırpma konumundan başlayıp yukarı doğru hareket ederek görüntü varlığı kaynağından kullanılacak piksel sayısı.

cropWidth

CropX konumundan başlayıp sağa doğru hareket ederek görüntü varlığı kaynağından kullanılacak piksel sayısı.

cropX

Görüntü varlığı kaynağının sol alt köşesinden başlayarak, cropWidth'i uygulamadan önce x ekseninde sağa atlanması gereken piksel sayısıdır.

kırpma

Görüntü varlığı kaynağının sol alt köşesinden başlayarak, cropHeight uygulanmadan önce y ekseninde yukarı doğru atlanması gereken piksel sayısıdır.

Kimliği

id özniteliği, bir Microsoft Advertising hesabındaki varlık için benzersiz bir Microsoft Advertising tanımlayıcısıdır.

Aynı görüntü varlığı tanımlayıcısı, farklı en boy oranları için aynı reklamda birden çok kez kullanılabilir ve aynı Microsoft Advertising hesabındaki birden çok reklam tarafından da kullanılabilir. Hızlı yanıt veren reklamlar için Görüntü toplu kaydı aracılığıyla resimler oluşturabilirsiniz. Ardından, döndürülen medya tanımlayıcısını görüntü varlığı kimliği olarak kullanabilirsiniz. Eklediğiniz görüntünün en boy oranı, görüntü varlığı alt Türü için desteklenmelidir.

Alt

özniteliği, subType bu görüntü varlığının en boy oranını temsil eder.

Hesap düzeyinde medya kitaplığında depolanan Görüntünün gerçek en boy oranı, sonuçta elde edilen boyutlar alt tür başına beklenen en boy oranına neden olduğu sürece değişebilir.

Olası alt tür değerleri Şunlardır: LandscapeImageMedia, SquareImageMedia, LandscapeLogoMedia, SquareLogoMedia, ImageMedia15X10, ImageMedia133X100, ImageMedia178X100, ImageMedia1X2 ve ImageMedia4X1. Gelecekte yeni alt türler eklenebilir, bu nedenle sabit bir değer kümesine bağımlılık almamalısınız.

Alt Tür	En boy oranı	Piksel cinsinden minimum boyutlar
LandscapeImageMedia	1.91:1	703 genişlik x 368 yükseklik
SquareImageMedia	1:1	300 genişlik x 300 yükseklik
LandscapeLogoMedia	4:1	160 genişlik x 40 yükseklik
SquareLogoMedia	1:1	40 genişlik x 40 yükseklik
ImageMedia15x10	1.5:1	300 genişlik x 200 yükseklik
ImageMedia133x100	1.33:1	100 genişlik x 75 yükseklik
ImageMedia178x100	1.78:1	624 genişlik x 350 yükseklik
ImageMedia1x2	1:2	470 genişlik x 940 yükseklik
ImageMedia4x1	4:1	608 genişlik x 152 yükseklik

Uzun Başlıklar

Bing'in reklam düzenini iyileştirmek için kullanabileceği uzun başlıkların listesi.

Tüm reklam biçimlerinde performansı en üst düzeye çıkarmak için uzun başlıklar her zaman reklamınızda gösterilmeyebilir.

Veri modeli açısından bakıldığında uzun başlıklar 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.

1-5 uzun başlık arasında ayarlamanız gerekir. Uzun başlıklar toplu dosyada JSON dizesi olarak gösterilir. Aşağıdaki örnek JSON'a iki uzun başlık eklenmiştir. id ve text değeri varlığın özellikleri, editorialStatus ve assetPerformanceLabel ise varlık bağlantısının özellikleridir; örneğin, varlık ile reklam arasındaki ilişkidir. Daha fazla ayrıntı için aşağıdaki assetPerformanceLabel, editorStatus, id ve metne bakın.

[{
	"text": "Find New Customers & Increase Sales!",
},
{
	"text": "Start Advertising on Contoso Today."
}]

Not

Virgülle ayrılmış toplu dosyada varlık bağlantıları listesini, her öznitelik anahtarını ve her öznitelik dizesi değerini fazladan bir çift tırnak kümesiyle çevrelemeniz gerekir. Örneğin, yukarıdaki JSON dizesi "[{""text"":""Yeni Müşteri Bul & Satışları Artır!""},{""text"":"Contoso Today'de Reklama Başla.""}]" olarak yazılır.

Aşağıda, örneğin salt okunur öznitelikleri id de alabileceğiniz toplu indirme örneği verilmiştir editorialStatus:

[{
	"id": 1,
	"text": "Find New Customers & Increase Sales!",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Start Advertising on Contoso Today",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

Ekle: Ana kampanya bir mağazayla ilişkilendirilmiyorsa gereklidir, isteğe bağlı olarak, üst kampanya bir mağazayla ilişkilendirildiyse. Üst kampanya bir mağazayla ilişkilendirildiyse ve LongHeadlines belirtirseniz Başlıklar, Açıklamalar ve Görüntüler de belirtmeniz gerekir. Yalnızca metin kabul edilir. Varlık hesabınızda zaten mevcut olsa bile, dahil ederseniz id, assetPerformanceLabel ve editorialStatus yoksayılır.
Güncelleştirme: Isteğe bağlı. Var olan tüm varlık bağlantılarını korumak için bu alanı boş bırakın veya ayarlayın. Bu alanı ayarlarsanız, daha önce bu reklama bağlı olan tüm başlıklar değiştirilir. Bu alanı belirtirseniz, 1-5 başlık listesi gerekir. Yalnızca metin kabul edilir. Varlık hesabınızda zaten mevcut olsa bile, dahil ederseniz id, assetPerformanceLabel ve editorialStatus yoksayılır.
Silmek: Salt okunur

assetPerformanceLabel

Bu sayede varlığın ne kadar iyi performans sergilediğiniz hakkında bilgi edinebilirsiniz.

Duyarlı assetPerformanceLabel arama reklamını indirdiğinizde özniteliği salt okunurdur. Olası değerler aşağıdaki tabloda açıklanmıştır.

Değer	Açıklama
Düşük	Bu varlığın performansı düşük ve reklam performansınızı geliştirmek için bu varlığı değiştirmenizi öneririz.
İyi	Bu varlık iyi performans sergiliyor. Reklam performansınızı geliştirmek için bu varlığı tutmanızı ve daha fazla varlık eklemenizi öneririz.
En iyi	Bu varlığın performansı en iyileri arasındadır ve daha benzer varlıklar eklemenizi öneririz.
Unrated	Bu varlık için herhangi bir performans derecelendirmemiz yok. Bunun nedeni, varlığın etkin olmaması, performansını belirlemek için yeterli bilgiye sahip olmaması veya bununla karşılaştırılacak kadar benzer varlık olmaması olabilir.
Öğrenim	Varlığın performansı etkin bir şekilde değerlendiriliyor. Değerlendirme tamamlandıktan sonra varlık derecelendirmesi Düşük, İyi, En İyi veya Derecelendirilmemiş olur.

editorstatus

Özniteliği editorialStatus , duyarlı arama reklamını indirdiğinizde salt okunur bir dizedir. Olası değerler aşağıdaki tabloda açıklanmıştır.

Değer	Açıklama
Etkin	Varlık, editoryal incelemeden geçti.
ActiveLimited	Varlık bir veya daha fazla pazarda editoryal incelemeden geçmiştir ve Varlığın bir veya daha fazla öğesi başka bir pazarda editoryal incelemeden geçiriliyor. Örneğin Varlık, Kanada için editoryal incelemeden geçmiştir ve Birleşik Devletler hala gözden geçirmeyi bekliyor.
Onaylanmadı	Varlık, editoryal incelemede başarısız oldu.
Etkin olmayan	Varlığın bir veya daha fazla öğesi editoryal incelemeden geçiriliyor.
Unknown	Gelecekte kullanılmak üzere ayrılmıştır.

Kimliği

id özniteliği, bir Microsoft Advertising hesabındaki varlık için benzersiz bir Microsoft Advertising tanımlayıcısıdır.

Metin

Her uzun başlığın text özniteliği en az bir sözcük içermelidir. Her başlığın text özniteliğinin giriş uzunluğu üst sınırı 90 karakterdir. Çift genişlikli karakterlere sahip diller için (ör. Geleneksel Çince) giriş uzunluğu üst sınırı 45 karakterdir. Çift genişlikli karakterler, kampanya veya reklam grubu dil 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.

Özniteliği yeni text satır (\n) karakterini içeremez.

Mobil Son Url

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 Son URL'ler hem de Son Mobil URL'ler 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.
Her URL noktalı virgül ve boşluk ("; ") ile sınırlandırılır.
'{' ve '}' kullanımı yalnızca etiketlerin (örneğin, "{lpurl}") çizgisini belirlemeye izin verilir.
Her URL, http:// veya https:// ile başlayan iyi biçimlendirilmiş bir URL olmalıdır.
Son Mobil URL'leri belirtirseniz Son Url'yi de belirtmeniz gerekir.

Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Bu alanı delete_value dizesi olarak ayarlarsanız, önceki ayar kaldırılır.
Silmek: Salt okunur

Değiştirme Zamanı

Varlığın son güncelleştirildiği tarih ve saat. Değer Eşgüdümlü Evrensel Saat (UTC) içindedir.

Not

Tarih ve saat değeri, istemcide değil sunucudaki tarih ve saati yansıtır. Tarih ve saatin biçimi hakkında bilgi için temel XML Veri Türleri'ndeki dateTime girdisine bakın.

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

Üst Kimlik

Varlık grubunu içeren kampanyanın sistem tarafından oluşturulan tanımlayıcısı.

Bu toplu alan, Kampanya kaydının Kimlik alanına eşler.

Ekle: Salt okunur ve Gerekli. Mevcut bir kampanya tanımlayıcısı belirtmeniz veya üst Kampanya kaydının Kimlik alanına eşit bir negatif tanımlayıcı belirtmeniz gerekir. Aynı Toplu dosyada yeni bir kampanyaya yeni reklam grupları ekliyorsanız bu önerilir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Güncelleştirme: Salt okunur ve Gerekli
Silmek: Salt okunur ve Gerekli

Not

Ekleme, güncelleştirme ve silme için Üst Kimlik veya Kampanya alanını belirtmeniz gerekir.

Yol 1

İ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 (Son Url alanı) etki alanından oluşturulur. Ardından , Yol 1 için bir değer belirttiyseniz, görüntü URL'sine eklenir. Yol 2 için de bir değer belirttiyseniz, bu değer Yol 1'in ardından görünen URL'ye de eklenir. Örneğin, Son Url'niz içeriyorsahttps://www.contoso.com, Yol 1alt dizinine1, Yol 2ise alt dizin2 olarak ayarlanırsa, görüntülenen URL olurhttps://www.contoso.com/subdirectory1/subdirectory2.

Yol {MatchType} gibi dinamik parametreler içerebilir. Desteklenen parametrelerin listesi için Microsoft Advertising yardım makalesine bakın . Hangi izleme veya URL parametrelerini kullanabilirim?.

Dinamik metin dizeleri eklerseniz maksimum giriş uzunluğu 1.000 karakterdir. En fazla 15 son karakter (dinamik metin değil) giriş yapılabilir. Son URL etki alanının uzunluğu ve birleştirilen yollar 67 karakteri aşarsa reklam görüntülenemez veya varsayılan metin kullanılır.

Çift genişlikli karakterlere sahip diller (ör. Geleneksel Çince) için, dinamik metin dizeleri eklerseniz maksimum giriş uzunluğu 1.000 karakterdir. En fazla 7 son karakter (dinamik metin değil) giriş yapılabilir. Son URL etki alanının uzunluğu ve birleştirilen yollar 33 karakteri aşarsa reklam görüntülenemez veya varsayılan metin kullanılır. Çift genişlikli karakterler, kampanya veya varlık grubu dil 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.

Yol 2

İ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 (Son Url alanı) etki alanından oluşturulur. Ardından , Yol 1 için bir değer belirttiyseniz, görüntü URL'sine eklenir. Yol 2 için de bir değer belirttiyseniz, bu değer Yol 1'in ardından görünen URL'ye de eklenir. Örneğin, Son Url'niz içeriyorsahttps://www.contoso.com, Yol 1alt dizinine1, Yol 2ise alt dizin2 olarak ayarlanırsa, görüntülenen URL olurhttps://www.contoso.com/subdirectory1/subdirectory2.

Yol 2'nin belirtilmesi için Yol 1'in de ayarlanmış olması gerekir.

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.

Durum

Varlık grubunun durumu.

Olası değerler Etkin, Silinmiş, Süresi Dolmuş veya Duraklatılmış olabilir. Süresi dolan durum salt okunurdur.

Ekle: Isteğe bağlı. Varsayılan değer Duraklatıldı'dır.
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Gerekli. Durum , Silinmiş olarak ayarlanmalıdır.

Başlangıç Tarihi:

Varlık grubunun sunuma başlayabildiği tarih; aksi takdirde, hizmet varlık grubunun etkin olduğu gün varlık grubuna hizmet sunmaya başlayabilir.

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

Ekle: Isteğe bağlı. Bu alanı ayarlamazsanız veya gönderdiğiniz tarih bugünün tarihinden önceyse, bugünün tarihi ayarlanır ve hizmet, varlık grubu durumu etkin olduğunda varlık grubuna hizmet etmeye başlayabilir.
Güncelleştirme: Isteğ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.
Silmek: Salt okunur

Aracılığıyla paylaş

Varlık Grubu Kaydı - Toplu

Varlık Grubu

İş Adı

Eyleme Çağır

Kampanya

İstemci Kimliği

Açıklama

assetPerformanceLabel

editorstatus

Kimliği

Metin

Editoryal İtiraz Durumu

Editoryal Konum

Editoryal Neden Kodu

Editoryal Durum

Editoryal Terim

Bitiş Tarihi

Son Url

Başlık

assetPerformanceLabel

editorstatus

Kimliği

Metin

Kimlik

Görüntü

cropHeight

cropWidth

cropX

kırpma

Kimliği

Alt

Uzun Başlıklar

assetPerformanceLabel

editorstatus

Kimliği

Metin

Mobil Son Url

Değiştirme Zamanı

Üst Kimlik

Yol 1

Yol 2

Durum

Başlangıç Tarihi:

Geri Bildirim

Ek kaynaklar