Video: Check out the best practices talk from the 2019 workshop
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:
Halten Sie die 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. Verwenden Sie keine private E-Mail-Adresse, die mit einem einzelnen oder nicht überwachten Konto verknüpft ist. Wenn Sie das API-Center aufrufen möchten, müssen Sie in Ihrem Verwaltungskonto angemeldet sein.
Wenn Sie über Probleme wie Produktänderungen, Wartungsausfallzeiten, Deaktivierungstermine usw. informiert werden möchten, abonnieren Sie unseren
Achten Sie darauf, dass Ihre App die Google Ads API Nutzungsbedingungen einhält (N&B). Bei Bedarf setzt sich das Team für die Überprüfung von Tokens und die Einhaltung der Nutzungsbedingungen über Ihre E-Mail-Adresse mit Ihnen in Verbindung. Wenn Sie Fragen oder Bedenken zu den Nutzungsbedingungen haben, können Sie sich an das Überprüfungsteam wenden. Antworten Sie dazu einfach auf die E-Mail, die Sie bei der Überprüfung Ihres Entwicklertoken-Antrags 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. Durch die Verarbeitung mehrerer Vorgänge innerhalb einer Anfrage werden die Anzahl der Anfragen und die damit zusammenhängenden Fixkosten reduziert. 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 übergeben, 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, mit der Gebote auf Keyword-Ebene aktualisiert werden, kann beispielsweise von Teilaktualisierungen profitieren, da nur die Felder für die Anzeigengruppen-ID, die Kriterien-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 Fehlerbehebung 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 Benutzeroberfläche. 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 Fehlerbehebung 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 so viel Kontext wie möglich in der Benutzeroberfläche zu geben. Bieten Sie einfache Schritte zur Behebung des Fehlers an (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 synchronisiert werden. Wie im Leitfaden zu Fehlertypen beschrieben, können Sie Synchronisierungsfehler reaktiv beheben, wenn 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 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, mit denen 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 Logik zur Kampagnenverwaltung oder andere Verarbeitungsschritte wie erwartet funktionieren. Ihr Entwicklertoken muss nicht genehmigt werden, um in einem Testkonto verwendet zu werden. Sie können also sofort mit der Entwicklung mit der Google Ads API beginnen, nachdem Sie ein Entwicklertoken angefordert haben, noch bevor Ihre App überprüft wurde.