Aracılığıyla paylaş

Arama Reklam Uzantısı Kaydı - Toplu

  • Makale

Toplu bir dosyaya yüklenip indirilebilen bir arama reklam uzantısı tanımlar.

Bir arama reklam uzantısını hesaptaki kampanyalarla ilişkilendirebilirsiniz. Her varlık (kampanya) tek bir çağrı reklam uzantısıyla ilişkilendirilebilir. Arama reklam uzantısı ilişkilendirmelerini yönetmek için Kampanya Çağrısı Reklam Uzantısı kaydını kullanın.

DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine CallAdExtensionsDownloadEntity değerini ekleyerek hesaptaki tüm Arama Reklam Uzantısı 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, hesabın paylaşılan kitaplığına yeni bir Arama Reklam Uzantısı ekler.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Phone Number,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Country Code,Call Only,Call Tracking Enabled,Toll Free
Format Version,,,,,,,,,,,,6.0,,,,,,
Call Ad Extension,Active,-12,0,,,ClientIdGoesHere,,,12/31/2020,2065550100,,,(Monday[09:00-21:00]),FALSE,US,TRUE,TRUE,FALSE

.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 BulkCallAdExtension nesnesini karşıya yükleyip indirebilirsiniz.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCallAdExtension
var bulkCallAdExtension = new BulkCallAdExtension
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // CallAdExtension object of the Campaign Management service.
    CallAdExtension = new CallAdExtension
    {
        // 'Country Code' column header in the Bulk file
        CountryCode = "US",
        // 'Id' column header in the Bulk file
        Id = callAdExtensionIdKey,
        // 'Call Only' column header in the Bulk file
        IsCallOnly = true,
        // 'Call Tracking Enabled' column header in the Bulk file
        IsCallTrackingEnabled = true,
        // 'Phone Number' column header in the Bulk file
        PhoneNumber = "2065550100",
        // 'Toll Free' column header in the Bulk file
        RequireTollFreeTrackingNumber = false,
                    
        // 'Ad Schedule' column header in the Bulk file
        Scheduling = new Schedule
        {
            // Each day and time range is delimited by a semicolon (;) in the Bulk file
            DayTimeRanges = new[]
            {
                // Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
                new DayTime
                {
                    Day = Day.Monday,
                    StartHour = 9,
                    StartMinute = Minute.Zero,
                    EndHour = 21,
                    EndMinute = Minute.Zero,
                },
            },
            // 'End Date' column header in the Bulk file
            EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
            {
                Month = 12,
                Day = 31,
                Year = DateTime.UtcNow.Year + 1
            },
            // 'Start Date' column header in the Bulk file
            StartDate = null,
            // 'Use Searcher Time Zone' column header in the Bulk file
            UseSearcherTimeZone = false,
        },

        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,
    },
};

uploadEntities.Add(bulkCallAdExtension);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Arama Ad Uzantısı kaydı için, Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları kullanılabilir.

Reklam Zamanlaması

Reklam uzantısının reklamlarınızla birlikte görüntülenmesini istediğiniz gün ve zaman aralıklarının listesi. Her gün ve zaman aralığı haftanın zamanlanmış gününü, başlangıç/bitiş saatini ve başlangıç/bitiş dakikasını içerir. Her gün ve zaman aralığı sol ve sağ parantez içine alınır ve diğer gün ve zaman aralıklarından noktalı virgülle (;) sınırlayıcı) ayrılır. Her gün ve zaman aralığında biçim Day[StartHour:StartMinue-EndHour:EndMinute] şeklindedir.

StartHour'un olası değerleri 00 ile 23 arasındadır ve burada 00 12:00 ve 12 12:00'dir.

EndHour'un olası değerleri 00 ile 24 arasındadır; burada 00 12:00 ve 12 de 12:00'dir.

StartMinute ve EndMinute değerlerinin olası değerleri 00 ile 60 arasında değişir.

Aşağıdaki örnekte hafta içi 09:00 ile 21:00 saatleri arasında gün ve saat aralıkları gösterilmektedir: (Pazartesi[09:00-21:00]);( Salı[09:00-21:00]); (Çarşamba[09:00-21:00]); (Perşembe[09:00-21:00]); (Cuma[09:00-21:00])

Ekle: Isteğe bağlı. Bu alanı ayarlamazsanız, reklam uzantısı takvim başlangıç ve bitiş tarihleri sırasında zamanlamaya uygun olacaktır.
Güncelleştirme: Isteğe bağlı. Tek tek gün ve zaman aralıkları güncelleştirilemez. Önceki kümenin yerini alması gereken yeni bir küme göndererek gün ve saat aralıklarını etkili bir şekilde güncelleştirebilirsiniz. Reklam Zamanlaması, Bitiş Tarihi, Başlangıç Tarihi ve Arama Saat DilimiNi Kullan alanları birbirine bağlıdır ve birlikte güncelleştirilir. Güncelleştirme sırasında bu alanların tümünü boş bırakırsanız, hiçbiri güncelleştirilmez. Bu alanlardan herhangi birinin değerlerini eklerseniz, bu alanların tümüne ait önceki değerler kaldırılır veya değiştirilir. Önceki tüm zamanlama ayarlarını kaldırmak için bu alanların her birini delete_value olarak ayarlayın.
Silmek: Salt okunur

