Namn- och innehållskrav för ID-synkroniseringsfiler name-and-content-requirements-for-id-synchronization-files

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

NOTE
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 file-name-syntax

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
NOTE
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 file-content-syntax

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 considerations

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 sync-matches-dpuuids-uuids

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 other-format-reqs

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
de293fbf-b489-49b0-8daa-51ed303af695