Innehåll i inkommande datafil: Syntax, ogiltiga tecken, variabler och exempel inbound-data-file-contents-syntax-invalid-characters-variables-and-examples
Obligatoriska fält, syntax och regler som du ska följa när du formaterar en inkommande trait-datafil.
Syntax för filinnehåll file-content-syntax
Fälten i den inkommande datafilen måste visas i den ordning som visas nedan. I det här exemplet <
>
symboler har lagts till för att hjälpa till att skilja ut varje element visuellt. Du behöver inte inkludera dessa i datafilen.
<user ID><TAB><trait ID>,<trait ID>,<trait ID>,...
Information om andra godkända filinnehållsformat finns i Anpassade partnerintegreringar.
code language-none |
---|
|
Filvariabler definierade file-variables-defined
Tabellen listar och definierar de variabler som används i en korrekt formaterad inkommande datafil. Kursiv används för att ange en variabelplatshållare.
User ID
Ett användar-ID kan vara:
- Ett unikt användar-ID som tilldelats av Audience Manager ( Audience Manager UUID).
- Ett unikt användar-ID som tilldelats i CRM-systemet ( DPUID, i Audience Manager).
- Ett mobilt Android- eller iOS-enhets-ID i dess ursprungliga oförändrade form så som det visas i det mobila operativsystemet.
För mobil-ID:
- IDFA-format: ID:n måste vara versaler och inte hash. Exempel,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Android-format: ID:n måste vara gemena och inte hashas. Exempel,
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
TAB
trait ID
The Audience Manager trait-ID. Vi ber dig att endast ombord på trakten i inkommande datafiler. Vi bearbetar inga andra typer av egenskaper vid inkommande dataöverföring.
Obs! Du kan hitta ditt Trait ID med hjälp av metoden GET som returnerar information om alla dina egenskaper. Mer information finns i Metoder för Trait API.
Formatering Trait IDs formatting-trait-ids
I följande tabell beskrivs de prefix som identifierar trait namn eller ID i en inkommande datafil. Se exempelfiler till exempel.
d_sid=
d_sid
-prefixet talar om för vårt system att ID:t är ett Audience Manager trait-ID. Detta är samma ID som visas i användargränssnittet. Du kan också returnera trait ID:n med API:t GET
-metod. Se Metoder för Trait API.d_unsid=
Data med prefix d_unsid
tar bort användare från den egenskapen. The d_unsid
-prefixet ignoreras i en overwrite
-fil.
The d_unsid=
-prefixet talar om för vårt system att ID:t är ett Audience Manager trait-ID. Detta är samma ID som visas i användargränssnittet. Du kan också returnera trait ID:n med API:t GET
-metod. Se Metoder för Trait API.
ic=
Trait Rulesgör att du kan ange kriterier för kvalificering av egenskaper. Om du formaterar en trasig regel som ic == trait ID
kan du skicka in egenskaper i en enkel kommaformaterad lista.
Exempel: du skapar följande 3-trait-regler:
ic == "123"
ic == "456"
ic == "789"
Dessa egenskaper är kopplade till ic
nyckel. På så sätt kan du skapa en enklare lista över egenskaper i datafilen. Och du behöver inte inkludera ic
prefix. Innehållet i datafilen kan därför se ut så här:
user ID <TAB> 123,456,789
Fackdata kan formateras som nyckelvärdepar med alfanumeriska strängar. Det finns flera sätt att formatera nyckelvärdepar, vilket visas nedan:
key = value
"key" = value
key = "value"
"key" = "value"
"age"="32"
, "gender"=m
, model = "pickup truck"
, product = tablet
är alla exempel på korrekt formaterade nyckelvärdepar.
Ogiltiga tecken i Trait IDs, User IDs och nyckelvärdepar invalid-chars
Trait IDs
Trait IDs består endast av numeriska tecken. Vi ber dig att endastonboarded traits i inkommande datafiler. Vi bearbetar inga andra trait typer i den inkommande dataöverföringen.
User IDs
%3A
) eller okodat kolon ( : ) i DPUID.ID:n för mobila enheter måste vara strikt formaterade så som visas här:
- IDFA-format: ID:n måste vara versaler och inte hash. Exempel,
6D92078A-8246-4BA4-AE5B-76104861E7DC
- Android-format: ID:n måste vara gemena och inte hashas. Exempel,
97987bca-ae59-4c7d-94ba-ee4f19ab8c21
Nyckelvärdepar
Felaktigt formaterade värdenamn i nyckelvärdepar orsakar också problem. Följ dessa regler när du skapar eller namnger värdet i ett nyckelvärdepar:
Du kan använda citattecknet i tangenten och i värdedelen av nyckelvärdepar, som i:
-
d_city = "New York", d_city = "San Francisco"
-
"d_city" = "New York", "d_city" = "San Francisco"
-product = camera
tolkas som product = camera
.TAB
TAB
i stället för tomma värden i nyckelvärdepar. Endast användning TAB
för att avgränsa variabler i den inkommande datafilen.\n, \t
\n, \t
) i nycklar eller i värden.Exempel på datafiler data-file-examples
d_sid
eller d_unsid
Den här datafilen visar en användare som är kvalificerad för traits 24, 26, 27 och som har tagits bort från trait 28 och 29.
59767559181262060060278870901087098252 d_sid=24,d_sid=26,d_sid=27,d_unsid=28,d_unsid=29
Obs!
I stället för att använda d_unsid kan du ta bort egenskaper från användarprofiler med följande syntax:
59767559181262060060278870901087098252 28:0, 29:0
59767559181262060060278870901087098252 28:-1, 29:-1
ic==
Dessa egenskaper har lagts till i en trait-regel med ic
prefix. Därför kan du lägga till dem i datafilen avgränsade med kommatecken. En flik skiljer UUID och trait ID:n. The ic
-prefix krävs inte i filen.
Numeriska ID:n
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 30608,50354,50338,50352,30626
Sträng-ID
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 ic=52,ic=55
Dessa fildata använder nyckelvärdepar för att skicka data till Audience Manager .
59767559181262060060278870901087098252 “gender”=”female”,“luxury_shopper”=”yes”
Hämta exempeldatafilen om du behöver ytterligare exempel. Den hämtade filen har en .overwrite
filtillägg. Du kan öppna den med en enkel textredigerare.
Exempelmatris examples-matrix
Diagrammet nedan visar exempel på det korrekta sättet att formatera dina inkommande filer, beroende på typ av ID och metoden som du vill lägga till med traits till profiler.
Exempel 1 example-1
Använd trait IDs skicka trait kvalificeringsinformation för Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_sid=24, d_sid=26, d_sid=27
Exempel 2 example-2
Använd trait IDs skicka trait information om diskvalificering för Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> d_unsid=24, d_unsid=26, d_unsid=27
eller
59767559181262060060278870901087098252 <TAB> 24:0, 26:0, 27:0
eller
59767559181262060060278870901087098252 <TAB> 24:-1, 26:-1, 27:-1
Exempel 3 example-3
Skicka i nyckelvärdepar för att lägga till trait kvalificeringsinformation för Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> product = tablet, product = phone
eller
59767559181262060060278870901087098252 <TAB> "product" = "tablet", "product" = "phone"
Exempel 4 example-4
Använd ic
prefix att skicka trait kvalificeringsinformation för Audience Manager UUIDs.
59767559181262060060278870901087098252 <TAB> 30608,50354,50338,50352,30626
eller
59767559181262060060278870901087098252 <TAB> ic=52,ic=55
Exempel 5 example-5
Använd trait IDs skicka trait kvalificeringsinformation för Android enheter.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_sid=24, d_sid=25, d_sid=26
Exempel 6 example-6
Använd trait IDs skicka trait information om diskvalificering för Android enheter.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> d_unsid=24, d_unsid=25, d_unsid=26
eller
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:0, 26:0, 27:0
eller
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 24:-1, 26:-1, 27:-1
Exempel 7 example-7
Skicka i nyckelvärdepar för att lägga till trait kvalificeringsinformation för Android enheter.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> product = tablet, product = phone
eller
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> "product" = "tablet", "product" = "phone"
Exempel 8 example-8
Använd ic
prefix att skicka trait kvalificeringsinformation för Android enheter.
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> 30608,50354,50338,50352,30626
eller
e4fe9bde-caa0-47b6-908d-ffba3fa184f2 <TAB> ic=52,ic=55
Exempel 9 example-9
Använd trait IDs skicka trait kvalificeringsinformation för iOS enheter.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_sid=24, d_sid=25, d_sid=26
Exempel 10 example-10
Använd trait IDs skicka trait information om diskvalificering för iOS enheter.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> d_unsid=24, d_unsid=25, d_unsid=26
eller
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:0, 26:0, 27:0
eller
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 24:-1, 26:-1, 27:-1
Exempel 11 example-11
Skicka i nyckelvärdepar för att lägga till trait kvalificeringsinformation för iOS enheter.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> product = tablet, product = phone
eller
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> "product" = "tablet", "product" = "phone"
Exempel 12 example-12
Använd ic
prefix att skicka trait kvalificeringsinformation för iOS enheter.
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> 30608,50354,50338,50352,30626
eller
6D92078A-8246-4BA4-AE5B-76104861E7DC <TAB> ic=52,ic=55
Exempel 13 example-13
Använd trait IDs skicka trait kvalificeringsinformation för DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_sid=24, d_sid=25, d_sid=26
Exempel 14 example-14
Använd trait IDs skicka trait information om diskvalificering för DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> d_unsid=24, d_unsid=25, d_unsid=26
eller
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:0, 26:0, 27:0
eller
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 24:-1, 26:-1, 27:-1
Exempel 15 example-15
Skicka i nyckelvärdepar för att lägga till trait kvalificeringsinformation för DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> product = tablet, product = phone
eller
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> "product" = "tablet", "product" = "phone"
Exempel 16 example-16
Använd ic
prefix att skicka trait kvalificeringsinformation för DPUUIDs.
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> 30608,50354,50338,50352,30626
eller
DBwFoc3dhfMNCFBh2M4F9ZkJEXMNnRDh2PXvnI1 <TAB> ic=52,ic=55