Microsoft Advertising-Sandbox

Microsoft Advertising stellt eine API-Sandkastenumgebung bereit, in der Sie Ihre Anwendung testen können, bevor Sie sie in der Produktionsumgebung bereitstellen. Anzeigen, die Sie in der Sandbox erstellen, werden nicht geschaltet. Die unterstützten Dienste in der Sandbox variieren je nach Produktion. Die Webdienstadressen für unterstützte Dienste finden Sie unter Bing Ads API-Webdienstadressen.

Hinweis

Die Sandbox kann mit oder ohne vorherige Benachrichtigung wegen Wartungsarbeiten ausgefallen sein.

Erstmalige Kundenregistrierung

Die Sandbox- und Produktionsumgebungen verwenden separate Anmeldeinformationen.

Führen Sie die folgenden Schritte aus, um einen neuen Sandbox-Kunden zu gewinnen. Wenn Sie bereits einen Sandbox-Kunden haben und einen neuen Benutzer hinzufügen möchten, z. B. mit Microsoft-Kontoanmeldeinformationen, können Sie mit den Schritten zur Benutzereinladung fortfahren.

  1. Öffnen Sie einen Browser, und navigieren Sie zur Sandbox-Registrierungsseite.

  2. Wählen Sie Jetzt registrieren aus.

  3. Wählen Sie Konto erstellen aus, um ein Microsoft-Konto (MSA) zu erstellen.

  4. Wählen Sie "Neue E-Mail-Adresse anfordern" aus.

  5. Geben Sie eine MSA-E-Mail-Adresse ein. Der E-Mail-Server muss outlook.com sein (z. B someone@outlook.com. ).

    Wichtig

    Sandbox unterstützt MSAs, die nur mit einem outlook.com E-Mail-Konto erstellt wurden. Sie dürfen auch kein E-Mail-Konto von einem anderen E-Mail-Dienst verwenden (beispielsweise auch dann nicht, @contoso.com) wenn das Konto mit einem outlook.com E-Mail-Konto verknüpft ist).

  6. Schließen Sie den MSA-Workflow ab, indem Sie die restlichen Benutzer- und Sicherheitsinformationen angeben. Sie werden dann zu Microsoft Advertising weitergeleitet, um die Sandbox-Kunden- und Kontoregistrierung fortzusetzen.

  7. Füllen Sie das Formular Konto erstellen aus.

  8. Wählen Sie für Live gehen die Option Zahlungsinformationen überspringen aus.

Optional: Weitere Benutzer einladen

Für die Authentifizierung mit OAuth in der Sandbox benötigen Sie ein Microsoft-Konto (MSA), das mit einem outlook.com E-Mail-Konto erstellt wurde. Wenn Ihr Sandbox-Kunde noch keine Benutzeranmeldeinformationen über ein Microsoft-Konto hat oder Ihr Sandbox-Kunde mit einem outlook-int.com-E-Mail-Konto erstellt wurde, müssen Sie einen Benutzer einladen, über die folgenden Schritte an Ihrem Sandbox-Konto zu arbeiten.

  1. Wählen Sie in der Microsoft Advertising-SandboxEinstellungen aus.

  2. Wählen Sie Benutzerverwaltung aus.

  3. Wählen Sie "Benutzer einladen" aus.

  4. 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 können 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. ), zeigt die BingAds-Benutzeroberfläche die Einladung auf unbestimmte Zeit als ausstehend an (die Einladung wird nie gesendet).

  5. Wählen Sie Senden aus.

