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.

NOTE
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.
code language-none
<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 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.

Variable
Beschreibung
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
Trennen Sie die Benutzer-ID und die Eigenschafts-IDs durch ein Tabulator-Trennzeichen.
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.

Präfix
Beschreibung
d_sid=
Die 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

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:

  • 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

ID-Typ
Anforderung
DPUUID
Nicht Verwenden Sie einen kodierten Doppelpunkt ( %3A ) oder nicht kodierter Doppelpunkt ( : ) in DPUUIDs.
Mobile iOS (IDFA) oder Android-Geräte-ID

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:

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:

  • d_city = "New York", d_city = "San Francisco"

  • "d_city" = "New York", "d_city" = "San Francisco"

Dash-Zeichen (-)
Wir ignorieren Bindestriche am Anfang von Schlüsseln. Beispiel: -product = camera interpretiert als product = camera .
TAB
Nicht use TAB anstelle von leeren Werten in Schlüssel-Wert-Paaren. Nur Verwendung TAB , um die Variablen in der eingehenden Datendatei zu trennen.
\n, \t
Verwenden Sie nicht die neue Zeile oder die Tabulatorzeichen ( \n, \t ) in Schlüsseln oder in Werten.

Beispiele für Datendateien data-file-examples

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 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

Mit 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

Mit Schlüssel-Wert-Paaren

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.

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
Beispiel 1
Beispiel 2
Beispiel 3
Beispiel 4
Google Advertising ID für Android-Geräte
Beispiel 5
Beispiel 6
Beispiel 7
Beispiel 8
Apple IDFA für iOS-Geräte
Beispiel 9
Beispiel 10
Beispiel 11
Beispiel 12
Ihre eigene CRM-ID (DPUUID)
Beispiel 13
Beispiel 14
Beispiel 15
Beispiel 16

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
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695