Dokumentation Audience Manager Användarhandbok för Audience Manager

Namn- och innehållskrav för ID-synkroniseringsfiler

Senast uppdaterad: 20 juli 2024

Ämnen:

Beskriver obligatoriska fält, syntax och namnkonventioner som används för filbaserad ID-synkronisering. Namnge och ordna filinnehållet enligt dessa specifikationer.

OBSERVERA

Textformaten (monospaced text, kursiv, parenteser [ ] ( ) etc.) i det här dokumentet anger kodelement och alternativ. Mer information finns i Formatkonventioner för kod- och textelement.

Filnamnssyntax och exempel

ID-filnamn innehåller följande obligatoriska och valfria element:

[adobe_id_] [c2c_id_]MASTERDPID_DPID[_DPID]_TIMESTAMP.sync[.SPLIT_NUMBER][.gz]

Parameter	Beskrivning
`adobe_id`	Ett statiskt prefix som identifierar filen som en ID-synkroniseringsfil. Använd det här prefixet när du matchar enhets-ID:n till andra enhets-ID:n eller kund-ID:n (DPUID).
`c2c_id`	Ett statiskt prefix som identifierar filen som en ID-synkroniseringsfil för personbaserade mål. Använd det här prefixet när du matchar kund-ID:n (DPUID) till hash-kodade e-postadresser för personbaserade mål.
`MASTERDPID`	Huvuddataleverantörens ID är det överordnade ID:t för DPID:n i filnamnet. Det första användar-ID:t i datafilen motsvarar också huvud-ID:t. De efterföljande DPID:n är andra identifierare som tillhör mallen. Synkroniseringen mappar DPID:n i filnamnet till UUID:n i filen. Detta DPID får bara innehålla enhets-ID, t.ex. AAM UUID, GAID, IDFA osv. Den får inte innehålla DPUID. Om du gör det kan synkroniseringen bli felaktig.
`DPID`	DataProvider-ID. Dessa ID:n representerar enheter eller datakällor som är kopplade till huvud-DID:t. Synkroniseringen mappar DPID:n i filnamnet till UUID:n i filen. Antalet DPID i filnamnet måste matcha antalet UUID i datafilen. Exempel: ditt filnamn innehåller ett huvud-DPID och tre DPID. Datafilen måste innehålla fyra motsvarande UUID-kolumner, formaterade enligt beskrivningen i filinnehållsavsnittet nedan.
`timestamp`	En 10-siffrig UNIX-tidsstämpel i sekunder. Tidsstämpeln gör varje filnamn unikt.
`.sync`	Anger en normal, fullständig synkronisering.
`[.SPLIT_NUMBER]`	Ett heltal. Används när du delar upp stora filer i flera mindre filer. Detta hjälper till att förbättra bearbetningstiden. Talet anger vilken del av originalfilen du skickar in. Se exemplen på filnamn nedan.
`[.gz]`	Anger att filen komprimeras med gzip-komprimering (tillval).

Exempel på filnamn

I följande exempel visas korrekt formaterade filnamn. Filnamnen kan se likadana ut.

adobe_id_111_222_333_444_1454442149.sync
adobe_id_123_898_456_1454442149.sync.1.gz
adobe_id_123_898_456_1454442149.sync.2.gz
c2c_id_123_898_1454442149.sync.gz

OBSERVERA

Information om namngivning av filer för ID-synkronisering (c2c-prefix) för personbaserade mål finns i Arbetsflöde A - Personalization baserad på all onlineaktivitet i kombination med offlinedata eller Arbetsflöde B - Personalization baserad på data som bara är offline.

Syntax för filinnehåll och exempel

Innehållet i en ID-fil innehåller följande element:

UUID <tab>UUID<tab>UUID<tab>UUID

Filen innehåller användar-ID (UUID). Separera ID:n på varje rad med en flik. I följande exempel visas en korrekt formaterad ID-fil. Innehållet kan se likadant ut.

abc123 def456 ghi789 xyz987

Fillinnehåll

När du skapar dina inkommande filer måste du se till att den första kolumnen bara är ifylld med enhets-ID:n, som AAM UUID, GAID, IDFA och så vidare. Se Index för ID:n i Audience Manager för en detaljerad förklaring av ID:n som stöds av Audience Manager.

IMPORTANT

Använd inte DPUID i den första kolumnen. Om du gör det kan synkroniseringen bli felaktig.

Synkroniseringen matchar DPUID:n med UUID:n

Syftet med en ID-synkroniseringsfil är att synkronisera DPUID från dina egna datakällor med Audience Manager UID:n. Synkroniseringen mappar DPUUID från mallen DPID och dess relaterade DPID till Audience Manager UUID. Var du placerar ID:n i filnamnet och brödtexten avgör hur dessa ID:n mappas till varandra. Ta till exempel de två exempelfilerna som visas här:

Fil 1: adobe_id_0_12345_1476312152.sync
Fil 2: adobe_id_12345_67890_1476312876.sync

Utifrån exempelnamnet och innehållet mappas ID:n ihop så här:

Fil 1 ( Hämta exempelfil)

DPID 0 = Adobe Audience Manager UUID

DPID 12345

68079982765673198504052656074456196039

XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR.38

67412682083411995725538770443620307584

XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70

89159024796760343733111707646026765593

XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM

66552757407517449462805881945288602094

XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M

66184778222667870903738139438735041506

XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

Steg 1: ID-synkroniseringsprocessen synkroniserar DPUUID från DPID 12345 med Audience Manager UUID i den vänstra kolumnen. Observera att DPID "0" i filnamnet representerar Audience Manager UUID.

Fil 2 ( Hämta exempelfil)

DPID 12345

DPID 67890

XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-Trj6E4njaMR.38

4598060374

XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70

4581274262

XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM

4392434426

XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLwregJU2M

2351382994

XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

4601584763

Steg 2: DPUUID från DPID 12345 har synkroniserats i steg 1 med Audience Manager UUID. Det som den här ID-synkroniseringen gör är att synkronisera DPUUID från DPID 67890 med Audience Manager UUID från steg 1.

Andra formatkrav

Användar-ID:n kan inte:

Ha flikar i själva ID:t. Flikar används bara för att avgränsa enskilda ID:n i datafilen.
Innehåller personligt identifierbar information (PII).
Använd kodningen URL. Skicka bara in okodade ID:n.

Rader som slutar med tabbar eller mellanslag bearbetas eller realiseras inte. Se i regel till att du inte tar bort radslut.

recommendation-more-help