Google Campaign Manager 360 Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8804 des Connectors.

Erste Schritte

Versionsunterstützung für Google Campaign Manager

Der Connector stellt die Berichte und Felder bereit, die über die Google Campaign Manager API v2.8 verfügbar sind. Der Connector stellt alle vorhandenen Berichte in Ihrer DCM-Instanz sowie eine Reihe allgemeiner Tabellen für Ad-hoc-Berichte bereit.

Herstellen einer Verbindung

Mit Google Campaign Manager verbinden

Geben Sie die folgenden Verbindungseigenschaften an, bevor Sie die Authentifizierungseigenschaften hinzufügen.

• ProfileID: Legen Sie hier die DoubleClick-Benutzerprofil-ID fest, mit der Sie eine Verbindung herstellen möchten. Dieser Wert kann aus der Profiltabelle abgerufen werden. Wenn dieser Wert nicht angegeben ist, wird das erste zurückgegebene Benutzerprofil verwendet.

Authentifizieren Sie sich bei Google Campaign Manager

Der Connector unterstützt die Verwendung von Benutzerkonten, Dienstkonten und GCP-Instanzkonten zur Authentifizierung.

In den folgenden Abschnitten werden die verfügbaren Authentifizierungsschemata für Google Campaign Manager erläutert:

• Benutzerkonten (OAuth)
• Dienstkonto (OAuthJWT)
• GCP-Instanzkonto

Benutzerkonten (OAuth)

AuthScheme muss auf gesetzt werden OAuth in allen Benutzerkonto-Flows.

Desktop-Anwendungen

Es wird eine eingebettete OAuth-Anwendung bereitgestellt, die die OAuth-Desktop-Authentifizierung vereinfacht. Alternativ können Sie eine benutzerdefinierte OAuth-Anwendung erstellen. Siehe Erstellen einer benutzerdefinierten OAuth-App für Informationen zum Erstellen benutzerdefinierter Anwendungen und Gründe dafür.

Der einzige Unterschied zwischen den beiden Methoden zur Authentifizierung besteht darin, dass Sie bei Verwendung benutzerdefinierter OAuth-Anwendungen zwei zusätzliche Verbindungseigenschaften festlegen müssen.

Nachdem Sie die folgenden Verbindungseigenschaften festgelegt haben, können Sie eine Verbindung herstellen:

• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH, das den Connector anweist, automatisch zu versuchen, das OAuth-Zugriffstoken abzurufen und zu aktualisieren.
• OAuthClientId: (nur benutzerdefinierte Anwendungen) Legen Sie dies in den Einstellungen Ihrer benutzerdefinierten OAuth-Anwendung auf die Client-ID fest.
• OAuthClientSecret: (nur benutzerdefinierte Anwendungen) Legen Sie dies in den benutzerdefinierten OAuth-Anwendungseinstellungen auf das Client-Geheimnis fest.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Der Connector schließt den OAuth-Prozess dann wie folgt ab:

• Extrahiert den Zugriffstoken aus der Rückruf URL.
• Erhält einen neuen Zugriffstoken, wenn der alte abläuft.
• Speichert OAuth-Werte in OAuthSettingsLocation die über Verbindungen hinweg bestehen bleiben.

Webanwendungen

Wenn Sie eine Verbindung über eine Webanwendung herstellen, müssen Sie eine benutzerdefinierte OAuth-Anwendung erstellen und bei Google Campaign Manager registrieren. Anschließend können Sie den Connector verwenden, um die OAuth-Tokenwerte abzurufen und zu verwalten. Siehe Erstellen einer benutzerdefinierten OAuth-App für weitere Informationen zu benutzerdefinierten Anwendungen.

Holen Sie sich ein OAuth-Zugriffstoken

Legen Sie die folgenden Verbindungseigenschaften fest, um das zu erhalten OAuthAccessToken:

• OAuthClientId: Stellen Sie dies in Ihren Anwendungseinstellungen auf die Client-ID ein.
• OAuthClientSecret: Legen Sie dies in Ihren Anwendungseinstellungen auf das Client-Geheimnis fest.

Rufen Sie dann gespeicherte Prozeduren auf, um den OAuth-Austausch abzuschließen:

