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 Integrationen von Drittanbietern behandelt. Außerdem finden Sie 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, lesen Sie unsere Dokumentation zu den ersten Schritten.
Erste Schritte als Drittanbieter
Wenn Sie die Ad Manager API verwenden möchten, um auf das Netzwerk eines Ad Manager-Kunden zuzugreifen, folgen Sie der Anleitung unten. Es ist keine zusätzliche Genehmigung von Google erforderlich. Beachten Sie jedoch, dass Sie mit dem Zugriff auf die Ad Manager API und/oder deren Nutzung den Nutzungsbedingungen der Ad Manager API zustimmen.
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 einsetzen. Die empfohlene Vorgehensweise ist, ein Testnetzwerk zu erstellen. Sie müssen kein Ad Manager-Kunde sein, um dies zu tun. 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öchten, 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 verarbeiten, in denen Funktionen möglicherweise nicht vorhanden sind. Dazu können Sie entweder Ausnahmen abfangen und ordnungsgemäß fehlschlagen oder eine Liste Ihrer Clients und der Funktionen führen, die jeder Client hat oder nicht hat. Es liegt in der Verantwortung des Kunden, mit seinem Ansprechpartner bei Google zusammenzuarbeiten, um die Funktionen in seinem Netzwerk zu verwalten.
Authentifizierung: So greifen Sie richtig auf das Ad Manager-Netzwerk eines Kunden zu
Damit Ihre Anwendung auf das Ad Manager-Netzwerk Ihres Kunden zugreifen kann, müssen Sie den Authentifizierungsworkflow 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 können.
- Bitten Sie den Kunden, dieses Konto als Nutzer zu seinem Ad Manager-Netzwerk hinzuzufü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 gehackt wird. Letzteres 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 Dienstkonto-E-Mail-Adresse für Sie generiert, die als Google-Konto fungiert. Anleitung zum Erstellen eines neuen Dienstkontos
Option 2: Sie können ein normales Google-Konto („Gmail“-Konto) erstellen, indem Sie sich als neuer Nutzer registrieren. Wenn Sie bereits ein Google-Konto haben, führen Sie diese Registrierung in einem Inkognitofenster oder einer neuen Browsersitzung durch. Wenn Ihr Unternehmen Google Workspace verwendet, können Sie stattdessen ein Google-Konto in der Domain Ihres Unternehmens erstellen und dieses verwenden. In diesem Leitfaden werden beide als „normales“ Google-Konto bezeichnet.
2. Bitten Sie den Kunden, Ihr Google-Konto seinem 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 eine E-Mail-Adresse für ein OAuth2-Dienstkonto zur Verfügung stellen, bitten Sie sie, diese 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 erforderlichen 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 dies programmatisch festgelegt werden. In der Java-Clientbibliothek für Anzeigen können Sie beispielsweise beim Erstellen einer DfpSession-Instanz den Netzwerkcode programmatisch festlegen.
Immer auf dem neuesten Stand bleiben
Es ist wichtig, dass du auf dem neuesten Stand bleibst, welche API-Versionen nicht mehr unterstützt oder 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 Drittanbieter nicht immer über bevorstehende Einstellungen und Abschaffungen informieren, wie wir es für unsere Kunden tun. Sie sind also dafür verantwortlich, einen unserer drei Hauptkanäle für API-Updates zu abonnieren und Ihre Benachrichtigungseinstellungen anzupassen:
Außerdem stellen wir auf unserer Entwicklerwebsite einen Zeitplan für die Einstellung bereit, den du regelmäßig im Blick behalten solltest.