DokumentationAudience ManagerAnvändarhandbok för Audience Manager

Innehåll i inkommande datafil: Syntax, ogiltiga tecken, variabler och exempel inbound-data-file-contents-syntax-invalid-characters-variables-and-examples

Last update: Wed Mar 16 2022 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

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.

NOTE
Vi har en gräns på 200 rader som vi kan behandla för varje användar-ID som skickas i den inkommande datafilen. Om du till exempel skickar 300 rader för ett användar-ID behålls de första 200 raderna och de ytterligare 100 raderna tas bort. I exemplet nedan är du bra eftersom du skickar tre rader vardera för användar-ID 1 och användar-ID 2. Vi har ingen begränsning för hur många traits- eller key-value-par du får med på en rad.
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>

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.

Variabel
Beskrivning
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
Avgränsa användar-ID och trait-ID:n med en enda tabbavgränsare.
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.

Prefix
Beskrivning
d_sid=
The 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

Nyckelvärdepar

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

ID-typ
Krav
DPUUID
Gör inte använd ett kodat kolon ( %3A ) eller okodat kolon ( : ) i DPUID.
Mobile iOS (IDFA) eller Android-enhets-ID

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:

Tecken
Krav
Citattecken (")

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"

Streck (-)
Vi ignorerar strecktecken i början av nycklarna. Till exempel: -product = camera tolkas som product = camera .
TAB
Gör inte use 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
Använd inte nya rad- eller tabbtecken ( \n, \t ) i nycklar eller i värden.

Exempel på datafiler data-file-examples

Datafilformat
Beskrivning och exempel
Med 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

Med 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

Med nyckelvärdepar

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.

ID-typ/åtgärd
Använd d_sid för att lägga till egenskaper i en användarprofil
Använd d_unsid för att ta bort egenskaper från en användarprofil
Skicka i nyckelvärdepar för att lägga till egenskaper i en användarprofil
Använd prefixet ic för att lägga till egenskaper i en användarprofil
Audience Manager UUID
Exempel 1
Exempel 2
Exempel 3
Exempel 4
Google Advertising ID for Android Devices
Exempel 5
Exempel 6
Exempel 7
Exempel 8
Apple IDFA för iOS-enheter
Exempel 9
Exempel 10
Exempel 11
Exempel 12
Ditt eget CRM-ID (DPUID)
Exempel 13
Exempel 14
Exempel 15
Exempel 16

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
Related Articles
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695