DocumentatieAudience ManagerAudience Manager-gebruikershandleiding

Content van binnenkomende databestanden: syntaxis, ongeldige tekens, variabelen en voorbeelden inbound-data-file-contents-syntax-invalid-characters-variables-and-examples

Last update: Wed Mar 16 2022 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 wordt < > er zijn 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 geaccepteerde bestandsindelingen raadpleegt u Aangepaste partnerintegratie.

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 Hiermee wordt een tijdelijke aanduiding voor een variabele aangegeven.

Variabele
Beschrijving
User ID

Een gebruikersnaam kan:

  • Een unieke gebruikersnaam toegewezen door Audience Manager ( UUID Audience Manager).
  • 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 wordt weergegeven door het mobiele besturingssysteem.

Voor mobiele id's:

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

De Audience Manager traditie-id. Wij vragen u ook alleen ongebogen eigenschappen in binnenkomende gegevensbestanden. We verwerken geen andere typen eigenschappen in de binnenkomende gegevensoverdracht.

Opmerking: De Trait-id kunt u vinden met de methode GET die details over al uw kenmerken retourneert. Zie voor meer informatie Trait API-methoden.

Opmaak Trait IDs formatting-trait-ids

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

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

Gegevens voorafgegaan door d_unsid Hiermee verwijdert u gebruikers van die eigenschap. De d_unsid voorvoegsel wordt genegeerd in een overwrite bestand.

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

ic=

Handelsvoorschriftenlaat u criteria voor vakkwalificatie plaatsen. Als u een gedragslijn opmaakt als ic == trait ID , kunt u in kenmerken verzenden in een eenvoudige lijst met komma's.

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. En u hoeft de ic voorvoegsel. Hierdoor kan de inhoud van het gegevensbestand er als volgt uitzien:

                 user ID <TAB> 123,456,789

Sleutelwaardeparen

De gegevens van het spoor kunnen als sleutel-waardeparen worden geformatteerd gebruikend alfanumerieke koorden. 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 Dit zijn allemaal voorbeelden van correct opgemaakte sleutelwaardeparen.

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

Trait IDs

Trait IDs bestaan alleen uit numerieke tekens. Wij vragen u ook alleenonboarded traits in binnenkomende gegevensbestanden. We verwerken geen andere trait typen in de binnenkomende gegevensoverdracht.

User IDs

Type id
Vereiste
DPUUID
Niet gebruiken een gecodeerde dubbele punt gebruiken ( %3A ) of niet-gecodeerde dubbele punt ( : ) 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/kleine letters zijn en geen hashes. Bijvoorbeeld, 6D92078A-8246-4BA4-AE5B-76104861E7DC
  • Android-indeling: Id's moeten kleine letters zijn en geen hashes. 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. Bijvoorbeeld: -product = camera wordt geïnterpreteerd als product = camera .
TAB
Niet gebruiken gebruiken TAB in plaats van lege waarden in sleutelwaardeparen. Alleen gebruiken TAB om variabelen in het binnenkomende gegevensbestand te scheiden.
\n, \t
De nieuwe regel of tabtekens ( \n, \t ) 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 eigenschappen ic voorvoegsel. 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. De ic voorvoegsel is niet vereist in het bestand.

Numerieke id's

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1  30608,50354,50338,50352,30626

Tekenreeks-id's

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”

Downloaden het bestand met voorbeeldgegevens als u meer voorbeelden nodig hebt. Het downloadbestand bevat een .overwrite bestandsextensie. U kunt het openen met een eenvoudige tekstverwerker.

Voorbeeldmatrix examples-matrix

In de onderstaande tabel ziet u voorbeelden van de juiste manier om uw binnenkomende bestanden op te maken, afhankelijk van de type id's en de methode waarmee u wilt toevoegen traits naar profielen.

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
UUID Audience Manager
Voorbeeld 1
Voorbeeld 2
Voorbeeld 3
Voorbeeld 4
Google-advertentie-id voor Android-apparaten
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

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

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

Voorbeeld 2 example-2

Gebruiken trait IDs om te verzenden trait informatie over ontzetting 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 sleutelwaardeparen om toe te voegen trait kwalificatiegegevens voor Audience Manager UUIDs.

59767559181262060060278870901087098252 <TAB> product = tablet, product = phone

of

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

Voorbeeld 4 example-4

Gebruik de ic voorvoegsel dat moet worden verzonden trait kwalificatiegegevens voor Audience Manager UUIDs.

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

of

59767559181262060060278870901087098252 <TAB> ic=52,ic=55

Voorbeeld 5 example-5

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

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

Voorbeeld 6 example-6

Gebruiken trait IDs om te verzenden trait informatie over ontzetting voor Android apparaten.

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 toe te voegen trait kwalificatiegegevens voor Android apparaten.

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 de ic voorvoegsel dat moet worden verzonden trait kwalificatiegegevens voor Android apparaten.

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

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

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

Voorbeeld 10 example-10

Gebruiken trait IDs om te verzenden trait informatie over ontzetting voor iOS apparaten.

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 toe te voegen trait kwalificatiegegevens voor iOS apparaten.

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 de ic voorvoegsel dat moet worden verzonden trait kwalificatiegegevens voor iOS apparaten.

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

Gebruiken trait IDs om te verzenden trait kwalificatiegegevens voor DPUUIDs.

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

Voorbeeld 14 example-14

Gebruiken trait IDs om te verzenden trait informatie over ontzetting voor DPUUIDs.

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 sleutelwaardeparen om toe te voegen trait kwalificatiegegevens voor DPUUIDs.

DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone

of

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

Voorbeeld 16 example-16

Gebruik de ic voorvoegsel dat moet worden verzonden trait kwalificatiegegevens voor DPUUIDs.

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

of

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