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.
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 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
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 .
d_sid=
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
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
%3A
)- oder nicht kodiertes Doppelsymbol ( : ).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:
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
als product = camera
interpretiert.TAB
TAB
anstelle leerer Werte in Schlüssel-Wert-Paaren. Verwenden Sie TAB
nur, um 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 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
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.
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