Häufig gestellte Fragen

Das Microsoft Q&A-Forum steht der Entwicklercommunity zur Verfügung, um Fragen zu den Bing Ads-APIs und Microsoft Advertising-Skripts zu stellen und zu beantworten. Microsoft überwacht die Foren und beantwortet Fragen, die die Community noch nicht beantwortet hat.

Wenn die Untersuchung sensible Konten oder persönliche Daten umfasst oder Wenn Sie die informationen, die Sie benötigen, um Ihr Problem über Microsoft Q&A zu lösen, nicht finden, wenden Sie sich an den Microsoft Advertising-Support. Um das Problem effizient zu beheben, stellen Sie Support mit den unter Einbinden des Supports angeforderten Details bereit.

Die Versionshinweise und das Migrationshandbuch sind hervorragende Ressourcen für den Einstieg.

Sie können sich über die Registerkarte News des Entwicklerportals für den monatlichen Newsletter anmelden, und dort werden auch die neuesten Blogankündigungen zusammengefasst.

Um zu beginnen, müssen Sie sich für ein Microsoft Advertising-Konto registrieren und dann Ihr Entwicklertoken über die Registerkarte Konto im Entwicklerportal abrufen.

Sie können Bing Ads-API-Anwendungen mit jeder Programmiersprache entwickeln, die Webdienste unterstützt. Die Bing Ads API Software Development Kits (SDK) verbessern die Entwicklung von Bing Ads-API-Anwendungen mit .NET, Java, PHP und Python. Jedes SDK enthält einen Proxy für alle Bing Ads-API-Webdienste und abstrahiert details zur Authentifizierung mit OAuth auf niedriger Ebene. Sie können die allgemeinen BulkServiceManager- und ReportingServiceManager-Schnittstellen verwenden, um Vorgänge in den Bulk- und Reporting Services auf niedriger Ebene abstrahieren und auszuführen.

Wir haben Anfragen für zusätzliche SDKs, z. B. Perl und Ruby, gehört, obwohl es nicht geplant ist, in naher Zukunft Unterstützung hinzuzufügen.

Zusätzlich zu den Codebeispielen finden Sie Codeausschnitte in vielen technischen Leitfäden, z. B. im Leitfaden zu den ersten Schritten . Sie können die Sprachauswahl oben oder rechts auf diesen Seiten verwenden, um Beispiele in CSharp, Java, Php oder Python anzuzeigen. Wenn Sie eine Sprache auswählen, wird die Einstellung beibehalten, während Sie durch andere Seiten navigieren. Die Sprachauswahl enthält nur Sprachen, die Beispiele für diese bestimmte Seite enthalten, und wird standardmäßig auf C# festgelegt, wenn die zuvor festgelegte Sprache für die Seite, zu der Sie navigiert haben, nicht verfügbar ist.

Der Massendienst wird empfohlen, insbesondere wenn Sie Anzeigen und Schlüsselwörter in mehreren Anzeigengruppen oder Kampagnen in einem Konto hinzufügen oder aktualisieren müssen. Einige Features sind in Bulk nicht verfügbar, z. B. AddUetTags, GetBMCStoresByCustomerId, GetGeoLocationsFileUrl und GetMediaMetaDataByAccountId. Für diese Features müssen Sie natürlich den Kampagnenverwaltungsdienst verwenden.

Der Berichterstellungsdienst unterstützt die meisten berichtstypen , die Sie in der Microsoft Advertising-Webanwendung finden können. Lesen Sie unbedingt die Leitfäden Berichtsattribute und Leistungsstatistiken und Aufbewahrungszeiträume für Berichtsdaten , um Details zur Verfügbarkeit zu erhalten.

Wenn ein Benutzer auf eine Anzeige klickt, kann es bis zu zwei Stunden dauern, bis das System den Klick verarbeitet (3 Stunden für Konvertierungen) und für die Berichterstellung zur Verfügung stellt. Wenn alle Daten für den vorigen Tag verarbeitet und für die Berichterstellung zur Verfügung gestellt wurden, wird dieser Status als Bücher geschlossen bezeichnet. Weitere Informationen dazu, wann die Bücher für die Berichterstellung geschlossen werden, finden Sie unter Zeitzonen in der Berichterstellung.

Sie müssen Ihre Anwendung aktualisieren, um den neuen msads.manage Bereich über den Microsoft Identity Platform-Endpunkt zu verwenden. Alle Anwendungsentwickler müssen Maßnahmen ergreifen, um den neuen Bereich zu verwenden.

Sie müssen einen Benutzer über den neuen msads.manage Bereich und den Microsoft Identity Platform-Endpunkt zur Zustimmung auffordern.

Wenn Sie über eine ältere Anwendungs-ID (client-ID) verfügen, die als Hexadezimalwert formatiert ist, z. B. 00000000012345A67, müssen Sie eine neue Anwendung registrieren. Gültige Microsoft Identity Platform Anwendungs-IDs sind als GUID mit Bindestrichen formatiert, z. B. ab01c23d-4e56-7f8a-90bc-1d23efabc45d. Wenn im Azure-Portal – App-Registrierungen keine vorhandene App angezeigt wird, ist dies ein Hinweis darauf, dass Sie sie durch eine neue App ersetzen sollten.

Ja Sie müssen einen Benutzer über den neuen msads.manage Bereich und den Microsoft Identity Platform-Endpunkt zur Zustimmung auffordern.

