Zusammenführen einer CarrierLookup-CSV mit ursprünglichen Kontaktdatensätzen
Ein praktischer Leitfaden für Datenteams zum Zusammenführen von CarrierLookup-CSV-Dateien mit Kontaktdaten unter Berücksichtigung von Anfragegrenzen.
Um eine CarrierLookup-CSV mit Kontaktdatensätzen zusammenzuführen, erstellen Sie vor dem Hochladen ein lokales Sidecar: Ordnen Sie jede vorbereitete, mit Ländercode versehene Nummer jeder ursprünglichen Kontakt-Zeilen-ID zu, die diese bereitgestellt hat.
Um eine CarrierLookup-CSV mit Kontaktdatensätzen zusammenzuführen, erstellen Sie vor dem Hochladen ein lokales Sidecar: Ordnen Sie jede vorbereitete, mit Ländercode versehene Nummer jeder ursprünglichen Kontakt-Zeilen-ID zu, die diese bereitgestellt hat. Übermitteln Sie nur vorbereitete Kennungen für das ausgewählte Land und gleichen Sie die zurückgegebene CSV-Datei anschließend anhand der Kennung ab, nicht anhand der Zeilenposition in der Datei. Dies bewahrt doppelte Kontakte, ohne vorzugeben, dass der Batch-Dienst für jeden Quelldatensatz eine Zeile zurückgibt.
Vorbereiten des Sidecars vor der Erstellung der Batch-Datei
Die Abfrage des ursprünglichen Netzbetreibers in Echtzeit von CarrierLookup gibt den ursprünglich zugewiesenen Netzbetreiber, den zugrunde liegenden Netzbetreiber, den Nummerntyp und die geografische Zuordnung zurück. Das separate Produkt für globale Netzbetreiberabfragen verarbeitet asynchrone Dateiaufgaben. Die Seite Globale Netzbetreiberabfrage ist der relevante Produktpfad. Batch-Aufträge akzeptieren einspaltige TXT- oder CSV-Dateien mit einer Nummer mit Ländercode pro Zeile und einem ausgewählten ISO-Land. Die vorbereitete Datei sollte im Wesentlichen für dieses ausgewählte Land bestimmt sein. Gehen Sie nicht davon aus, dass das Produkt XLSX-Dateien, gemischte Schemata oder Dateien mit CRM-Zeilen-IDs akzeptiert.
Ein CRM-Export aus der Quelle kann wiederholte Nummern, unterschiedliche Anzeigeformate, leere Werte und Nummern außerhalb des beabsichtigten Landes enthalten. Erstellen Sie vor der Übermittlung eine lokale Zuordnung von der kanonischen Nummer mit Ländercode zu einer Liste von Quell-Zeilen-IDs. Bewahren Sie den ursprünglichen Text und die Normalisierungsentscheidung zur Überprüfung neben jeder Zeile auf. Beispielsweise können sich zwei Kontakte eine geschäftliche Telefonanlage teilen; das Sidecar sollte beide Zeilen-IDs beibehalten, auch wenn die übermittelte Liste diese Nummer nur einmal enthält. Dies ist eine kundeneigene Datenstruktur und keine Spalte, die vom Batch-Produkt zurückgegeben wird.
Trennen Sie eine abgelehnte Quellzeile von einer ausgeschlossenen vorbereiteten Kennung. Eine Zeile kann vor dem Hochladen unbrauchbar sein, weil ihr der Kontext zur Normalisierung fehlt, während die Batch-Vorverarbeitung später Duplikate oder Nummern außerhalb des ausgewählten Landes ausschließen kann. Protokollieren Sie den Status eindeutig.
Verwenden Sie die Kennungsbedeutung, nicht die Zeilenposition, als Verknüpfungsschlüssel
Eine erfolgreiche Batch-Aufgabe gibt eine CSV-Datei mit einer Kennung und Feldern zur ursprünglichen Zuweisung zurück. Batch-Kennungen sind Ziffern mit Ländercode ohne Pluszeichen oder Leerzeichen. Das Quell-CRM speichert E.164-Nummern möglicherweise mit einem führenden Pluszeichen, nationaler Formatierung oder Satzzeichen. Normalisieren Sie beide Seiten in dieselbe kundeneigene Vergleichsform, bevor Sie sie zusammenführen, während Sie jede ursprüngliche Darstellung separat beibehalten. Gehen Sie nicht davon aus, dass die Reihenfolge der CSV-Zeilen mit der Reihenfolge der Kontaktzeilen übereinstimmt; die Vorverarbeitung kann ungültige oder doppelte Einträge ausschließen.
Die Verknüpfung ist eine n:1-Beziehung: Mehrere Kontaktzeilen können auf eine vorbereitete Nummer und eine zurückgegebene Abfragezeile verweisen. Erweitern Sie das Ergebnis erst nach der Validierung des Schlüssels wieder auf diese Quellzeilen. Wenn umgekehrt eine zurückgegebene Kennung im übermittelten Manifest fehlt, stellen Sie sie zur Überprüfung unter Quarantäne, anstatt sie der nächstgelegenen Zeile zuzuordnen. Dies ist eine Abgleichsregel und keine Behauptung, dass unerwartete Zeilen ein normales Produktverhalten darstellen.
Ein kompaktes Manifest kann die Quell-Zeilen-ID, den ursprünglichen Telefontext, den normalisierten Vergleichswert, das ausgewählte Land, den Namen der vorbereiteten Datei und die Referenz des Übermittlungs-Batches enthalten. Dies sind lokale Metadatenfelder. Sie dürfen nicht als CarrierLookup-CSV-Spalten beworben werden. Die API-Dokumentation sollte für die aktuelle Aufgabenübermittlung und Ergebnisdetails verwendet werden.
Überprüfen Sie Ausschlüsse und Duplikate vor der Aktualisierung von Datensätzen
Die Batch-Vorverarbeitung schließt ungültige Zeilen, Duplikate, Nummern ohne Ländercode und Nummern außerhalb des ausgewählten Landes aus. Ausgeschlossene Zeilen werden nicht berechnet. Aus diesem Grund können eine Upload-Zeilenanzahl, eine Anzahl vorbereiteter gültiger Nummern und eine Ergebnisanzahl voneinander abweichen. Gleichen Sie diese als drei separate Mengen ab. Füllen Sie den Netzbetreiber einer ausgeschlossenen Zeile nicht aus einer benachbarten Ausgabezeile auf. Wenn doppelte Quellkontakte sich eine normalisierte Nummer teilen, kann die Anwendung das eine abgeschlossene Ergebnis wieder beiden zuordnen, mit derselben Beobachtungszeit und Quelle.
Eine Aufgabe kann während der Vorbereitung fehlschlagen, wenn zu wenige gültige Mobilfunknummern geschätzt werden oder eine andere Akzeptanzbedingung nicht erfüllt ist. Erstellen Sie in diesem Fall keine Phantom-Ergebniszeilen aus der Eingabedatei. Bewahren Sie das Manifest zur Diagnose auf und konsultieren Sie die Produktdokumentation für die aktuellen Limits pro Produkt. Dieser Artikel nennt bewusst keine spezifischen Mindest- oder Höchstwerte für Aufgaben oder normale Fertigstellungszeiten. Die Batch-Aufgabe ist asynchron; warten Sie daher auf den Erfolg, bevor Sie deren CSV verwenden.
Die CSV-Felder beschreiben die ursprüngliche Zuweisung, nicht den aktuellen Netzbetreiber nach der Rufnummernmitnahme. Region und Stadt sind geografische Zuordnungsbereiche, nicht der Standort eines Kontakts. Eine abgeschlossene Zeile mit leeren Zuweisungsfeldern sollte eine abgeschlossene Zeile mit nicht verfügbaren Werten bleiben und nicht als ungültige Verknüpfung verworfen werden.
Erstellen Sie einen Abgleichsbericht vor dem CRM-Schreibvorgang
Der endgültige kundeneigene Bericht sollte übermittelte eindeutige Kennungen, zurückgegebene Kennungen, nicht übereinstimmende übermittelte Schlüssel, unerwartete zurückgegebene Schlüssel, Quellzeilen, deren Nummern vor dem Hochladen abgelehnt wurden, und doppelte Quellzeilen, die dasselbe Ergebnis erhalten, auflisten. Ein Prüfer sollte die Zusammenführungsrichtlinie für nicht übereinstimmende Fälle genehmigen, bevor Schreibvorgänge beginnen. Bewahren Sie die Roh-CSV und das Sidecar gemäß der eigenen Zugriffs- und Aufbewahrungsrichtlinie der Organisation auf, damit eine spätere Prüfung die Zuordnung reproduzieren kann.
Überprüfen Sie bei jeder CRM-Aktualisierung, ob der Kontakt noch dieselbe normalisierte Nummer trägt. Wenn sie sich während der Laufzeit der Aufgabe geändert hat, markieren Sie einen Konflikt, anstatt den aktuellen Datensatz mit veraltetem Netzbetreiberkontext zu überschreiben. Eine optionale Datensatzversionsprüfung kann die Integration des Kunden dabei unterstützen, diese Regel durchzusetzen; dies ist kein CarrierLookup-Feature. Speichern Sie die Abfragequelle und die Beobachtungszeit zusammen mit den Feldern zur ursprünglichen Zuweisung.
Führen Sie nach einem Testlauf eine Stichprobe durch: eine wiederholte Nummer, eine während der Vorbereitung ausgeschlossene Nummer, ein abgeschlossenes Ergebnis mit leeren Feldern und einen während der Aufgabe bearbeiteten Kontakt. Die erwarteten Ergebnisse sind eine bewusste n:1-Erweiterung, kein erfundenes Netzbetreiberergebnis, beibehaltene leere Werte und ein aufgeschobener Konflikt. Diese Validierung zielt auf das reale Risiko eines Datei-Workflows ab: die Zuordnung einer technisch korrekten Abfrage zum falschen Kontakt.
Wenn eine Quellzeile mehrere Telefonfelder enthält, protokollieren Sie, welches Feld die jeweilige vorbereitete Kennung generiert hat. Eine primäre Kontaktnummer und eine alternative Nummer sollten keine austauschbaren Netzbetreiberwerte erhalten. Das Sidecar kann dann erklären, warum eine abgeschlossene CSV-Zeile ein Feld aktualisiert, das andere jedoch unverändert gelassen hat, selbst wenn beide Werte zur selben Personen- oder Firmendatensatz gehören.
FAQ
Sollten Teams Batch-CSV-Zeilen nach Position zusammenführen?
Nein. Verwenden Sie die zurückgegebene Kennung mit Ländercode und eine lokale Sidecar-Zuordnung zu den Quell-Zeilen-IDs; die Vorverarbeitung kann Zeilen entfernen.
Wie sollten doppelte Kontakte mit einer Telefonnummer behandelt werden?
Bewahren Sie jede Quell-Zeilen-ID im Sidecar auf, übermitteln Sie die vorbereitete Kennung gegebenenfalls einmal und ordnen Sie das abgeschlossene Ergebnis bewusst jeder übereinstimmenden Zeile zu.
Was passiert mit einer während der Vorbereitung ausgeschlossenen Nummer?
Bewahren Sie sie in einem Ausschlussbericht auf und erfinden Sie kein Netzbetreiberergebnis für diese Quellzeile.
Kann die CSV das aktuelle Netzwerk oder den Standort eines Kontakts anzeigen?
Nein. Sie berichtet über den ursprünglichen Netzbetreiber und die geografische Zuordnung des Nummernkreises, was keine Fakten zum aktuellen Netzwerk oder zum Standort einer Person sind.
Weitere Informationen
Wählen Sie die Produktinformationen aus, die zum nächsten Schritt in Ihrem Workflow passen.