Sprache

Erste Schritte mit der Bing Ads-API

Jeder Microsoft Advertising-Benutzer mit einem Entwicklertoken kann mit der Verwendung der Bing Ads-API beginnen. Für Werbetreibende, die eine große Anzahl von Anzeigen schalten, oder Entwickler, die Werbetools entwickeln, bietet die Bing Ads-API eine programmgesteuerte Schnittstelle zu Microsoft Advertising.

Sie können Ihre Bing Ads API-Anwendung in jeder Sprache entwickeln, die Webdienste unterstützt. Informationen zu den ersten Schritten mit einem bestimmten SDK finden Sie unter Erste Schritte in C# | Java | PHP | Python.

Abrufen eines Benutzerzugriffstokens

Berücksichtigen Sie den Benutzer, bei dem Sie sich anmelden möchten, example@contoso.comz. B. . Die Bing Ads-API akzeptiert diese E-Mail-Adresse und das Kennwort nicht. Stattdessen müssen Sie das AuthenticationToken-Headerelement festlegen, das ein Benutzerzugriffstoken enthält. Ein Zugriffstoken kann man sich so vorstellen, dass es einen Benutzernamen und ein Kennwort darstellt.

Wie erhalten Sie ein Zugriffstoken für einen Benutzer? Als Anwendungsentwickler verwenden Sie eine Microsoft-Autorisierungs-URL, um den Microsoft Advertising-Benutzer zur Zustimmung aufzufordern. Sobald ein Benutzer seine Zustimmung erteilt, können Sie ein Zugriffstoken erhalten und im Namen des Benutzers handeln. Das Zugriffstoken stellt die Anmeldeinformationen des Benutzers dar, der Zugriff auf ein oder mehrere Microsoft Advertising-Konten hat.

  1. Anwendung registrieren

  2. Anfordern der Benutzereinwilligung für Ihre Anwendung zur Verwaltung ihrer Microsoft Advertising-Konten

  3. Abrufen von Zugriffs- und Aktualisierungstoken

  4. Ersten API-Aufruf vornehmen

Tipp

Ausführliche Informationen dazu, wie Sie mithilfe der Bing Ads-SDKs Zugriffstoken erhalten und aktualisieren können, finden Sie unter Authentifizierung mit den SDKs.

Entwicklertoken abrufen

Um die Bing Ads-APIs verwenden zu können, benötigen Sie ein Entwicklertoken und gültige Benutzeranmeldeinformationen. Wenn Sie noch kein Microsoft Advertising-Konto haben, können Sie sich über die Microsoft Advertising-Webanwendung registrieren.

Hinweis

Die Sandbox- und Produktionsumgebungen verwenden separate Anmeldeinformationen. Sie können sich hier für ein Sandbox-Konto anmelden. Jeder kann den universellen Sandbox-Entwickler-Token verwenden, d. h. BBD37VB98.

Sie können diese Schritte ausführen, um ein Entwicklertoken für die Produktion zu erhalten.

Hinweis

Ab dem 31. Mai 2025 ist die Seite "Entwicklerportal" veraltet und wird hier durch eine neue Version ersetzt. Bitte aktualisieren Sie Ihre Lesezeichen und beginnen Sie mit der Verwendung der neuen Seite, um Unterbrechungen zu vermeiden. Wenden Sie sich bei Fragen oder Hilfe an den Support.

  1. Melden Sie sich mit Super-Admin-Anmeldeinformationen auf der Kontoregisterkarte des Microsoft Advertising Developer Portals an.
  2. Wählen Sie den Benutzer aus, dem Sie das Entwicklertoken zuordnen möchten. In der Regel benötigt eine Anwendung nur ein universelles Token, unabhängig davon, wie viele Benutzer unterstützt werden.
  3. Klicken Sie auf die Schaltfläche "Anforderungstoken ".

Das universelle Entwicklertoken kann zur Authentifizierung mit beliebigen Microsoft Advertising-Benutzeranmeldeinformationen verwendet werden. Sie können dasselbe universelle Entwicklertoken unabhängig davon verwenden, ob Ihre Anwendung von einem oder mehreren Microsoft Advertising-Benutzern verwendet wird. Ab Juli 2019 ist dies der Standard-Tokentyp.

Das Einzelbenutzer-Entwicklertoken kann nur zur Authentifizierung eines Benutzers für den Zugriff auf einen Kunden verwendet werden. Dieser Tokentyp ist veraltet und wird durch das universelle Token ersetzt. Wenn weiterhin angezeigt wird, dass einem Ihrer Benutzer ein einzelnes Benutzertoken zugewiesen ist, können Sie "Upgrade auf universell" auswählen.

Ein Entwicklertoken ermöglicht den programmgesteuerten Zugriff auf die Konten, die für einen Benutzer zulässig sind. Durch das Abrufen eines Entwicklertokens für den API-Zugriff werden keine zusätzlichen Berechtigungen für Microsoft Advertising-Konten gewährt. Jedem Microsoft Advertising-Benutzer wird für jeden Kunden, auf den er zugreifen kann, eine Rolle zugewiesen, z. B. Super-Admin oder Inserentenkampagnen-Manager. Mit einem Entwicklertoken stehen die gleichen Konten, die in der Microsoft Advertising-Webanwendung verfügbar sind, dem Benutzer programmgesteuert über die API zur Verfügung.

Verwendung der API-Anmeldeinformationen

Wenn Sie einen Dienstvorgang wie GetCampaignsByAccountId aufrufen, müssen Sie Anforderungsheaderelemente wie DeveloperToken, CustomerId und CustomerAccountId angeben.

