Drittanbieter sind keine direkten Nutzer von Ad Manager, da sie möglicherweise kein eigenes Ad Manager-Netzwerk haben. Stattdessen erstellen sie Dienste oder Integrationen mit Ad Manager für ihre Kunden, die Ad Manager-Kunden sind. In diesem Leitfaden werden die Grundlagen von Drittanbieterintegrationen behandelt. Sie finden hier Best Practices, Tipps und Tricks.
In diesem Leitfaden wird davon ausgegangen, dass Sie mit der Ad Manager API vertraut sind. Wenn Sie mit der Ad Manager API nicht vertraut sind, sehen Sie sich unsere Dokumentation für den Einstieg an.
Erste Schritte als Drittanbieter
Wenn Sie mit der Ad Manager API auf das Netzwerk eines Ad Manager-Kunden zugreifen möchten, folgen Sie einfach der Anleitung unten. Es ist keine zusätzliche Genehmigung von Google erforderlich. Wenn Sie jedoch auf die Ad Manager API zugreifen und/oder sie verwenden, stimmen Sie den Nutzungsbedingungen für die Ad Manager API zu.
Ad Manager-Integration als Drittanbieter testen
Als Drittanbieter fragen Sie sich vielleicht, wie Sie Ihre Ad Manager-Integration testen können, bevor Sie sie in den Produktionsnetzwerken Ihrer Kunden ausführen. Es wird empfohlen, ein Testnetzwerk zu erstellen. Dazu müssen Sie kein Ad Manager-Kunde sein. Jeder mit einem Google-Konto kann ein Testnetzwerk erstellen.
Beachten Sie jedoch die Unterschiede zwischen Test- und Produktionsnetzwerken. In Testnetzwerken können keine Anzeigen ausgeliefert werden. Testnetzwerke enthalten auch nicht unbedingt alle Funktionen, die Ihre Kunden in ihren Produktionsnetzwerken haben. Wenn Sie Ad Manager-Funktionen testen müssen, die in Ihrem Testnetzwerk nicht verfügbar sind, können Sie über einen Ad Manager-Reseller Zugriff auf ein Nicht-Testnetzwerk erwerben.
Außerdem sollten Sie Ihren Kunden klar mitteilen, welche Funktionen in ihrem Produktionsnetzwerk verfügbar sein müssen, damit Ihre Anwendung ordnungsgemäß funktioniert. Ihre Anwendung sollte Fälle, in denen Funktionen möglicherweise nicht vorhanden sind, entweder durch Abfangen von Ausnahmen und ordnungsgemäßes Beenden oder durch Führen einer Liste Ihrer Clients und der Funktionen, die jeder Client hat oder nicht hat, verarbeiten. Es sollte in der Verantwortung Ihres Kunden liegen, sich an seinen Google-Ansprechpartner zu wenden, um Funktionen in seinem Netzwerk zu verwalten.
Authentifizierung: Richtig auf das Ad Manager-Netzwerk eines Kunden zugreifen
Damit Ihre Anwendung auf das Ad Manager-Netzwerk Ihres Kunden zugreifen kann, müssen Sie Ihren Authentifizierungsablauf sicher einrichten.
Dies erfolgt in zwei Schritten:
- Erstellen Sie eine E‑Mail-Adresse für ein Google-Konto, mit der Sie auf das Netzwerk Ihres Kunden zugreifen.
- Lassen Sie den Kunden dieses Konto als Nutzer in sein Ad Manager-Netzwerk einfügen.
Für Schritt 1 können Sie entweder für jeden Kunden ein separates Google-Konto oder ein primäres Konto erstellen, das Sie für alle Kunden verwenden. Die erste Option ist sicherer, falls eines Ihrer Konten manipuliert wird. Das bedeutet, dass Sie Schritt 1 nur einmal ausführen müssen.
Unabhängig davon, was Sie in Schritt 1 tun, müssen Sie in Schritt 2 jeden neuen Kunden bitten, das entsprechende Google-Konto, das Sie für ihn erstellt haben, als Nutzer zu seinem Ad Manager-Netzwerk hinzuzufügen.
1. Google-Konto erstellen
Es gibt verschiedene Möglichkeiten, ein Google-Konto zu erstellen, das einem Ad Manager-Netzwerk hinzugefügt werden kann.
Option 1: Erstellen Sie ein OAuth2-Dienstkonto. Dadurch wird eine E‑Mail-Adresse für das Dienstkonto generiert, die als Google-Konto fungiert. Anleitung zum Erstellen eines neuen Dienstkontos
Option 2: Sie können ein reguläres Google-Konto (Gmail-Konto) erstellen, indem Sie sich als neuer Nutzer registrieren. Wenn Sie bereits ein Google-Konto haben, schließen Sie die Registrierung in einem Inkognitofenster oder einer neuen Browsersitzung ab. Wenn Ihr Unternehmen Google Workspace verwendet, können Sie auch ein Google-Konto in der Domain Ihres Unternehmens erstellen und dieses verwenden. In diesem Leitfaden bezeichnen wir beide als „normales“ Google-Konto.
2. Kunden bitten, Ihr Google-Konto ihrem Netzwerk hinzuzufügen
Nachdem Sie ein Google-Konto für den Zugriff auf das Netzwerk Ihres Kunden erhalten haben, bitten Sie ihn, das Konto als neuen Nutzer in seinem Ad Manager-Netzwerk hinzuzufügen.
Wenn Sie ihnen die E‑Mail-Adresse eines OAuth2-Dienstkontos geben, bitten Sie sie, das Konto ihrem Netzwerk hinzuzufügen.
Wenn Sie ihnen ein reguläres Google-Konto zur Verfügung stellen, bitten Sie sie, Ihr Konto als Nutzer zu ihrem Netzwerk hinzuzufügen.
Unabhängig davon, welchen Weg Sie wählen, sollten Sie mit Ihrem Kunden besprechen, welche Rollen und Berechtigungen Ihr Konto haben sollte, damit Ihre Anwendung auf die benötigten Daten im Netzwerk Ihres Kunden zugreifen kann.
Sie können jetzt API-Aufrufe an das Ad Manager-Netzwerk Ihres Kunden senden. Achten Sie darauf, dass Sie den SOAP-Header „networkCode“ auf den Netzwerkcode des Kunden festlegen, für den Sie den API-Aufruf ausführen. In allen unseren Clientbibliotheken kann diese Einstellung programmatisch festgelegt werden. In der Java-Clientbibliothek für Anzeigen können Sie beispielsweise beim Erstellen einer DfpSession-Instanz den Netzwerkcode programmatisch festlegen.
Über die API auf dem Laufenden bleiben
Es ist wichtig, dass Sie immer auf dem neuesten Stand sind, welche API-Versionen eingestellt werden und wann neue Versionen veröffentlicht werden. Sie möchten nicht überrascht werden, wenn eine Version eingestellt wird, und riskieren, dass Ihre Clients nicht mehr funktionieren. Wir können Dritte nicht immer über bevorstehende Einstellungen und Schließungen informieren, wie wir es bei unseren Kunden tun. Es liegt also in Ihrer Verantwortung, einen unserer drei Hauptkanäle für API-Updates zu abonnieren und Ihre Benachrichtigungseinstellungen anzupassen:
Auf unserer Entwicklerwebsite finden Sie außerdem einen Zeitplan für die Einstellung, den Sie regelmäßig im Blick behalten sollten.