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: Sat Jul 20 2024 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 har symbolerna < > lagts till för att hjälpa till att separera varje element visuellt. Du behöver inte inkludera dessa i din datafil.

<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 anger 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 ( DPUUID, i Audience Manager).
  • Ett mobilt Android- eller iOS-enhets-ID i dess ursprungliga, oförändrade form 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

Audience Manager trait-ID. Vi ber dig att ta med endast inkluderade egenskaper i inkommande datafiler. Vi bearbetar inga andra typer av egenskaper i den inkommande dataöverföringen.

Obs! Trait-ID:t kan hittas med hjälp av metoden GET som returnerar information om alla dina egenskaper. Mer information finns i Programmeringsmetoder.

Formaterar Trait IDs formatting-trait-ids

Följande tabell beskriver prefixen som identifierar trait namn eller ID:n i en inkommande datafil. Se exempelfilerna för exempel.

Prefix
Beskrivning
d_sid=
Prefixet d_sid 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-metoden GET . Se -API-metoder för spår.
d_unsid=

Data som har prefixats med d_unsid tar bort användare från den egenskapen. Prefixet d_unsid ignoreras i en overwrite -fil.

Prefixet d_unsid= 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-metoden GET . Se -API-metoder för spår.

ic=

Trait-reglergör att du kan ange kriterier för trait-kvalificering. Om du formaterar en trait-regel som ic == trait ID kan du skicka in traits i en enkel kommaformaterad lista.

Exempel: du skapar följande 3-trait-regler:

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

Dessa egenskaper är associerade med nyckeln ic . På så sätt kan du skapa en enklare lista över egenskaper i datafilen. Du behöver inte ta med prefixet ic . Innehållet i datafilen kan därför se ut så här:

                 user ID <TAB> 123,456,789

Nyckelvärdepar

Trait-data 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 ta med endastonboarded traits i inkommande datafiler. Inga andra trait-typer bearbetas i den inkommande dataöverföringen.

User IDs

ID-typ
Krav
DPUUID
Använd inte en kodad kolon ( %3A ) eller okodad kolon ( : ) i DPUID.
Mobile iOS (IDFA) eller Android device 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 ett 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. -product = camera tolkas till exempel som product = camera .
TAB
Använd inte TAB i stället för tomma värden i nyckelvärdepar. Använd bara TAB för att separera variabler i den inkommande datafilen.
\n, \t
Använd inte de nya rad- eller tabbtecknen ( \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 prefixet ic . Därför kan du lägga till dem i datafilen avgränsade med kommatecken. En flik skiljer UUID och trait ID:n. Prefixet ic 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 fler exempel. Den hämtade filen har filtillägget .overwrite. Du kan öppna den med en enkel textredigerare.

Exempelmatris examples-matrix

Diagrammet nedan visar exempel på rätt sätt att formatera dina inkommande filer, beroende på typen av ID:n och metoden som du vill lägga till traits i profiler med.

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 för Android-enheter
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 för att 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 för att skicka information om trait 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 prefixet ic för 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 för att 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 för att skicka information om trait 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 prefixet ic för 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 för att 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 för att skicka information om trait 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 prefixet ic för 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 för att 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 för att skicka information om trait 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 prefixet ic för 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