1. Rufen Sie GetOAuthAuthorizationURL auf gespeicherte Prozedur. Legen Sie die CallbackURL-Eingabe auf die Callback URL fest, die Sie in Ihren Anwendungseinstellungen angegeben haben. Die gespeicherte Prozedur gibt die URL an den OAuth-Endpoint zurück.
2. Navigieren Sie zu der URL, die die gespeicherte Prozedur in Schritt 1 zurückgegeben hat. Melden Sie sich bei der benutzerdefinierten OAuth-Anwendung an und autorisieren Sie die Webanwendung. Nach der Authentifizierung leitet Sie der Browser zur Rückruf-URL weiter.
3. Rufen Sie den GetOAuthAccessToken gespeicherte Prozedur. Setzen Sie AuthMode auf WEB und den Verifier-Eingang für den Parameter „Code“ in der Abfrage der Rückruf URL.

Sobald Sie die Zugriffs- und Aktualisierungstoken erhalten haben, können Sie eine Verbindung zu Daten herstellen und das OAuth-Zugriffstoken entweder automatisch oder manuell aktualisieren.

Automatische Aktualisierung des OAuth-Zugriffstokens

Damit der Treiber den OAuth-Zugriffstoken automatisch aktualisiert, legen Sie bei der ersten Datenverbindung Folgendes fest:

• InitiateOAuth: Setzen Sie dies auf REFRESH.
• OAuthClientId: Legen Sie dies in Ihren Anwendungseinstellungen auf die Client-ID fest.
• OAuthClientSecret: Legen Sie dies in Ihren Anwendungseinstellungen auf das Client-Geheimnis fest.
• OAuthAccessToken: Setzen Sie dies auf den von GetOAuthAccessToken zurückgegebenen Zugriffstoken.
• OAuthRefreshToken: Setzen Sie dies auf das von GetOAuthAccessToken zurückgegebene Aktualisierungstoken.
• OAuthSettingsLocation: Legen Sie hier den Speicherort fest, an dem der Connector die OAuth-Tokenwerte speichert, die über Verbindungen hinweg bestehen bleiben.

Bei nachfolgenden Datenverbindungen werden die Werte für OAuthAccessToken und OAuthRefreshToken von übernommen OAuthSettingsLocation.

Manuelle Aktualisierung des OAuth-Zugriffstokens

Der einzige Wert, der zum manuellen Aktualisieren des OAuth-Zugriffstokens bei der Verbindung mit Daten benötigt wird, ist das OAuth-Aktualisierungstoken.

Verwenden Sie das RefreshOAuthAccessToken gespeicherte Prozedur zum manuellen Aktualisieren der OAuthAccessToken nach dem von GetOAuthAccessToken zurückgegebenen ExpiresIn-Parameterwert abgelaufen ist, legen Sie die folgenden Verbindungseigenschaften fest:

• OAuthClientId: Legen Sie dies in Ihren Anwendungseinstellungen auf die Client-ID fest.
• OAuthClientSecret: Legen Sie dies in Ihren Anwendungseinstellungen auf das Client-Geheimnis fest.

Rufen Sie dann RefreshOAuthAccessToken auf mit OAuthRefreshToken gesetzt auf das von GetOAuthAccessToken zurückgegebene OAuth-Aktualisierungstoken. Nachdem die neuen Token abgerufen wurden, öffnen Sie eine neue Verbindung, indem Sie die Eigenschaft OAuthAccessToken auf den von RefreshOAuthAccessToken zurückgegebenen Wert setzen.

Speichern Sie abschließend das OAuth-Aktualisierungstoken, damit Sie es nach Ablauf des OAuth-Zugriffstokens manuell aktualisieren können.

Kopflose Maschinen

Um den Treiber für die Verwendung von OAuth mit einem Benutzerkonto auf einem Headless-Computer zu konfigurieren, müssen Sie sich auf einem anderen Gerät authentifizieren, das über einen Internetbrowser verfügt.

