Dil

Bing Ads API'sini kullanmaya başlayın

Geliştirici belirteci olan tüm Microsoft Advertising kullanıcıları Bing Ads API'sini kullanmaya başlayabilir. Bing Ads API, çok sayıda reklam yerleştiren reklamverenler veya reklam araçları oluşturan geliştiriciler için Microsoft Advertising'e programlı bir arabirim sağlar.

Bing Ads API uygulamanızı web hizmetlerini destekleyen herhangi bir dilde geliştirebilirsiniz. Belirli bir SDK'yı kullanmaya başlamak için bkz: C# | Java | PHP | Python'a Başlarken.

Kullanıcı erişim belirteci alma

Oturum açmak istediğiniz kullanıcıyı göz önünde bulundurun, örneğin, example@contoso.com. Bing Ads API'si bu e-posta adresini ve parolayı kabul etmeyecektir. Bunun yerine, kullanıcı erişim belirteci içeren AuthenticationToken üst bilgi öğesini ayarlamanız gerekir. Erişim belirtecinin bir kullanıcı adı ve parolayı temsil ettiği düşünülebilir.

Bir kullanıcı için erişim belirtecini nasıl alabilirsiniz? Uygulama geliştiricisi olarak, Microsoft Advertising kullanıcısından onay istemek için bir Microsoft yetkilendirme URL'si kullanırsınız. Kullanıcı onay verdikten sonra bir erişim belirteci alabilir ve kullanıcı adına işlem yapabilirsiniz. Erişim belirteci, bir veya daha fazla Microsoft Advertising hesabına erişimi olan kullanıcı kimlik bilgilerini temsil eder.

  1. Bir başvuruyu kaydedin

  2. Uygulamanızın Microsoft Advertising hesaplarını yönetmesi için kullanıcı izni isteyin

  3. Belirteçlere erişme ve yenileme

  4. İlk API çağrınızı yapın

İpucu

Bing Ads SDK'larını kullanarak jetonlara nasıl erişeceğiniz ve token'ları nasıl yenileyeceğiniz hakkında ayrıntılı bilgi için SDK'larla Kimlik Doğrulama bölümüne bakın.

Geliştirici Belirteci Alma

Bing Ads API'lerini kullanmak için bir geliştirici belirteğinizin ve geçerli kullanıcı kimlik bilgileriniz olmalıdır. Henüz bir Microsoft Advertising hesabınız yoksa, Microsoft Advertising web uygulaması aracılığıyla kaydolabilirsiniz.

Not

Korumalı alan ve üretim ortamları ayrı kimlik bilgileri kullanır. Buradan bir Sandbox hesabına kaydolabilirsiniz. Evrensel sandbox geliştirici belirtecini, yani BBD37VB98'i herkes kullanabilir.

Üretim için bir geliştirici belirteci almak için bu adımları takip edebilirsiniz.

Not

31 Mayıs 2025 tarihinden itibaren Geliştirici Portalı sayfası kullanım dışı bırakılacak ve burada yeni bir sürümle değiştirilecektir. Herhangi bir aksaklığı önlemek için lütfen yer işaretlerinizi güncelleştirin ve yeni sayfayı kullanmaya başlayın. Sorularınız veya yardım için lütfen Destek ekibiyle iletişime geçin.

  1. Microsoft Advertising Geliştirici Portalı hesap sekmesinde Süper Yönetici Yönetici kimlik bilgileri ile oturum açın.
  2. Geliştirici belirteciyle ilişkilendirilmesini istediğiniz kullanıcıyı seçin. Genellikle, bir uygulamanın kaç kullanıcının destekleneceğine bakılmaksızın yalnızca bir evrensel belirteç gerekir.
  3. Jeton İste düğmesine tıklayın.

Evrensel geliştirici belirteci, herhangi bir Microsoft Advertising kullanıcı kimlik bilgisiyle kimlik doğrulaması yapmak için kullanılabilir. Uygulamanızın bir veya birden fazla Microsoft Advertising kullanıcısı tarafından kullanılıp kullanılmayacağından bağımsız olarak aynı evrensel geliştirici belirtecini kullanabilirsiniz. Temmuz 2019 itibarıyla, bu varsayılan belirteç türüdür.

Tek kullanıcılı geliştirici belirteci yalnızca bir müşteriye erişim için bir kullanıcının kimliğini doğrulamak için kullanılabilir. Bu belirteç türü, evrensel belirteç lehine kullanım dışı bırakılmıştır. Kullanıcılarınızdan birine tek bir kullanıcı belirtecinin atandığını görmeye devam ediyorsanız, "Evrensel'e Yükselt" seçeneğini seçebilirsiniz.