Yalnızca Ara

Reklamlarınızı akıllı telefonda gören kişilere hem telefon numaranızı hem de web sitenizi veya yalnızca telefon numaranızı gösterme seçeneği. İşletmeniz her müşteriyle konuşmanızı gerektiriyorsa yalnızca telefon numaranızı göstermek isteyebilirsiniz.

Reklam uzantısının yalnızca web sitenizin bağlantısı olmadan telefon numarasını göstermesini istiyorsanız ve aksi takdirde reklam uzantısının, telefon numarasının yanı sıra web sitenize bir bağlantı eklemesini istiyorsanız TRUE olarak ayarlayın.

Ekle: Isteğe bağlı. Bu alanı belirtmezseniz veya boş bırakırsanız, FALSE varsayılan değeri ayarlanır ve reklam uzantısı telefon numarasına ek olarak web sitenizin bağlantısını içerir.
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

Arama İzleme Etkin

Arama reklam uzantısı için arama izlemenin etkinleştirilip etkinleştirilmediğini belirler.

Çağrı izlemeyi etkinleştirmek için bu özelliği TRUE olarak ayarlayın ve aksi takdirde FALSE olarak ayarlayın.

Not

Arama izleme yalnızca Birleşik Devletler ve Birleşik Krallık'ta desteklenir.

Ekle: Isteğe bağlı. Bu alanı belirtmezseniz veya boş bırakırsanız, VARSAYıLAN YANLIŞ değeri ayarlanı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: 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

Ülke Kodu

Telefon numarasının kayıtlı olduğu ülke kodu.

Ülke kodu 2 karakterli bir ülke kodu içermelidir. 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: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.
Silmek: Salt okunur

Editoryal Konum

Editoryal incelemede başarısız olan reklam uzantısını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 uzantısının editoryal durumu.

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

Değer Açıklama
Etkin Reklam uzantısı, editoryal incelemeden geçti.
ActiveLimited Reklam uzantısı bir veya daha fazla pazarda editoryal incelemeden geçmiştir ve reklam uzantısının bir veya daha fazla öğesi başka bir pazarda editoryal incelemeden geçiriliyor. Örneğin, reklam uzantısı Kanada için editoryal incelemeden geçmiştir ve Birleşik Devletler hala gözden geçirmeyi bekliyor.
Onaylanmadı Reklam uzantısı editoryal incelemede başarısız oldu.
Etkin olmayan Reklam uzantısını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

Bitiş Tarihi

Reklam uzantısı, AA/GG/YYYY olarak biçimlendirilmiş zamanlanmış bitiş tarihi dizesidir.

Bitiş tarihi kapsayıcıdır. Örneğin, bu alanı 31.12.2020 olarak ayarlarsanız, reklam uzantıları 31.12.2020 tarihinde saat 23:59'da gösterilmeyi durdurur.

Ekle: Isteğe bağlı. Bir bitiş tarihi belirtmezseniz ilişkili kampanyaları, reklam gruplarını veya reklamları duraklatmadığınız sürece reklam uzantısı yayınlanmaya devam eder.
Güncelleştirme: Isteğe bağlı. Başlangıç tarihi null olduğu veya yeni bitiş tarihinden önce gerçekleştiği sürece bitiş tarihi kısaltılabilir veya uzatılabilir. Bu alanı delete_value dizesi olarak ayarlarsanız, bitiş tarihini etkili bir şekilde kaldıracaksınız. Reklam Zamanlaması, Bitiş Tarihi, Başlangıç Tarihi ve Arama Saat DilimiNi Kullan alanları birbirine bağlıdır ve birlikte güncelleştirilir. Güncelleştirme sırasında bu alanların tümünü boş bırakırsanız, hiçbiri güncelleştirilmez. Bu alanlardan herhangi birinin değerlerini eklerseniz, bu alanların tümüne ait önceki değerler kaldırılır veya değiştirilir. Önceki tüm zamanlama ayarlarını kaldırmak için bu alanların her birini delete_value olarak ayarlayın.
Silmek: Salt okunur

Kimlik

Reklam uzantısını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 uzantısı için negatif tanımlayıcı kümesine, Kampanya Çağrısı Reklam Uzantısı gibi bağımlı kayıt türlerinin Kimlik alanında başvurulabilir. Aynı Toplu dosyaya yeni reklam uzantıları 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 uzantısını içeren hesabın sistem tarafından oluşturulan tanımlayıcısı.

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

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

Telefon Numarası

Reklama eklenecek tıklanabilir telefon numarası.

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

Kampanyada arama ve konum reklam uzantıları varsa, bu telefon numarası konum reklam uzantılarında belirtilen telefon numarasını geçersiz kılar.

