Microsoft Advertising Sandbox
Microsoft Advertising bietet eine API-Sandboxumgebung, in der Sie Ihre Anwendung testen können, bevor Sie sie in der Produktionsumgebung bereitstellen. Anzeigen, die Sie in der Sandbox erstellen, werden nicht bereitgestellt. Die unterstützten Dienste in der Sandbox unterscheiden sich von der Produktion. Informationen zum Abrufen der Webdienstadressen für unterstützte Dienste finden Sie unter Webdienstadressen der Bing Ads-API.
Hinweis
Die Sandbox kann für die Wartung mit oder ohne vorherige Benachrichtigung ausgefallen sein.
Anfängliche Kundenanmeldung
Die Sandbox- und Produktionsumgebungen verwenden separate Anmeldeinformationen.
Führen Sie die folgenden Schritte aus, um einen neuen Sandboxkunden zu erhalten. Wenn Sie bereits über einen Sandboxkunden verfügen und einen neuen Benutzer hinzufügen möchten, z. B. mit Den Anmeldeinformationen für das Microsoft-Konto, können Sie mit den Schritten zur Benutzerinladung fortfahren.
Öffnen Sie einen Browser, und navigieren Sie zu https://sandbox.bingads.microsoft.com?simpsp=true.
Klicken Sie auf Für Microsoft Advertising registrieren oder jetzt registrieren.
Wählen Sie Neue E-Mail-Adresse erstellen aus, um einen MSA zu erstellen. Verwenden Sie keine vorhandene E-Mail-Adresse.
Klicken Sie auf Weiter.
Geben Sie eine MSA-E-Mail-Adresse ein. Der E-Mail-Server muss outlook-int.com sein (z. B someone@outlook-int.com. ).
Wichtig
Sandbox unterstützt nur MSAs, die mit einem outlook-int.com-E-Mail-Konto erstellt wurden. Sie dürfen kein outlook.com-E-Mail-Konto verwenden. Außerdem dürfen Sie kein E-Mail-Konto von einem anderen E-Mail-Dienst verwenden (z. B. auch dann, @contoso.com) wenn das Konto mit einem outlook.com- oder outlook-int.com-E-Mail-Konto verknüpft ist.
Schließen Sie den MSA-Arbeitsablauf ab, indem Sie die restlichen Benutzer- und Sicherheitsinformationen angeben. Sie werden dann zu Microsoft Advertising umgeleitet, um die Registrierung des Sandbox-Kunden und -Kontos fortzusetzen.
Ausfüllen des Formulars "Konto erstellen "
Klicken Sie für Kampagne importieren/erstellen auf Kampagnenerstellung überspringen.
Klicken Sie für Go Live auf Zahlungsinformationen überspringen.
Weitere Benutzer einladen
Für die Authentifizierung mit OAuth in der Sandbox benötigen Sie ein Sandbox-Microsoft-Konto (MSA). Wenn Ihr Sandbox-Kunde noch nicht über Benutzeranmeldeinformationen über ein Microsoft-Konto verfügt, müssen Sie einen Benutzer einladen, mit den folgenden Schritten an Ihrem Sandboxkonto zu arbeiten.
Klicken Sie in der Microsoft Advertising-Sandbox auf Ihren Benutzernamen (obere rechte Ecke).
Klicken Sie auf Konten & Abrechnung.
Klicken Sie auf Benutzer.
Klicken Sie auf Benutzer einladen.
Geben Sie die E-Mail-Adresse des einzuladenden Benutzers ein. Der E-Mail-Server muss outlook.com sein (z. B someone@outlook.com. ).
Wichtig
Sie dürfen Einladungen nur an outlook.com E-Mail-Konten senden. Sie dürfen keine Einladungen an eine andere Domäne senden, auch wenn das Konto mit einem outlook.com E-Mail-Konto verknüpft ist. Wenn Sie versuchen, someone@contoso.comeine Einladung an eine andere Domäne zu senden (z. B. ), wird auf der BingAds-Benutzeroberfläche die Einladung auf unbestimmte Zeit als ausstehend angezeigt (die Einladung wird nie gesendet).
Klicken Sie auf Senden.
Microsoft Advertising sendet eine E-Mail-Einladung an den Benutzer. Wenn die Einladung nicht im Posteingang angezeigt wird, überprüfen Sie den Junk-Email Ordner. Es kann einige Minuten dauern, bis die Einladung empfangen wurde. Die folgenden Schritte zeigen, wie Sie die Einladung annehmen.
Öffnen Sie die E-Mail aus Microsoft Advertising mit der Betreffzeile Einladung zu Microsoft Advertising.
Klicken Sie auf den eingebetteten Link.
Wählen Sie Neue E-Mail-Adresse erstellen aus, um einen MSA zu erstellen. Verwenden Sie keine vorhandene E-Mail-Adresse.
Klicken Sie auf Weiter.
Geben Sie eine MSA-E-Mail-Adresse ein. Der E-Mail-Server muss outlook-int.com sein (z. B someone@outlook-int.com. ).
Wichtig
Sandbox unterstützt nur MSAs, die mit einem outlook-int.com-E-Mail-Konto erstellt wurden. Sie dürfen kein outlook.com-E-Mail-Konto verwenden. Außerdem dürfen Sie kein E-Mail-Konto von einem anderen E-Mail-Dienst verwenden (z. B. auch dann, @contoso.com) wenn das Konto mit einem outlook.com- oder outlook-int.com-E-Mail-Konto verknüpft ist.
Beenden Sie den Workflow, indem Sie die restlichen Benutzerinformationen angeben.
Beenden Sie Microsoft Advertising nach Abschluss des MSA-Prozesses.
Hinweis
Beim MSA-Registrierungsprozess kehren Sie zur SI Microsoft Advertising-Benutzeroberfläche (ui.si.bingads.microsoft.com) zurück. Melden Sie sich nach Abschluss des MSA-Prozesses von der SI-Schnittstelle ab, und melden Sie sich dann mit Ihrer neuen outlook-int.com-E-Mail-Adresse unter an https://secure.sandbox.bingads.microsoft.com/.
Api-Zugriff abrufen
Die Sandbox- und Produktionsumgebungen verwenden separate Anmeldeinformationen.
Ersetzen Sie https://login.microsoftonline.com/common für die Sandboxumgebung durch https://login.windows-ppe.net/consumers.
Diese Tabelle enthält zusätzliche Sandboxendpunkte.
| Beschreibung | Produktion | Sandbox |
|---|---|---|
| Endpunkt für OAuth-Anforderungen | login.microsoftonline.com | login.windows-ppe.net |
| Domäne für E-Mails, die beim Abrufen eines Microsoft-Kontos verwendet wird | Beliebige E-Mail-Adresse | outlook-int.com |
| Endpunkt zum Ändern des Kennworts für das Microsoft-Konto | account.live.com/password/change | account.live-int.com/password/change |
Obwohl Sie in der Produktion Ihr eigenes Entwicklertoken verwenden müssen, können alle Microsoft Advertising-Kunden das folgende universelle Entwicklertoken in der Sandbox verwenden.
BBD37VB98
Obwohl Sie in der Produktion Ihre eigene Anwendungs-ID (eine Client-ID) verwenden müssen, können alle Microsoft Advertising-Kunden die folgende öffentliche Anwendungs-ID in der Sandbox verwenden. Die Client-ID "Tutorial Sample App" ist auf Desktop- oder Konsolenanwendungen beschränkt und kann nicht mit einem geheimen Clientschlüssel in einer Webanwendung verwendet werden.
4c0b021c-00c3-4508-838f-d3127e8167ff
Jetzt können Sie Zugriffs- und Aktualisierungstoken für Ihren Microsoft Advertising-Benutzer abrufen und Ihren ersten Dienstaufruf mithilfe der Bing Ads-API durchführen. Weitere Informationen finden Sie im Schnellstarthandbuch .
Tipp
Ausführliche Informationen zum Abrufen von Zugriffs- und Aktualisierungstoken mithilfe der Bing Ads SDKs finden Sie unter Authentifizierung mit den SDKs.
Bewährte Methoden für Sandbox
Sandbox sollte nicht in derselben Kapazität wie die Produktion verwendet werden.
- Stellen Sie sicher, dass Sie beim Bereitstellen Ihrer Anwendung in der Produktionsumgebung die Produktions-WSDLs und Ihre Produktionsanmeldeinformationen verwenden.
- Sandbox enthält das aktuelle Produktionsrelease und wird mit Featurevorschauen mit oder ohne vorherige Benachrichtigung aktualisiert.
- Die Kapazität der Sandbox ist kleiner als die der Produktion, und Sie sollten sie nicht zum Durchführen von Stress- oder Kapazitätstests verwenden.
- Verwenden Sie nicht mehr als einen Thread.
Ad Insight Service
Sandbox unterstützt einen begrenzten Satz von Schlüsselwörtern zum Testen von Ad Insight-Dienstvorgängen. Sie sollten die Testdaten nicht verwenden, um ähnliche Schätzungen für Ihre Schlüsselwörter in der Produktion abzuleiten oder zu erwarten. Einige der Einschränkungen werden in der folgenden Tabelle beschrieben.
Tipp
Verwenden Sie den Ad Insight-Dienst in der Produktion anstelle der Sandbox. Sandbox bietet nur eine Teilmenge der Produktionsdienstvorgänge, und die Erkenntnisdaten liegen hinter der Produktion zurück. Sandbox-Verkaufschancendaten werden jedes Wochenende aktualisiert und sind bis Montag verfügbar. Die Schlüsselwort (keyword) Ideendaten in der Sandbox können um mehrere Monate hinter der Produktion zurückbleiben. Wenn ein Vorgang aufgrund eines ungültigen Datumsbereichs fehlschlägt, versuchen Sie erneut, die Anforderung mit einem früheren Datumsbereich zu übermitteln.
| Dienstvorgang | Sandbox-Einschränkungen |
|---|---|
| GetBidLandscapeByKeywordIds | Nicht unterstützt Sie können den Vorgang mit vorhandenen Schlüsselwort (keyword)-Bezeichnern aufrufen, aber es werden keine Daten zurückgegeben. |
| GetEstimatedBidByKeywordIds | Eine begrenzte Anzahl von Schlüsselwörtern wird unterstützt: Luft, Auto, beste Angebote, Buchung, Autoinformationen, Pflege, Deal of the Day, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel. |
| GetEstimatedBidByKeywords | Eine begrenzte Anzahl von Schlüsselwörtern wird unterstützt: Luft, Auto, beste Angebote, Buchung, Autoinformationen, Pflege, Deal of the Day, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel. |
| GetEstimatedPositionByKeywordIds | Eine begrenzte Anzahl von Schlüsselwörtern wird unterstützt: Luft, Auto, beste Angebote, Buchung, Autoinformationen, Pflege, Deal of the Day, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel. Um die Wahrscheinlichkeit zu erhöhen, eine Schätzung zu erhalten, sollte das MaxBid-Element mehr als oder gleich 5 US-Dollar oder die Entsprechung in anderen Währungen sein. |
| GetEstimatedPositionByKeywords | Eine begrenzte Anzahl von Schlüsselwörtern wird unterstützt: Luft, Auto, beste Angebote, Buchung, Autoinformationen, Pflege, Deal of the Day, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel. Um die Wahrscheinlichkeit zu erhöhen, eine Schätzung zu erhalten, sollte das MaxBid-Element mehr als oder gleich 5 US-Dollar oder die Entsprechung in anderen Währungen sein. |
| GetHistoricalKeywordPerformance | Eine begrenzte Anzahl von Schlüsselwörtern wird unterstützt: Luft, Auto, beste Angebote, Buchung, Autoinformationen, Pflege, Deal of the Day, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel. Die Elemente MatchType und AdPosition müssen auf Aggregate festgelegt werden. Das Devices-Element muss auf Computer oder left nil festgelegt werden. |
| GetHistoricalSearchCount | Eine begrenzte Anzahl von Schlüsselwörtern wird unterstützt: Luft, Auto, beste Angebote, Buchung, Autoinformationen, Pflege, Deal of the Day, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel. Das EndMonthAndYear-Element muss auf den vorherigen Monat festgelegt werden. Wenn das heutige Datum beispielsweise der 1. April 2020 ist, sollte der Endmonat März 2020 sein. Das Devices-Element muss auf Computer oder left nil festgelegt werden. |
| GetKeywordCategories | Es sollte keinen Unterschied zwischen Sandbox und Produktion geben. |
| GetKeywordDemographics | Eine begrenzte Anzahl von Schlüsselwörtern wird unterstützt: Luft, Auto, beste Angebote, Buchung, Autoinformationen, Pflege, Deal of the Day, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel. Das Devices-Element muss auf Computer oder left nil festgelegt werden. |
| GetKeywordIdeas | Sandbox-Testdaten werden alle 3 Monate aktualisiert, sodass Sie einen früheren Datumsbereich festlegen müssen. |
| GetKeywordLocations | Eine begrenzte Anzahl von Schlüsselwörtern wird unterstützt: Luft, Auto, beste Angebote, Buchung, Autoinformationen, Pflege, Deal of the Day, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel. Das Devices-Element muss auf Computer oder left nil festgelegt werden. |
| SuggestKeywordsForUrl | Es sollte keinen Unterschied zwischen Sandbox und Produktion geben. |
| SuggestKeywordsFromExistingKeywords | Wenn SuggestionType auf 1 festgelegt ist, sollte es keinen Unterschied im Verhalten im Vergleich zur Produktion geben. Für die Vorschlagstypwerte 2, 3 und 4 wird eine begrenzte Anzahl von Schlüsselwörtern unterstützt: Air, Auto, beste Angebote, Buchung, Autoinformationen, Pflege, Deal des Tages, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel. |
Massendienst
Die Dateigrößenbeschränkung für den Upload in der Produktion beträgt 100 MB oder 2,5 Millionen Zeilen. Für die Sandbox beträgt der Grenzwert 20.000 Zeilen. Weitere Informationen finden Sie unter Massendownload und -upload.
Kampagnenverwaltungsdienst
Redaktionelle Unterstützung
Sandbox unterstützt eingeschränkte redaktionelle Rezensionen und Aufrufe. Sie können die Gründe für redaktionelle Probleme nicht wie in der Produktion in der Sandbox abrufen, z. B. über den Dienstvorgang GetEditorialReasonsByIds .
Produktanzeigen
Produktanzeigen werden in der Sandbox im USA unterstützt. Um automatisch genehmigt zu werden, müssen Sie einen Katalog und einen Microsoft Merchant Center-Store erstellen, der wie folgt mit "Sandbox" endet.
Klicken Sie in der Microsoft Advertising-Webanwendung auf Tools.
Klicken Sie unter Verwaltungstools auf Microsoft Merchant Center.
Klicken Sie auf Speicher erstellen, und geben Sie einen Geschäftsnamen ein, der mit "Sandbox" endet (Groß-/Kleinschreibung wird nicht beachtet).
Fügen Sie Ihre Store-Informationen hinzu, wählen Sie unter Katalogeinstellungendie Option Produktanzeigen aus, und klicken Sie auf Fertig stellen.
Klicken Sie in Ihrem neuen Speicher auf Katalogverwaltung und dann auf Katalog erstellen.
Fügen Sie Ihren Katalognamen hinzu, wählen Sie Datei später manuell hochladen unter Katalogfeeddatei aus, und klicken Sie auf Speichern.
Customer Billing Service
Zahlungsmethoden werden in der Sandbox nicht unterstützt.
Reporting Service
Wenn Sie eine Schlüsselwort (keyword) erstellen, sollten testleistungsdaten innerhalb weniger Stunden generiert werden. Die Daten werden bereitgestellt, um das Generieren, Abrufen und Analysieren von Berichten in der Sandbox zu testen. Sie sollten die Testdaten nicht verwenden, um eine ähnliche Leistung für Ihre Schlüsselwörter in der Produktion abzuleiten oder zu erwarten.
Testdaten werden nur für den gleichen Tag generiert, an dem die Entität hinzugefügt oder aktualisiert wurde. Wenn Sie beispielsweise heute eine Schlüsselwort (keyword) hinzufügen und einen Schlüsselwort (keyword) Leistungsbericht für die letzte Woche herunterladen, sind keine Daten vorhanden. Sie müssten einen Bericht pullen, der heute in den Berichtszeitraum einschließt.
Die folgenden Berichte können Leistungsdaten in der Sandbox zurückgeben. Alle anderen Berichtstypen können erfolgreich übermittelt werden, obwohl der Sandboxdienst keine Beispieldaten zurückgibt, d. h. die Url zum Herunterladen des Berichts wird nicht festgelegt, wenn Sie ergebnisse abrufen.