DocumentatieAudience ManagerAudience Manager-gebruikershandleiding

Inbound Data File Contents: Syntax, Invalid Characters, Variables en Examples inbound-data-file-contents-syntax-invalid-characters-variables-and-examples

Last update: Tue Aug 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

De vereiste gebieden, syntaxis, en regels u zouden moeten volgen wanneer het formatteren van een binnenkomend dossier van eigenschapsgegevens.

Syntaxis bestandsinhoud file-content-syntax

De velden in het binnenkomende gegevensbestand moeten in de hieronder getoonde orde verschijnen. In dit voorbeeld zijn de symbolen < > toegevoegd om elk element visueel te kunnen scheiden. U hoeft deze niet op te nemen in het gegevensbestand.

<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...

Voor andere toegelaten formaten van de dossierinhoud, zie {de Integraties van de Partner van 0} Douane .

NOTE
We hebben een limiet van 200 regels die we kunnen verwerken voor elke gebruikersnaam die in het binnenkomende gegevensbestand wordt verzonden. Als u bijvoorbeeld 300 regels verzendt voor een gebruikers-id, worden de eerste 200 regels bewaard en worden de extra 100 regels verwijderd. In het onderstaande voorbeeld kun je het beste drie regels verzenden voor gebruikers-id 1 en gebruikersnaam 2. Wij dwingen geen grens op het aantal eigenschappen of zeer belangrijke paren af u in een lijn omvat.
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>

Bestandsvariabelen gedefinieerd file-variables-defined

De tabel bevat een lijst met en definieert de variabelen die worden gebruikt in een bestand met correct opgemaakte binnenkomende gegevens. Cursief wijst op veranderlijke placeholder.

Variabele
Beschrijving
User ID

Een gebruikersnaam kan:

  • Een unieke gebruikersnaam die is toegewezen door Audience Manager ( Audience Manager UUID).
  • Een unieke gebruikersnaam die is toegewezen in uw CRM-systeem ( DPUUID, in Audience Manager).
  • Een mobiele Android- of iOS-apparaat-id in de oorspronkelijke, ongewijzigde vorm zoals deze door het mobiele besturingssysteem wordt weergegeven.

Voor mobiele id's:

  • IDFA-indeling: id's moeten hoofdletters en kleine letters zijn en geen hashed. Bijvoorbeeld: 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Android-indeling: id's moeten kleine letters zijn en geen hashing. Bijvoorbeeld: 97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
Scheid de gebruikers-id en de gebruikers-id met één tabscheidingsteken.
trait ID

De standaard-id voor Audience Manager . Wij vragen dat u slechts ongebogen eigenschappen in binnenkomende gegevensdossiers omvat. We verwerken geen andere typen eigenschappen in de binnenkomende gegevensoverdracht.

Opmerking: de Trait-id kunt u vinden met de GET-methode die details retourneert over al je kenmerken. Zie Trait API-methodenvoor meer informatie.

Opmaak Trait IDs formatting-trait-ids

In de volgende tabel worden de voorvoegsels beschreven die trait namen of id's in een binnenkomend gegevensbestand identificeren. Zie de steekproefdossiersvoor voorbeelden.

Voorvoegsel
Beschrijving
d_sid=
Het voorvoegsel d_sid vertelt ons systeem dat de id een Audience Manager -kenmerk-id is. Dit is dezelfde id die in de gebruikersinterface wordt weergegeven. U kunt ook doel-id's retourneren met de API GET -methode. Zie Trait API-methoden.
d_unsid=

Gegevens die met d_unsid zijn voorafgegaan, verwijderen gebruikers van die eigenschap. Het voorvoegsel d_unsid wordt genegeerd in een overwrite -bestand.

Het voorvoegsel d_unsid= vertelt ons systeem dat de id een Audience Manager -kenmerk-id is. Dit is dezelfde id die in de gebruikersinterface wordt weergegeven. U kunt ook doel-id's retourneren met de API GET -methode. Zie Trait API-methoden.

ic=

Met de overtrekregelskunt u criteria instellen voor de kwalificatie van de eigenschap. Als u een regel met een kenmerk opmaakt als ic == trait ID , kunt u kenmerken in een eenvoudige lijst met komma's opmaken.

