--- title: Erweiterter Empfängerlisten-Konnektor slug: campaign/docs/erweiterter-empfpercentc3percenta4ngerlisten-konnektor docTags: createdAt: 2026-08-06T15:53:47.015Z --- :::hint{type="info"} **Note** Dieses Kapitel richtet sich an Administratoren und Entwickler mit Administratorrechten in Microsoft Dynamics. ::: :::hint{type="info"} **Note** Die Dokumentation bezieht sich auf die Konnektor-Version 1.584 und höher. ::: Die aktuelle Version von Microsoft Dynamics CRM kann nicht mehr als 100.000 Empfänger je Kampagne adressieren. Der erweiterte Empfängerlisten-Konnektor für Optimizely Campaign ist ein externer Windows-Dienst, der die technische Beschränkung aufhebt und Kampagnen und die Übertragung von Marketinglisten mit mehr als 100.000 Empfängern steuert. ## Voraussetzungen - Installationsdatei. Wenden Sie sich an die [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV). - Microsoft Dynamics CRM online oder On-Premise (lokal) - SQL-Datenbank, wie beispielsweise LocalDB oder SQL Express. - Portreservierung 1. Öffnen Sie die Eingabeaufforderung als Administrator. 2. Führen Sie das Konfigurationsprogramm `netsh` aus. 3. Reservieren Sie den Port mit der Aufforderung `add urlacl url=http://+:20000/ user=domain\\username`. :::hint{type="info"} **Note** Die Angabe des Ports *+*:20000 muss mit der späteren Angabe des Ports in der Installationsdatei *IntegrationService.exe.config* übereinstimmen. ::: ### Technische Voraussetzungen - SQL-Server - Microsoft SQL Server 2008R2 (alle Versionen mit LocalDB) und neuer - Microsoft SQL Azure - Windows Identity Foundation 3.5 (Windows-Funktion) - .NET Version 4.6.2 ## Installation 1. Entpacken Sie die Installationsdatei, die Sie von der [Kundenbetreuung](docId\:ZWe1T3UPz3JW6_4mc76qV) erhalten haben. 2. Öffnen Sie die Datei *IntegrationService.exe.config* in einem Texteditor. 3. Optional: Konfigurieren Sie die Proxy-Einstellungen. ```javascript ``` :::hint{type="info" indent="2"} **Note** Die Konfiguration ersetzt nicht die Proxy-Konfiguration für das CRM. Diese ist weiterhin notwendig für Funktionen wie Double Opt-in oder Transaktions-Mails. ::: 4. Passen Sie das Element *connectionStrings* wie folgt an: ```javascript ``` :::Paragraph{indent="1"} **Microsoft Dynamics CRM online** ::: :::Paragraph{listStyleType="disc" indent="2"} Stellen Sie beim Parameter *connectionString* der URL den Parameter *AuthType=Office365;* voran: ::: ```javascript connectionString="AuthType=Office365;Url={https://server/organization/}; Domain= ; Username= ; Password= ;" ``` :::Paragraph{listStyleType="disc" indent="2"} Die Parameter *Username* und *Password* sind erforderlich. ::: :::Paragraph{indent="1"} **Microsoft Dynamics CRM On-Premise** ::: :::Paragraph{listStyleType="disc" indent="2"} Wenn Sie sich über die folgenden Windows-Dienste anmelden, sind die Parameter *Domain*, *Username* und *Password* im *connectionString* nicht notwendig: ::: :::Paragraph{listStyleType="disc" indent="3"} Microsoft Dynamics CRM Asynchronous Processing Service (MSCRMAsyncService) ::: :::Paragraph{listStyleType="disc" indent="3"} Microsoft Dynamics CRM Sandbox Processing Service (MSCRM SandboxService) ::: 5. Speichern Sie die Datei *IntegrationService.exe.config*. 6. Öffnen Sie die Eingabeaufforderung als Administrator. 7. Geben Sie den Konnektor-Pfad ein und installieren Sie die Datei *Integrationservice.exe* mit der Aufforderung `integrationservice.exe install`. ![Bild: Eingabeaufforderung](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/uyeSEb8m8GiHnLY6vdKEH-20260720-145418.png "Bild: Eingabeaufforderung") 8. Öffnen Sie Windows-Dienste und starten Sie *Episerver Campaign Integration Service*. :::hint{type="info"} **Note** Wenn Sie die Konfiguration aktualisieren oder ändern möchten, müssen Sie den Konnektor zuerst über Windows-Dienste stoppen. ::: ## Konnektor konfigurieren In der Datei *IntegrationService.exe.config* können Sie die folgenden Parameter für die Datenübertragung anpassen. | Parameter | Beschreibung | Standardwert | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | | MaxSendRetries | Anzahl der Versuche, ein Empfängerpaket zu übermitteln, wenn ein Versuch z. B. durch eine Zeitüberschreitung fehlschlägt. | 3 | | TimeoutCrmConnection | Maximale Dauer in Sekunden für die Übermittlung eines Empfängerpakets vom CRM zum Dienst, bevor ein Zeitüberschreitungsfehler auftritt. | 60 | | TimeoutEpiserverConnection | Maximale Dauer in Sekunden für die Übermittlung eines Empfängerpakets vom Dienst zu Optimizely Campaign, bevor ein Zeitüberschreitungsfehler auftritt. | 120 | | UseSoapServiceForRecipientLists | Wahl zwischen Datenübertragung mittels SOAP- oder REST-API. Standardmäßig wird die REST-API verwendet. | false | | BatchSize | Größe des Empfängerpakets bei der Übertragung vom Dienst zu Optimizely Campaign. Bei der Übertragung mittels SOAP-API beträgt der maximale Wert *1000*. | 5000 | | CrmBatchSize | Größe des Empfängerpakets bei der Übertragung vom CRM zum Dienst. | 1000 | | MaxThreads | Anzahl der parallelen Threads bei der Übertragung mittels API. Die maximale Anzahl beträgt *6*. | 5 | ## Konfiguration in Microsoft Dynamics CRM 1. Wählen Sie in Microsoft Dynamics CRM unter **Einstellungen** > **Konfigurationen**. ![Bild: Konfigurationen](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/tSBFt2LaIWC5jIIWFJOAh-20260720-145418.png "Bild: Konfigurationen") 2. Klicken Sie auf **Neu**. 3. Geben Sie als Namen *Use Windows Service* ein. ![Bild: Namen eingeben](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Llsw8wrDkMHiIP38t9lAq-20260720-145418.png "Bild: Namen eingeben") :::hint{type="info"} **Tip** Sie können das Feld **Wert** frei lassen. Es ist keine Definition erforderlich. ::: 4. Klicken Sie auf **Speichern und Schließen**. ![Bild: Konfiguration speichern](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/zLpWKED8sv9Z4xACACuxc-20260720-145418.png "Bild: Konfiguration speichern") ## Wartung und Fehlersuche Mit dem Tool **Hangfire** können Sie geplante, laufende und ausgeführte Workflows einsehen und verwalten. Sie installieren Hangfire automatisch mit dem Konnektor und können das Tool im Webbrowser unter der folgenden Adresse aufrufen: *http\://localhost*:20000*/hangfire*. Um die **Protokolldaten** des Dienstes einzusehen, öffnen Sie im Verzeichnis *logs* die Datei *logs.txt*. Die Protokolldaten der vergangenen Tage finden Sie im Verzeichnis *archives*. ## Deinstallation Um den erweiterten Empfängerlisten-Konnektor zu deinstallieren und vollständig zu entfernen, gehen Sie wie folgt vor: :::hint{type="info"} **Note** Der erweiterte Empfängerlisten-Konnektor muss inaktiv sein. Öffnen Sie Windows-Dienste und stoppen Sie *Episerver Campaign Integration Service*. ::: 1. Öffnen Sie die Eingabeaufforderung als Administrator. 2. Geben Sie den Konnektor-Pfad ein und deinstallieren Sie die Datei *Integrationservice.exe* mit der Aufforderung `integrationservice.exe uninstall`. ![Bild: Eingabeaufforderung](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/WvCp6ufcyvijWm81RUhwc-20260720-145418.png "Bild: Eingabeaufforderung") :::hint{type="info"} **Tip** Das Installationsverzeichnis bleibt weiterhin bestehen. Löschen Sie das Verzeichnis inklusive der Protokolldaten. ::: 3. Wählen Sie in Microsoft Dynamics CRM unter **Einstellungen** > **Konfigurationen**. ![Bild: Konfigurationen](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/iwN0HA0jncuFoJip_3D5q-20260720-145418.png "Bild: Konfigurationen") 4. Wählen Sie den Konfigurationsdatensatz *Use Windows Service* aus und klicken Sie auf **Löschen**. ![Bild: Konfiguration löschen](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Imi_ypZsUou_xH3T4uWYO-20260720-145418.png "Bild: Konfiguration löschen")