Video: Check out the best practices talk from the 2019 workshop
In diesem Leitfaden werden einige Best Practices beschrieben, 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 in Notfällen oder bei Themen im Zusammenhang mit der Einhaltung der Nutzungsbedingungen der API. Wenn wir Sie bezüglich der Einhaltung der Nutzungsbedingungen der API nicht erreichen können, wird Ihr API-Zugriff möglicherweise eingeschränkt oder widerrufen.
Wenn Sie über Probleme wie Produktänderungen, Wartungsausfallzeiten und Einstellungstermine informiert werden möchten, abonnieren Sie unsere
Achten Sie darauf, dass Ihre App die Google Ads API Nutzungsbedingungen (N&B) einhält. Bei Bedarf wendet sich das API-Compliance-Team an die Administratoren und Inhaber 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 einfach 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 Teilobjekte senden.
Batchvorgänge
Eine Anfrage an die API verursacht eine Reihe von Fixkosten, z. B. die Round-Trip-Netzwerklatenz, die 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 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 in mehreren Anzeigengruppen 50.000 Keywords 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 die Felder deserialisiert, validiert und in der Datenbank gespeichert werden. Wenn Sie vollständige Objekte senden, obwohl Sie nur einige Felder aktualisieren möchten, kann dies zu einer längeren Verarbeitungszeit und einer geringeren Leistung führen. Um dies zu vermeiden, unterstützt die Google Ads API Teilaktualisierungen. So können Sie nur die Felder in einem Objekt ausfüllen, die Sie ändern müssen oder die erforderlich sind.
Teilaktualisierungen werden schneller verarbeitet und führen seltener zu Fehlern. 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 Teilaktualisierungen 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 zur Einbindung der Fehlerbehandlung in Ihre App beschrieben. Weitere Informationen zur Fehlerbehandlung 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 UI. Andere funktionieren 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 aufgetretenen Fehler, um dem Nutzer in der UI so viel Kontext wie möglich zu geben. Bieten Sie einfache Schritte an, mit denen der Fehler behoben werden kann (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 unbekannte 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 Mitarbeiter sie überprüfen und eine geeignete Lösung finden kann.
Fehlertypen unterscheiden
Es ist wichtig, die Unterschiede zwischen den Fehlertypen in der Google Ads API zu kennen, um eine robuste Fehlerbehandlung zu entwickeln. Einige der häufigsten Fehlertypen sind:
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 im Leitfaden zu Fehlertypen beschrieben, können Sie Synchronisierungsfehler reaktiv beheben, wenn sie auftreten, aber Sie können 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 sie 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. Weitere Informationen, die protokolliert werden sollten, sind die Kundennummer, der API-Dienst, die Round-Trip-Anfragelatenz, die Anzahl der Wiederholungen sowie die Rohdaten der Anfrage und Antwort.
Trends beobachten
Beobachten Sie Trends bei API-Fehlern, 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 Sie anhand Ihrer Logs 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. Sie können ein Testkonto verwenden, um mit der Google Ads API zu experimentieren und zu testen, ob die Verbindung Ihrer App, die Kampagnenverwaltungslogik oder andere Verarbeitungsschritte wie erwartet funktionieren. Für die Verwendung in einem Testkonto ist für Ihr Google Cloud-Projekt nur die Zugriffsebene „Testkonto“ erforderlich. 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.