Stel bijvoorbeeld dat u deze drie regels voor de eigenschap maakt:

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

Deze kenmerken zijn gekoppeld aan de ic -toets. Zo kunt u een eenvoudigere lijst met eigenschappen maken in het gegevensbestand. U hoeft het voorvoegsel ic niet op te nemen. Hierdoor kan de inhoud van het gegevensbestand er als volgt uitzien:

                 user ID <TAB> 123,456,789

Sleutelwaardeparen

Trait-gegevens kunnen worden opgemaakt als sleutelwaardeparen met alfanumerieke tekenreeksen. Er zijn verschillende manieren om sleutelwaardeparen op te maken, zoals hieronder wordt getoond:

  • key = value
  • "key" = value
  • key = "value"
  • "key" = "value"

"age"="32" , "gender"=m , model = "pickup truck" , product = tablet zijn voorbeelden van correct opgemaakte sleutel-waardeparen.

Ongeldige tekens in Trait IDs -, User IDs - en sleutelwaardeparen invalid-chars

Trait IDs

Trait IDs bestaat alleen uit numerieke tekens. Wij vragen u om slechtsonboarded traits in binnenkomende gegevensdossiers op te nemen. Andere trait -typen in de binnenkomende gegevensoverdracht worden niet verwerkt.

User IDs

Type id
Vereiste
DPUUID
gebruik niet een gecodeerde dubbelepunt ( %3A ) of uncoded dubbelpunt (:) symbool in DPUUIDs.
Mobile iOS (IDFA) of Android-apparaat-id

Mobiele apparaat-id's moeten strikt zijn opgemaakt zoals hieronder wordt weergegeven:

  • IDFA-indeling: id's moeten hoofdletters en kleine letters zijn en geen hashed. Bijvoorbeeld: 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Android-indeling: id's moeten kleine letters zijn en geen hashing. Bijvoorbeeld: 97987bca-ae59-4c7d-94ba-ee4f19ab8c21

Belangrijke paren

Onjuist opgemaakte waardennamen in een sleutelwaardepaar veroorzaken ook problemen. Volg deze regels wanneer het creëren van of het noemen van de waarde in een zeer belangrijk-waardepaar:

