Häufige Stolperfallen

Die AdSense-Verwaltungs-API verfügt über Aufrufe zum Generieren neuer und gespeicherter Berichte. Sie können einfache Analysen wie Einnahmen pro Tag oder sehr komplexe Tabellen mit Klickraten pro benutzerdefiniertem Channel und Land enthalten. In diesem Leitfaden finden Sie eine Liste von Grenzfällen, die für eine robuste Einbindung in die APIs korrekt behandelt werden sollten.

Berichtsstruktur

Berichtsergebnisse werden als ReportResult-Objekt zurückgegeben. Ausführliche Informationen finden Sie in der Referenz zu Berichtsantworten.

Chronologische Dimensionen verwenden: DATE, WEEK und MONTH

Berichte können leer sein oder Lücken enthalten

Wenn es während des in der Anfrage angegebenen Zeitraums keine Aktivitäten gab, werden keine Anzeigenanfragen generiert und der Berichtsdienst zeigt keine Zeilen für diese Zeiträume an. Das ist beispielsweise wichtig, wenn Sie ein Diagramm erstellen.

Weitere Informationen finden Sie im Leitfaden zum Ausfüllen von Daten.

Dimensionen MONTH und WEEK im selben Bericht anfordern

Dieser Bericht kann negative oder unerwartete Folgen haben. Wenn eine Woche zu zwei verschiedenen Monaten gehört, werden zwei Zeilen für diese Woche angezeigt, eine für jeden Monat.

Beispiel

Abmessungen	Messwerte	Startdatum	Enddatum
WEEK MONTH	CLICKS	2014-04-28	2014-05-03

Retouren:

MONTH	WEEK*	CLICKS
2014-04	2014-04-27	50
2014-05	2014-04-27	43

* erster Tag der Woche

Lösung

Entfernen Sie „MONTH“ aus dem Bericht.

WEEK	CLICKS
2014-04-27	93

Dimensionswerte sortieren

Wenn Sie beispielsweise Dimensionen für Plattformen (Computer, High-End-Mobilgeräte usw.) anfordern, werden nur die Plattformen mit Aktivität angezeigt. Wenn an einem bestimmten Tag, in einer bestimmten Woche oder in einem bestimmten Monat keine Besuche über High-End-Mobilgeräte verzeichnet wurden, sind für diese Kategorie keine Informationen verfügbar.

Beispiel

Abmessungen	Messwerte	Startdatum	Enddatum
PLATFORM_TYPE_NAME MONTH	AD_REQUESTS	2014-02-01	2014-03-31

Retouren:

MONTH	PLATFORM_TYPE_NAME	AD_REQUESTS
2014-03	Computer	100
2014-03	High-End-Mobilgeräte	5
2014-04	Computer	75

Lösung

Gehen Sie bei der Verarbeitung der Berichtsergebnisse von null für alle Dimensionswerte aus, die nicht in den Ergebnissen angezeigt werden:

MONTH	PLATFORM_TYPE_NAME	AD_REQUESTS
2014-03	Computer	100
2014-03	High-End-Mobilgeräte	5
2014-04	Computer	75
2014-04	High-End-Mobilgeräte	0

Mehrere zusammenhängende Berichte kombinieren

Manchmal ist ein Bericht zu groß, um auf einmal generiert zu werden, und muss in Batches zusammengefasst werden. Wenn Ihre App dies tut, prüfen Sie Folgendes:

• Wenn Sie die Dimensionen WEEK oder MONTH verwenden und den Bericht in der Mitte einer Woche oder eines Monats aufteilen, enthält jeder Bericht doppelte Einträge mit unterschiedlichen Daten.
• Achten Sie darauf, dass alle Berichte dieselben Messwerte und Dimensionen haben, da Daten unter Umständen nicht kombiniert werden können, wenn Sie verschiedene Dimensionen verwenden.

Spezielle Konten

Einige Ihrer Nutzer haben möglicherweise AdSense-Konten mit unerwarteten oder unbekannten Attributen. Berücksichtigen Sie dabei Folgendes:

• Publisher mit Tausenden von Domains oder Websites
• Publisher mit Tausenden von Anzeigenblöcken oder benutzerdefinierten Channels
• Publisher, die Berichte zu mehreren Ad-Clients erstellen möchten (z. B. AdSense für Suchergebnisseiten oder AdSense für Videos)

Mehrere Konten

Nutzer können Zugriff auf mehrere AdSense-Konten haben. Aus diesem Grund muss bei jedem API-Aufruf eine Konto-ID angegeben werden. Mit dem Aufruf von accounts.list wird eine Liste der Konten abgerufen. Außerdem sollte dem Nutzer ein Dialogfeld zur Kontoauswahl angezeigt werden. Es kann umgangen werden, wenn nur ein Konto abgerufen wird.

Änderungen der Zeitzone

AdSense-Publisher können ihre Zeitzone jederzeit ändern, was zu Spitzen oder Einbrüchen in den Berichten führen kann. Weitere Informationen finden Sie im Leitfaden für Berichte in der lokalen Zeitzone.