Geliştirici belirteci, bir kullanıcı için izin verilen hesaplara programlı erişim sağlar. API erişimi için bir geliştirici belirteci almak, hiçbir Microsoft Advertising hesabına ek izinler vermez. Her Microsoft Advertising kullanıcısına, erişebildikleri her müşteri için Süper Yönetici veya Reklamveren Kampanya Yöneticisi gibi bir rol atanır. Bir geliştirici belirteciyle, Microsoft Advertising web uygulamasında bulunan hesapların aynısı API aracılığıyla program aracılığıyla kullanıcı tarafından kullanılabilir.

API Kimlik Bilgileri Nerede Kullanılır?

GetCampaignsByAccountId gibi bir hizmet işlemini çağırdığınızda, DeveloperToken, CustomerId ve CustomerAccountId gibi istek üst bilgisi öğelerini belirtmeniz gerekir.

<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
    <Action mustUnderstand="1">GetCampaignsByAccountId</Action>
    <ApplicationToken i:nil="false">ValueHere</ApplicationToken>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <CustomerAccountId i:nil="false">ValueHere</CustomerAccountId>
    <CustomerId i:nil="false">ValueHere</CustomerId>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <GetCampaignsByAccountIdRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <AccountId>ValueHere</AccountId>
      <CampaignType>ValueHere</CampaignType>
    </GetCampaignsByAccountIdRequest>
  </s:Body>
</s:Envelope>

Microsoft Advertising SDK'larından birini kullanıyorsanız istek üst bilgisi öğeleri AuthorizationData kullanılarak ayarlanır. SDK kimlik doğrulama kitaplığı hakkında daha fazla bilgi için SDK'larla Kimlik Doğrulaması bölümüne bakın.

var authorizationData = new AuthorizationData
{
    Authentication = <AuthenticationGoesHere>, 
    CustomerId = <CustomerIdGoesHere>,
    AccountId = <AccountIdGoesHere>,
    DeveloperToken = "<DeveloperTokenGoesHere>"
};
static AuthorizationData authorizationData = new AuthorizationData();
authorizationData.setAuthentication(<AuthenticationGoesHere>);
authorizationData.setCustomerId("<CustomerIdGoesHere>");
authorizationData.setAccountId("<AccountIdGoesHere>");
authorizationData.setDeveloperToken("<DeveloperTokenGoesHere>");
$authorizationData = (new AuthorizationData())
    ->withAuthentication($AuthenticationGoesHere)
    ->withCustomerId($CustomerIdGoesHere)
    ->withAccountId($AccountIdGoesHere)
    ->withDeveloperToken($DeveloperTokenGoesHere);
authorization_data = AuthorizationData(
    authentication = <AuthenticationGoesHere>,
    customer_id = <CustomerIdGoesHere>,
    account_id = <AccountIdGoesHere>,
    developer_token = '<DeveloperTokenGoesHere>'
)

Hesabınızı ve müşteri kimliklerinizi alma

Bir kullanıcının müşteri kimliğini ve hesap kimliğini almak için Microsoft Advertising web uygulamasında oturum açabilir ve Kampanyalar sekmesine tıklayabilirsiniz. URL, sorgu dizesinde müşteri kimliğinizi tanımlayan bir cid anahtarı/değer çifti ve hesap kimliğinizi tanımlayan bir yardım anahtarı/değer çifti içerecektir. Örneğin;https://ui.ads.microsoft.com/campaign/Campaigns.m?cid=FindCustomerIdHere& aid=FindAccountIdHere#/customer/FindCustomerIdHere/account/FindAccountIdHere/campaign.

İpucu

Hesap numarasını hesap tanımlayıcısı ile karıştırmayın. Hesap numarası, Microsoft Advertising web uygulamasında hesabı tanımlamak için kullanılan, sistem tarafından oluşturulan hesap numarasıdır. Hesap numarası xxxxxxxx biçimindedir; burada xxxxxxxx, herhangi sekiz alfasayısal karakterden oluşan bir dizidir. API hizmeti istekleri yalnızca hesap tanımlayıcısını kullanır ve asla hesap numarasını kullanmaz.

Müşteri Yönetimi API'si ile, kimliği doğrulanmış her kullanıcı için müşteri ve hesap tanımlayıcılarını alabilirsiniz.

Microsoft Advertising kimlik bilgileriniz ve DeveloperToken ile GetUser'ı arayın. Gövde içinde UserId değerini sıfır olarak ayarlayın. Yanıt, UserId değerini içeren bir User nesnesi içerir.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:ApplicationToken i:nil="true" xmlns:h="https://bingads.microsoft.com/Customer/v13" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
    <h:AuthenticationToken xmlns:h="https://bingads.microsoft.com/Customer/v13">OAuthAccessTokenGoesHere</h:AuthenticationToken>
    <h:DeveloperToken xmlns:h="https://bingads.microsoft.com/Customer/v13">DeveloperTokenGoesHere</h:DeveloperToken>
  </s:Header>
  <s:Body>
    <GetUserRequest xmlns="https://bingads.microsoft.com/Customer/v13">
      <UserId i:nil="true" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
    </GetUserRequest>
  </s:Body>