1. Wählen Sie eine von zwei Optionen:
   • Option 1: Erhalten Sie die OAuthVerifierWert wie unten unter „Erhalten und Umtauschen eines Prüfcodes“ beschrieben.
   • Option 2: Installieren Sie den Connector auf einem Computer mit einem Internetbrowser und übertragen Sie die OAuth-Authentifizierungswerte, nachdem Sie sich über den üblichen browserbasierten Ablauf authentifiziert haben, wie unten unter „OAuth-Einstellungen übertragen“ beschrieben.
2. Konfigurieren Sie dann den Connector so, dass der Zugriffstoken auf der Headless-Maschine automatisch aktualisiert wird.

Option 1: Einen Verifier-Code erhalten und umtauschen

Um einen Prüfcode zu erhalten, müssen Sie sich bei der OAuth-Autorisierungs URL authentifizieren.

Befolgen Sie die nachstehenden Schritte, um sich vom Computer aus mit einem Internetbrowser zu authentifizieren und die OAuthVerifier Verbindungseigenschaft.

1. Wählen Sie eine dieser Optionen:

   • Wenn Sie die eingebettete OAuth-Anwendung verwenden, klicken Sie auf Google Campaign Manager OAuth-Endpoint, um den Endpoint in Ihrem Browser zu öffnen.

   • Wenn Sie eine benutzerdefinierte OAuth-Anwendung verwenden, erstellen Sie die Autorisierungs-URL, indem Sie die folgenden Eigenschaften festlegen:

     • InitiateOAuth: Auf setzen OFF.
     • OAuthClientId: Auf die Client-ID eingestellt, die Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
     • OAuthClientSecret: Auf das Client-Geheimnis setzen, das Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.

     Rufen Sie dann GetOAuthAuthorizationURL auf gespeicherte Prozedur mit der entsprechenden CallbackURL. Öffnen Sie die von der gespeicherten Prozedur zurückgegebene URL in einem Browser. 2. Melden Sie sich an und erteilen Sie dem Connector die entsprechenden Berechtigungen. Sie werden dann zur Callback-URL weitergeleitet, die den Prüfcode enthält. 3. Speichern Sie den Wert des Prüfcodes. Später setzen Sie diesen in OAuthVerifier Verbindungseigenschaft.

Als Nächstes müssen Sie den OAuth-Verifiziercode gegen OAuth-Aktualisierungs- und Zugriffstoken austauschen. Legen Sie die folgenden Eigenschaften fest:

Legen Sie auf der Headless-Maschine die folgenden Verbindungseigenschaften fest, um die OAuth-Authentifizierungswerte zu erhalten:

• InitiateOAuth: Setzen Sie dies auf REFRESH.
• OAuthVerifier: Setzen Sie dies auf den Prüfcode.
• OAuthClientId: (nur benutzerdefinierte Anwendungen) Legen Sie dies in den Einstellungen Ihrer benutzerdefinierten OAuth-Anwendung auf die Client-ID fest.
• OAuthClientSecret: (nur benutzerdefinierte Anwendungen) Legen Sie dies in den benutzerdefinierten OAuth-Anwendungseinstellungen auf das Client-Geheimnis fest.
• OAuthSettingsLocation: Legen Sie dies fest, um die verschlüsselten OAuth-Authentifizierungswerte am angegebenen Speicherort beizubehalten.

Nachdem die OAuth-Einstellungsdatei generiert wurde, müssen Sie die folgenden Eigenschaften neu festlegen, um eine Verbindung herzustellen:

• InitiateOAuth: Setzen Sie dies auf REFRESH.
• OAuthClientId: (nur benutzerdefinierte Anwendungen) Legen Sie hier die Client-ID fest, die Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• OAuthClientSecret: (nur benutzerdefinierte Anwendungen) Legen Sie hier das Client-Geheimnis fest, das Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• OAuthSettingsLocation: Legen Sie dies auf den Speicherort fest, der die verschlüsselten OAuth-Authentifizierungswerte enthält. Stellen Sie sicher, dass dieser Speicherort dem Connector Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.

Option 2: OAuth-Einstellungen übertragen

Bevor Sie eine Verbindung auf einem Headless-Computer herstellen, müssen Sie eine Verbindung mit dem Treiber auf einem Gerät herstellen und installieren, das einen Internetbrowser unterstützt. Legen Sie die Verbindungseigenschaften wie oben unter „Desktop-Anwendungen“ beschrieben fest.

