Uygulama Yükleme Reklam Kaydı - Toplu
Toplu dosyada indirilebilen ve karşıya yüklenebilen bir uygulama yükleme reklamı tanımlar.
Uygulama Yükleme Reklamları, metin reklamlarına benzer ancak bir düğmeyle uygulamalarınıza doğrudan bağlantılar sağlayarak müşterileri uygulamayı indirmeleri için doğrudan ilgili mağazaya gönderir. Bu, web sitesi trafiği yerine uygulamalarının indirmelerini yönetmek ve yönlendirmek isteyen reklamverenler için ideal bir çözümdür.
Uygulama Yükleme Reklamları müşterinin mobil cihazını ve işletim sistemini otomatik olarak algılar ve bunları ilgili Apple App Store veya Google Play'e gönderir. Ayrıca Uygulama Uzantıları ile aynı dönüşüm izleme iş ortaklarıyla dönüşümleri izleyebilirsiniz: AppsFlyer, Kochava, Tune, Singular, Adjust ve Branch.
Not
Uygulama Yükleme Reklamları Avustralya, Brezilya, Kanada, Fransa, Almanya, Hindistan, Birleşik Krallık ve Birleşik Devletler yalnızca iOS ve Android'de kullanılabilir. Şu anda yalnızca Apple App Store ve Google Play Store'daki Birleşik Devletler kullanılabilir uygulamalar desteklenmektedir. Windows için destek yoktur.
Henüz herkesin bu özelliği yok. Yoksa, endişelenme. Çok yakında.
Not
Uygulama yükleme reklamları yalnızca Reklam Grubu Türü'nü "SearchStandard" olarak ayarlandığı Arama kampanyalarında oluşturulabilir. Reklam Grubu Türü "SearchDynamic" olarak ayarlandıysa, reklam grubu uygulama yükleme reklamlarını desteklemez.
DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine AppInstallAds'inDownloadEntity değerini ekleyerek hesaptaki tüm Uygulama Yükleme Reklam kayıtlarını 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.
Aşağıdaki Toplu CSV örneği, geçerli bir Ebeveyn Kimliği değeri sağlanırsa yeni bir uygulama yükleme reklamı ekler.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter
Format Version,,,,,,,,,,,,,,6.0,,,,,,,
App Install Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,Contoso Quick Setup,Find New Customers & Increase Sales!,,,,All,,Android,AppStoreIdGoesHere,FinalUrlGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer
.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 BulkAppInstallAd nesnesini karşıya yükleyip indirebilirsiniz.
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkAppInstallAd
var bulkAppInstallAd = new BulkAppInstallAd
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
// 'Ad Group' column header in the Bulk file
AdGroupName = "AdGroupNameGoesHere",
// 'Campaign' column header in the Bulk file
CampaignName = "ParentCampaignNameGoesHere",
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// AppInstallAd object of the Campaign Management service.
AppInstallAd = new AppInstallAd
{
// 'App Platform' column header in the Bulk file
AppPlatform = "Android",
// 'App Id' column header in the Bulk file
AppStoreId = "AppStoreIdGoesHere",
// 'Device Preference' column header in the Bulk file
DevicePreference = 0,
// 'Final Url' column header in the Bulk file
FinalUrls = new[] {
// Each Url is delimited by a semicolon (;) in the Bulk file
"FinalUrlGoesHere"
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdStatus.Active,
// 'Text' column header in the Bulk file
Text = "Find New Customers & Increase Sales!",
// 'Title' column header in the Bulk file
Title = "Contoso Quick Setup",
// 'Tracking Template' column header in the Bulk file
TrackingUrlTemplate = null,
// 'Custom Parameter' column header in the Bulk file
UrlCustomParameters = new CustomParameters
{
// Each custom parameter is delimited by a semicolon (;) in the Bulk file
Parameters = new[] {
new CustomParameter(){
Key = "promoCode",
Value = "PROMO1"
},
new CustomParameter(){
Key = "season",
Value = "summer"
},
}
},
},
};
uploadEntities.Add(bulkAppInstallAd);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
Uygulama Yükleme Reklam kaydı için Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları bulunur. Uygulama Kimliği, Uygulama Platformu, Metin ve Başlık alanlarının birleşimi, uygulama yükleme reklamını benzersiz hale getirir.
- Reklam Grubu
- Uygulama Kimliği
- Uygulama Platformu
- Kampanya
- İstemci Kimliği
- Özel Parametre
- Cihaz Tercihi
- Editoryal İtiraz Durumu
- Editoryal Konum
- Editoryal Neden Kodu
- Editoryal Durum
- Editoryal Terim
- Son Url
- Son Url Soneki
- Kimlik
- Değiştirme Zamanı
- Üst Kimlik
- Yayımcı Ülkeleri
- Durum
- Metin
- Başlık
- İzleme Şablonu
Reklam Grubu
Reklamı içeren reklam grubunun 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 Ad Grubu alanını belirtmeniz gerekir.
Uygulama Kimliği
Uygulama mağazası tarafından sağlanan uygulama tanımlayıcısı.
Uygulama yeniyse, reklamın teslim edilmeye uygun hale gelmesi için lütfen 4-7 gün beklemeyi bekleyin.
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
Uygulama Platformu
Uygulama platformu.
Olası değerler iOS ve Android'i içerir.
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
Reklam grubunu ve reklamı içeren kampanyanın adı.
Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur
İ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ı
Silmek: Salt okunur
Özel Parametre
URL izleme için özel anahtar ve değer parametreleri koleksiyonunuz.
Toplu bir dosyada, özel parametrelerin listesi aşağıdaki gibi biçimlendirilir.
Her özel parametre çiftini Key=Value olarak biçimlendirin, örneğin {_promoCode}=PROMO1.
Microsoft Advertising, dahil ettiğiniz ilk 8 özel parametre anahtarı ve değer çiftini kabul eder ve 8'den fazla özel parametre eklerseniz hata döndürülür. Her anahtar ve değer çifti noktalı virgül ve boşlukla ("; "), örneğin {_promoCode}=PROMO1; {_season}=summer.
Anahtar noktalı virgül içeremez. Bir Değer noktalı virgül içeriyorsa , '\;' olarak kaçış olmalıdır. Buna ek olarak, Değer ters eğik çizgi içeriyorsa , '\' olarak da kaçılmalıdır.
Anahtar 16 UTF-8 bayt'ı ve Değer 250 UTF-8 bayt'ı aşamaz. Anahtar gereklidir ve Değer isteğe bağlıdır. Anahtarın en büyük boyutu ayraçları ve alt çizgiyi (örneğin, '{', '_' ve '}' içermez.
Not
Toplu hizmet ile Anahtar çevresindeki küme ayraçlarıyla ve baştaki bir alt çizgiyle biçimlendirilmelidir; örneğin Anahtar promoCode ise {_promoCode} olarak biçimlendirilmelidir. Kampanya Yönetimi hizmetiyle, çevresindeki ayraçları ve alt çizgiyi belirtemezsiniz.
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
Cihaz Tercihi
Bu alan, uygulama yükleme reklamlarının mobil ve tablet cihazlarda mı yoksa yalnızca mobil cihazlarda mı görüntüleneceğini belirler. (Uygulama yükleme reklamları şu anda masaüstü bilgisayarlarda desteklenmiyor.)
Olası değerler, kampanya yönetimi hizmetinde kullanılan değerlerden farklı olan Tümü (mobil ve tablet cihazları) ve Mobil (tabletler hariç) değerleridir.
Varsayılan değer Tümü'dür.
Toplu indirme ve karşıya yükleme sonuçları dosyasında bu alan hiçbir zaman boş olmaz. Bir cihaz tercihi belirtmediyseniz Tümü varsayılan değeri döndürülür.
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. Bu alanı delete_value olarak ayarlarsanız, etkin bir şekilde Varsayılan Tümü değerine sıfırlarsınız.
Silmek: Salt okunur
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
Reklamın editoryal durumu.
Olası değerler aşağıdaki tabloda açıklanmıştır.
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
Son Url
Arama kullanıcısının indiği ve uygulamayı yüklemeyi seçebildiği URL.
Uygulama yükleme reklamları için Son Url 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.
- Bu alanda yalnızca bir Url belirtebilirsiniz.
- '{' 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.
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
Son Url Soneki
Son URL soneki, giriş sayfası URL'nizin sonuna eklenecek izleme parametrelerini içerebilir. Müşterilerinizin her zaman giriş sayfanıza gönderilmesi için giriş sayfanızın gerektirdiği izleme parametrelerini son URL son ekine yerleştirmenizi öneririz. Daha fazla ayrıntı ve doğrulama kuralları için teknik kılavuzlardaki Son URL Son Eki'ne bakın.
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
Kimlik
Reklamın 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 sonra reklam için negatif tanımlayıcı kümesine, Uygulama Yükleme Reklam Etiketi gibi bağımlı kayıt türlerinin Üst Kimlik alanında başvurulabilir. Aynı Toplu dosyaya yeni reklamlar ve yeni bağımlı kayıtlar 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
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
Reklamı içeren reklam grubunun sistem tarafından oluşturulan tanımlayıcısı.
Bu toplu alan, Ad Grubu kaydının Kimlik alanına eşler.
Ekle: Salt okunur ve Gerekli. Mevcut bir reklam grubu tanımlayıcısı belirtmeniz veya üst Ad Grubu kaydının Kimlik alanına eşit bir negatif tanımlayıcı belirtmeniz gerekir. Aynı Toplu dosyadaki yeni bir reklam grubuna yeni reklamlar ekliyorsanız bu önerilir. Daha fazla bilgi için bkz. Toplu Dosya Şeması Başvuru Anahtarları.
Güncelleştirme: Salt okunur
Silmek: Salt okunur
Not
Ekleme, güncelleştirme ve silme için Üst Kimlik veya Ad Grubu alanını belirtmeniz gerekir.
Yayımcı Ülkeleri
Editör yönergeleri belirtilen terime izin verilmeyen yayımcı ülkelerinin veya bölgelerinin listesi.
Toplu dosyada, yayımcı ülke veya bölge listesi noktalı virgülle (;)) sınırlandırılır.
Ekle: Salt okunur
Güncelleştirme: Salt okunur
Silmek: Salt okunur
Durum
Reklamın durumu.
Olası değerler Etkin, Duraklatılmış veya Silinmiş olabilir.
Ekle: Isteğe bağlı. Varsayılan değer Etkin'dir.
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.
Metin
Reklam kopyası. Kopya en az bir sözcük içermelidir. Reklamın kopyası ve başlığı toplam en az üç sözcük olmalıdır.
Reklam kopyası {keyword} gibi dinamik metin dizeleri içeremez.
Kopyanın giriş uzunluğu üst sınırı 71 karakterdir. Geleneksel Çince kullanan reklam grupları için metnin 38 karakterle sınırlı olduğunu unutmayın.
Reklam kopyası yeni satır (\n) karakterini içeremez.
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
Reklamın başlığı. Başlık en az bir sözcük içermelidir. Reklamın kopyası ve başlığı toplam en az üç sözcük olmalıdır.
Başlık {keyword} gibi dinamik metin dizeleri içeremez.
Başlığın giriş uzunluğu üst sınırı 25 karakterdir. Geleneksel Çince kullanan reklam grupları için başlığın 15 karakterle sınırlı olduğunu unutmayın.
Başlık yeni satır (\n) karakterini içeremez.
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
İzleme Şablonu
FinalUrls ile belirtilen URL için varsayılan olarak kullanılacak izleme şablonu.
Aşağıdaki doğrulama kuralları, izleme şablonları için geçerlidir. Desteklenen şablonlar ve parametreler hakkında daha fazla ayrıntı için Hangi izleme veya URL parametrelerini kullanabilirim? Microsoft Advertising yardım makalesine bakın.
Düşük düzeyli varlıklar için tanımlanan izleme şablonları(ör. reklamlar, kampanya gibi daha üst düzey varlıklar için ayarlananları geçersiz kılar). Daha fazla bilgi için bkz . Varlık Sınırları.
İzleme şablonunun 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.
İzleme şablonu aşağıdakilerden biriyle başlayan iyi biçimlendirilmiş bir URL olmalıdır: http://, https://, {lpurl}, veya {unescapedlpurl}.
Microsoft Advertising, özel parametrelerin mevcut olup olmadığını doğrulamaz. İzleme şablonunuzda özel parametreler kullanıyorsanız ve bunlar yoksa, giriş sayfası URL'si değiştirme olmadan özel parametrelerinizin anahtar ve değer yer tutucularını içerir. Örneğin, izleme şablonunuz
https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}
ise ve kampanya, reklam grubu, ölçüt, anahtar sözcük veya reklam düzeyinde {_season} veya {_promocode} tanımlanmamışsa, giriş sayfası URL'si aynı olur.
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
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin