Inhalt der eingehenden Datendatei: Syntax, ungültige Zeichen, Variablen und Beispiele inbound-data-file-contents-syntax-invalid-characters-variables-and-examples
Erforderliche Felder, Syntax und Regeln, die Sie bei der Formatierung einer eingehenden Eigenschaftendatendatei befolgen sollten.
Syntax des Dateiinhalts file-content-syntax
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.
code language-none |
---|
|
Definierte Dateivariablen file-variables-defined
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.
User ID
Eine Benutzer-ID kann:
- Eine eindeutige Benutzer-ID, die von Audience Manager ( Audience Manager-UUID).
- Eine eindeutige Benutzer-ID, die in Ihrem CRM-System zugewiesen ist ( DPUUID, in Audience Manager).
- Eine mobile Android- oder iOS-Geräte-ID in ihrer ursprünglichen, unveränderten Form, wie sie vom mobilen Betriebssystem verfügbar gemacht wird.
Für mobile IDs:
- IDFA-Format: IDs müssen in Großbuchstaben und nicht gehasht sein. Beispiel,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Android-Format: IDs müssen in Kleinbuchstaben und nicht gehasht sein. Beispiel,
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
trait ID
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.
Formatierung Trait IDs formatting-trait-ids
In der folgenden Tabelle werden die Präfixe beschrieben, die trait Namen oder IDs in einer eingehenden Datendatei. Siehe Beispieldateien für Beispiele.
d_sid=
d_sid
-Präfix weist unser System an, dass die ID ein Audience Manager Eigenschafts-ID. Hierbei handelt es sich um dieselbe ID, die auch in der Benutzeroberfläche angezeigt wird. Sie können Eigenschaften-IDs auch mit der API zurückgeben GET
-Methode. Siehe API-Methoden für Eigenschaften.d_unsid=
Daten mit dem Präfix d_unsid
entfernt Benutzer aus dieser Eigenschaft. Die d_unsid
-Präfix wird in einer overwrite
-Datei.
Die d_unsid=
-Präfix weist unser System an, dass die ID ein Audience Manager Eigenschafts-ID. Hierbei handelt es sich um dieselbe ID, die auch in der Benutzeroberfläche angezeigt wird. Sie können Eigenschaften-IDs auch mit der API zurückgeben GET
-Methode. Siehe API-Methoden für Eigenschaften.
ic=
Eigenschaftsregelnkönnen Sie Kriterien für die Eigenschaftsqualifizierung festlegen. Wenn Sie eine Eigenschaftsregel als ic == trait ID
können Sie Eigenschaften in einer einfachen, kommagetrennten Liste senden.
Angenommen, Sie erstellen diese 3 Eigenschaftsregeln:
ic == "123"
ic == "456"
ic == "789"
Diese Eigenschaften sind mit der Variablen ic
Schlüssel. Auf diese Weise können Sie eine einfachere Eigenschaftsliste in der Datendatei erstellen. Außerdem müssen Sie die ic
-Präfix. Daher könnte der Inhalt Ihrer Datendatei wie folgt aussehen:
user ID <TAB> 123,456,789
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:
key = value
"key" = value
key = "value"
"key" = "value"
"age"="32"
, "gender"=m
, model = "pickup truck"
, product = tablet
sind alle Beispiele für korrekt formatierte Schlüssel-Wert-Paare.
Ungültige Zeichen in Trait IDs, User IDs und Schlüssel-Wert-Paare invalid-chars
Trait IDs
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.
User IDs
%3A
) oder nicht kodierter Doppelpunkt ( : ) in DPUUIDs.Mobilgeräte-IDs müssen wie im Folgenden gezeigt streng formatiert sein:
- IDFA-Format: IDs müssen in Großbuchstaben und nicht gehasht sein. Beispiel,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Android-Format: IDs müssen in Kleinbuchstaben und nicht gehasht sein. Beispiel,
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
Schlüssel-Wert-Paare
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:
Sie können das Anführungszeichen im Schlüssel- und im Wert-Teil des Schlüssel-Wert-Paares wie folgt verwenden:
-
d_city = "New York", d_city = "San Francisco"
-
"d_city" = "New York", "d_city" = "San Francisco"
-product = camera
interpretiert als product = camera
.TAB
TAB
anstelle von leeren Werten in Schlüssel-Wert-Paaren. Nur Verwendung TAB
, um die Variablen in der eingehenden Datendatei zu trennen.\n, \t
\n, \t
) in Schlüsseln oder in Werten.Beispiele für Datendateien data-file-examples
d_sid
oder d_unsid
Diese Datendatei zeigt einen Benutzer, der für die Eigenschaften 24, 26, 27 qualifiziert ist und aus den Eigenschaften 28 und 29 entfernt wurde.
59767559181262060060278870901087098252 d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29
Hinweis:
Anstatt d_unsid zu verwenden, können Sie Eigenschaften auch mithilfe der folgenden Syntax aus Benutzerprofilen entfernen:
59767559181262060060278870901087098252 28:0, 29:0
59767559181262060060278870901087098252 28:-1, 29:-1
ic==
Diese Eigenschaften wurden einer Eigenschaftsregel mit der Variablen ic
-Präfix. Daher können Sie sie wie unten gezeigt durch Kommas getrennt zur Datendatei hinzufügen. Eine Registerkarte trennt die UUID und die Eigenschaften-IDs. Die ic
-Präfix ist in der Datei nicht erforderlich.
Numerische IDs
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 30608,50354,50338,50352,30626
String-IDs
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 ic=52,ic=55
Diese Dateidaten verwenden Schlüssel-Wert-Paare, um Daten an zu übergeben. Audience Manager .
59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”
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.
Beispielmatrix examples-matrix
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.
Beispiel 1 example-1
Verwendung trait IDs zum Senden trait Qualifizierungsinformationen für Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
Beispiel 2 example-2
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
Beispiel 3 example-3
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"
Beispiel 4 example-4
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
Beispiel 5 example-5
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
Beispiel 6 example-6
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
Beispiel 7 example-7
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"
Beispiel 8 example-8
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
Beispiel 9 example-9
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
Beispiel 10 example-10
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
Beispiel 11 example-11
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"
Beispiel 12 example-12
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
Beispiel 13 example-13
Verwendung trait IDs zum Senden trait Qualifizierungsinformationen für DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
Beispiel 14 example-14
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
Beispiel 15 example-15
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"
Beispiel 16 example-16
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