Best Practices

In diesem Leitfaden werden einige Best Practices beschrieben, mit denen Sie die Effizienz und Leistung Ihrer Anwendungen optimieren können.

App pflegen

So sorgen Sie dafür, dass Ihre App ohne Unterbrechung ausgeführt wird:

  • Achten Sie darauf, dass die Liste der Inhaber und Bearbeiter Ihres Google Cloud-Projekts auf dem neuesten Stand ist. Wir kontaktieren diese Nutzer im Notfall oder bei Themen im Zusammenhang mit der Einhaltung der API-Nutzungsbedingungen. Wenn wir Sie nicht bezüglich der Einhaltung der API-Nutzungsbedingungen kontaktieren können, wird Ihr API-Zugriff möglicherweise eingeschränkt oder widerrufen.

  • Wenn Sie über Probleme wie Produktänderungen, Wartungsausfälle und Termine für die Einstellung von Produkten informiert werden möchten, abonnieren Sie unseren API-Blog und unseren Produkt-Blog.

  • Ihre App muss den Nutzungsbedingungen für die Google Ads API entsprechen. Falls erforderlich, wendet sich das API-Compliance-Team an die Inhaber und Bearbeiter Ihres Google Cloud-Projekts mit API-Zugriff. Wenn Sie Fragen oder Bedenken zu den Nutzungsbedingungen haben, können Sie sich an das Compliance-Team wenden. Antworten Sie dazu auf die E‑Mail, die Sie bei der Überprüfung Ihres Antrags auf API-Zugriff erhalten haben.

Optimierung

Sie können Ihre App optimieren, indem Sie Batchvorgänge ausführen und gegebenenfalls dünnbesetzte Objekte senden.

Batchvorgänge

Eine Anfrage an die API ist mit einer Reihe von Fixkosten verbunden, z. B. Netzwerklatenz für Hin- und Rückflug, Serialisierungs- und Deserialisierungsverarbeitung sowie Aufrufe von Backend-Systemen. Um die Auswirkungen dieser Fixkosten zu verringern und die Gesamtleistung zu steigern, sind die meisten Mutate-Methoden in der API so konzipiert, dass sie ein Array von Vorgängen akzeptieren. Wenn Sie mehrere Vorgänge in einer Anfrage zusammenfassen, können Sie die Anzahl der Anfragen und die damit verbundenen Fixkosten reduzieren. Vermeiden Sie nach Möglichkeit Anfragen mit nur einem Vorgang.

Angenommen, Sie fügen einer Kampagne 50.000 Keywords in mehreren Anzeigengruppen hinzu. Anstatt 50.000 Anfragen mit jeweils einem Keyword zu stellen, stellen Sie 100 Anfragen mit jeweils 500 Keywords oder sogar 10 Anfragen mit jeweils 5.000 Keywords. Die Anzahl der in einer Anfrage zulässigen Vorgänge ist begrenzt. Daher müssen Sie möglicherweise die Batchgröße anpassen, um eine optimale Leistung zu erzielen.

Teilobjekte senden

Wenn Objekte an die API gesendet werden, müssen Felder deserialisiert, validiert und in der Datenbank gespeichert werden. Wenn Sie vollständige Objekte übergeben, obwohl Sie nur einige Felder aktualisieren möchten, kann dies zu zusätzlicher Verarbeitungszeit und einer geringeren Leistung führen. Um dieses Problem zu beheben, unterstützt die Google Ads API dünnbesetzte Aktualisierungen. So können Sie nur die Felder in einem Objekt ausfüllen, die Sie ändern müssen oder die erforderlich sind. Dünnbesetzte Aktualisierungen werden schneller verarbeitet und sind weniger fehleranfällig. Felder, die nicht in der update_mask (auch als FieldMask bezeichnet) enthalten sind, bleiben unverändert.

Beispielsweise kann eine Anwendung, die Gebote auf Keyword-Ebene aktualisiert, von dünnbesetzten Aktualisierungen profitieren, da nur die Felder für die Anzeigengruppen-ID, die Kriteriums-ID und die Gebote ausgefüllt werden müssen.

Fehlerbehandlung

Während der Entwicklung werden Sie mit hoher Wahrscheinlichkeit auf Fehler stoßen. In diesem Abschnitt werden Überlegungen und Strategien für die Integration der Fehlerverwaltung in Ihre Anwendung beschrieben. Weitere Informationen zur Fehlerverwaltung finden Sie im Leitfaden zur Fehlerbehebung.

Anfragequellen unterscheiden