Microsoft Advertising sendet eine E-Mail-Einladung an den Benutzer. Wenn die Einladung nicht im Posteingang angezeigt wird, überprüfen Sie den Ordner "Junk-E-Mail". Es kann einige Minuten dauern, bis Sie die Einladung erhalten. Die folgenden Schritte zeigen, wie Sie die Einladung annehmen.

  1. Öffnen Sie die E-Mail von Microsoft Advertising mit der Betreffzeile, Einladung zu Microsoft Advertising

  2. Kopieren Sie den eingebetteten Link, und öffnen Sie ihn in einem Fenster mit InPrivate-Modus oder in einem anderen Browser.

  3. Wählen Sie Konto erstellen aus, um ein Microsoft-Konto (MSA) zu erstellen.

  4. Wählen Sie "Neue E-Mail-Adresse anfordern" aus.

  5. Geben Sie eine MSA-E-Mail-Adresse ein. Der E-Mail-Server muss outlook.com sein (z. B someone@outlook.com. ).

    Wichtig

    Sandbox unterstützt MSAs, die nur mit einem outlook.com E-Mail-Konto erstellt wurden. Sie dürfen auch kein E-Mail-Konto von einem anderen E-Mail-Dienst verwenden (beispielsweise auch dann nicht, @contoso.com) wenn das Konto mit einem outlook.com E-Mail-Konto verknüpft ist).

  6. Beenden Sie den Arbeitsablauf, indem Sie die restlichen Benutzerinformationen angeben

  7. Beenden Sie Microsoft Advertising nach Abschluss des MSA-Prozesses.

Hinweis

