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 Webprogrammierung und Webdatenformaten vertraut sind.

Vorbereitung

AdSense-Konto erstellen

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

AdSense kennenlernen

Wenn Sie mit den AdSense-Konzepten noch 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 die ausgewählte Sprache und folgen Sie den Links, um die Quelle herunterzuladen. Die Clientbibliotheken übernehmen die folgenden Aufgaben:

  • authentifizierung
  • Erkennung von Diensten
  • Erstellen der Anfragen an die API
  • Analyse von Antworten

Lesen Sie die Anleitung zum Installieren und Konfigurieren der ausgewählten Clientbibliothek. Diese finden Sie in der Regel in der Infodatei 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

Damit Sie die AdSense Management API verwenden können, 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:Das für die Registrierung verwendete Google-Konto sollte Ihr Entwicklerkonto sein, d. h. das Konto, das Nutzern Ihrer Anwendung als Entwickler der Anwendung angezeigt werden soll. Dieses Konto muss nicht mit einer AdSense-Anmeldung verknüpft sein, da Nutzer bei Verwendung der Anwendung Zugriff auf ihre eigenen Konten gewähren.

Kurzanleitung

Führe die folgenden Schritte aus, um deine ersten Anfragen zu stellen. 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, bei 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 contentbezogenen Anzeigen oder Suchanzeigen. Ein AdSense-Konto kann über einen oder mehrere Ad-Clients verfügen.

    1. Bei Webanwendungen werden Nutzer zu einer Website weitergeleitet, auf der sie Zugriff gewähren können. Nach der Autorisierung werden sie an die Callback-URL weitergeleitet, die in der APIs-Konsole definiert ist.
    2. Installierte Apps 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 API 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 Berichte für ein gesamtes Konto oder für einen Teil von Anzeigenblöcken erstellen, indem Sie Channels 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 Format).

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

    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 ersteren können Sie die Leistung für eine bestimmte Seite oder Domain erfassen, während Sie mit letzteren die Leistung für bestimmte, vom Nutzer ausgewählte Gruppen von Anzeigenblöcken erfassen können.

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