Inhalt der eingehenden Datendatei: Syntax, ungültige Zeichen, Variablen und Beispiele

Erforderliche Felder, Syntax und Regeln, die Sie bei der Formatierung einer eingehenden Eigenschaftendatendatei befolgen sollten.

Syntax des Dateiinhalts

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.

HINWEIS

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.

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

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=

Eigenschaftsregeln kö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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Verwendung trait IDs zum Senden trait Qualifizierungsinformationen für DPUUIDs.

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

Beispiel 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

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

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

Auf dieser Seite