Erste Schritte

Dieses Dokument richtet sich an Entwickler, die die AdSense Management API verwenden möchten, um Informationen zu ihrem AdSense-Konto abzurufen. In diesem Dokument wird davon ausgegangen, dass Sie mit Webprogrammierungskonzepten und Webdatenformaten vertraut sind.

Hinweis

AdSense-Konto erstellen

Registriere dich jetzt oder melde dich in deinem AdSense-Konto an, um loszulegen.

AdSense kennenlernen

Falls Sie mit den AdSense-Konzepten nicht vertraut sind, lesen Sie die einführenden Informationen zu AdSense und experimentieren Sie mit der AdSense-Benutzeroberfläche, bevor Sie mit dem Codieren beginnen.

Clientbibliothek auswählen

Auf der Seite Clientbibliotheken und Beispiele finden Sie Informationen zu den verfügbaren Bibliotheken und Beispielen. Klicken Sie auf den Tab für Ihre ausgewählte Sprache und folgen Sie den Links, um die Quelle herunterzuladen. Die Clientbibliotheken übernehmen Folgendes:

  • authentifizierung
  • Erkennung von Diensten
  • die Anfragen an die API erstellen,
  • Parsen von Antworten

Lesen Sie die Anleitung zum Installieren und Konfigurieren der ausgewählten Clientbibliothek. Diese finden Sie in der Regel in der README-Datei im Stammverzeichnis des Repositorys.

Wenn Ihre Implementierung besondere Anforderungen hat, z. B. die Verwendung einer nicht unterstützten Sprache, können Sie direkte Anfragen an die API senden, anstatt eine Clientbibliothek zu verwenden.

Anwendung registrieren

Wenn Sie die AdSense Management API verwenden möchten, müssen Sie die von Ihnen entwickelte Anwendung registrieren. Dazu erstellen Sie ein Projekt und generieren eine Client-ID.

App registrieren

Bearbeiten Sie die Konfigurationsdateien für Ihr Clientbibliotheksprojekt mit den neu erstellten Anmeldedaten. Weitere Informationen finden Sie in der Dokumentation zur Clientbibliothek.

Hinweis:Verwenden Sie zur Registrierung Ihr Entwicklerkonto, also das Konto, das Nutzern Ihrer Anwendung als Entwickler der Anwendung angezeigt werden soll. Dieses Konto muss nicht mit einem AdSense-Log-in verknüpft sein, da Nutzer während der Verwendung der Anwendung Zugriff auf ihre eigenen Konten gewähren.

Kurzanleitung

Führe die folgenden Schritte aus, um deine ersten Anfragen zu senden. Diese Schritte können je nach verwendeter Bibliothek oder Sprache leicht variieren:

  1. Verwenden Sie das entsprechende Beispiel, um eine Liste von Ad-Clients aus einem AdSense-Konto abzurufen. Diese Anfrage löst einen einmaligen Prozess aus, in dem der AdSense-Nutzer Ihr Projekt authentifiziert und autorisiert.

    Ad-Clients stellen eine Verknüpfung zwischen einem AdSense-Konto und einem AdSense-Produkt dar, beispielsweise Contentanzeigen oder Suchanzeigen. Ein AdSense-Konto kann einen oder mehrere Ad-Clients haben.

    1. Bei Webanwendungen werden Nutzer zu einer Website weitergeleitet, wo sie den Zugriff gewähren können. Nach der Autorisierung werden sie an die Callback-URL weitergeleitet, die in der Google API Console definiert ist.
    2. Installierte Anwendungen funktionieren ähnlich. Die Clientbibliothek versucht, ein Browserfenster zu öffnen und einen Autorisierungscode zu verwenden. Für Android-, Chrome- und iOS-Anwendungen ist diese Methode plattformspezifisch.
  2. Verwenden Sie den Google APIs Explorer für reports.generate, um den folgenden Bericht anzufordern:
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

    Mit Berichten erhalten Sie Informationen zu Ihren Einnahmen und zu den Auswirkungen auf diese Einnahmen. Sie können Channels für ein gesamtes Konto oder einen Teil Ihrer Anzeigenblöcke verwenden.

  3. Versuchen Sie, denselben Bericht von Ihrer Anwendung anzufordern.
  4. Sie können die Berichte nach Anzeigenblöcken filtern. Rufen Sie die Liste der Anzeigenblöcke mit adunits.list ab. Eine Ad-Client-ID ist erforderlich (siehe Schritt 1). Nachdem Sie einen Anzeigenblock ausgewählt haben, verwenden Sie seine ID im Parameter filter für reports.generate:

    Anzeigenblöcke sind vom Nutzer konfigurierte Platzhalter für Anzeigen, die einige Eigenschaften für die geschalteten Anzeigen definieren (z. B. Größe und Form).

    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS
    • filter: AD_UNIT_ID==ca-pub-123456789:987654321
  5. Filtern Sie nach benutzerdefinierten Channels oder URL-Channels oder kombinieren Sie mehrere Filter.

    Channels sind Tools, mit denen Sie die Leistung für einen Teil Ihrer Anzeigenblöcke erfassen können. Es gibt zwei Arten von Channels: URL-Channels und benutzerdefinierte Channels. Mit Letzterem können Sie die Leistung auf einer bestimmten Seite oder Domain erfassen, während Sie mit benutzerdefinierten Channels die Leistung bestimmter, vom Nutzer ausgewählter Gruppen von Anzeigenblöcken verfolgen können.

Sie können mit der Implementierung beginnen, indem Sie sich die restlichen verfügbaren Aufrufe und Ressourcen in der Referenzdokumentation ansehen.