Nach Abschluss der Anweisungen unter „Desktopanwendungen“ werden die resultierenden Authentifizierungswerte verschlüsselt und an den durch angegebenen Speicherort geschrieben OAuthSettingsLocation. Der Standarddateiname ist OAuthSettings.txt.

Nachdem Sie die Verbindung erfolgreich getestet haben, kopieren Sie die OAuth-Einstellungsdatei auf Ihren Headless-Rechner.

Legen Sie auf dem Headless-Rechner die folgenden Verbindungseigenschaften fest, um eine Verbindung zu Daten herzustellen:

• InitiateOAuth: Setzen Sie dies auf REFRESH.
• OAuthClientId: (nur benutzerdefinierte Anwendungen) Legen Sie hier die Client-ID fest, die Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• OAuthClientSecret: (nur benutzerdefinierte Anwendungen) Legen Sie hier das Client-Geheimnis fest, das Ihnen bei der Registrierung Ihrer Anwendung zugewiesen wurde.
• OAuthSettingsLocation: Legen Sie hier den Speicherort Ihrer OAuth-Einstellungsdatei fest. Stellen Sie sicher, dass dieser Speicherort dem Connector Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.

Dienstkonten (OAuthJWT)

Um sich mit einem Dienstkonto zu authentifizieren, müssen Sie ein neues Dienstkonto erstellen und über eine Kopie des Kontozertifikats verfügen. Wenn Sie noch kein Dienstkonto haben, können Sie eines erstellen, indem Sie dem Verfahren unter Erstellen einer benutzerdefinierten OAuth-App folgen.

Legen Sie für eine JSON-Datei diese Eigenschaften fest:

• AuthScheme: Setzen Sie dies auf OAuthJWT.
• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH.
• OAuthJWTCertType: Setzen Sie dies auf GOOGLEJSON.
• OAuthJWTCert: Setzen Sie hier den Pfad zum .json Datei bereitgestellt von Google.
• OAuthJWTSubject: (optional) Legen Sie diesen Wert nur fest, wenn das Dienstkonto Teil einer GSuite-Domäne ist und Sie die Delegation aktivieren möchten. Der Wert dieser Eigenschaft sollte die Email-Adresse des Benutzers sein, auf dessen Daten Sie zugreifen möchten.

Legen Sie für eine PFX-Datei stattdessen diese Eigenschaften fest:

• AuthScheme: Setzen Sie dies auf OAuthJWT.
• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH.
• OAuthJWTCertType: Setzen Sie dies auf PFXFILE.
• OAuthJWTCert: Setzen Sie hier den Pfad zum .pfx Datei bereitgestellt von Google.
• OAuthJWTCertPassword: (optional) Setzen Sie dies auf .pfx Dateikennwort. In den meisten Fällen müssen Sie dies angeben, da Google PFX-Zertifikate verschlüsselt.
• OAuthJWTCertSubject: (optional) Legen Sie dies nur fest, wenn Sie ein verwenden OAuthJWTCertType speichert mehrere Zertifikate. Sollte nicht für von Google generierte PFX-Zertifikate festgelegt werden.
• OAuthJWTIssuer: Setzen Sie hier die Email-Adresse des Dienstkontos. Diese Adresse enthält normalerweise die Domäne iam.gserviceaccount.com.
• OAuthJWTSubject: (optional) Legen Sie diesen Wert nur fest, wenn das Dienstkonto Teil einer GSuite-Domäne ist und Sie die Delegation aktivieren möchten. Der Wert dieser Eigenschaft sollte die Email-Adresse des Benutzers sein, auf dessen Daten Sie zugreifen möchten.

GCP-Instanzkonten

Wenn der Connector auf einer virtuellen GCP-Maschine ausgeführt wird, kann er sich mithilfe eines an die virtuelle Maschine gebundenen Dienstkontos authentifizieren. Um diesen Modus zu verwenden, setzen Sie AuthScheme Zu GCPInstanceAccount.

Erstellen einer benutzerdefinierten OAuth-App

