Aracılığıyla paylaş


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

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.

Değer Açıklama
Etkin Reklam, editoryal incelemeden geçti.
ActiveLimited Reklam, bir veya daha fazla pazarda editoryal incelemeden geçti ve reklamın bir veya daha fazla öğesi başka bir pazarda editoryal incelemeden geçiyor. Örneğin reklam, Kanada için editoryal incelemeden geçmiştir ve Birleşik Devletler incelemeyi beklemeye devam etmektedir.
Onaylanmadı Reklam, editoryal incelemede başarısız oldu.
Etkin olmayan Reklamın bir veya daha fazla öğesi editör tarafından inceleniyor.

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