Best Practices

Video: Das Best-Practices-Gespräch vom 2019-Workshop

In diesem Leitfaden werden einige Best Practices vorgestellt, 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 individuellen Konto oder einem nicht überwachten Konto verknüpft ist.

• Abonnieren Sie unser

  • Forum
  • API-Blog
  • Produktblog

Das Forum wird regelmäßig vom Google Ads API-Team überwacht und ist der ideale Ort, um Fragen zur API zu stellen.

• Ihre App muss den Nutzungsbedingungen für die Google Ads API entsprechen. Bei Bedarf wird sich das Team für die Tokenüberprüfung und das 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. Antworten Sie dazu auf die E-Mail, die Sie bei der Prüfung Ihres Entwicklertoken-Antrags erhalten haben.

Optimierung

Batchvorgänge

Eine Anfrage an die API ist mit einer Reihe von Fixkosten verbunden, z. B. Round-Trip-Netzwerklatenz, Serialisierungs- und Deserialisierungsverarbeitung und Aufrufe an Backend-Systeme. Um die Auswirkungen dieser Fixkosten zu verringern und die Gesamtleistung zu steigern, sind die meisten mutate-Methoden in der API so konzipiert, dass eine Reihe von Vorgängen akzeptiert werden. Durch die Verarbeitung mehrerer Vorgänge innerhalb einer Anfrage werden die Anzahl der Anfragen und die damit zusammenhängenden Fixkosten reduziert. Vermeiden Sie wenn möglich, Anfragen mit nur einem Vorgang zu stellen.

Angenommen, Sie fügen einer Kampagne 50.000 Keywords für mehrere Anzeigengruppen hinzu. Anstelle von 50.000 Anfragen mit je einem Keyword können Sie 100 Anfragen mit jeweils 500 Keywords oder sogar 10 Anfragen mit jeweils 5.000 Keywords senden. Es gibt Limits für die Anzahl der Vorgänge, die in einer Anfrage zulässig sind. 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 sein. Wenn Sie vollständige Objekte übergeben, wenn Sie nur wenige Felder aktualisieren möchten, kann dies zu zusätzlicher Verarbeitungszeit und geringerer Leistung führen. Um dies zu vermeiden, unterstützt die Google Ads API eine partielle Aktualisierung, bei der Sie nur die Felder in einem Objekt füllen, die Sie ändern müssen oder die erforderlich sind. Sparse-Updates 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, bei der Gebote auf Keyword-Ebene aktualisiert werden, von einer geringen Aktualisierung profitieren, da nur die Felder für die Anzeigengruppen-ID, die Kriteriums-ID und die Gebotsfelder ausgefüllt werden müssten.

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 Anwendung beschrieben. Darüber hinaus finden Sie in der Anleitung zur Fehlerbehebung weitere Informationen zum Beheben von Fehlern.

Anfragequellen unterscheiden

Einige Apps sind hauptsächlich interaktiv und senden API-Aufrufe direkt als Antwort auf vom Nutzer initiierte Aktionen in einer UI. Andere arbeiten hauptsächlich offline und führen API-Aufrufe im Rahmen eines regelmäßigen Backend-Prozesses aus. Bei manchen Apps kommt auch beides vor. Beim Fehlermanagement kann es nützlich 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 dem Nutzer so viel Kontext wie möglich in der UI zur Verfügung zu stellen. Nennen Sie einfache Schritte, mit denen sich der Fehler beheben lässt (siehe die folgenden Vorschläge).

Implementieren Sie für Anfragen, die im Back-End initiiert werden, Handler für die verschiedenen Fehlertypen, die in Ihrer Anwendung auftreten können. Schließen Sie immer einen Standard-Handler ein, um seltene oder zuvor nicht aufgetretene 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 Bediener den Vorgang prüfen und eine geeignete Lösung bestimmen kann.

Fehlertypen unterscheiden

Für eine zuverlässige Fehlerbehandlung ist es wichtig, die Unterschiede zwischen den Fehlertypen in der Google Ads API zu kennen. Dies sind einige der häufigsten Fehlertypen:

1. Authentifizierungsfehler
2. Wiederholbare Fehler
3. Validierungsfehler
4. Fehler im Zusammenhang mit der Synchronisierung

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 unter Umständen Änderungen vor, die Ihrer App nicht bekannt sind. Dies kann dazu führen, dass die lokale Datenbank der Anwendung nicht mehr synchron ist. Wie in unserem Leitfaden zu Fehlertypen beschrieben, können Sie Synchronisierungsfehler reaktiv beheben, aber auch proaktiv 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 Anfragen für Umlaufanfragen, die Anzahl der Wiederholungsversuche und die Rohanfrage und -antwort.

Trends beobachten

Beobachten Sie Trends bei API-Fehlern, damit Sie Probleme mit Ihrer Anwendung erkennen und beheben können. Sie können eine eigene Lösung erstellen oder eines der vielen verfügbaren kommerziellen Tools verwenden, die Ihre Logs für die Erstellung interaktiver Dashboards und das Senden automatischer Benachrichtigungen verwenden können.

Entwicklung

Testkonten nutzen

Bei Testkonten handelt es sich um Google Ads-Konten, in denen keine Anzeigenauslieferung erfolgt. Sie können ein Testkonto verwenden, um mit der Google Ads API zu experimentieren und die Konnektivität, die Kampagnenverwaltungslogik oder andere Verarbeitungsvorgänge Ihrer App wie erwartet zu testen. Ihr Entwickler-Token muss nicht zur Verwendung in einem Testkonto genehmigt werden. Sie können also direkt nach der Anforderung eines Entwickler-Tokens und sogar vor der Prüfung Ihrer App mit der Entwicklung mit der Google Ads API beginnen.