Wann sollte eine benutzerdefinierte OAuth-App erstellt werden?

bettet OAuth-Anwendungsanmeldeinformationen mit Branding ein, die bei der Verbindung über eine Desktop-Anwendung oder von einem Headless-Computer aus verwendet werden können. Bei Verwendung einer Webanwendung ist jedoch das Erstellen einer benutzerdefinierten OAuth-Anwendung erforderlich.

Für Dienstkonten müssen Sie immer eine benutzerdefinierte OAuth-Anwendung erstellen.

Sie können Ihre eigenen OAuth-Anwendungsanmeldeinformationen erstellen, wenn Sie Folgendes möchten:

• das Branding des Authentifizierungsdialogs steuern
• die Umleitungs-URI steuern, zu der die Anwendung den Benutzer nach der Authentifizierung umleitet
• die Berechtigungen anpassen, die Sie vom Benutzer anfordern

Benutzerkonten

Erstellen einer OAuth-App zur Benutzerkonto-Authentifizierung

Befolgen Sie die nachstehenden Schritte, um eine App zu registrieren und die OAuthClientId Und OAuthClientSecret.

Desktop-Anwendungen

1. Melden Sie sich bei der Google API Konsole an und öffnen Sie ein Projekt.
2. Wählen Sie API Manager aus dem Hauptmenü.
3. Wählen Sie Credentials > Create Credentials > OAuth Client Id. Klicken Sie dann auf Other.
4. Wählen Sie Library > DCM/DFA Reporting And Trafficking API > Enable API.

Erstellen einer OAuth-App zur Dienstkontoauthentifizierung

Um die erforderlichen Authentifizierungseigenschaften zu erhalten, befolgen Sie die Schritte unten, um eine OAuth-Anwendung zu erstellen und einen privaten Schlüssel zu generieren:

1. Melden Sie sich bei der Google API Konsole an und öffnen Sie ein Projekt.
2. Wählen Sie den API-Manager aus dem Hauptmenü.
3. Wählen Sie Create Credentials > Service Account Key.
4. Im Service Account Menü, auswählen New Service Account oder wählen Sie ein vorhandenes Dienstkonto.
5. Wenn Sie ein neues Dienstkonto erstellen, wählen Sie eine oder mehrere Rollen aus. Sie können einfache Rollen auf Projektebene in zuweisen IAM and Admin; andere Rollen ermöglichen Ihnen, den Zugriff auf Google APIs weiter anzupassen.
6. In Key Type, wähle den Schlüsseltyp P12.
7. Erstelle die App, um das Schlüsselpaar herunterzuladen. Das Passwort des privaten Schlüssels wird angezeigt: Setze dieses in OAuthJWTCertPassword.
8. Klicken Sie im Abschnitt „Dienstkonten“ auf „Dienstkonten verwalten“ und legen Sie fest OAuthJWTIssuer an die im angezeigte Email Adresse service account Id Feld.

DoubleClick Campaign Manager-Daten abrufen

DoubleClick Campaign Manager-Daten sind in verschiedene Metriken (Klicks, Cost-per-Click, Impressionen usw.) unterteilt, die über verschiedene Dimensionen (Land, Monat usw.) abgefragt werden können. Die automatische Erkennung aller vorhandenen Berichte für Ihr DCM-Konto ist extrem teuer. Um dies zu umgehen, stellt der Connector fünf allgemeine Tabellen bereit, eine für jeden Berichtstyp, die sowohl Ad-hoc-Berichte als auch die Ausführung Ihrer vorhandenen Berichte ermöglichen. Es besteht auch die Möglichkeit, benutzerdefinierte Schema für Ihre vorhandenen Berichte zu erstellen, damit diese als eigene Tabellen abgefragt werden können. In diesen Abschnitten werden die verschiedenen Strategien zum Abfragen Ihrer DCM-Daten mit dem Connector erläutert.

Integrierte Berichtstabellen

