Best Practices

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

App warten

Damit Ihre App ohne Unterbrechungen ausgeführt wird, gehen Sie so vor:

  • Achten Sie darauf, dass die Liste der Inhaber und Bearbeiter Ihres Google Cloud-Projekts auf dem neuesten Stand ist. Wir setzen uns mit diesen Nutzern in Verbindung, wenn es um Notfälle oder Themen im Zusammenhang mit der Einhaltung der API-Nutzungsbedingungen geht. Wenn wir Sie bezüglich der Einhaltung der API-Nutzungsbedingungen nicht kontaktieren können, wird Ihr API-Zugriff möglicherweise eingeschränkt oder widerrufen.

  • Wenn Sie über Probleme wie Produktänderungen, Wartungsunterbrechungen und Einstellungsdaten informiert werden möchten, abonnieren Sie unseren API-Blog und Produktblog.

  • Halten Sie die Nutzungsbedingungen der Google Ads API ein. Bei Bedarf 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 AGB haben, können Sie sich an das Compliance-Team wenden. Antworten Sie dazu einfach auf die E‑Mail, die Sie bei der Überprüfung Ihres API-Zugriffsantrags erhalten haben.

Optimierung

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

Batchvorgänge

Eine Anfrage an die API verursacht eine Reihe von Fixkosten, z. B. die Netzwerk-Roundtrip-Latenz, die Verarbeitung der Serialisierung und Deserialisierung 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 jeder Anfrage zusammenfassen, können Sie die Anzahl der Anfragen und die damit verbundenen Fixkosten reduzieren. Wenn möglich, sollten Sie Anfragen mit nur einem Vorgang vermeiden.

Angenommen, Sie fügen einer Kampagne 50.000 Keywords in mehreren Anzeigengruppen hinzu. Anstatt 50.000 Anfragen mit jeweils einem Keyword zu senden, können Sie 100 Anfragen mit jeweils 500 Keywords oder sogar 10 Anfragen mit jeweils 5.000 Keywords senden. Die Anzahl der Vorgänge, die in einer Anfrage zulässig sind, ist begrenzt. Möglicherweise müssen Sie 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 einer längeren Verarbeitungszeit und einer geringeren Leistung führen. Um dieses Problem zu beheben, unterstützt die Google Ads API spärliche Updates. So können Sie nur die Felder in einem Objekt ausfüllen, die Sie ändern müssen oder die erforderlich sind. Sparsame Updates werden schneller verarbeitet und es ist weniger wahrscheinlich, dass Fehler auftreten. Felder, die nicht in update_mask (auch als FieldMask bezeichnet) enthalten sind, bleiben unverändert.

Eine App, die Gebote auf Keyword-Ebene aktualisiert, kann beispielsweise von der Verwendung von spärlichen Updates 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 zum Einbauen der Fehlerbehandlung in Ihre App beschrieben. Zusätzlich zu diesem Abschnitt finden Sie im Leitfaden zur Fehlerbehebung weitere Informationen zur Fehlerbehebung.

Anfragequellen unterscheiden

Einige Apps sind in erster Linie interaktiv und geben API-Aufrufe direkt als Reaktion auf nutzerinitiierte Aktionen in einer Benutzeroberfläche aus. Andere funktionieren hauptsächlich offline und senden API-Aufrufe im Rahmen eines regelmäßigen Backend-Prozesses. Bei manchen Apps kommt auch beides vor. Bei der Fehlerbehandlung kann es hilfreich sein, zwischen diesen verschiedenen Arten von Anfragen zu unterscheiden.

Bei von Nutzern initiierten Anfragen sollten Sie sich auf eine gute Nutzererfahrung konzentrieren. Verwenden Sie den aufgetretenen Fehler, um dem Nutzer in der Benutzeroberfläche so viel Kontext wie möglich zu geben. Gib klare Schritte an, die der Nutzer unternehmen kann, um den Fehler zu beheben (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 App auftreten können. Fügen Sie immer einen Standard-Handler ein, um seltene oder bisher unbekannte Fehler zu beheben. Ein guter Ansatz für einen Standard-Handler besteht darin, den fehlgeschlagenen Vorgang und den Fehler in eine Warteschlange zu stellen, damit ein menschlicher Bediener sie überprüfen und eine geeignete Lösung finden kann.

Fehlertypen unterscheiden

Die Unterschiede zwischen den Fehlertypen in der Google Ads API sind entscheidend, wenn Sie eine robuste Fehlerbehandlung entwickeln möchten. Zu den häufigsten Fehlertypen gehören:

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 synchronisiert werden. Wie in unserem Leitfaden 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 alle Objekte aus jedem Konto täglich abrufen, um die täglichen Kontingente nicht zu überschreiten. Fragen Sie stattdessen ChangeStatus ab oder filtern Sie nach kürzlich geänderten Einheiten, um Änderungen inkrementell 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 protokollierende Informationen sind unter anderem die Kunden-ID, der API-Dienst, die Roundtrip-Anfragelatenz, die Anzahl der Wiederholungsversuche sowie die bereinigte Rohanfrage und ‑antwort (dabei müssen vertrauliche Anmeldedaten wie OAuth-Tokens, Entwicklertokens, sofern sie noch in Legacy-Anfrageheadern enthalten sind, und alle personenbezogenen Daten unkenntlich gemacht werden).

Behalten Sie die Trends bei API-Fehlern im Blick, damit Sie Probleme mit Ihrer App erkennen und beheben können. Sie können eine eigene Lösung entwickeln oder eines der vielen verfügbaren kommerziellen Tools verwenden, mit denen sich aus Ihren Logs interaktive Dashboards erstellen und automatische Benachrichtigungen senden lassen.

Entwicklung

Verwenden Sie während der Entwicklung Testkonten.

Testkonten nutzen

Testkonten sind Google Ads-Konten, in denen keine Anzeigen ausgeliefert werden. Mit einem Testkonto können Sie die Google Ads API ausprobieren und testen, ob die Verbindungsfunktionen, die Logik zur Kampagnenverwaltung oder andere Verarbeitungsvorgänge Ihrer App wie erwartet funktionieren. Für die Verwendung in einem Testkonto ist für Ihr Google Cloud-Projekt nur Testzugriff erforderlich. Sie können also sofort mit der Entwicklung mit der Google Ads API beginnen, während Google Ihre Anwendung für höhere API-Zugriffsebenen prüft.

Weiter
API-Limits und ‑Kontingente