DokumentationAudience ManagerBenutzerhandbuch für Audience Manager

Inhalte eingehender Datendateien: Syntax, ungültige Zeichen, Variablen und Beispiele inbound-data-file-contents-syntax-invalid-characters-variables-and-examples

Last update: Fri Dec 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erforderliche Felder, Syntax und Regeln, die Sie beim Formatieren einer eingehenden Eigenschaftsdatendatei befolgen sollten.

Syntax des Dateiinhalts file-content-syntax

Die Felder in der eingehenden Datendatei müssen in der unten angegebenen Reihenfolge angezeigt werden. In diesem Beispiel wurden die < > 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>,...

Informationen zu anderen akzeptierten Dateiinhaltsformaten finden Sie unter Benutzerdefinierte Partnerintegrationen.

NOTE
Für jede Benutzer-ID, die in der eingehenden Datendatei gesendet wird, können maximal 200 Zeilen verarbeitet werden. 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 die Benutzer-ID 1 und die Benutzer-ID 2 senden. Wir erzwingen keine Begrenzung für die Anzahl der Eigenschaften oder Schlüssel-Wert-Paare, die Sie in eine Zeile aufnehmen.
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>

Dateivariablen definiert file-variables-defined

In der folgenden Tabelle werden die Variablen aufgelistet 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 sein:

  • Eine eindeutige Benutzer-ID, die Audience Manager- zugewiesen wurde ( Audience Manager-UUID).
  • Eine eindeutige, Ihrem CRM-System zugewiesene Benutzer-ID ( DPUUID, im Audience Manager).
  • Eine Android- oder iOS-Geräte-ID für Mobilgeräte in ihrer ursprünglichen, unveränderten Form, wie sie vom Betriebssystem für Mobilgeräte bereitgestellt wird.

Für Mobile IDs:

  • IDFA-Format: IDs müssen in Großbuchstaben geschrieben und dürfen nicht gehasht werden. Beispiel: 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Android-Format: IDs müssen in Kleinbuchstaben geschrieben und dürfen nicht gehasht werden. Beispiel: 97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
Trennen Sie die Benutzer-ID und die Eigenschafts-IDs durch ein einzelnes Tabulatortrennzeichen.
trait ID

Der Audience Manager die Eigenschafts-ID. Wir bitten Sie (nur Onboarding-Eigenschaften in eingehende Datendateien einzubeziehen. Andere Eigenschaftstypen werden bei der eingehenden Datenübertragung nicht verarbeitet.

Hinweis: Die Eigenschafts-ID kann mithilfe der GET-Methode gefunden werden, die Details zu allen Eigenschaften zurückgibt. Weitere Informationen finden Sie unter für -Trait-API-Methoden .

Trait IDs formatting-trait-ids

Die folgende Tabelle beschreibt die Präfixe zur Identifizierung von trait oder IDs in einer eingehenden Datendatei. Beispiele finden Sie Beispieldateien.

Präfix
Beschreibung
d_sid=

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

d_unsid=

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

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

ic=

Mit -EigenschaftsregelnSie Kriterien für die Eigenschaftsqualifizierung festlegen. Wenn Sie eine Trait-Regel wie ic == trait ID formatieren, können Sie Traits in einer einfachen kommageformatierten Liste senden.

Angenommen, Sie erstellen diese 3 Eigenschaftsregeln:

  • ic == "123"
  • ic == "456"
  • ic == "789"

Diese Eigenschaften sind mit dem ic verknüpft. Auf diese Weise können Sie in der Datendatei eine einfachere Eigenschaftenliste erstellen. Und Sie müssen das ic Präfix nicht angeben. 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 mehrere 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 Beispiele für korrekt formatierte Schlüssel-Wert-Paare.

Ungültige Zeichen in Trait IDs, User IDs und Schlüssel-Wert-Paaren invalid-chars

Trait IDs

Trait IDs bestehen nur aus numerischen Zeichen. Wir bitten Sie, nuronboarded traits in eingehende Datendateien einzubeziehen. Bei der eingehenden Datenübertragung verarbeiten wir keine anderen trait.

User IDs

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

Die IDs von Mobilgeräten müssen streng formatiert sein, wie hier gezeigt:

  • IDFA-Format: IDs müssen in Großbuchstaben geschrieben und dürfen nicht gehasht werden. Beispiel: 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Android-Format: IDs müssen in Kleinbuchstaben geschrieben und dürfen nicht gehasht werden. Beispiel: 97987bca-ae59-4c7d-94ba-ee4f19ab8c21

Schlüssel-Wert-Paare

Falsch formatierte Wertnamen in einem Schlüssel-Wert-Paar verursachen ebenfalls 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 Wertteil des Schlüssel-Wert-Paares wie folgt verwenden:

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

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

Bindestrich (-)
Wir ignorieren Strichzeichen am Anfang der Schlüssel. Beispielsweise wird -product = camera als product = camera interpretiert.
TAB
Verwenden in Schlüssel-Wert-Paaren TAB statt leerer Werte. Verwenden Sie TAB nur, um Variablen in der eingehenden Datendatei zu trennen.
\n, \t
Verwenden Sie die neuen Zeilen- oder Tabulatorzeichen ( \n, \t ) nicht in Schlüsseln oder 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 auch Eigenschaften 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 in der Abbildung gezeigt, durch Kommas getrennt zur Datendatei hinzufügen. Eine Registerkarte trennt die UUID und die Eigenschafts-IDs. Das ic -Präfix ist in der Datei nicht erforderlich.

Numerische IDs

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  30608,50354,50338,50352,30626

Zeichenfolgen-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 SieBeispieldatendatei herunter, wenn Sie zusätzliche Beispiele benötigen. Die Download-Datei hat eine .overwrite Dateierweiterung. Sie können sie mit einem einfachen Texteditor öffnen.

Beispielmatrix examples-matrix

Das folgende Diagramm zeigt Beispiele für die korrekte Formatierung der eingehenden Dateien, abhängig vom ID-Typ und der Methode, mit der Sie traits zu Profilen hinzufügen möchten.

ID-Typ/Vorgang
Verwenden Sie d_sid, um einem Benutzerprofil Eigenschaften hinzuzufügen.
Verwenden Sie d_unsid, um Eigenschaften aus einem Benutzerprofil zu entfernen.
Senden von Schlüssel-Wert-Paaren, um einem Benutzerprofil Eigenschaften hinzuzufügen
Verwenden des IC-Präfix, um einem Benutzerprofil Eigenschaften 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 Informationen zum trait 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 ic-Präfix, 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 Informationen zur trait 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 ic Präfix, 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 Informationen zur trait 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 ic Präfix, 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 Informationen zum trait 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 ic Präfix, um trait Qualifizierungsinformationen für DPUUIDs zu senden.

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

oder

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