Der Treiber enthält fünf integrierte Tabellen: CrossDimensionReachReport, FloodlightReport, PathToConversionReport, ReachReport und StandardReport. Diese allgemeinen Tabellen enthalten alle möglichen Dimensionen und Messwerte für den angegebenen Berichtstyp, aber nicht alle Kombinationen von Dimensionen oder Messwerten sind in DCM gültig. Daher sind „SELECT *“-Abfragen an diese Tabellen normalerweise nicht zulässig. Stattdessen haben Sie mehrere Möglichkeiten, Daten aus diesen Tabellen abzurufen:

1. Ad-hoc-Berichte sind verfügbar, indem Sie eine Abfrage ausführen und dabei eine beliebige gültige Kombination von Dimensionen oder Metriken aus der Tabelle auswählen. Beispiel:

   SELECT Campaign, CampaignId, Impressions, Clicks, ClickRate, TotalConversions FROM StandardReport
   

   Diese Abfrage umfasst einen mehrstufigen Prozess. Zunächst wird die Berichtsdefinition in DCM erstellt und die Verarbeitung gestartet. Beachten Sie, dass die Verarbeitung von DCM-Berichten sehr lange dauern kann, insbesondere wenn Sie über ein großes Datenvolumen verfügen. Sobald die Verarbeitung abgeschlossen ist, wird der Bericht heruntergeladen und vom Connector ausgegeben. Abschließend wird die Berichtsdefinition aus DCM gelöscht.

2. Sie können im Filter eine ReportID für die Abfrage angeben, um einen vorhandenen Bericht auszuführen. Diese Abfrage ermöglicht „SELECT *“, aber beachten Sie, dass nur die Felder mit Daten gefüllt werden, die tatsächlich im Bericht enthalten sind, während der Rest NULL zurückgibt. Beispiel:

   SELECT * FROM StandardReport WHERE ReportID='123456789'
   

   Der Bericht wird in Echtzeit ausgeführt. Beachten Sie daher, dass die Verarbeitung von DCM-Berichten sehr lange dauern kann, insbesondere wenn Sie über ein großes Datenvolumen verfügen. Die Berichtsdefinition wird in diesem Fall nicht gelöscht.

3. Sie können sowohl eine ReportID als auch eine FileID im Filter angeben, um einen zuvor ausgeführten Bericht herunterzuladen. Diese Abfrage ermöglicht „SELECT *“, aber beachten Sie, dass nur die Felder mit Daten gefüllt werden, die tatsächlich im Bericht enthalten sind, während der Rest NULL zurückgibt. Beispiel:

   SELECT * FROM StandardReport WHERE ReportID='123456789' AND FileID='987654321'
   

   Da der Bericht in diesem Fall bereits ausgeführt wurde, werden die Ergebnisse sofort zurückgegeben. Der RunReport und CheckReportStatus gespeicherte Prozeduren können zusammen mit dieser Abfragemethode zur asynchronen Verarbeitung des Berichts in Ihrer Anwendung verwendet werden.

Vorhandene DCM-Berichte

Der Connector bietet außerdem die Funktion CreateCustomSchema gespeicherte Prozedur zum Erstellen neuer Tabellendefinitionen für Ihre vorhandenen Berichte in DCM. Die gespeicherte Prozedur verwendet einen Tabellennamen, die Berichts-ID und einen Ausgabeordner als Eingaben. Durch den Aufruf wird eine neue Schema erstellt, die Sie wie jede andere Tabelle Abfrage können. Sie müssen die Location Verbindungseigenschaft zum Ordner, der die neuen Script enthält, um nach ihrer Erstellung darauf zugreifen zu können. Beispiel:

EXEC CreateCustomSchema TableName='MyCustomReport', ReportID='123456789', OutputFolder='C:\Users\Administrator\Desktop'

Wichtige Hinweise

Konfigurationsdateien und ihre Pfade

• Alle Verweise auf das Hinzufügen von Konfigurationsdateien und deren Pfaden beziehen sich auf Dateien und Speicherorte auf dem Jitterbit-Agenten, auf dem der Connector installiert ist. Diese Pfade sind je nach Agent und Operationssystem entsprechend anzupassen. Wenn mehrere Agenten in einer Agentengruppe verwendet werden, werden auf jedem Agenten identische Dateien benötigt.

Erweiterte Funktionen

