Drittanbieter sind keine direkten Nutzer von Ad Manager, da sie unter Umständen kein eigenes Ad Manager-Netzwerk haben. Stattdessen erstellen sie Dienste oder Integrationen mit Ad Manager für ihre Ad Manager-Kunden. In diesem Leitfaden werden die Grundlagen der Integrationen von Drittanbietern mit Best Practices, Tipps und Tricks behandelt.
In diesem Leitfaden wird davon ausgegangen, dass Sie Grundkenntnisse der Ad Manager API haben. Wenn Sie nicht mit der Ad Manager API vertraut sind, finden Sie entsprechende Informationen in der Dokumentation zum Einstieg.
Erste Schritte als Drittanbieter
Wenn Sie mit der Ad Manager API auf das Netzwerk eines Ad Manager-Kunden zugreifen möchten, folgen Sie einfach den folgenden Richtlinien. Eine zusätzliche Genehmigung von Google ist nicht erforderlich. Durch den Zugriff auf und/oder die Verwendung der Ad Manager API stimmen Sie den Nutzungsbedingungen der 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. Über Testnetzwerke können keine Anzeigen ausgeliefert werden. Testnetzwerke enthalten außerdem nicht unbedingt alle Funktionen, die Ihre Clients möglicherweise in ihren Produktionsnetzwerken haben. Wenn Sie Ad Manager-Funktionen testen möchten, die in Ihrem Testnetzwerk nicht verfügbar sind, können Sie den Zugriff auf ein Netzwerk, das kein Testnetzwerk ist, über einen Ad Manager-Reseller erwerben.
Außerdem sollten Sie Ihren Kunden klar sein, welche Funktionen in ihrem Produktionsnetzwerk verfügbar sein müssen, damit Ihre Anwendung ordnungsgemäß funktioniert. Ihre Anwendung sollte mit Fällen umgehen, in denen Funktionen möglicherweise nicht vorhanden sind, indem entweder Ausnahmen abgefangen und ordnungsgemäß fehlschlagen oder eine Liste Ihrer Clients und der jeweiligen Merkmale führen. Es sollte in der Verantwortung Ihres Kunden liegen, mit seinem Ansprechpartner bei Google zusammenzuarbeiten, um Funktionen in seinem Netzwerk zu verwalten.
Authentifizierung: Richtigen Zugriff auf das Ad Manager-Netzwerk eines Clients
Damit Ihre Anwendung auf das Ad Manager-Netzwerk Ihres Clients zugreifen kann, müssen Sie Ihren Authentifizierungsworkflow auf sichere Weise einrichten.
Dies erfolgt in zwei Schritten:
- Erstellen Sie die E-Mail-Adresse eines Google-Kontos, mit der Sie auf das Netzwerk Ihres Kunden zugreifen.
- Bitten Sie den Kunden, dieses Konto seinem Ad Manager-Netzwerk als Nutzer hinzuzufügen.
In Schritt 1 können Sie entweder ein separates Google-Konto für jeden Kunden erstellen oder ein primäres Konto, das Sie für alle Kunden verwenden. Die erste Option ist sicherer für den Fall, dass 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 als Nutzer erstellt haben, 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, durch das die E-Mail-Adresse eines Dienstkontos für Sie generiert wird, das 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 diese Registrierung in einem Inkognitofenster oder einer neuen Browsersitzung ab. Wenn Ihr Unternehmen Google Workspace verwendet, können Sie stattdessen ein Google-Konto in der Domain Ihres Unternehmens erstellen und dieses verwenden. Im Rahmen dieses Leitfadens bezeichnen wir beide als "reguläre" Google-Konten.
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 dem Ad Manager-Netzwerk als neuen Nutzer hinzuzufügen.
Wenn Sie die E-Mail-Adresse eines OAuth2-Dienstkontos zur Verfügung stellen, bitten Sie den Nutzer, diese zu seinem Netzwerk hinzuzufügen.
Wenn Sie ihm ein reguläres Google-Konto zur Verfügung stellen, bitten Sie ihn, Ihr Konto als Nutzer zu seinem Netzwerk hinzuzufügen.
Unabhängig von der gewählten Route sollten Sie mit Ihrem Kunden besprechen, welche Rollen und Berechtigungen Ihr Konto haben sollte, damit Ihre Anwendung auf die erforderlichen Daten im Netzwerk des Clients zugreifen kann.
Jetzt können Sie API-Aufrufe an das Ad Manager-Netzwerk Ihres Kunden senden. Sie müssen den SOAP-Header „networkCode“ auf den Netzwerkcode des Clients festlegen, an den Sie den API-Aufruf senden. All unsere Clientbibliotheken ermöglichen die programmatische Einstellung. In der Java-Clientbibliothek für Anzeigen können Sie beispielsweise den Netzwerkcode programmatisch festlegen, wenn Sie eine DfpSession-Instanz erstellen.
Mit der API auf dem neuesten Stand bleiben
Es ist wichtig, dass Sie sich informieren, welche API-Versionen eingestellt oder eingestellt werden und wann neue Versionen veröffentlicht werden. Sie möchten nicht überrascht werden, wenn eine Version eingestellt wird und die Gefahr besteht, dass Ihre Clients nicht mehr funktionieren. Im Gegensatz zu unseren Kunden können wir uns nicht immer über bevorstehende Einstellungs- und Einstellungsoptionen an Dritte wenden. Daher liegt es in Ihrer Verantwortung, einen unserer drei Hauptkanäle für API-Updates zu abonnieren und Ihre Benachrichtigungseinstellungen anzupassen:
Auf der Entwicklerwebsite finden Sie außerdem einen Zeitplan für die Einstellung, den Sie regelmäßig überprüfen sollten.
Support
Wenn bei der Ad Manager-Integration Probleme auftreten, bieten wir je nach Problem folgende Supportkanäle an. Wenn Sie eine Frage auf Produktebene haben, wenden Sie sich bitte an die Ad Manager-Produktforen. Wenn Sie eine API-spezifische Frage haben, wenden Sie sich bitte an die Ad Manager API-Foren. In diesem Blogpost finden Sie Tipps dazu, wie Sie unterscheiden können, ob es sich um eine Frage auf Produktebene oder um eine API-spezifische Frage handelt.