Video: Best Practices aus dem Workshop 2019
In diesem Leitfaden finden Sie einige Best Practices, mit denen Sie die Effizienz und Leistung Ihrer Apps optimieren können.
Laufende Wartung
So vermeiden Sie Unterbrechungen bei der Anzeigenauslieferung:
Halten Sie die E-Mail-Adresse des Entwicklerkontakts im API-Center auf dem neuesten Stand. Unter diesem Alias kontaktieren wir Sie. Falls wir Sie nicht erreichen, um mit Ihnen die Einhaltung der API-Nutzungsbedingungen zu besprechen, kann Ihr API-Zugang ohne Vorankündigung gesperrt werden. Verwenden Sie keine private E-Mail-Adresse, die mit einem individuellen oder nicht überwachten Konto verknüpft ist. Sie müssen in Ihrem Verwaltungskonto angemeldet sein, um das API-Center aufzurufen.
Wenn Sie über Themen wie Produktänderungen, Wartungszeiten und Einstellungstermine informiert werden möchten, abonnieren Sie unseren
Das Forum wird regelmäßig vom Google Ads API-Team überwacht und ist daher der ideale Ort, um API-Fragen zu stellen.
- Ihre App muss die Nutzungsbedingungen der Google Ads API einhalten. Falls erforderlich, wird sich das Team für die Tokenüberprüfung und -compliance über Ihre Kontakt-E-Mail-Adresse mit Ihnen in Verbindung setzen. Wenn Sie Fragen oder Bedenken zu den Nutzungsbedingungen haben, können Sie sich an das Prüfteam wenden. Antworten Sie dazu auf die E-Mail, die Sie bei der Überprüfung Ihres Antrags auf ein Entwicklertoken erhalten haben.
Optimierung
Sie können Ihre App optimieren, indem Sie Batchvorgänge ausführen und gegebenenfalls spärliche Objekte senden.
Batchvorgänge
Das Senden einer Anfrage an die API ist mit einer Reihe von Fixkosten verbunden, z. B. Netzwerklatenz, Serialisierung und Deserialisierung sowie Aufrufe von Back-End-Systemen. Um die Auswirkungen dieser Fixkosten zu verringern und die Gesamtleistung zu steigern, sind die meisten Mutatmethoden in der API so konzipiert, dass sie eine Reihe von Vorgängen akzeptieren. Durch die Verarbeitung mehrerer Vorgänge innerhalb einer Anfrage werden die Anzahl der Anfragen und die damit zusammenhängenden Fixkosten reduziert. 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 senden, sollten Sie 100 Anfragen mit jeweils 500 Keywords oder sogar 10 Anfragen mit jeweils 5.000 Keywords senden. 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 einer zusätzlichen Verarbeitungszeit und einer geringeren Leistung führen.
Um dies zu vermeiden, unterstützt die Google Ads API sparsame Aktualisierungen. Sie können also nur die Felder in einem Objekt ausfüllen, die Sie ändern müssen oder die erforderlich sind. Sparse Updates werden schneller verarbeitet und führen seltener zu Fehlern.
Felder, die nicht in der Aktualisierungsmaske (auch als FieldMask bezeichnet) enthalten sind, bleiben unverändert.
Für eine App, bei der Gebote auf Keyword-Ebene aktualisiert werden, können beispielsweise seltene Aktualisierungen sinnvoll sein, da nur die Felder „Anzeigengruppen-ID“, „Kriteriens-ID“ und „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 zur Fehlerverwaltung in Ihrer App beschrieben. Weitere Informationen zur Fehlerverwaltung finden Sie im Leitfaden zur Fehlerbehebung.
Anfragequellen unterscheiden
Einige Apps sind hauptsächlich interaktiv und senden API-Aufrufe direkt als Reaktion auf vom Nutzer initiierte Aktionen in einer Benutzeroberfläche. Andere arbeiten hauptsächlich offline und senden API-Aufrufe im Rahmen eines regelmäßigen Back-End-Prozesses. 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 den Nutzern auf der Benutzeroberfläche so viel Kontext wie möglich zu bieten. Biete einfache Schritte zur Fehlerbehebung an (siehe Vorschläge unten).
Implementieren Sie für Anfragen, die im Back-End initiiert werden, Handler für die verschiedenen Arten von Fehlern, die in Ihrer App auftreten können. Fügen Sie immer einen Standard-Handler hinzu, um seltene oder bisher nicht aufgetretene Fehler zu behandeln. 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 entwickeln möchten, ist es wichtig, die Unterschiede zwischen den Fehlertypen in der Google Ads API zu kennen. 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. Dies führt dazu, dass die lokale Datenbank Ihrer App nicht mehr synchronisiert ist. Wie in unserem Leitfaden zu Fehlertypen erwähnt, können Sie Synchronisierungsfehler reaktiv beheben, wenn sie auftreten. Sie können aber auch versuchen, sie proaktiv zu verhindern. Beispiel für ein proaktives Vorgehen: Jede Nacht synchronisieren Sie alle Konten, fragen dabei alle Google Ads-Objekte in den Konten ab und gleichen sie mit denen in der lokalen Datenbank ab.
Logfehler
Alle Fehler sollten protokolliert werden, damit ihre Behebung und Überwachung vereinfacht wird. Zumindest sollten die Anfrage-ID sowie die Vorgänge, die den Fehler verursacht haben, und der Fehler selbst protokolliert werden. Weitere zu protokollierende Informationen sind die Kunden-ID, der API-Dienst, die Latenz der Anfrage, die Anzahl der Wiederholungen sowie die Anfrage und Antwort im Rohformat.
Trends beobachten
Behalten Sie die Trends bei API-Fehlern im Auge, damit Sie Probleme mit Ihrer App erkennen und beheben können. Sie können eine eigene Lösung entwickeln oder eines der vielen kommerziellen Tools verwenden, mit denen Sie anhand Ihrer Protokolle interaktive Dashboards erstellen und automatische Benachrichtigungen senden können.
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 Konnektivität, die Logik zur Kampagnenverwaltung oder andere Verarbeitungsschritte Ihrer App wie erwartet funktionieren. Ihr Entwickler-Token muss nicht genehmigt werden, um in einem Testkonto verwendet zu werden. Sie können also sofort nach dem Anfordern eines Entwickler-Tokens mit der Entwicklung mit der Google Ads API beginnen, noch bevor Ihre App überprüft wurde.