Konum Reklam Uzantısı Kaydı - Toplu
Toplu dosyada indirilebilen ve karşıya yüklenebilecek bir konum reklam uzantısı tanımlar.
Bir konum reklam uzantısını hesapla veya hesaptaki kampanyalarla ilişkilendirebilirsiniz. Her varlık (hesap veya kampanya), karar verdikçe hesabınızdaki toplam konum reklamı uzantısı sayısına kadar birçok konum reklamı uzantısıyla ilişkilendirilebilir. Konum reklam uzantısı ilişkilendirmelerini yönetmek için Hesap Konumu Reklam Uzantısı ve Kampanya Konumu Reklam Uzantısı kayıtlarını kullanın.
DownloadCampaignsByAccountIds veya DownloadCampaignsByCampaignIds hizmet isteğine LocationAdExtensionsDownloadEntity değerini ekleyerek hesaptaki tüm Konum 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 Konum Reklam Uzantısı ekler.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Business Name,Phone Number,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Address Line 1,Address Line 2,Postal Code,City,State Or Province Code,Province Name,Latitude,Longitude,Country Code
Format Version,,,,,,,,,,,,,6.0,,,,,,,,,,,
Location Ad Extension,Active,-15,0,,,ClientIdGoesHere,,,12/31/2020,Contoso Shoes,206-555-0100,,,(Monday[09:00-21:00]),FALSE,1234 Washington Place,Suite 1210,98608,Woodinville,,WA,0,0,US
.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 BulkLocationAdExtension nesnesini karşıya yükleyip indirebilirsiniz.
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkLocationAdExtension
var bulkLocationAdExtension = new BulkLocationAdExtension
{
// '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
// LocationAdExtension object of the Campaign Management service.
LocationAdExtension = new LocationAdExtension
{
Address = new Address
{
// 'City' column header in the Bulk file
CityName = "Woodinville",
// 'Country Code' column header in the Bulk file
CountryCode = "US",
// 'Postal Code' column header in the Bulk file
PostalCode = "98608",
// 'State Or Province Code' column header in the Bulk file
ProvinceCode = null,
// 'Province Name' column header in the Bulk file
ProvinceName = "WA",
// 'Address Line 1' column header in the Bulk file
StreetAddress = "1234 Washington Place",
// 'Address Line 2' column header in the Bulk file
StreetAddress2 = "Suite 1210",
},
// 'Business Name' column header in the Bulk file
CompanyName = "Contoso Shoes",
// 'Geo Code Status' column header in the Bulk file
GeoCodeStatus = null,
GeoPoint = new GeoPoint
{
// 'Latitude' column header in the Bulk file
LatitudeInMicroDegrees = 0,
// 'Longitude' column header in the Bulk file
LongitudeInMicroDegrees = 0,
},
// 'Id' column header in the Bulk file
Id = locationAdExtensionIdKey,
// 'Phone Number' column header in the Bulk file
PhoneNumber = "206-555-0100",
// '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(bulkLocationAdExtension);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
Konum Reklam Uzantısı kaydı için Toplu Dosya Şeması'nda aşağıdaki öznitelik alanları kullanılabilir.
- Reklam Zamanlaması
- Adres Satırı 1
- Adres Satırı 2
- İş Adı
- Şehir
- İstemci Kimliği
- Ülke Kodu
- Editoryal Konum
- Editoryal Neden Kodu
- Editoryal Durum
- Editoryal Terim
- Bitiş Tarihi
- Coğrafi Kod Durumu
- Kimlik
- Enlem
- Boylam
- Değiştirme Zamanı
- Üst Kimlik
- Telefon Numarası
- Posta Kodu
- İl Adı
- Yayımcı Ülkeleri
- Başlangıç Tarihi:
- Eyalet veya İl Kodu
- Durum
- Arama Saat Dilimini Kullanma
- Sürüm
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
Adres Satırı 1
Adresin ilk satırı.
İlk satır en fazla 80 karakter içerebilir.
Ekle: Gerekli
Güncelleştirme: Gerekli
Silmek: Salt okunur
Adres Satırı 2
Adresin ikinci satırı.
İkinci satır en fazla 80 karakter içerebilir.
Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, önceki ayar kaldırılır.
Silmek: Salt okunur
İş Adı
İşletmenin adı.
Ad en fazla 80 karakter içerebilir.
Ekle: Gerekli
Güncelleştirme: Gerekli
Silmek: Salt okunur
Şehir
Sokak adresinin bulunduğu şehrin adı.
Ad en fazla 80 karakter içerebilir.
Ekle: Gerekli
Güncelleştirme: Gerekli
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
Sokak adresinin bulunduğu ülke veya bölge.
Ü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: Gerekli
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.
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
Coğrafi Kod Durumu
İşletmenin enlem ve boylam koordinatlarının belirlenip belirlenmediğini gösteren bir durum değeri.
Koordinatları sağlarsanız, durum Tamamlandı olarak ayarlanır; aksi takdirde durum, belirtilen işletme adresinin koordinatlarını belirleme işleminin ilerleme durumunu gösterir.
Olası değerler aşağıdaki tabloda açıklanmıştır.
Ekle: Salt okunur
Güncelleştirme: Salt okunur
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 Konumu 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
Enlem
Derece cinsinden belirtilen enlem. Enlem -85'ten büyük veya buna eşit ve +85'ten küçük veya buna eşit olmalıdır.
Not
Kampanya Yönetimi hizmeti, -85000000 ile 850000000 arasında mikro dereceler kullanır. BulkLocationAdExtension'ı SDK'lar aracılığıyla kullandığınızda, BulkLocationAdExtension uygulaması mikro derecelerden dönüştürüldüğünden ve değeri Bulk dosyasına derece olarak yazdığından mikro derece kullanmanız gerekir.
Enlem ve boylam koordinatları, kullanıcı reklamdaki adrese tıkladığında işletmenin konumunu Bing Haritalar işaretlemek için kullanılır. Belirtilen koordinatlar geçerli değerler aralığında değilse, hizmet koordinatları adrese göre belirler.
Bilinen koordinatları belirtirseniz, hizmet belirtilen koordinatların belirtilen iş adresiyle eşleşip eşleşmediğini onaylamaz. Koordinatları sağlamazsanız, Toplu hizmet koordinatları belirlemek için işletmelerin adresini kullanır.
Not
10'dan fazla konum reklam uzantısı eklerken hizmet, koordinatları çevrimdışı olarak çözer ve hizmet işleminin yürütülmesi sırasında koordinatları önceden çözer. Konum, koordinatlar belirlenene kadar bir reklamda kullanılmaz ve eklenen konum reklam uzantılarının sayısına ve geçerli talebe bağlı olarak saniyeler ile dakikalar arasında sürebilir.
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.
Silmek: Salt okunur
Boylam
Derece cinsinden belirtilen boylam. Boylam -180'den büyük veya buna eşit ve +180'den küçük veya buna eşit olmalıdır.
Not
Kampanya Yönetimi hizmeti, -180000000 ile 1800000000 arasında mikro dereceler kullanır. BulkLocationAdExtension'ı SDK'lar aracılığıyla kullandığınızda, BulkLocationAdExtension uygulaması mikro derecelerden dönüştürüldüğünden ve değeri Bulk dosyasına derece olarak yazdığından mikro derece kullanmanız gerekir.
Enlem ve boylam koordinatları, kullanıcı reklamdaki adrese tıkladığında işletmenin konumunu Bing Haritalar işaretlemek için kullanılır. Belirtilen koordinatlar geçerli değerler aralığında değilse, hizmet koordinatları adrese göre belirler.
Bilinen koordinatları belirtirseniz, hizmet belirtilen koordinatların belirtilen iş adresiyle eşleşip eşleşmediğini onaylamaz. Koordinatları sağlamazsanız, Toplu hizmet koordinatları belirlemek için işletmelerin adresini kullanır.
Not
10'dan fazla konum reklam uzantısı eklerken hizmet, koordinatları çevrimdışı olarak çözer ve hizmet işleminin yürütülmesi sırasında koordinatları önceden çözer. Konum, koordinatlar belirlenene kadar bir reklamda kullanılmaz ve eklenen konum reklam uzantılarının sayısına ve geçerli talebe bağlı olarak saniyeler ile dakikalar arasında sürebilir.
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.
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
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ı
İşletmenin 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.
Kampanya bir arama uzantısı da içeriyorsa, arama uzantısındaki telefon numarası konum reklam uzantısının telefon numarasını geçersiz kılar.
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.
Silmek: Salt okunur
Posta Kodu
Posta veya posta kodu.
Posta kodu en fazla 80 karakter içerebilir.
Ekle: Isteğe bağlı
Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, önceki ayar kaldırılır.
Silmek: Salt okunur
İl Adı
Sokak adresinin bulunduğu eyaletin veya eyaletin adı, örneğin Washington.
Ad en fazla 50 karakter içerebilir.
İl Adı veya Eyalet veya İl Kodu belirtmeniz gerekir.
Not
Ülke Kodu alanı FR, IE veya SG olarak ayarlandıysa Eyalet veya İl Kodu ve İl Adı gerekli değildir.
Ekle: Gerekli
Güncelleştirme: Gerekli
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
Eyalet veya İl Kodu
Sokak adresinin bulunduğu eyalet veya ili tanımlayan bir kod, örneğin WA.
Kod en fazla 50 karakter içerebilir.
İl Adı veya Eyalet veya İl Kodu belirtmeniz gerekir.
Not
Ülke Kodu alanı FR, IE veya SG olarak ayarlandıysa Eyalet veya İl Kodu ve İl Adı gerekli değildir.
Ekle: Gerekli
Güncelleştirme: Gerekli
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.
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