Einige Apps sind hauptsächlich interaktiv und geben API-Aufrufe direkt als Reaktion auf vom Nutzer initiierte Aktionen in einer Benutzeroberfläche aus. Andere arbeiten hauptsächlich offline und geben API-Aufrufe im Rahmen eines regelmäßigen Backend-Prozesses aus. Bei manchen Apps kommt auch beides vor. Bei der Fehlerverwaltung kann es hilfreich sein, diese verschiedenen Arten von Anfragen zu unterscheiden.

Bei von Nutzern initiierten Anfragen sollten Sie sich auf eine gute Nutzererfahrung konzentrieren. Verwenden Sie den spezifischen Fehler, der aufgetreten ist, um dem Nutzer in der Benutzeroberfläche so viel Kontext wie möglich zu bieten. Bieten Sie klare Schritte zur Behebung des Fehlers an (siehe die folgenden Vorschläge).

Implementieren Sie für Anfragen, die im Backend initiiert werden, Handler für die verschiedenen Arten von Fehlern, die in Ihrer Anwendung auftreten können. Fügen Sie immer einen Standard-Handler hinzu, um seltene oder bisher nicht aufgetretene Fehler zu beheben. Ein guter Ansatz für einen Standard-Handler besteht darin, den fehlgeschlagenen Vorgang und den Fehler einer Warteschlange hinzuzufügen, damit ein menschlicher Operator sie überprüfen und eine geeignete Lösung finden kann.

Fehlertypen unterscheiden

Wenn Sie eine robuste Fehlerbehandlung einrichten möchten, müssen Sie die Unterschiede zwischen den Fehlertypen in der Google Ads API kennen. Dies sind einige der häufigsten Fehlertypen:

Weitere Informationen finden Sie unter Fehlertypen und Häufige Fehler.

Back-Ends synchronisieren

Wenn die Nutzer Ihrer App manuellen Zugriff auf Google Ads-Konten haben, können sie Änderungen vornehmen, die Ihrer App nicht bekannt sind. Dadurch kann die lokale Datenbank Ihrer App nicht mehr synchron sein. Wie in unserem Leitfaden zu Fehlertypen beschrieben, können Sie synchronisierungsbezogene Fehler reaktiv beheben, wenn sie auftreten. Sie können aber auch versuchen, sie proaktiv zu verhindern. Eine proaktive Strategie besteht darin, regelmäßig einen Synchronisierungsjob auszuführen, um Ihre lokale Datenbank mit den Google Ads-Objekten in Ihren Konten abzugleichen. Bei großen Kontohierarchien sollten Sie nicht jede Nacht alle Objekte aus allen Konten abrufen, um die täglichen Kontingente nicht zu erschöpfen. Fragen Sie stattdessen ChangeStatus ab oder filtern Sie nach kürzlich geänderten Entitäten, um Änderungen schrittweise zu synchronisieren.

Logfehler

Alle Fehler sollten protokolliert werden, damit ihre Behebung und Überwachung vereinfacht wird. Protokollieren Sie mindestens die Anfrage-ID, die Vorgänge, die den Fehler verursacht haben, und den Fehler selbst. Zu den weiteren Informationen, die protokolliert werden sollten, gehören die Kundennummer, der API-Dienst, die Roundtrip-Anfragelatenz, die Anzahl der Wiederholungsversuche sowie die bereinigte Rohanfrage und -antwort. Achten Sie darauf, vertrauliche Anmeldedaten wie OAuth-Tokens und alle personenidentifizierbaren Informationen zu entfernen.

Beobachten Sie Trends bei API-Fehlern, um Probleme mit Ihrer App zu erkennen und zu beheben. Sie können eine eigene Lösung entwickeln oder eines der vielen verfügbaren kommerziellen Tools verwenden, die Ihre Logs nutzen, um interaktive Dashboards zu erstellen und automatisierte Benachrichtigungen zu senden.

Entwicklung

Verwenden Sie während der Entwicklung Testkonten.

Testkonten nutzen

Testkonten sind Google Ads-Konten, über die keine Anzeigen ausgeliefert werden. Mit einem Testkonto können Sie die Google Ads API ausprobieren und testen, ob die Verbindung Ihrer App, die Logik für die Kampagnenverwaltung oder andere Verarbeitungen wie erwartet funktionieren. Für Ihr Google Cloud-Projekt ist nur Testzugriff erforderlich, um es in einem Testkonto zu verwenden. Sie können also sofort mit der Entwicklung mit der Google Ads API beginnen, während Sie darauf warten, dass Google Ihren Antrag auf höhere API-Zugriffsebenen prüft.

Weiter
API-Limits und ‑Kontingente