Telefon numarası yeniden biçimlendirilmiş olabilir. Örneğin, telefon numarasını 4255551212 olarak ayarlarsanız, (425) 555-1212 olarak yeniden biçimlendirilir.

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

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

Başlangıç Tarihi:

Reklam uzantısı, AA/GG/YYYY olarak biçimlendirilmiş zamanlanmış başlangıç tarihi dizesidir.

Başlangıç tarihi dahil. Örneğin , StartDate değerini 5/5/2020 olarak ayarlarsanız reklam uzantıları 5/5/2020 tarihinde saat 12:00'de gösterilmeye başlar.

Ekle: Isteğe bağlı. Başlangıç tarihi belirtmezseniz, reklam uzantısı hemen zamanlamaya uygundur.
Güncelleştirme: Isteğe bağlı. Bitiş tarihi null olduğu veya yeni başlangıç tarihinden sonra gerçekleştiği sürece başlangıç tarihi kısaltılabilir veya uzatılabilir. Bu alanı delete_value dizesi olarak ayarlarsanız başlangıç tarihini etkin bir şekilde kaldırmış olursunuz ve reklam uzantısı hemen zamanlamaya uygundur. Reklam Zamanlaması, Bitiş Tarihi, Başlangıç Tarihi ve Arama Saat DilimiNi Kullan alanları birbirine bağlıdır ve birlikte güncelleştirilir. Güncelleştirme sırasında bu alanların tümünü boş bırakırsanız, hiçbiri güncelleştirilmez. Bu alanlardan herhangi birinin değerlerini eklerseniz, bu alanların tümüne ait önceki değerler kaldırılır veya değiştirilir. Önceki tüm zamanlama ayarlarını kaldırmak için bu alanların her birini delete_value olarak ayarlayın.
Silmek: Salt okunur

Durum

Reklam uzantısının durumu.

Olası değerler Etkin veya Silinmiş değerlerdir.

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.

Ücret -siz

Kendi telefon numaranızı veya Microsoft Advertising iletme telefon numarasını kullanabilirsiniz. Microsoft Advertising iletme telefon numarası, iş telefon numaranıza yönlendirilen benzersiz bir telefon numarasıdır. Microsoft Advertising iletme numarasıyla, reklamınızın performansını analiz edebilmeniz için reklamınızın tüm çağrılarını izleyebilirsiniz. Bu alan, arama izleme için ücretsiz bir Microsoft Advertising iletme telefon numarası oluşturulup oluşturulmayacağını belirler. Bu alan yalnızca Arama İzleme Etkin alanı da TRUE olduğunda ayarlanabilir.

Ağustos 2017'den önce, arama izleme için bir Microsoft Advertising iletme telefon numarası oluşturulması gerekiyorsa istemciler bu özelliği TRUE olarak ayarlayabilirdi. Ağustos 2017'den bu yana müşteriler artık ücretsiz yeni bir Microsoft Advertising iletme telefon numarası oluşturamıyor. Bu değeri TRUE olarak ayarlarsanız işlem başarılı olur; ancak ücretsiz bir numara oluşturulmaz ve arama reklam uzantısını aldığınızda bu özellik FALSE olarak ayarlanır. Ağustos 2017'den önce ücretsiz iletme numarası sağlanmışsa, arama reklam uzantısını aldığınızda numara hala etkinse bu özellik TRUE olur.

Ekle: Isteğe bağlı. Bu alanı belirtmezseniz veya boş bırakırsanız, VARSAYıLAN YANLIŞ değeri ayarlanı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: Salt okunur

Arama Saat Dilimini Kullanma

Hesap saat diliminin mi yoksa reklamların gönderilebileceği arama kullanıcısının saat diliminin mi kullanılacağını belirler.

Reklam uzantılarının arama kullanıcısının saat diliminde gösterilmesini istiyorsanız bu özelliği TRUE olarak ayarlayın ve aksi takdirde FALSE olarak ayarlayın.

Ekle: Isteğe bağlı. Bu alanı belirtmezseniz veya boş bırakırsanız, FALSE varsayılan değeri ayarlanır ve hesap saat dilimi kullanılır.
Güncelleştirme: Isteğe bağlı. Bu alanı delete_value dizesi olarak ayarlarsanız, etkin bir şekilde VARSAYıLAN YANLIŞ değerine sıfırlarsınız. Reklam Zamanlaması, Bitiş Tarihi, Başlangıç Tarihi ve Arama Saat DilimiNi Kullan alanları birbirine bağlıdır ve birlikte güncelleştirilir. Güncelleştirme sırasında bu alanların tümünü boş bırakırsanız, hiçbiri güncelleştirilmez. Bu alanlardan herhangi birinin değerlerini eklerseniz, bu alanların tümüne ait önceki değerler kaldırılır veya değiştirilir. Önceki tüm zamanlama ayarlarını kaldırmak için bu alanların her birini delete_value olarak ayarlayın.
Silmek: Salt okunur

Sürüm

Reklam uzantısının içeriğinin güncelleştirildiği sayı. Uzantıyı eklediğinizde sürüm 1 olarak ayarlanır ve her düzeltildiğinde artırılır.

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