Wenn Sie einen Benutzer (unter Verwendung des allgemeinen Mandanten) mit dem Microsoft Identity Platform-Endpunkt zur Zustimmung auffordern, variiert die Benutzeranmeldung je nach der zugrunde liegenden Identität hinter seinen Anmeldeinformationen.

• Eine Person, die nur über eine MSA-Identität verfügt, wird zur MSA-Anmeldeseite weitergeleitet.
• Eine Person, die nur über eine Azure AD-Identität verfügt, wird zur Anmeldeseite ihrer Organisation weitergeleitet.
• Für eine Person, deren Anmeldeinformationen sowohl in der MSA- als auch in den Azure AD-Domänen gültig sind, wird eine Mehrdeutigkeitsseite angezeigt, auf der sie aufgefordert wird, zwischen ihrer persönlichen Identität und ihrer Geschäfts-, Schul- oder Uniidentität zu wählen. Diese Mehrdeutigkeit ist immer vorhanden, solange dieser Benutzer über zwei Identitäten verfügt, die an dieselbe E-Mail-Adresse gebunden sind. Der Benutzer kann dies nicht mehr sehen, indem er die E-Mail-Adresse seines persönlichen Microsoft-Kontos ändert. Weitere Informationen finden Sie unter https://cloudblogs.microsoft.com/enterprisemobility/2016/09/15/cleaning-up-the-azure-ad-and-microsoft-account-overlap/.

Wenn der Benutzer nicht mehr über eine MSA-persönliches Konto-Identität verfügt, akzeptiert die Bing Ads-API das vorhandene Zugriffstoken nicht mehr. Ebenso kann das Aktualisierungstoken nicht mehr zum Anfordern eines neuen Zugriffstokens verwendet werden, sodass Sie die Benutzereinwilligung erneut anfordern müssen, damit Ihre Anwendung ihre Microsoft Advertising-Konten verwalten kann. Sie sollten das vorherige Aktualisierungstoken verwerfen.

Nein Geschäfts-, Schul- oder Unikonten werden nur in der Produktion unterstützt.

Zum programmgesteuerten Verwalten eines Microsoft Advertising-Kontos müssen Sie die Zustimmung mindestens einmal über den Einwilligungsflow der Webanwendung erteilen. Für die wiederholte oder langfristige Authentifizierung sollten Sie den Autorisierungscodegenehmigungsflow befolgen, um ein Zugriffstoken und ein Aktualisierungstoken abzurufen. Anschließend können Sie das neueste Aktualisierungstoken verwenden, um neue Zugriffs- und Aktualisierungstoken ohne weitere Benutzerinteraktion anzufordern. Möglicherweise müssen Sie die Benutzereinwilligung erneut anfordern, z. B. wenn der Benutzer die Kontowiederherstellung durchläuft, sein Kennwort geändert oder anderweitig Berechtigungen für die Authentifizierung für Ihre Anwendung entfernt hat.

Das Zugriffstoken läuft in der Regel nach einer Stunde ab, obwohl Sie die Ablaufzeit immer bei jeder Anforderung eines neuen Tokens überprüfen sollten.

Aktualisierungstoken sind und sind für Ihre Anwendung immer völlig undurchsichtig. Sie sind langlebig, z. B. 90 Tage für öffentliche Clients, aber die App sollte nicht so geschrieben werden, dass sie erwartet, dass ein Aktualisierungstoken für einen beliebigen Zeitraum gültig ist. Aktualisierungstoken können jederzeit ungültig gemacht werden, und die einzige Möglichkeit für eine App zu wissen, ob ein Aktualisierungstoken gültig ist, besteht darin, es durch eine Tokenanforderung einzulösen. Selbst wenn Sie das Token auf demselben Gerät kontinuierlich mit dem neuesten Aktualisierungstoken aktualisieren, sollten Sie davon ausgehen, dass Sie erneut starten und die Zustimmung des Benutzers anfordern, wenn Sie z. B. den Benutzer abgemeldet haben, der Microsoft Advertising-Benutzer sein Kennwort geändert hat, ein Gerät aus der Liste der vertrauenswürdigen Geräte entfernt hat oder die Berechtigungen für ihre Anwendung zur Authentifizierung in ihrem Namen entfernt haben. Microsoft kann jederzeit ohne vorherige Warnung festlegen, dass die Zustimmung des Benutzers erneut erteilt werden sollte. Als bewährte Methode sollten Sie das neueste Aktualisierungstoken immer sicher speichern, wenn Sie neue Zugriffs- und Aktualisierungstoken anfordern.

Das Zugriffstoken stellt die Benutzeranmeldeinformationen dar, die Zugriff auf ein oder mehrere Microsoft Advertising-Konten haben. Die Anwendungs-ID (auch als client_id bezeichnet) identifiziert Ihre Anwendung für jeden Microsoft Advertising-Benutzer, der seine Zustimmung erteilt. Das Entwicklertoken erteilt Ihrer Anwendung die Berechtigung, die Bing Ads-API zu verwenden.

Bing Ads ist jetzt Microsoft Advertising. Unser neuer Name spiegelt wider, wie wir unsere Werbelösungen erweitern, damit Sie mehr Kunden erreichen können. Es ist nicht geplant, eine der aktuellen API-Versionen umzubenennen. In der folgenden Tabelle sind Namen aufgeführt, die entweder geändert wurden oder nicht geändert wurden. Weitere Informationen finden Sie in der Markenankündigung.