Beim MSA-Registrierungsvorgang kehren Sie zur SI Microsoft Advertising-Benutzeroberfläche (ads-int.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.com E-Mail-Adresse unter https://sandbox.bingads.microsoft.com/an.

Sandbox-Umgebung — Google OAuth-Support

Die Microsoft Advertising-Sandbox - und Produktionsumgebungen verwenden separate Anmeldeinformationen. Zusätzlich zu Microsoft-Konten können Sie jetzt Sandbox-Kunden erstellen und Benutzer mit Google OAuth 2.0 authentifizieren.

Auf diese Weise können Entwickler und Werbetreibende Microsoft Advertising-APIs in der Sandbox mit einer Google-Identität testen, ohne dass ein Microsoft-Konto erforderlich outlook.com ist.

Erstkunden-Sign-Up (Sandbox) – Google OAuth

Sie können einen neuen Sandbox-Kunden mit einem Google-Konto erstellen.

Schritte zum Erstellen eines neuen Sandbox-Kunden mit Google OAuth

  1. Öffnen Sie einen Browser, und navigieren Sie zur Sandbox-Registrierungsseite.

  2. Wählen Sie Jetzt registrieren aus.

  3. Wählen Sie Sign up with Google.

  4. Schließen Sie den Google OAuth-Authentifizierungsablauf ab:

    • Melden Sie sich mit Ihrem Google-Konto an.
    • Überprüfen Sie Ihre Einwilligung, um Microsoft Advertising den Zugriff auf Ihr Konto zu gestatten.
    • Genehmigen Sie die angeforderten Bereiche (email, profile), wenn Sie dazu aufgefordert werden.

  5. Nach erfolgreicher Authentifizierung werden Sie zurück zu Microsoft Advertising umgeleitet, um die Sandbox-Kundenerstellung fortzusetzen.

  6. Füllen Sie das Formular "Konto erstellen " aus.

    • Wählen Sie für Live gehen die Option Zahlungsinformationen überspringen aus.

Annehmen einer Einladung mit Google OAuth

Eingeladene Benutzer können Sandbox-Einladungen mit Google OAuth wie folgt annehmen:

  1. Öffnen Sie den Einladungslink.
  2. Wählen Sie Bei Google anmelden aus.
  3. Schließen Sie den Google OAuth-Authentifizierungsablauf ab.
  4. Nach erfolgreicher Anmeldung wird der Benutzer dem Sandbox-Konto hinzugefügt.

Diese erweiterte Sandbox-Unterstützung ermöglicht es Teams, Microsoft Advertising-APIs mit Google-authentifizierten Benutzern zu testen und dabei das gleiche API-Verhalten wie in der Produktion beizubehalten.

API-Zugriff erhalten

Die Sandbox- und Produktionsumgebungen verwenden separate Anmeldeinformationen.

Diese Tabelle enthält zusätzliche Sandbox-Endpunkte.

Beschreibung Produktion Sandbox
Endpunkt für OAuth-Anforderungen login.microsoftonline.com login.microsoftonline.com
Domäne für die E-Mail-Adresse, die beim Abrufen eines Microsoft-Kontos verwendet wird Beliebige E-Mail-Adresse outlook.com
Endpunkt zum Ändern des Kennworts für das Microsoft-Konto account.live.com/password/change account.live.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

Sie müssen Ihre eigene Anwendungs-ID sowohl in der Produktion als auch in der Sandbox verwenden (auch als Client-ID bezeichnet).

Jetzt können Sie Zugriffs- und Aktualisierungstoken für Ihren Microsoft Advertising-Benutzer abrufen und Ihren ersten Dienstanruf mithilfe der Bing Ads-API tätigen. Weitere Informationen dazu finden Sie im Schnellstarthandbuch .

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.

API-Zugriff für Google oAuth erhalten

Erstellen Sie ein Google-Konto unter https://accounts.google.com.

Bewährte Methoden für Sandbox

Die Sandbox sollte nicht in der gleichen Funktion 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 die aktuelle Produktionsversion und wird mit Featurevorschauen mit oder ohne vorherige Ankündigung aktualisiert.
  • Die Kapazität der Sandbox ist geringer als die der Produktion, und Sie sollten sie nicht zum Ausführen von Stress- oder Kapazitätstests verwenden.
  • Verwenden Sie nicht mehr als einen Thread.

Ad Insight Service

Sandbox unterstützt eine begrenzte Anzahl 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 sind in der folgenden Tabelle beschrieben.

Tipp

Verwenden Sie den Ad Insight-Dienst in der Produktion anstelle der Sandbox. Die Sandbox bietet nur eine Teilmenge der Produktionsservicevorgänge an, und die Erkenntnisdaten hinken der Produktion hinterher. Sandbox-Opportunity-Daten werden jedes Wochenende aktualisiert und aktualisiert und sind bis Montag verfügbar. Die Schlüsselwort(keyword)-Ideendaten in der Sandbox können mehrere Monate hinter der Produktion zurückbleiben. Wenn ein Vorgang aufgrund eines ungültigen Datumsbereichs fehlschlägt, versuchen Sie, die Anforderung erneut mit einem früheren Datumsbereich zu übermitteln.

Dienst Betrieb Sandbox-Einschränkungen
GetBidLandscapeByKeywordIds Nicht unterstützt Sie können den Vorgang mit vorhandenen Schlüsselwortbezeichnern (keyword) aufrufen, es werden jedoch keine Daten zurückgegeben.
GetEstimatedBidByKeywordIds Eine begrenzte Anzahl von Schlüsselwörtern wird unterstützt: Luft, Auto, beste Angebote, Buchung, Autoinformationen, Pflege, Angebot des Tages, 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, Angebot des Tages, 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, Angebot des Tages, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel.

Um die Wahrscheinlichkeit zu erhöhen, eine Schätzung zu erhalten, sollte das MaxBid-Element größer oder gleich 5 US-Dollar oder dem Gegenwert in anderen Währungen sein.
GetEstimatedPositionByKeywords Eine begrenzte Anzahl von Schlüsselwörtern wird unterstützt: Luft, Auto, beste Angebote, Buchung, Autoinformationen, Pflege, Angebot des Tages, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel.

Um die Wahrscheinlichkeit zu erhöhen, eine Schätzung zu erhalten, sollte das MaxBid-Element größer oder gleich 5 US-Dollar oder dem Gegenwert in anderen Währungen sein.
GetHistoricalKeywordPerformance Eine begrenzte Anzahl von Schlüsselwörtern wird unterstützt: Luft, Auto, beste Angebote, Buchung, Autoinformationen, Pflege, Angebot des Tages, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel.

Die MatchType - und AdPosition-Elemente müssen auf "Aggregate" eingestellt sein.

Das Devices-Element muss auf Computer oder Left nil eingestellt sein.
GetHistoricalSearchCount Eine begrenzte Anzahl von Schlüsselwörtern wird unterstützt: Luft, Auto, beste Angebote, Buchung, Autoinformationen, Pflege, Angebot des Tages, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel.

Das EndMonthAndYear-Element muss auf den vorherigen Monat festgelegt sein. Wenn das heutige Datum beispielsweise der 1. April 2020 ist, sollte das Ende des Monats März 2020 sein.

Das Devices-Element muss auf Computer oder Left nil eingestellt sein.
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, Angebot des Tages, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel.

Das Devices-Element muss auf Computer oder Left nil eingestellt sein.
GetKeywordIdeas Sandbox-Testdaten werden alle 3 Monate aktualisiert, daher müssen Sie einen früheren Datumsbereich festlegen.
GetKeywordLocations Eine begrenzte Anzahl von Schlüsselwörtern wird unterstützt: Luft, Auto, beste Angebote, Buchung, Autoinformationen, Pflege, Angebot des Tages, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel.

Das Devices-Element muss auf Computer oder Left nil eingestellt sein.
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 Werte des Vorschlagstyps 2, 3 und 4 wird eine begrenzte Anzahl von Schlüsselwörtern unterstützt: Flug, Auto, beste Angebote, Buchung, Autoinformationen, Pflege, Angebot des Tages, Rabatte, Unterhaltung, Finanzen, Spiele, Hotelbewertungen, Versicherungsvergleich, Sport, das Hotel.

Massendienst

Das Dateigrößenlimit für den Upload in der Produktion beträgt 100 MB oder 2,5 Millionen Zeilen. Für die Sandbox beträgt das Limit 20 KB Zeilen. Weitere Informationen finden Sie unter Massendownload und -upload.

Campaign Management Service

Redaktionelle Unterstützung

Sandbox unterstützt eingeschränkte redaktionelle Prüfungen und Einsprüche. Sie können die Gründe für redaktionelle Probleme in der Sandbox nicht wie in der Produktion abrufen, z. B. über den Dienstvorgang GetEditorialReasonsByIds .

Produktanzeigen

Produktanzeigen werden in den USA in Sandbox unterstützt. Um automatisch genehmigt zu werden, müssen Sie einen Katalog und einen Microsoft Merchant Center-Shop erstellen, der wie folgt mit "Sandbox" endet.

  1. Wählen Sie in der Microsoft Advertising-Webanwendung Tools aus.
  2. Wählen Sie unter Verwaltungstools die Option Microsoft Merchant Center aus.
  3. Wählen Sie Shop erstellen aus und geben Sie einen Shop-Namen ein, der auf "Sandbox" endet (Groß-/Kleinschreibung wird nicht beachtet).
  4. Fügen Sie Ihre Shop-Informationen hinzu, wählen Sie unter Katalogeinstellungendie Option Produktanzeigen aus, und wählen Sie Fertig stellen.
  5. Klicken Sie in Ihrem neuen Shop auf Katalogverwaltung und dann auf Katalog erstellen.
  6. Fügen Sie Ihren Katalognamen hinzu, wählen Sie unter Katalogfeeddateidie Option Manuelles Hochladen der Datei später aus, und wählen Sie Speichern aus.

Customer Billing Service

Zahlungsmethoden werden in der Sandbox nicht unterstützt.

Reporting Service

Wenn Sie ein Schlüsselwort (Keyword) erstellen, sollten Testleistungsdaten innerhalb weniger Stunden generiert werden. Die Daten werden zum Testen des Generierens, Abrufens und Analysierens von Berichten in der Sandbox bereitgestellt. 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 denselben Tag generiert, an dem die Entität hinzugefügt oder aktualisiert wurde. Wenn Sie beispielsweise heute ein Schlüsselwort (Keyword) hinzufügen und einen Schlüsselwort (Keyword)-Performance-Bericht für die letzte Woche herunterladen, sind keine Daten vorhanden. Sie müssten einen Bericht abrufen, der den heutigen Tag in den Berichtszeitraum einbezieht.

Die folgenden Berichte können Leistungsdaten in der Sandbox zurückgeben. Alle anderen Berichtstypen können erfolgreich übermittelt werden, obwohl der Sandbox-Dienst keine Beispieldaten zurückgibt, d. h. die Download-URL des Berichts wird nicht festgelegt, wenn Sie nach Ergebnissen fragen.

  • Last updated on