Erforderliche Felder, Syntax und Regeln, die Sie bei der Formatierung einer eingehenden Eigenschaftendatendatei befolgen sollten.
Die Felder in der eingehenden Datendatei müssen in der unten gezeigten Reihenfolge angezeigt werden. In diesem Beispiel wird die <
>
-Symbole hinzugefügt wurden, um jedes Element visuell zu trennen. Sie müssen diese nicht in Ihre Datendatei aufnehmen.
<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...
Weitere akzeptierte Dateiinhaltsformate finden Sie unter Benutzerdefinierte Partnerintegrationen.
Wir haben eine Grenze von 200 Zeilen, die wir für jede Benutzer-ID verarbeiten können, die in der eingehenden Datendatei gesendet wird. Wenn Sie beispielsweise 300 Zeilen für eine Benutzer-ID senden, werden die ersten 200 Zeilen beibehalten und die zusätzlichen 100 Zeilen werden verworfen. Im folgenden Beispiel sind Sie gut, da Sie jeweils 3 Zeilen für Benutzer-ID 1 und Benutzer-ID 2 senden. Wir erzwingen keine Beschränkung für die Anzahl der Eigenschaften oder Schlüssel-Wert-Paare, die Sie in eine Zeile einschließen.
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID1><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
<user ID2><TAB><trait ID>,<trait ID>,<trait ID>
In der Tabelle werden die Variablen aufgeführt und definiert, die in einer ordnungsgemäß formatierten eingehenden Datendatei verwendet werden. Eine kursive Formatierung gibt einen Variablenplatzhalter an.
Variable | Beschreibung |
---|---|
|
Eine Benutzer-ID kann:
Für mobile IDs:
|
|
Trennen Sie die Benutzer-ID und die Eigenschafts-IDs durch ein Tabulator-Trennzeichen. |
|
Die Audience Manager Eigenschafts-ID. Wir bitten Sie, nur integrierte Eigenschaften in eingehenden Datendateien. Bei der eingehenden Datenübertragung werden keine anderen Eigenschaftstypen verarbeitet.
Hinweis: Die Eigenschafts-ID kann mithilfe der GET-Methode gefunden werden, die Details zu allen Ihren Eigenschaften zurückgibt. Weitere Informationen finden Sie unter API-Methoden für Eigenschaften . |
In der folgenden Tabelle werden die Präfixe beschrieben, die trait Namen oder IDs in einer eingehenden Datendatei. Siehe Beispieldateien für Beispiele.
Präfix | Beschreibung |
---|---|
|
Die |
|
Daten mit dem Präfix Die |
|
Eigenschaftsregeln können Sie Kriterien für die Eigenschaftsqualifizierung festlegen. Wenn Sie eine Eigenschaftsregel als Angenommen, Sie erstellen diese 3 Eigenschaftsregeln:
Diese Eigenschaften sind mit der Variablen
|
Schlüssel-Wert-Paare |
Eigenschaftsdaten können mithilfe alphanumerischer Zeichenfolgen als Schlüssel-Wert-Paare formatiert werden. Es gibt verschiedene Möglichkeiten, Schlüssel-Wert-Paare zu formatieren, wie unten dargestellt:
"age"="32" , "gender"=m , model = "pickup truck" , product = tablet sind alle Beispiele für korrekt formatierte Schlüssel-Wert-Paare. |
Trait IDs bestehen nur aus numerischen Zeichen. Wir bitten Sie, onlyonboarded traits in eingehenden Datendateien. Wir verarbeiten keine anderen trait Typen in der eingehenden Datenübertragung.
ID-Typ | Anforderung |
---|---|
DPUUID |
Nicht Verwenden Sie einen kodierten Doppelpunkt ( |
Mobile iOS (IDFA) oder Android-Geräte-ID |
Mobilgeräte-IDs müssen wie im Folgenden gezeigt streng formatiert sein:
|
Auch falsch formatierte Wertnamen in einem Schlüssel-Wert-Paar verursachen Probleme. Befolgen Sie diese Regeln beim Erstellen oder Benennen des Werts in einem Schlüssel-Wert-Paar:
Zeichen | Anforderung |
---|---|
Anführungszeichen (") |
Sie können das Anführungszeichen im Schlüssel- und im Wert-Teil des Schlüssel-Wert-Paares wie folgt verwenden:
|
Dash-Zeichen (-) |
Wir ignorieren Bindestriche am Anfang von Schlüsseln. Beispiel: |
|
Nicht use |
|
Verwenden Sie nicht die neue Zeile oder die Tabulatorzeichen ( |
Datendateiformat | Beschreibung und Beispiel |
---|---|
Mit |
Diese Datendatei zeigt einen Benutzer, der für die Eigenschaften 24, 26, 27 qualifiziert ist und aus den Eigenschaften 28 und 29 entfernt wurde.
Hinweis: Anstatt d_unsid zu verwenden, können Sie Eigenschaften auch mithilfe der folgenden Syntax aus Benutzerprofilen entfernen:
|
Mit |
Diese Eigenschaften wurden einer Eigenschaftsregel mit der Variablen Numerische IDs
String-IDs
|
Mit Schlüssel-Wert-Paaren |
Diese Dateidaten verwenden Schlüssel-Wert-Paare, um Daten an zu übergeben. Audience Manager .
|
Download die Beispieldatendatei, wenn Sie zusätzliche Beispiele benötigen. Die Download-Datei verfügt über eine .overwrite
Dateierweiterung. Sie können sie mit einem einfachen Texteditor öffnen.
Die folgende Tabelle zeigt Beispiele für die richtige Formatierung Ihrer eingehenden Dateien, je nach ID-Typ und der Methode, mit der Sie hinzufügen möchten traits in Profile.
ID-Typ/Vorgang | Verwenden Sie d_sid, um Eigenschaften zu einem Benutzerprofil hinzuzufügen. | Verwenden Sie d_unsid, um Eigenschaften aus einem Benutzerprofil zu entfernen. | Senden von Schlüssel-Wert-Paaren, um Eigenschaften zu einem Benutzerprofil hinzuzufügen | Verwenden Sie das Präfix "ic", um Eigenschaften zu einem Benutzerprofil hinzuzufügen. |
---|---|---|---|---|
Audience Manager-UUID |
||||
Google Advertising ID für Android-Geräte |
||||
Apple IDFA für iOS-Geräte |
||||
Ihre eigene CRM-ID (DPUUID) |
Verwendung trait IDs zum Senden trait Qualifizierungsinformationen für Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
Verwendung trait IDs zum Senden trait disqualifikationsinformationen für Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_unsid=24, d_unsid=26, d_unsid=27
oder
59767559181262060060278870901087098252 <TAB> 24:0, 26:0, 27:0
oder
59767559181262060060278870901087098252 <TAB> 24:-1, 26:-1, 27:-1
Senden von Schlüssel-Wert-Paaren zum Hinzufügen trait Qualifizierungsinformationen für Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
oder
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
Verwenden Sie die ic
Präfix zum Senden trait Qualifizierungsinformationen für Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
oder
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
Verwendung trait IDs zum Senden trait Qualifizierungsinformationen für Android Geräte.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
Verwendung trait IDs zum Senden trait disqualifikationsinformationen für Android Geräte.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_unsid=24, d_unsid=25, d_unsid=26
oder
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:0, 26:0, 27:0
oder
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:-1, 26:-1, 27:-1
Senden von Schlüssel-Wert-Paaren zum Hinzufügen trait Qualifizierungsinformationen für Android Geräte.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
oder
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
Verwenden Sie die ic
Präfix zum Senden trait Qualifizierungsinformationen für Android Geräte.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626
oder
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55
Verwendung trait IDs zum Senden trait Qualifizierungsinformationen für iOS Geräte.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
Verwendung trait IDs zum Senden trait disqualifikationsinformationen für iOS Geräte.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_unsid=24, d_unsid=25, d_unsid=26
oder
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:0, 26:0, 27:0
oder
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:-1, 26:-1, 27:-1
Senden von Schlüssel-Wert-Paaren zum Hinzufügen trait Qualifizierungsinformationen für iOS Geräte.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
oder
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
Verwenden Sie die ic
Präfix zum Senden trait Qualifizierungsinformationen für iOS Geräte.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626
oder
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55
Verwendung trait IDs zum Senden trait Qualifizierungsinformationen für DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
Verwendung trait IDs zum Senden trait disqualifikationsinformationen für DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_unsid=24, d_unsid=25, d_unsid=26
oder
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:0, 26:0, 27:0
oder
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:-1, 26:-1, 27:-1
Senden von Schlüssel-Wert-Paaren zum Hinzufügen trait Qualifizierungsinformationen für DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
oder
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
Verwenden Sie die ic
Präfix zum Senden trait Qualifizierungsinformationen für DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
oder
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55