In diesem Abschnitt wird eine Auswahl erweiterter Funktionen des Google Campaign Manager-Connectors beschrieben.

Benutzerdefinierte Ansichten

Der Connector ermöglicht Ihnen die Definition virtueller Tabellen, sogenannter benutzerdefinierter Ansichten, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese Ansichten sind nützlich, wenn Sie die an die Treiber gesendeten Abfragen nicht direkt steuern können. Siehe Benutzerdefinierte Ansichten für einen Überblick über das Erstellen und Konfigurieren benutzerdefinierter Ansichten.

SSL-Konfiguration

Verwenden Sie SSL-Konfiguration, um anzupassen, wie der Connector TLS/SSL-Zertifikatsverhandlungen handhabt. Sie können aus verschiedenen Zertifikatsformaten wählen; siehe SSLServerCert-Eigenschaft unter „Verbindungszeichenfolgenoptionen“ für weitere Informationen.

Proxy

So konfigurieren Sie den Connector mit privaten Agent-Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Abfrageverarbeitung

Der Connector verlagert möglichst viel der Verarbeitung der SELECT-Anweisung auf Google Campaign Manager und verarbeitet dann den Rest der Abfrage im Speicher (clientseitig).

Benutzerdefinierte Ansichten

Mit dem Jitterbit Connector für Google Campaign Manager können Sie eine virtuelle Tabelle definieren, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese werden als benutzerdefinierte Ansichten bezeichnet und sind in Situationen nützlich, in denen Sie die an den Treiber gesendete Abfrage nicht direkt steuern können, z. B. wenn Sie den Treiber von Jitterbit verwenden. Die benutzerdefinierten Ansichten können verwendet werden, um Prädikate zu definieren, die immer angewendet werden. Wenn Sie in der Abfrage an die Ansicht zusätzliche Prädikate angeben, werden diese mit der bereits als Teil der Ansicht definierten Abfrage kombiniert.

Es gibt zwei Möglichkeiten, benutzerdefinierte Ansichten zu erstellen:

• Erstellen Sie eine Konfigurationsdatei im JSON-Format, die die gewünschten Ansichten definiert.
• DDL-Anweisungen.

Definieren von Ansichten mithilfe einer Konfigurationsdatei

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

• Jedes Stammelement definiert den Namen einer Ansicht.
• Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM CampaignPerformance WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie UserDefinedViews Verbindungseigenschaft zur Angabe des Speicherorts Ihrer JSON-Konfigurationsdatei. Beispiel:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Definieren von Ansichten mit DDL-Anweisungen

Der Connector kann das Schema auch über DDL-Anweisungen wie CREATE LOCAL VIEW, ALTER LOCAL VIEW und DROP LOCAL VIEW erstellen und ändern.

Erstellen einer Ansicht

Um eine neue Ansicht mit DDL-Anweisungen zu erstellen, geben Sie den Ansichtsnamen und die Abfrage wie folgt an:

CREATE LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers LIMIT 20;

Wenn keine JSON-Datei vorhanden ist, erstellt der obige Code eine. Die Ansicht wird dann in der JSON-Konfigurationsdatei erstellt und ist nun erkennbar. Der Speicherort der JSON-Datei wird durch angegeben UserDefinedViews Verbindungseigenschaft.

Ändern einer Ansicht

Um eine vorhandene Ansicht zu ändern, geben Sie den Namen der vorhandenen Ansicht zusammen mit der neuen Abfrage an, die Sie stattdessen verwenden möchten:

ALTER LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers WHERE TimeModified > '3/1/2020';

Die Ansicht wird dann in der JSON-Konfigurationsdatei aktualisiert.

Löschen einer Ansicht

Um eine vorhandene Ansicht zu löschen, geben Sie den Namen eines vorhandenen Schema neben der neuen Abfrage an, die Sie stattdessen verwenden möchten.

DROP LOCAL VIEW [MyViewName]

Dadurch wird die Ansicht aus der JSON-Konfigurationsdatei entfernt. Sie kann nicht mehr abgefragt werden.

Schema für benutzerdefinierte Ansichten