<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>

Wenn Sie eines der Microsoft Advertising-SDKs verwenden, werden die Elemente des Anforderungsheaders mithilfe von AuthorizationData festgelegt. Weitere Informationen zur SDK-Authentifizierungsbibliothek finden Sie unter Authentifizierung mit den SDKs.

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>'
)

Abrufen Ihrer Konto- und Kunden-IDs

Um die Kunden-ID und die Konto-ID eines Benutzers zu erhalten, können Sie sich bei der Microsoft Advertising-Webanwendung anmelden und auf die Registerkarte "Kampagnen" klicken. Die URL enthält ein Schlüssel-Wert-Paar cid in der Abfragezeichenfolge, das Ihre Kunden-ID identifiziert, und ein Hilfeschlüssel-Wert-Paar, das Ihre Konto-ID identifiziert. Zum Beispiel:https://ui.ads.microsoft.com/campaign/Campaigns.m?cid=FindCustomerIdHere& ; aid=FindAccountIdHere#/customer/FindCustomerIdHere/account/FindAccountIdHere/campaign.

Tipp

Verwechseln Sie die Kontonummer nicht mit der Kontokennung. Die Kontonummer ist die vom System generierte Kontonummer, mit der das Konto in der Microsoft Advertising-Webanwendung identifiziert wird. Die Kontonummer hat die Form xxxxxxxx, wobei xxxxxxxx eine Folge von acht beliebigen alphanumerischen Zeichen ist. Die API-Dienstanfragen verwenden nur den Kontobezeichner und niemals die Kontonummer.

Mit der Kundenverwaltungs-API können Sie die Kunden- und Kontobezeichner für jeden authentifizierten Benutzer abrufen.

Rufen Sie GetUser mit Ihren Microsoft Advertising-Anmeldeinformationen und DeveloperToken auf. Legen Sie im Hauptteil die UserId auf Null fest. Die Antwort enthält ein User-Objekt , das die UserId enthält.

<?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>

Rufen Sie dann SearchAccounts mit der UserId auf, die vom vorherigen Schritt zurückgegeben wurde. Das zurückgegebene Inserentenkonto (oder die zurückgegebenen Inserentenkonten) enthält Konto- und Kunden-IDs.

<?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>

Tipp

Ein Codebeispiel, das Konten für den aktuellen authentifizierten Benutzer zurückgibt, finden Sie unter Codebeispiel für die Suche nach Benutzerkonten .

Referenz zu Headerelementen

Bing Ads API-Dienstvorgänge verwenden das Simple Object Access Protocol (SOAP), um die Anforderungs- und Antwortnachrichten mit dem Dienstvorgang auszutauschen. Weitere Informationen finden Sie unter Bing Ads API Services-Protokoll.

Jede SOAP-Anforderung muss die folgenden SOAP-Header enthalten, die die Anmeldeinformationen des Benutzers enthalten.

Hinweis

Die Elemente "CustomerAccountId" und "CustomerId" gelten nicht für die Dienste "Kundenabrechnung" und "Kundenverwaltung".

Element Beschreibung Datentyp
ApplicationToken Dieses Headerelement wird nicht verwendet und sollte ignoriert werden. Zeichenfolge
AuthenticationToken Das OAuth-Zugriffstoken, das einen Microsoft-Kontobenutzer darstellt, der über Berechtigungen für Microsoft Advertising-Konten verfügt. Weitere Informationen finden Sie unter Authentifizierung mit OAuth. Zeichenfolge
CustomerAccountId Der Bezeichner des Kontos, das die Entitäten in der Anforderung besitzt. Dieses Header-Element muss denselben Wert wie das AccountId-Body-Element haben, wenn beide erforderlich sind. Dieses Element ist für die meisten Dienstvorgänge erforderlich, und als bewährte Methode sollten Sie es immer festlegen. Zeichenfolge
Kunden-ID Der Bezeichner des Kunden, der das Konto enthält und besitzt. Wenn Sie das Konto eines anderen Kunden verwalten, sollten Sie diese Kundennummer anstelle Ihrer eigenen Kundennummer verwenden. Dieses Element ist für die meisten Dienstvorgänge erforderlich, und als bewährte Methode sollten Sie es immer festlegen. Zeichenfolge
EntwicklerToken Das Entwicklertoken, das für den Zugriff auf die Bing Ads-API verwendet wird. Zeichenfolge

Benötigen Sie Hilfe?

Tipps zur Problembehandlung finden Sie unter Behandeln von Dienstfehlern und -ausnahmen.

Entwicklern steht das Microsoft Q&A-Forum zur Verfügung, in dem sie Fragen zu den Bing Ads-APIs und Microsoft Advertising-Skripts stellen und beantworten können. Microsoft überwacht die Foren und beantwortet Fragen, die die Community noch nicht beantwortet hat.

Wichtig

Um sicherzustellen, dass Ihre Frage angezeigt wird, markieren Sie sie mit "advertising-api".

Wenn die Untersuchung vertrauliche Konto- oder persönliche Details umfasst oder wenn Sie über Microsoft Q&A nicht die Informationen finden, die Sie zur Lösung Ihres Problems benötigen, wenden Sie sich an den Microsoft Advertising Support. Um das Problem effizient zu beheben, geben Sie bitte dem Support die unter " Support beauftragen" angeforderten Details an.

Siehe auch

Bing Ads API – Übersicht
Bing Ads API-Konzepte

  • Last updated on