Video: Best Practices aus dem Workshop 2019
In diesem Leitfaden finden Sie einige Best Practices, die Sie implementieren können, um die Effizienz und Leistung Ihrer Apps zu optimieren.
Laufende Wartung
So vermeiden Sie Unterbrechungen bei der Anzeigenauslieferung:
Halten Sie die E-Mail-Adresse für Entwicklerkontakte 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 aufrufen zu können.
Wenn Sie über Probleme wie Produktänderungen, Wartungsarbeiten, Einstellungstermine usw. informiert werden möchten, abonnieren Sie unseren
Das Forum wird regelmäßig vom Google Ads API-Team überwacht. Es ist daher der ideale Ort, um Fragen zur API zu stellen.
- Halten Sie die Nutzungsbedingungen der Google Ads API ein. Falls erforderlich, wird sich das Team für die Überprüfung von Tokens und die Einhaltung von Richtlinien über Ihre Kontakt-E-Mail-Adresse mit Ihnen in Verbindung setzen. Wenn Sie Fragen oder Bedenken bezüglich der Nutzungsbedingungen haben, können Sie sich an das Überprüfungsteam wenden, indem Sie auf die E-Mail antworten, 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
Eine Anfrage an die API verursacht eine Reihe von Fixkosten, z. B. die Roundtrip-Netzwerklatenz, die Verarbeitung der Serialisierung und Deserialisierung sowie Aufrufe von Back-End-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. Durch die Verarbeitung mehrerer Vorgänge innerhalb einer Anfrage werden die Anzahl der Anfragen und die damit zusammenhängenden Fixkosten reduziert. 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 zusätzlichen 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. Seltene Updates werden schneller verarbeitet und es ist weniger wahrscheinlich, dass Fehler auftreten.
Felder, die nicht in der Aktualisierungsmaske (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 „Anzeigengruppen-ID“, „Kriteriums-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 für die Fehlerbehandlung in Ihrer App beschrieben. Weitere Informationen zur Fehlerbehebung finden Sie im Leitfaden zur Fehlerbehebung.
Anfragequellen unterscheiden
Einige Apps sind in erster Linie 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 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 spezifischen Fehler, der aufgetreten ist, um dem Nutzer in der Benutzeroberfläche so viel Kontext wie möglich zu geben. Biete einfache Schritte an, die der Nutzer unternehmen kann, um den Fehler zu beheben (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 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. Zu den häufigsten Fehlertypen gehören:
- Authentifizierungsfehler
- Wiederholbare Fehler
- Validierungsfehler
- Fehler im Zusammenhang mit der Synchronisierung
Weitere Informationen finden Sie unter Fehlertypen und Häufige Fehler.
Synchronisierungs-Back-Ends
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 auf Synchronisierungsfehler reagieren, wenn sie auftreten, 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. Zu protokollierende Informationen sind unter anderem die Kunden-ID, der API-Dienst, die Roundtrip-Anfragelatenz, die Anzahl der Wiederholungsversuche sowie die Rohanfrage und ‑antwort.
Trends beobachten
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 Verarbeitungsschritte Ihrer App wie erwartet funktionieren. Ihr Entwickler-Token muss nicht genehmigt werden, damit Sie es in einem Testkonto verwenden können. 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 wird.