Teken
Vereiste
Aanhalingsteken (")

U kunt het aanhalingsteken in de sleutel en in het waardegedeelte van sleutel-waardepaar als volgt gebruiken:

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

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

Streepje (-)
We negeren streepjesborden aan het begin van toetsen. -product = camera wordt bijvoorbeeld geïnterpreteerd als product = camera .
TAB
gebruik niet TAB in plaats van lege waarden in sleutel-waardeparen. Gebruik TAB alleen om variabelen in het binnenkomende gegevensbestand te scheiden.
\n, \t
Gebruik de nieuwe regel of tabtekens ( \n, \t ) niet in toetsen of in waarden.

Voorbeelden van gegevensbestanden data-file-examples

Gegevensbestandsindeling
Beschrijving en voorbeeld
Met d_sid of d_unsid

In dit gegevensbestand wordt een gebruiker weergegeven die is gekwalificeerd voor de kenmerken 24, 26, 27 en die is verwijderd uit kenmerk 28 en 29.

59767559181262060060278870901087098252  d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29

Opmerking:

In plaats van d_unsid te gebruiken, kunt u eigenschappen uit gebruikersprofielen ook verwijderen door de volgende syntaxis te gebruiken:

59767559181262060060278870901087098252 28:0, 29:0

59767559181262060060278870901087098252 28:-1, 29:-1

Met ic==

Deze kenmerken zijn toegevoegd aan een regel met kenmerk ic prefix. Als zodanig kunt u ze toevoegen aan het gegevensbestand, gescheiden door komma's, zoals getoond. Een tabblad scheidt de UUID en de eigenschap-id's. Het voorvoegsel ic is niet vereist in het bestand.

Numerieke IDs

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  30608,50354,50338,50352,30626

identiteitskaart van het Koord

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  ic=52,ic=55

Met sleutelwaardeparen

In dit bestand worden sleutelwaardeparen gebruikt om gegevens door te geven aan Audience Manager .

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

Downloadhet dossier van steekproefgegevens als u extra voorbeelden nodig hebt. Het downloadbestand heeft een bestandsextensie .overwrite . U kunt het openen met een eenvoudige tekstverwerker.

Voorbeeldmatrix examples-matrix

De grafiek toont hieronder voorbeelden van de correcte manier om uw Binnenkomende dossiers, afhankelijk van het type van IDsen de methode te formatteren waardoor u traits aan profielen wilt toevoegen.

Type id/bewerking
D_ijd gebruiken om kenmerken toe te voegen aan een gebruikersprofiel
G_unsid gebruiken om kenmerken uit een gebruikersprofiel te verwijderen
Verzenden in sleutelwaardeparen om eigenschappen aan een gebruikersprofiel toe te voegen
Gebruik het voorvoegsel ic om kenmerken aan een gebruikersprofiel toe te voegen
Audience Manager UUID
Voorbeeld 1
Voorbeeld 2
Voorbeeld 3
Voorbeeld 4
Google Advertising ID for Android Devices
Voorbeeld 5
Voorbeeld 6
Voorbeeld 7
Voorbeeld 8
Apple IDFA voor iOS-apparaten
Voorbeeld 9
Voorbeeld 10
Voorbeeld 11
Voorbeeld 12
Je eigen CRM-id (DPUUID)
Voorbeeld 13
Voorbeeld 14
Voorbeeld 15
Voorbeeld 16

Voorbeeld 1 example-1

Gebruik trait IDs om trait kwalificatiegegevens voor Audience Manager UUIDs te verzenden.

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

Voorbeeld 2 example-2

Met trait IDs kunt u trait informatie over diskwalificatie verzenden voor Audience Manager UUIDs .

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

of

59767559181262060060278870901087098252 <TAB> 24:0, 26:0, 27:0

of

59767559181262060060278870901087098252 <TAB> 24:-1, 26:-1, 27:-1

Voorbeeld 3 example-3

Verzenden in sleutel-waardeparen om trait kwalificatiegegevens voor Audience Manager UUIDs toe te voegen.

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

of

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

Voorbeeld 4 example-4

Gebruik het voorvoegsel ic om trait kwalificatiegegevens voor Audience Manager UUIDs te verzenden.

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

of

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

Voorbeeld 5 example-5

Gebruik trait IDs om trait kwalificatiegegevens voor Android apparaten te verzenden.

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

Voorbeeld 6 example-6

Gebruik trait IDs om trait diskwalificatiegegevens voor Android -apparaten te verzenden.

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

of

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:0, 26:0, 27:0

of

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:-1, 26:-1, 27:-1

Voorbeeld 7 example-7

Verzenden in sleutelwaardeparen om trait kwalificatiegegevens voor Android -apparaten toe te voegen.

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone

of

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"

Voorbeeld 8 example-8

Gebruik het voorvoegsel ic om trait kwalificatiegegevens voor Android -apparaten te verzenden.

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626

of

e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55

Voorbeeld 9 example-9

Gebruik trait IDs om trait kwalificatiegegevens voor iOS apparaten te verzenden.

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

Voorbeeld 10 example-10

Gebruik trait IDs om trait diskwalificatiegegevens voor iOS -apparaten te verzenden.

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

of

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:0, 26:0, 27:0

of

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:-1, 26:-1, 27:-1

Voorbeeld 11 example-11

Verzenden in sleutelwaardeparen om trait kwalificatiegegevens voor iOS -apparaten toe te voegen.

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone

of

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"

Voorbeeld 12 example-12

Gebruik het voorvoegsel ic om trait kwalificatiegegevens voor iOS -apparaten te verzenden.

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626

of

6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55

Voorbeeld 13 example-13

Gebruik trait IDs om trait kwalificatiegegevens voor DPUUIDs te verzenden.

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

Voorbeeld 14 example-14

Gebruik trait IDs om trait diskwalificatiegegevens voor DPUUIDs te verzenden.

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

of

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:0, 26:0, 27:0

of

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:-1, 26:-1, 27:-1

Voorbeeld 15 example-15

Verzenden in sleutel-waardeparen om trait kwalificatiegegevens voor DPUUIDs toe te voegen.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

of

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

Voorbeeld 16 example-16

Gebruik het voorvoegsel ic om trait kwalificatiegegevens voor DPUUIDs te verzenden.

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

of

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