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:
Achten Sie darauf, dass die Liste der Administratoren und Inhaber 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 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, Wartungsausfallzeiten und Einstellungsdaten informiert werden möchten, abonnieren Sie unseren
Ihre App muss den Nutzungsbedingungen der Google Ads API entsprechen. Falls erforderlich, wendet sich das API-Compliance-Team an die Administratoren und Inhaber Ihres Google Cloud-Projekts mit API-Zugriff. Wenn Sie Fragen oder Bedenken bezüglich der 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 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. 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.
Seltene Aktualisierungen werden schneller verarbeitet und es ist weniger wahrscheinlich, dass Fehler auftreten. Felder, die nicht in der „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 Sparse 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. Zusätzlich zu diesem Abschnitt finden Sie im Leitfaden zur Fehlerbehebung weitere Informationen zur Fehlerbehandlung.
Anfragequellen unterscheiden
Einige Apps sind in erster Linie interaktiv und geben API-Aufrufe direkt als Reaktion auf nutzerinitiierte Aktionen auf 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. 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 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. Einige der häufigsten Fehlertypen sind:
- 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 zu Fehlertypen beschrieben, können Sie auf Synchronisierungsfehler reagieren, wenn sie auftreten. Sie können aber auch versuchen, sie proaktiv zu verhindern. Eine proaktive Strategie besteht darin, einen nächtlichen Synchronisierungsjob für alle Ihre Konten auszuführen, die Google Ads-Objekte in Ihren Konten abzurufen und mit Ihrer lokalen Datenbank zu vergleichen.
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 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 aus Ihren Logs interaktive Dashboards erstellt und automatische Benachrichtigungen gesendet werden können.
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 Konnektivität, die Logik für die Kampagnenverwaltung oder andere Verarbeitungsvorgänge Ihrer App wie erwartet funktionieren. Für Ihr Google Cloud-Projekt ist nur Testzugriff erforderlich, um es mit einem Testkonto zu verwenden. 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.