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 wurden die < > -Symbole 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>,...

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 ) zugewiesen wird.
  • 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 Eigenschaft-ID des Audience Managers . Wir möchten Sie bitten, nur integrierte Eigenschaften in eingehende Datendateien aufzunehmen. 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 Eigenschaften-API-Methoden .

Formatierung 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 unter Beispieldateien .

Präfix Beschreibung

d_sid=

Das Präfix d_sid weist unser System darauf hin, 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-Methode GET zurückgeben. Siehe Eigenschaften-API-Methoden .

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= weist unser System darauf hin, 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-Methode GET zurückgeben. Siehe Eigenschaften-API-Methoden .

ic=

Mit Eigenschaftsregeln können Sie Kriterien für die Eigenschaftsqualifikation festlegen. 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 nicht das Präfix ic einfügen. 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-Paaren

Trait IDs

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

User IDs

ID-Typ Anforderung

DPUUID

Verwenden Sie keinen kodierten Doppelpunkt ( %3A ) oder nicht kodierten Doppelpunkt ( : ) in DPUUIDs.

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. Zum Beispiel wird -product = camera als product = camera interpretiert.

TAB

Verwenden Sie in Schlüssel-Wert-Paaren nicht TAB anstelle von leeren Werten. Verwenden Sie TAB nur zum Trennen von Variablen in der eingehenden Datendatei.

\n, \t

Verwenden Sie nicht die neue Zeile oder 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 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”

[] (assets/ftp_dpm_1234_1445374061.overwrite) Laden Sie die Beispieldatendatei 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Auf dieser Seite