Benutzerdefinierte Ansichten werden im angezeigt UserViews Schema standardmäßig. Dies geschieht, um zu vermeiden, dass der Name der Ansicht mit einer tatsächlichen Entität im Datenmodell kollidiert. Sie können den Namen des für UserViews verwendeten Schema ändern, indem Sie festlegen UserViewsSchemaName Eigentum.

Arbeiten mit benutzerdefinierten Ansichten

Beispielsweise eine SQL-Anweisung mit einer benutzerdefinierten Ansicht namens UserViews.RCustomers listet nur Kunden in Raleigh auf:

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Daraus ergibt sich die effektive Abfrage an die Quelle:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Dies ist ein sehr einfaches Beispiel für eine Abfrage an eine benutzerdefinierte Ansicht, die tatsächlich eine Kombination aus der Abfrage und der Ansichtsdefinition ist. Es ist möglich, diese Abfragen in viel komplexeren Mustern zusammenzustellen. Alle SQL-Operationen sind in beiden Abfragen zulässig und werden bei Bedarf kombiniert.

SSL-Konfiguration

Anpassen der SSL-Konfiguration

Standardmäßig versucht der Connector, SSL/TLS auszuhandeln, indem er das Zertifikat des Servers mit dem vertrauenswürdigen Zertifikatspeicher des Systems vergleicht.

Um ein anderes Zertifikat anzugeben, siehe SSLServerCert Eigenschaft für die verfügbaren Formate, um dies zu tun.

Datenmodell

Der Jitterbit Connector für Google Campaign Manager modelliert Google Campaign Manager-Entitäten in relationalen Tabellen, Ansichten und gespeicherten Prozeduren. Die bereitgestellten Tabellen geben Ihnen einen Überblick über Ihre Kontoinformationen und die für DoubleClick Campaign Manager-Abfragen verfügbaren Berichte.

API Einschränkungen und-Anforderungen sind in diesem Abschnitt dokumentiert.

Zusätzliche Schemas erstellen

Das Kontrollkästchen CreateCustomSchema gespeicherte Prozedur kann verwendet werden, um einfach neue Schema für einen bestimmten Bericht zu generieren. Diese Prozedur verwendet den Tabellennamen und eine Berichts-ID und erstellt eine Schema, die vom Connector gelesen werden kann.

Wenn die Location Verbindungseigenschaft festgelegt ist, wird die Datei in diesen Ordner ausgegeben. Andernfalls kann die OutputFolder-Eingabe verwendet werden, um einen Ausgabeordner anzugeben. Um mit der Abfrage dieser neuen Dateien zu beginnen, legen Sie einfach die Location Verbindungseigenschaft zum Ordner, der diese neuen Schema enthält.

Ansichten

Ansichten sind Tabellen, die nicht geändert werden können. Normalerweise werden Daten, die schreibgeschützt sind und nicht aktualisiert werden können, als Ansichten angezeigt.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zur Datenquelle. Sie können zum Suchen, Aktualisieren und Ändern von Informationen in der Datenquelle verwendet werden.

Ansichten

Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten sind jedoch schreibgeschützt.

Abfragen können für eine Ansicht ausgeführt werden, als wäre sie eine normale Tabelle.

Jitterbit-Connector für Google Campaign Manager-Ansichten

CrossDimensionReachReport

Tabelle zum Ausführen von in DCM gespeicherten CrossDimensionReach-Berichten oder Ad-hoc-Berichten.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Dateien

Listet alle DoubleClick Campaign Manager-Dateien für den Benutzer auf.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Flutlichtbericht

Tabelle zum Ausführen von Floodlight-Berichten, die in DCM oder Ad-hoc-Berichten gespeichert sind.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

PfadZumKonvertierungsbericht

Tabelle zum Ausführen von in DCM gespeicherten PathToConversion-Berichten oder Ad-hoc-Berichten.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Reichweitenbericht

Tabelle zum Ausführen von in DCM gespeicherten Reichweitenberichten oder Ad-hoc-Berichten.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Berichte

Listet alle DoubleClick Campaign Manager-Berichte für den Benutzer auf.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

StandardBericht

Tabelle zum Ausführen von in DCM gespeicherten Standardberichten oder Ad-hoc-Berichten.

Spalten