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

In der Tabelle sind die Variablen aufgeführt und definiert, die in einer ordnungsgemäß formatierten eingehenden Datendatei verwendet werden. Eine kursive Formatierung gibt einen Variablenplatzhalter an.
Variable Beschreibung
Benutzer-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 und nicht mit Hashing versehen sein. Beispiel: 97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
Trennen Sie die Benutzer-ID und die Eigenschaften-IDs durch ein Tabulatortrennzeichen.
Eigenschaften-ID
Die Eigenschaften-ID von Audience Manager . 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 .

Formatieren von Eigenschaften-IDs

In der folgenden Tabelle werden die Präfixe beschrieben, die Eigenschaftsnamen oder IDs in einer eingehenden Datendatei identifizieren. 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- Eigenschaftenkennung 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. Siehe Eigenschaften-API-Methoden .
d_unsid=
Daten mit dem Präfix d_unsid entfernen Benutzer aus dieser Eigenschaft. Das d_unsid- Präfix wird in einer Überschreibungsdatei ignoriert .
Das Präfix d_unsid= weist unser System darauf hin, dass die ID eine Audience Manager- Eigenschaftenkennung 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. Siehe Eigenschaften-API-Methoden .
ic=
Mit Eigenschaftsregeln können Sie Kriterien für die Eigenschaftsqualifikation festlegen. Wenn Sie eine Eigenschaftsregel als ic == Merkmal-ID formatieren, können Sie Eigenschaften in einer einfachen, kommageformatierten Liste senden.
Beispiel: Sie erstellen die folgenden 3 Eigenschaftenregeln:
  • ic == "123"
  • ic == "456"
  • ic == "789"
Diese Eigenschaften sind mit dem Schlüssel ic verknüpft. Auf diese Weise können Sie eine einfachere Eigenschaftenliste in der Datendatei erstellen. Außerdem müssen Sie das Präfix "ic"nicht einschließen. Der Inhalt Ihrer Datendatei könnte daher wie folgt aussehen:
                 Benutzer-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 = Wert
  • "key" = Wert
  • key = "value"
  • "key" = "value"
"age"="32" , "gender"=m , model = "pickup ruck" , product = tablet sind Beispiele für korrekt formatierte Schlüssel/Wert Paare.

Ungültige Zeichen in Eigenschaften-IDs, Benutzer-IDs und Schlüssel-Wert-Paaren

Eigenschaften-IDs

Eigenschaften-IDs bestehen nur aus numerischen Zeichen. Wir bitten Sie, nur Eigenschaften an Bord in eingehende Datendateien einzuschließen. Bei der eingehenden Datenübertragung werden keine anderen Eigenschaftsarten verarbeitet.

Anwender-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 und nicht mit Hashing versehen sein. 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 Anfang der Schlüssel. Beispiel: -product = camera wird als product = camera interpretiert .
TAB
Verwenden Sie in Schlüssel-Wert-Paaren nicht die TAB-Methode anstelle leerer Werte. Verwenden Sie TAB nur zur Trennung von Variablen in der eingehenden Datendatei.
\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 Eigenschaften auch mithilfe der folgenden Syntax aus Benutzerprofilen entfernen:
59767559181262060060278870901087098252&nbsp;28:0,&nbsp;29:0
59767559181262060060278870901087098252&nbsp;28:-1,&nbsp;29: -1
Mit ic=
Diese Eigenschaften wurden einer Eigenschaftsregel mit dem Präfix "ic" 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 Präfix ic ist in der Datei nicht erforderlich.
Numerische IDs
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1&nbsp;&nbsp;30608,50354,50338,50352,30 626
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 zu übermitteln .
59767559181262060060278870901087098252&nbsp;"gender"="women","luxuriöse_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 folgende Diagramm zeigt Beispiele für die richtige Formatierung Ihrer Inbound-Dateien, je nach Typ der IDs und der Methode, mit der Sie Eigenschaften zu Profilen hinzufügen möchten.
ID-Typ/Vorgang Mit d_sid Eigenschaften zu einem Benutzerprofil hinzufügen Mit d_unsid können Sie Eigenschaften aus einem Benutzerprofil entfernen Senden Sie Schlüsselwertpaare, 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)

Example 1

Verwenden Sie Eigenschaften-IDs, um Informationen zur Eigenschaftsqualifikation für Audience Manager-UUIDs zu senden.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

Example 2

Verwenden Sie Eigenschafts-IDs, um Informationen zum Ausschluss von Eigenschaften für Audience Manager-UUIDs zu senden.
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 Eigenschaften-Qualifizierungsinformationen für Audience Manager-UUIDs hinzuzufügen.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

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

Example 4

Verwenden Sie das Präfix "ic", um Informationen zur Eigenschaftsqualifikation für Audience Manager-UUIDs zu senden.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

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

Example 5

Verwenden Sie Eigenschaften-IDs, um Informationen zur Eigenschaftsqualifikation für Android-Geräte zu senden.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 6

Verwenden Sie Eigenschafts-IDs, um Informationen zum Verlust von Eigenschaften für Android-Geräte zu senden.
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 Eigenschaften-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 Präfix "ic", um Informationen zur Eigenschaftsqualifikation 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 Eigenschaften-IDs, um Informationen zur Eigenschaftsqualifikation für iOS-Geräte zu senden.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

Example 10

Verwenden Sie Eigenschaften-IDs, um Informationen zum Identitätsverlust für iOS-Geräte zu senden.
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 Eigenschaften-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 Präfix "ic", um Informationen zur Eigenschaftsqualifikation 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 Eigenschaften-IDs, um Informationen zur Eigenschaftsqualifikation für DPUUIDs zu senden.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

Example 14

Verwenden Sie Eigenschafts-IDs, um Informationen zum Ausschluss von Eigenschaften für DPUUIDs zu senden.
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 Eigenschaften-Qualifizierungsinformationen für DPUUIDs hinzuzufügen.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

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

Example 16

Verwenden Sie das Präfix "ic", um Informationen zur Eigenschaftsqualifikation für DPUUIDs zu senden.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

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