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 wurden die Symbole < > hinzugefügt, um die einzelnen Elemente 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 Unique User-ID, die von Audience Manager ( Audience Manager-UUID) zugewiesen wird.
  • Eine eindeutige Benutzer-ID, die in Ihrem CRM-System zugewiesen ist ( DPUUID, in Audience Manager).
  • Eine Android- oder iOS-Mobilgerä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 mit Hashing geschrieben sein. Beispiel: 97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
Trennen Sie die Benutzer-ID und die Eigenschafts-IDs durch ein Tabulator-Trennzeichen.
trait ID

Die Kennung der Eigenschaft Audience Manager . Wir möchten Sie bitten, nur integrierte Eigenschaften in eingehende Datendateien aufzunehmen. Bei der eingehenden Datenübertragung werden keine anderen Eigenschaftstypen verarbeitet.

Hinweis: Die Eigenschaften-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, mit denen trait -Namen oder -IDs in einer eingehenden Datendatei identifiziert werden. Beispiele finden Sie in den Beispieldateien .

Präfix
Beschreibung
d_sid=
Das Präfix d_sid teilt unserem System mit, dass die ID eine Audience Manager -Eigenschafts-ID ist. Hierbei handelt es sich um dieselbe ID, die auch in der Benutzeroberfläche angezeigt wird. Sie können Eigenschaften-IDs auch mit der API GET -Methode zurückgeben. Siehe API-Methoden für Eigenschaften.
d_unsid=

Daten mit dem Präfix d_unsid entfernen Benutzer aus dieser Eigenschaft. Das Präfix d_unsid wird in einer overwrite -Datei ignoriert.

Das Präfix d_unsid= teilt unserem System mit, dass die ID eine Audience Manager -Eigenschafts-ID ist. Hierbei handelt es sich um dieselbe ID, die auch in der Benutzeroberfläche angezeigt wird. Sie können Eigenschaften-IDs auch mit der API GET -Methode zurückgeben. Siehe API-Methoden für Eigenschaften.

ic=

Eigenschaftsregelnermöglichen es Ihnen, Kriterien für die Eigenschaftsqualifizierung festzulegen. Wenn Sie eine Eigenschaftsregel als ic == trait ID formatieren, 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 dem Schlüssel ic verknüpft. Auf diese Weise können Sie eine einfachere Eigenschaftsliste in der Datendatei erstellen. Außerdem müssen Sie das Präfix ic nicht einbeziehen. Daher könnte der Inhalt Ihrer Datendatei 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 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 den Paaren Trait IDs, User IDs und Schlüssel-Wert invalid-chars

Trait IDs

Trait IDs besteht nur aus numerischen Zeichen. Wir möchten Sie bitten, nuronboarded traits in die eingehenden Datendateien aufzunehmen. Bei der eingehenden Datenübertragung werden keine anderen trait-Typen verarbeitet.

User IDs

ID-Typ
Anforderung
DPUUID
Verwenden Sie in DPUUIDs kein kodiertes Doppelpunkt ( %3A )- oder nicht kodiertes Doppelsymbol ( : ).
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 mit Hashing geschrieben 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. Beispielsweise wird -product = camera als product = camera interpretiert.
TAB
Verwenden Sie nicht TAB anstelle leerer Werte in Schlüssel-Wert-Paaren. Verwenden Sie TAB nur, um Variablen in der eingehenden Datendatei zu trennen.
\n, \t
Verwenden Sie nicht die neue Zeile oder 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 dem Präfix ic hinzugefügt. Daher können Sie sie wie unten gezeigt durch Kommas getrennt zur Datendatei hinzufügen. Eine Registerkarte trennt die UUID und die Eigenschaften-IDs. Das Präfix ic 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 Audience Manager zu übergeben.

59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”

Laden Sie die Beispieldatendatei herunter, wenn Sie weitere Beispiele benötigen. Die Download-Datei hat die Dateierweiterung ".overwrite". Sie können sie mit einem einfachen Texteditor öffnen.

Beispielmatrix examples-matrix

Die folgende Tabelle zeigt Beispiele für die korrekte Formatierung Ihrer eingehenden Dateien, je nach dem Typ der IDs und der Methode, mit der Sie traits zu Profilen hinzufügen möchten.

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

Verwenden Sie trait IDs , um trait Qualifizierungsinformationen für Audience Manager UUIDs zu senden.

59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27

Beispiel 2 example-2

Verwenden Sie trait IDs , um trait disqualifikationsbezogene Informationen 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

Beispiel 3 example-3

Senden Sie Schlüssel-Wert-Paare, um trait Qualifizierungsinformationen für Audience Manager UUIDs hinzuzufügen.

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

oder

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

Beispiel 4 example-4

Verwenden Sie das Präfix ic , um trait Qualifizierungsinformationen für Audience Manager UUIDs zu senden.

59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626

oder

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

Beispiel 5 example-5

Verwenden Sie trait IDs , um trait Qualifizierungsinformationen für Android Geräte zu senden.

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26

Beispiel 6 example-6

Verwenden Sie trait IDs , um trait disqualifikationsbezogene Informationen 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

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

Beispiel 8 example-8

Verwenden Sie das Präfix ic , um trait Qualifizierungsinformationen 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

Beispiel 9 example-9

Verwenden Sie trait IDs , um trait Qualifizierungsinformationen für iOS Geräte zu senden.

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26

Beispiel 10 example-10

Verwenden Sie trait IDs , um trait disqualifikationsbezogene Informationen 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

Beispiel 11 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"

Beispiel 12 example-12

Verwenden Sie das Präfix ic , um trait Qualifizierungsinformationen 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

Beispiel 13 example-13

Verwenden Sie trait IDs , um trait Qualifizierungsinformationen für DPUUIDs zu senden.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26

Beispiel 14 example-14

Verwenden Sie trait IDs , um trait disqualifikationsinformationen 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

Beispiel 15 example-15

Senden Sie Schlüssel-Wert-Paare, um trait Qualifizierungsinformationen für DPUUIDs hinzuzufügen.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

oder

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

Beispiel 16 example-16

Verwenden Sie das Präfix ic , um trait Qualifizierungsinformationen für DPUUIDs zu senden.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626

oder

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695