Bu makale, Bing Ads API hakkında sık sorulan bazı soruların yanıtlarını içerir.
Yardım Alma
Nereden yardım alabilirim?
Microsoft Q&A forumu, geliştirici topluluğunun Bing Ads API'leri ve Microsoft Reklam Betikleri hakkındaki soruları sorması ve yanıtlaması için kullanılabilir. Microsoft forumları izler ve topluluğun henüz yanıtlamadığı soruları yanıtlar.
Önemli
Sorunuzu gördüğümüzden emin olmak için bunu 'advertising-api' ile etiketleyin.
Araştırmada hassas hesap veya kişisel ayrıntılar varsa veya Microsoft Q&A aracılığıyla sorununuzu çözmek için ihtiyacınız olan bilgileri bulamadıysanız lütfen Microsoft Reklam Desteği ile iletişime geçin. Sorunu verimli bir şekilde çözmek için lütfen destek ekibiyle etkileşimde bulunma konusunda istenen ayrıntıları sağlayın.
Değişiklikler hakkında nasıl bilgi edinebilirim?
Sürüm Notları ve Geçiş Kılavuzu, başlangıç olarak harika kaynaklardır.
Geliştirici Portalı'nın Haberler sekmesinden aylık bültene kaydolabilirsiniz ve en son blog duyuruları da burada toplanır.
Başlarken
Bing Ads API'sini kullanma gereksinimleri nelerdir?
Başlamak için bir Microsoft Advertising hesabına kaydolmanız ve geliştirici belirtecinizi Geliştirici Portalı'nın Hesap sekmesinden almanız gerekir.
Hangi programlama dilleri ve SDK'lar desteklenir?
Web hizmetlerini destekleyen herhangi bir programlama diliyle Bing Ads API uygulamaları geliştirebilirsiniz. Bing Ads API Yazılım Geliştirme Setleri (SDK), .NET, Java, PHP ve Python dilleriyle Bing Ads API uygulamaları geliştirme deneyimini geliştirir. Her SDK, tüm Bing Ads API web hizmetlerinin ara sunucusunu içerir ve OAuth ile kimlik doğrulamasının düşük düzey ayrıntılarını soyutlar. Düşük düzey Toplu ve Raporlama hizmetlerindeki işlemleri soyutlayıp yürütmek için üst düzey BulkServiceManager ve ReportingServiceManager arabirimlerini kullanabilirsiniz.
Yakın dönemde destek ekleme planı olmasa da perl ve Ruby gibi ek SDK'lar için istekler aldık.
Kod örneklerini farklı programlama dillerinde nasıl görüntüleyebilirim?
Kod Örnekleri'ne ek olarak, birçok teknik kılavuzda (örneğin Kullanmaya Başlama kılavuzu) kod parçacıkları bulabilirsiniz. CSharp, Java, Php veya Python'daki örnekleri görüntülemek için bu sayfaların üstündeki veya sağındaki dil seçiciyi kullanabilirsiniz. Bir dil seçtiğinizde, diğer sayfalarda gezinirken ayar korunur. Dil seçici yalnızca belirli bir sayfa için örnekleri olan dilleri içerir ve daha önce ayarladığınız dil, gezindiğiniz sayfa için kullanılamıyorsa varsayılan olarak C# olarak ayarlanır.
Özellik Kullanılabilirliği
Toplu veya Kampanya Yönetimi API'sini mi kullanmalıyım?
Özellikle bir hesaptaki birden çok reklam grubuna veya kampanyaya reklam ve anahtar sözcük eklemeniz veya güncelleştirmeniz gerekiyorsa Toplu hizmet önerilir. Bazı özellikler Toplu olarak kullanılamaz; örneğin AddUetTags, GetBMCStoresByCustomerId, GetGeoLocationsFileUrl ve GetMediaMetaDataByAccountId. Bu özellikler için elbette Kampanya Yönetimi hizmetini kullanmanız gerekir.
Hangi API performans raporları kullanılabilir ve verilerim ne zaman kullanılabilir olacak?
Raporlama hizmeti, Microsoft Advertising web uygulamasında bulabileceğiniz rapor türlerinin çoğunu destekler. Kullanılabilirlik ayrıntıları için Rapor Öznitelikleri ve Performans İstatistikleri ve Raporlama Verileri Saklama Zaman Aralıkları kılavuzlarını gözden geçirin.
Bir kullanıcı bir reklama tıkladığında, sistemin tıklamayı işlemesi (dönüşümler için 3 saat) ve bunu raporlama için kullanılabilir hale getirmesi iki saat kadar sürebilir. Önceki güne ilişkin tüm veriler işlendiğinde ve raporlama için kullanıma sunulduğunda, bu durum Kapalı Kitaplar olarak adlandırılır. Defterlerin raporlama için ne zaman kapattığı hakkında daha fazla bilgi için bkz. Raporlama'da Saat Dilimleri.
OAuth
Bing Ads API, İçerik API'si ve Otel Fiyat Reklamları API'si aracılığıyla çok faktörlü kimlik doğrulaması ne zaman gerekli olacak?
Önemli
Haziran 2022'de, Bing Ads gereksinimi olarak çok faktörlü kimlik doğrulamasını kullanıma aldık. Bu gereksinimle uyumlu olmak için yine de kod değişikliği yapmanız gerekebilir. Microsoft Advertising, Ekim ayının başlarında teknik uygulama denetimleri gerçekleştiriyor.
Bu blog gönderisinde uyumluluğu sağlamak için gerçekleştirmeniz gereken adımlar özetlenmiştir.
Daha fazla bilgi için çok faktörlü kimlik doğrulama gereksinimi kılavuzuna bakın.
Çok faktörlü kimlik doğrulama gereksinimine uymak için herhangi bir değişiklik yapmam gerekiyor mu?
Uygulamanızı Microsoft kimlik platformu uç noktası aracılığıyla yeni msads.manage
kapsamı kullanacak şekilde güncelleştirmeniz gerekir. Yeni kapsamı kullanmak için tüm uygulama geliştiricilerin işlem yapması gerekir.
Yeni kapsam ve Microsoft kimlik platformu uç noktası aracılığıyla msads.manage
kullanıcıdan onay istemeniz gerekir.
msads.manage kullanmak için yeni bir uygulama kaydetmem gerekiyor mu?
0000000012345A67 gibi onaltılık değer olarak biçimlendirilmiş eski bir uygulama kimliğiniz (diğer adıyla İstemci Kimliği) varsa, yeni bir uygulama kaydetmeniz gerekir. Geçerli Microsoft kimlik platformu uygulama kimlikleri, 00001111-aa-2222-bbbb-3333cccc44444 gibi tirelerle GUID olarak biçimlendirilir. Azure portal - Uygulama kayıtları içinde mevcut bir uygulama görmüyorsanız, bu uygulamayı yeni bir uygulamayla değiştirmeniz gerektiğinin göstergesidir.
Msads.manage'a yükselttiğim zaman kullanıcının onay vermesi gerekiyor mu?
Evet. Yeni kapsam ve Microsoft kimlik platformu uç noktası aracılığıyla msads.manage
kullanıcıdan onay istemeniz gerekir.
Microsoft kimlik platformu uç noktası üzerinden onay istendiğinde kullanıcı deneyimi nedir?
Microsoft kimlik platformu uç noktasıyla bir kullanıcıdan onay (ortak kiracıyı kullanarak) istediğinizde, kullanıcı oturum açma deneyimi kimlik bilgilerinin arkasındaki temel kimliğe bağlı olarak değişir.
- Yalnızca MSA kimliğine sahip bir kişi MSA oturum açma sayfasına yönlendirilir.
- Yalnızca Azure AD kimliği olan bir kişi, kuruluş oturum açma sayfasına yönlendirilir.
- Kimlik bilgileri hem MSA hem de Azure AD etki alanlarında geçerli olan bir kişi, kendi kişisel kimliğiyle iş veya okul kimliği arasında seçim yapmalarını isteyen bir kesinleştirme sayfasıyla karşılaşır. Bu kullanıcının aynı e-posta adresine bağlı iki kimliği olduğu sürece bu kesinleştirme her zaman mevcut olacaktır. Kullanıcı , kişisel Microsoft hesabının e-posta adresini değiştirerek bunu görmeyi durdurabilir. Daha fazla bilgi için bkz. https://cloudblogs.microsoft.com/enterprisemobility/2016/09/15/cleaning-up-the-azure-ad-and-microsoft-account-overlap/.
Not
Uygulamanızın kullanıcılarının iş ve kişisel hesap gibi doğru kimlik bilgilerini seçmelerine yardımcı olmak için 122 ile 125 arasındaki işlem hata kodlarını işlemeniz gerekir.
Kullanıcı kişisel hesabını microsoft advertising'teki iş veya okul hesabına kullandığında yenileme belirtecine ne olur?
Kullanıcının artık bir MSA kişisel hesap kimliği yoksa, Bing Ads API artık mevcut erişim belirtecini kabul etmeyecektir. Benzer şekilde, yenileme belirteci artık yeni erişim belirteci istemek için kullanılamaz, bu nedenle uygulamanızın Microsoft Advertising hesaplarını yönetmesi için yeniden kullanıcı onayı istemeniz gerekir. Önceki yenileme belirtecini atmalısınız.
Korumalı alan iş veya okul hesaplarını destekliyor mu?
Hayır. İş veya okul hesapları yalnızca üretimde desteklenir.
Kullanıcı etkileşimi olmadan uygulamamı çalıştırmak istiyorum. Microsoft Advertising kimlik bilgilerini kullanma izni istenmeden nasıl kimlik doğrulaması yapabilirim?
Bir Microsoft Advertising hesabını program aracılığıyla yönetmek için web uygulaması onay akışı aracılığıyla en az bir kez onay vermeniz gerekir. Yineleme veya uzun süreli kimlik doğrulaması için, erişim belirteci ve yenileme belirteci almak için yetkilendirme kodu verme akışını izlemeniz gerekir. Bundan sonra, yeni erişim istemek ve başka kullanıcı etkileşimi olmadan belirteçleri yenilemek için en son yenileme belirtecini kullanabilirsiniz. Örneğin, kullanıcı hesap kurtarma işleminden geçtiyse, parolasını değiştirdiyse veya uygulamanızın kendi adına kimlik doğrulaması için izinlerini kaldırdıysa yeniden kullanıcı onayı istemeniz gerekebilir.
Erişim ve yenileme belirteçlerinin süresi ne zaman doluyor?
Erişim belirtecinin süresi genellikle bir saat sonra dolar, ancak her yeni belirteç istediğinizde her zaman süre sonunu denetlemeniz gerekir.
Yenileme belirteçleri uygulamanız için tamamen donuk ve her zaman olacaktır. Bunlar, genel istemciler için 90 gün gibi uzun sürelidir, ancak bir yenileme belirtecinin herhangi bir süre boyunca süreceğini beklemek için uygulama yazılmamalıdır. Yenileme belirteçleri her an geçersiz kılınabilir ve bir uygulamanın yenileme belirtecinin geçerli olup olmadığını bilmesinin tek yolu belirteç isteğinde bulunarak bunu kullanmaya çalışmaktır. Aynı cihazdaki belirteci en son yenileme belirteci ile sürekli yenileseniz bile, yeniden başlamayı ve kullanıcı onayı istemeyi beklemeniz gerekir. Örneğin, kullanıcı oturumunu kapatmış, Microsoft Advertising kullanıcısı parolasını değiştirmiş, güvenilir cihazlar listesinden bir cihazı kaldırmış veya uygulamanızın kendi adına kimlik doğrulaması yapması için izinleri kaldırmış olabilirsiniz. Microsoft, önceden uyarı vermeden herhangi bir zamanda kullanıcı onayının yeniden verilmesi gerektiğini belirleyebilir. En iyi uygulama olarak, her yeni erişim ve yenileme belirteci istediğinizde her zaman en son yenileme belirtecini güvenli bir şekilde depolamanız gerekir.
Neden erişim belirteci ve geliştirici belirtecine ihtiyacım var?
Erişim belirteci, bir veya daha fazla Microsoft Advertising hesabına erişimi olan kullanıcı kimlik bilgilerini temsil eder. Uygulama kimliği (client_id) onay veren her Microsoft Advertising kullanıcısı için uygulamanızı tanımlar. Geliştirici belirteci, uygulamanıza Bing Ads API'sini kullanma izni verir.
Dağlamak
Bing Ads API, Microsoft Advertising platformuyla birlikte yeniden modellenecek mi?
Bing Ads artık Microsoft Advertising'tir. Yeni adımız, daha fazla müşteriye ulaşmanıza yardımcı olmak için reklam çözümlerimizi nasıl büyüttiğimizi yansıtır. Geçerli API sürümlerinden herhangi birini yeniden işleme planı yoktur. Aşağıdaki tabloda, değişmemiş veya değişmemiş adlar listelenmiştir. Daha fazla bilgi için lütfen marka duyurusunu inceleyin.
Önceki Ad | Geçerli Ad |
---|---|
Reklam Önizleme ve Tanılama Aracı | Reklam Önizleme ve Tanılama Aracı |
Bing Ads | Microsoft Advertising |
Bing Ads Onaylı Profesyoneller | Bing Ads Onaylı Profesyoneller |
Bing Ads API | Bing Ads API |
Bing Ads Uygulaması | Microsoft Advertising Uygulaması |
Bing Ads İçerik API'si | Bing Ads İçerik API'si |
Bing Ads Düzenleyici | Microsoft Advertising Düzenleyici |
Bing Ads Fanları | Microsoft Reklam Hayranları |
Bing Ads Zekası | Microsoft Advertising Intelligence |
Bing Ads İş Ortağı | Microsoft Reklam İş Ortağı |
Bing Ads Betikleri | Microsoft Reklam Betikleri |
Bing Ads SDK | Bing Ads SDK |
Bing Otel Merkezi | Microsoft Hotel Center |
Bing İşyeri Merkezi | Microsoft Merchant Center |
Bing Ağı | Microsoft Advertising Network |
Bing Ağ dağıtımı | Microsoft Reklam İş Ortağı siteleri |
Bing İş Ortağı Ödülleri | Microsoft Reklam İş Ortağı Ödülleri |
Bing İş Ortağı Programı | Microsoft Reklam İş Ortağı Programı |
Bing Alışveriş Kampanyaları | Microsoft Alışveriş Kampanyaları |
Anahtar sözcük Planner | Anahtar sözcük Planner |
Otel Fiyat Reklamları | Otel Fiyat Reklamları |
Otel API'si | Otel API'si |