</s:Envelope>

Ardından, önceki adımda döndürülen UserId ile SearchAccounts'u çağırın. İade edilen reklamveren hesabı (veya hesapları), hesap ve müşteri tanımlayıcılarını içerir.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header>
    <h:ApplicationToken i:nil="true" xmlns:h="https://bingads.microsoft.com/Customer/v13" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
    <h:AuthenticationToken xmlns:h="https://bingads.microsoft.com/Customer/v13">OAuthAccessTokenGoesHere</h:AuthenticationToken>
    <h:DeveloperToken xmlns:h="https://bingads.microsoft.com/Customer/v13">DeveloperTokenGoesHere</h:DeveloperToken>
  </s:Header>
  <s:Body>
    <SearchAccountsRequest xmlns="https://bingads.microsoft.com/Customer/v13">
      <Predicates xmlns:a="https://bingads.microsoft.com/Customer/v13/Entities" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:Predicate>
          <a:Field>UserId</a:Field>
          <a:Operator>Equals</a:Operator>
          <a:Value>UserIdGoesHere</a:Value>
        </a:Predicate>
      </Predicates>
      <Ordering i:nil="true" xmlns:a="https://bingads.microsoft.com/Customer/v13/Entities" xmlns:i="http://www.w3.org/2001/XMLSchema-instance" />
      <PageInfo xmlns:a="https://bingads.microsoft.com/Customer/v13/Entities" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <a:Index>0</a:Index>
        <a:Size>10</a:Size>
      </PageInfo>
    </SearchAccountsRequest>
  </s:Body>
</s:Envelope>

İpucu

Geçerli kimliği doğrulanmış kullanıcının hesaplarını döndüren bir kod örneği için Kullanıcı Hesaplarında Ara Kod Örneği'ne bakın.

Üstbilgi öğeleri başvurusu

Bing Ads API hizmet işlemleri, istek ve yanıt iletilerini hizmet işlemiyle değiş tokuş etmek için Basit Nesne Erişim Protokolü (SOAP) kullanır. Daha fazla bilgi için Bing Ads API Hizmetleri Protokolü'ne bakın.

Her SOAP isteği, kullanıcının kimlik bilgilerini içeren aşağıdaki SOAP üst bilgilerini içermelidir.

Not

CustomerAccountId ve CustomerId öğeleri, Müşteri Faturalama ve Müşteri Yönetimi hizmetleri için geçerli değildir.

Eleman Açıklama Veri Türü
ApplicationToken Bu üst bilgi öğesi kullanılmaz ve yok sayılmalıdır. dize
AuthenticationToken Microsoft Advertising hesaplarına izinleri olan bir Microsoft Hesabı kullanıcısını temsil eden OAuth erişim belirteci. Daha fazla bilgi için OAuth ile kimlik doğrulaması konusuna bakın. dize
CustomerAccountId İstekteki varlıkların sahibi olan hesabın tanımlayıcısı. Her ikisi de gerekli olduğunda, bu üst bilgi öğesinin AccountId gövde öğesiyle aynı değere sahip olması gerekir. Bu öğe çoğu hizmet işlemi için gereklidir ve en iyi uygulama olarak bunu her zaman ayarlamalısınız. dize
Müşteri Kimliği Hesabı içeren ve sahibi olan müşterinin tanımlayıcısı. Başka bir müşterinin hesabını yönetiyorsanız kendi müşteri kimliğiniz yerine bu müşteri kimliğini kullanmanız gerekir. Bu öğe çoğu hizmet işlemi için gereklidir ve en iyi uygulama olarak bunu her zaman ayarlamalısınız. dize
Geliştirici simgesi Bing Ads API'sine erişmek için kullanılan geliştirici belirteci. dize

Yardım mı gerekiyor?

Sorun giderme ipuçları için Hizmet Hatalarını ve İstisnaları İşleme bölümüne bakın.

Geliştirici topluluğunun Bing Ads API'leri ve Microsoft Advertising Betikleri hakkında sorular sorması ve yanıtlaması için Microsoft Q&A forumu mevcuttur. Microsoft forumları izler ve topluluğun henüz yanıtlamadığı soruları yanıtlar.

Önemli

Sorunuzu gördüğümüzden emin olmak için "advertising-api" ile etiketleyin.

Araştırma hassas hesap veya kişisel bilgileri içeriyorsa ya da Microsoft Q&A aracılığıyla sorununuzu çözmek için gereken bilgileri bulamıyorsanız, lütfen Microsoft Advertising Desteği'ne başvurun. Sorunu etkili bir şekilde çözmek için lütfen Katılım Desteği'nde istenen ayrıntıları destekleyin.

Ayrıca Bkz

Bing Ads API'ye Genel Bakış
Bing Ads API Kavramları