Show Menu
THEMEN×

Inhalt der eingehenden Datendatei: Syntax, ungültige Zeichen, Variablen und Beispiele

Erforderliche Felder, Syntax und Regeln, die Sie beim Formatieren einer eingehenden Eigenschaftendatendatei beachten sollten.

Syntax des Dateiinhalts

Die Felder in der eingehenden Datendatei müssen in der unten stehenden Reihenfolge angezeigt werden. In diesem Beispiel wurden die <``> Symbole hinzugefügt, 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 verworfen. Im folgenden Beispiel sind Sie gut, weil Sie jeweils 3 Zeilen für Benutzer-ID 1 und Benutzer-ID 2 senden. Wir erzwingen keine Begrenzung der Anzahl der Eigenschaften oder Schlüssel-Wert-Paare, die Sie in eine Zeile einbeziehen.
<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>

Definierte Dateivariablen

Die Tabelle Liste und definiert die Variablen, die in einer ordnungsgemäß formatierten eingehenden Datendatei verwendet werden. Eine kursive Formatierung gibt einen Variablenplatzhalter an.
Variable Beschreibung
User ID
Eine Benutzer-ID kann:
  • Eine eindeutige Benutzer-ID, die von Audience Manager zugewiesen wird ( 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 ihrem ursprünglichen, unveränderten Formular, wie vom mobilen Betriebssystem verfügbar.
Für mobile IDs:
  • IDFA-Format: IDs müssen in Großbuchstaben und nicht mit Hashing versehen sein. Beispiel, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Android-Format: IDs müssen in Kleinbuchstaben vorliegen und dürfen nicht mit Hashing versehen werden. Beispiel, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
Trennen Sie die Benutzer-ID und die Eigenschaften-IDs durch ein Tabulatortrennzeichen.
trait ID
Die Audience Manager- Eigenschaften-ID. Wir bitten Sie, nur Eigenschaften an Bord in eingehende Datendateien einzuschließen. Bei der eingehenden Datenübertragung werden keine anderen Eigenschaftsarten verarbeitet.
Hinweis: Die Eigenschaften-ID kann mithilfe der GET-Methode gefunden werden, die Details zu all Ihren Eigenschaften zurückgibt. Weitere Informationen finden Sie unter Eigenschaften-API-Methoden .

Formatierung Trait IDs

In der folgenden Tabelle werden die Präfixe beschrieben, mit denen trait Namen oder IDs in einer eingehenden Datendatei identifiziert werden. Beispiele finden Sie in den Beispieldateien .
Präfix Beschreibung
d_sid=
Das d_sid Präfix weist unser System darauf hin, dass die ID eine Audience Manager- Eigenschafts-ID ist. Dies ist die gleiche ID, die auf der Benutzeroberfläche angezeigt wird. Sie können Eigenschaften-IDs auch mit der API- GET Methode zurückgeben. See Trait API Methods .
d_unsid=
Daten mit dem Präfix d_unsid entfernen Benutzer aus dieser Eigenschaft. Das d_unsid Präfix wird in einer overwrite Datei ignoriert.
Das d_unsid= Präfix weist unser System darauf hin, dass die ID eine Audience Manager- Eigenschafts-ID ist. Dies ist die gleiche ID, die auf der Benutzeroberfläche angezeigt wird. Sie können Eigenschaften-IDs auch mit der API- GET Methode zurückgeben. See Trait API Methods .
ic=
Mit Eigenschaftsregeln können Sie Kriterien für die Eigenschaftsqualifikation festlegen. Wenn Sie eine Eigenschaftsregel wie ic == trait ID folgt formatieren, können Sie Eigenschaften in einer einfachen, kommagetrennten Liste senden.
Beispiel: Sie erstellen die folgenden 3 Eigenschaftenregeln:
  • ic == "123"
  • ic == "456"
  • ic == "789"
Diese Eigenschaften sind mit dem ic Schlüssel verknüpft. Auf diese Weise können Sie eine einfachere Liste der Eigenschaften in der Datendatei erstellen. Außerdem müssen Sie das ic Präfix nicht einschließen. Der Inhalt Ihrer Datendatei könnte daher wie folgt aussehen:
                 user ID  <TAB> 123,456,789
Schlüsselwertpaare
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 nachfolgend gezeigt:
  • key = value
  • "key" = value
  • key = "value"
  • "key" = "value"
"age"="32" , "gender"=m , model = "pickup truck" , product = tablet sind Beispiele für korrekt formatierte Schlüssel-Wert-Paare.

Ungültige Zeichen in Trait IDsund User IDs Schlüsselwertpaaren

Trait IDs

Trait IDs bestehen nur aus numerischen Zeichen. Wir bitten Sie, nuronboarded traits ​in eingehende Datendateien einzuschließen. Wir verarbeiten keine anderentraitArten der eingehenden Datenübertragung.

User IDs

ID-Typ Anforderung
DPUUID
Verwenden Sie keinen kodierten Doppelpunkt ( %3A ) oder nicht kodierten Doppelpunkt ( : ) in DPUUIDs.
iOS (IDFA) oder Android-Geräte-ID
Mobilgeräte-IDs müssen wie folgt streng formatiert sein:
  • IDFA-Format: IDs müssen in Großbuchstaben und nicht mit Hashing versehen sein. Beispiel, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Android-Format: IDs müssen in Kleinbuchstaben vorliegen und dürfen nicht mit Hashing versehen werden. Beispiel, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21

Schlüsselwertpaare

Auch falsch formatierte Wertnamen in einem Schlüssel-Wert-Paar verursachen Probleme. Beachten Sie beim Erstellen oder Benennen des Werts in einem Schlüssel-Wert-Paar die folgenden Regeln:
Zeichen Anforderung
Anführungszeichen (")
Sie können das Anführungszeichen im Schlüssel und im Werteteil des Schlüsselwertpaars wie folgt verwenden:
  • d_city = "New York", d_city = "San Francisco"
  • "d_city" = "New York", "d_city" = "San Francisco"
Bindestrich (-)
Wir ignorieren Bindestriche am Beginn der Schlüssel. Zum Beispiel -product = camera wird als product = camera .
TAB
Verwenden Sie in Schlüssel-Wert-Paaren nicht TAB anstelle leerer Werte. Nur TAB zum Trennen von Variablen in der eingehenden Datendatei verwenden.
\n, \t
Verwenden Sie die neuen Zeilen- oder Tabulatorzeichen ( \n, \t ) nicht in Schlüsseln oder Werten.

Beispiele für Datendateien

Datendateiformat Beschreibung und Beispiel
Mit d_sid oder d_unsid
Diese Datendatei zeigt einen Benutzer, der für die Eigenschaften 24, 26, 27 qualifiziert ist, und wurde aus den Eigenschaften 28 und 29 entfernt.
59767559181262060060278870901087098252&nbsp;&nbsp;d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29
Hinweis:
Statt d_unsid zu verwenden, können Sie auch Eigenschaften aus Profilen entfernen, indem Sie die folgende Syntax verwenden:
59767559181262060060278870901087098252&nbsp;28:0,&nbsp;29:0
59767559181262060060278870901087098252&nbsp;28:-1,&nbsp;29:-1
Mit ic==
Diese Eigenschaften wurden einer Eigenschaftsregel mit dem ic Präfix hinzugefügt. Daher können Sie sie der Datendatei durch Kommas wie gezeigt hinzufügen. Eine Registerkarte trennt die UUID und die Eigenschaften-IDs. Das ic Präfix ist in der Datei nicht erforderlich.
Numerische IDs
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;30608,50354,50338,50352,30626
String-IDs
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;ic=52,ic=55
Mit Schlüssel-Wert-Paaren
Diese Dateidaten verwenden Schlüssel-Wert-Paare, um Daten an Audience Manager weiterzugeben .
59767559181262060060278870901087098252&nbsp;“gender”=”female”,“luxury_shopper”=”yes”
Laden Sie die Musterdatendatei herunter, wenn Sie weitere Beispiele benötigen. Die Download-Datei hat eine .overwrite Dateierweiterung. Sie können es mit einem einfachen Texteditor öffnen.

Beispielmatrix

Das unten stehende Diagramm zeigt Beispiele für die richtige Formatierung Ihrer Inbound-Dateien, je nach Typ der IDs und der Methode, mit der Sie Profilen traits hinzufügen möchten.
ID-Typ/Vorgang Verwenden Sie d_sid, um Eigenschaften zu einem Profil hinzuzufügen Mit d_unsid können Sie Eigenschaften aus einem Profil entfernen Senden Sie Schlüssel-Wert-Paare, um Eigenschaften zu einem Profil hinzuzufügen Verwenden Sie das Präfix "ic", um Eigenschaften zu einem Profil 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)

Example 1

Verwenden Sie trait IDs zum Senden von trait Qualifizierungsinformationen für UUIDs.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

Example 2

Verwenden Sie trait IDs zum Senden von trait Disqualifizierungsinformationen für 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

Example 3

Senden Sie Schlüssel-Wert-Paare, um trait Qualifizierungsinformationen hinzuzufügen UUIDs.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

oder
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"

Example 4

Verwenden Sie das ic Präfix, um trait Qualifizierungsinformationen zu senden UUIDs.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

oder
59767559181262060060278870901087098252 <TAB> ic=52,ic=55

Example 5

Verwenden Sie trait IDs zum Senden von trait Qualifizierungsinformationen für Android Geräte.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 6

Verwenden Sie trait IDs zum Senden von trait Informationen zum Ausschluss von Android Geräten.
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

Example 7

Senden Sie Schlüssel-Wert-Paare, um trait Qualifizierungsinformationen für Android Geräte hinzuzufügen.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone

oder
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"

Example 8

Verwenden Sie das ic Präfix, um trait Informationen zur Qualifizierung für Android Geräte zu senden.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626

oder
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55

Example 9

Verwenden Sie trait IDs zum Senden von trait Qualifizierungsinformationen für iOS Geräte.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

Example 10

Verwenden Sie trait IDs zum Senden von trait Informationen zum Ausschluss von iOS Geräten.
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

Example 11

Senden Sie Schlüssel-Wert-Paare, um trait Qualifizierungsinformationen für iOS Geräte hinzuzufügen.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone

oder
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"

Example 12

Verwenden Sie das ic Präfix, um trait Informationen zur Qualifizierung für iOS Geräte zu senden.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626

oder
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55

Example 13

Verwenden Sie trait IDs zum Senden von trait Qualifizierungsinformationen für DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 14

Verwenden Sie trait IDs zum Senden von trait Disqualifizierungsinformationen 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

Example 15

Senden Sie Schlüssel-Wert-Paare, um trait Qualifizierungsinformationen hinzuzufügen DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

oder
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"

Example 16

Verwenden Sie das ic Präfix, um trait Qualifizierungsinformationen zu senden DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

oder
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55