Video: Sehen Sie sich das Video zu Best Practices aus dem Workshop 2019 an.
In diesem Leitfaden werden einige Best Practices beschrieben, mit denen Sie die Effizienz und Leistung Ihrer Anwendungen optimieren können.
Laufende Wartung
So vermeiden Sie Unterbrechungen bei der Anzeigenauslieferung:
Halten Sie die Kontakt-E-Mail-Adresse des Entwicklers 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. Vermeiden Sie die Verwendung einer persönlichen E-Mail-Adresse, die mit einem einzelnen Konto verbunden ist oder nicht überwacht wird.
Wenn Sie über Probleme wie Produktänderungen, Ausfallzeiten wegen Wartungsarbeiten, Einstellungstermine usw. informiert werden möchten, abonnieren Sie unsere
Das Forum wird regelmäßig vom Google Ads API-Team überwacht. Es ist daher der ideale Ort, um Fragen zu APIs zu stellen.
- Achten Sie darauf, dass Ihre App den Nutzungsbedingungen für die Google Ads API entspricht. Bei Bedarf wird sich das Tokenüberprüfungs- und Compliance-Team ü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, indem Sie auf die E-Mail antworten, die Sie bei der Überprüfung Ihres Entwicklertoken-Antrags erhalten haben.
Optimierung
Batchvorgänge
Das Stellen einer Anfrage an die API bringt eine Reihe von Fixkosten mit sich, wie etwa Round-Trip-Netzwerklatenz, Serialisierungs- und Deserialisierungsverarbeitung sowie Aufrufe an Back-End-Systeme. Die meisten mutate-Methoden in der API akzeptieren eine Reihe von Vorgängen, um die Auswirkungen dieser Fixkosten zu verringern und die Gesamtleistung zu verbessern. Durch die Verarbeitung mehrerer Vorgänge innerhalb einer Anfrage werden die Anzahl der Anfragen und die damit zusammenhängenden Fixkosten reduziert. Vermeiden Sie möglichst Anfragen mit nur einem Vorgang.
Angenommen, Sie möchten einer Kampagne 50.000 Keywords für mehrere Anzeigengruppen hinzufügen. Anstatt 50.000 Anfragen mit je einem Keyword zu senden, können Sie auch 100 Anfragen mit je 500 Keywords oder sogar 10 Anfragen mit je 5.000 Keywords senden. Die Anzahl der in einer Anfrage zulässigen Vorgänge ist begrenzt, sodass Sie unter Umständen die Batchgröße anpassen müssen, 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. Die Übergabe vollständiger Objekte, wenn Sie nur wenige Felder aktualisieren möchten, kann zusätzliche Verarbeitungszeit und geringere Leistung zur Folge haben.
Um dies zu vermeiden, unterstützt die Google Ads API eine dünnbesetzte Aktualisierung, sodass Sie nur die Felder eines Objekts ausfüllen, die Sie ändern müssen oder die erforderlich sind. Dünnbesetzte Aktualisierungen werden schneller verarbeitet und verursachen weniger Fehler.
Felder, die nicht in der update_mask (auch als FieldMask bezeichnet) enthalten sind, bleiben unverändert.
Beispielsweise kann eine App, die Gebote auf Keyword-Ebene aktualisiert, von einer geringen Aktualisierungen profitieren, da nur die Felder für 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 zum Einbinden des Fehlermanagements in Ihrer App beschrieben. Zusätzlich zu diesem Abschnitt finden Sie im Leitfaden zur Fehlerbehebung weitere Informationen zum Verwalten von Fehlern.
Anfragequellen unterscheiden
Einige Anwendungen sind primär interaktiv und geben API-Aufrufe direkt als Reaktion auf vom Nutzer initiierte Aktionen in einer UI aus. 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. Stellen Sie dem Nutzer anhand des aufgetretenen Fehlers so viel Kontext wie in der UI zur Verfügung. Bieten Sie ihnen einfache Schritte zum Beheben des Fehlers an (siehe Vorschläge unten).
Implementieren Sie für auf dem Back-End initiierte Anfragen Handler für die verschiedenen Fehlertypen, die in Ihrer Anwendung auftreten können. Verwenden Sie immer einen Standard-Handler, um seltene oder zuvor nicht aufgetretene Fehler zu beheben. Ein guter Ansatz für einen Standard-Handler besteht darin, den fehlgeschlagenen Vorgang und Fehler in eine Warteschlange aufzunehmen, damit ein menschlicher Bediener eine geeignete Lösung prüfen und bestimmen kann.
Fehlertypen unterscheiden
Es ist wichtig, die Unterschiede zwischen den Fehlertypen in der Google Ads API zu kennen, um eine zuverlässige Fehlerbehandlung zu erstellen. Dies sind einige der häufigsten Fehlertypen:
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, nehmen sie möglicherweise Änderungen vor, 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 beschrieben, können Sie Synchronisierungsfehler reaktiv beheben, sobald 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 Kundennummer, der API-Dienst, die Latenz von Umlaufanfragen, die Anzahl der Wiederholungsversuche sowie die Rohanfragen und -antworten.
Trends beobachten
Achten Sie darauf, Trends bei API-Fehlern zu beobachten, damit Sie Probleme mit Ihrer Anwendung erkennen und beheben können. Erwägen Sie, eine eigene Lösung zu erstellen oder eines der vielen verfügbaren kommerziellen Tools zu verwenden, die Ihre Logs verwenden können, um interaktive Dashboards zu erstellen und automatische Benachrichtigungen zu senden.
Entwicklung
Testkonten nutzen
Bei Testkonten handelt es sich um Google Ads-Konten, in denen keine Anzeigenauslieferung erfolgt. Mit einem Testkonto können Sie mit der Google Ads API experimentieren und so prüfen, ob die Konnektivität Ihrer App, die Kampagnenverwaltungslogik oder andere Verarbeitungsprozesse wie erwartet funktionieren. Ihr Entwickler-Token muss nicht für die Verwendung in einem Testkonto genehmigt werden. Sie können also sofort nach der Anforderung eines Entwickler-Tokens und sogar vor der Überprüfung Ihrer App mit der Google Ads API mit der Entwicklung beginnen.