Namn på utgående datafiler: Syntax och exempel outbound-data-file-name-syntax-and-examples

Beskriver obligatoriska fält, syntax och konventioner som används för att namnge en utgående datafil.

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

Syntax- och filnamnselement syntax-file-name

Utgående filnamn innehåller följande element. Alla element nedan är valfria.

[SYNC_TYPE][_DID][_MASTER_DPID][_PID_ALIAS][_SYNC-MODE][_TIMESTAMP]SPLITNUM.sync[.gz]

Parametrar

Tabellen definierar elementen i ett namn på en utgående datafil.

Filnamnselement
Beskrivning
SYNC_TYPE

Hänvisar till dataöverföringsmetoderna. Överföringsmetoderna omfattar:

  • FTP - Överföring med SFTP
  • Amazon S3 - Överför till Amazon AWS
DID

Mål-ID.

I Audience Manager är ett mål den instans av integreringen där du kan mappa dina målsegment. Kunderna kan ha flera destinationer beroende på verksamhetens behov.

MASTER_DPID

Data-provider eller ID för datakälla. Detta ID identifierar typen av användar-ID som finns i filinnehållet. De vanligaste användar-ID-nycklarna är:

  • 20914 - Google Advertiser-ID (raw, unhashed)
  • 20915 - Apple ID för annonsörer (raw, unhashed)
  • Leverantörs-ID - Användar-ID:n från tredje part (webb/cookie)

Mer information finns i Globala datakällor.

PID_ALIAS
Kundidentifieraren från tredjepartsplattformen.
SYNC_MODE

Synkroniseringsläget är en makroplatshållare som lägger till en etikett till filnamnet baserat på synkroniseringstyp. Synkroniseringstyperna omfattar fullständig och inkrementell. De visas i filnamnet som iter eller full .

  • iter : Anger en iterativ eller stegvis synkronisering. En inkrementell fil innehåller endast nya data som samlats in sedan den senaste synkroniseringen.
  • full : Anger en fullständig synkronisering. En helt synkroniserad fil innehåller gamla data och alla nya data som samlats in sedan den senaste synkroniseringen.
TIMESTAMP
En 13-siffrig UNIX-tidsstämpel i millisekunder i UTC-tidszonen.
SPLITNUM

Ett heltal. Identifierar en del av en fil som har delats upp i flera delar för att förbättra bearbetningstiden. Talet anger vilken del av den ursprungliga filen som data hör till.

Heltalet måste vara minst 3 siffror långt, föregånget av nollor, om delningsstorleken är mindre än 100 delar.

Originalfilen kommer inte att ha något delat nummer. Den första delade filen avslutas med 001. Se exempel nedan.

.gz (optional)
GZIP-komprimering.

Exempel på filnamn file-name-examples

Scenario 1

Filer som skickas till en Amazon S3 plats, med PID_ALIAS="XYZCustomer" och med Google Advertiser IDs i filinnehållet.

Exempel: inkrementella filer:

  • S3_1234_20914_XYZCustomer_iter_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000001.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000002.sync.gz

Exempel: fullständiga filer:

  • S3_1234_20914_XYZCustomer_full_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_full_1486140844000001.sync.gz

Scenario 2

Filer skickade till FTP plats, utan PID_ALIAS och med Apple Advertiser IDs i filinnehållet:

Exempel: inkrementella filer:

  • ftp_1234_20915_iter_1486140843000.sync.gz
  • ftp_1234_20915_iter_1486140843000001.sync.gz

Exempel: fullständiga filer:

  • ftp_1234_20915_full_1486140843000.sync.gz
  • ftp_1234_20915_full_1486140843000001.sync.gz

Scenario 3: Filer skickade till FTP plats, med PID_ALIAS="XYZCustomer" och med användar-ID från tredje part i filinnehållet ( Vendor ID=45454):

Exempel: inkrementella filer:

  • ftp_1234_45454_XYZCustomer_iter_1486140843000.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz

Exempel: fullständiga filer:

  • ftp_1234_45454_XYZCustomer_full_1486140843200.sync.gz
  • ftp_1234_45454_XYZCustomer_full_1486140843200001.sync.gz

Innehåll i utgående datafil: Syntax och parametrar outbound-contents-syntax

Beskriver obligatoriska fält, syntax och konventioner som används för att organisera information i en utgående datafil. Formatera data enligt dessa specifikationer.

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

Syntax

Fält i datafilen visas i följande ordning:

UUID<SPACE>SEGMENT_1,SEGMENT_2<SPACE>REMOVED_SEGMENT_,...

Parametrar

Tabellen innehåller variabler som definierar innehållet i en datafil.

Parameter
Beskrivning
UUID
Ett unikt användar-ID som tilldelats av Audience Manager .
<SPACE>
Avgränsa UUID- och segmentdata med ett blanksteg
SEGMENT_N
Det segment-ID som en besökare tillhör. Avgränsa flera segment med kommatecken.
REMOVED_SEGMENT_N
Det segment-ID som användaren diskvalificerades från. Avgränsa flera segment med kommatecken. Med en fullständig synkronisering kan du ignorera de borttagna segmenten eftersom datafilen innehåller den fullständiga listan över aktuella segment för användaren. Vanligtvis vill du veta mer om segment som en användare tillhör i stället för de som de har tagits bort från. Se även Namn på utgående datafil: Syntax och exempel.

Exempel: Grundläggande filformat

En korrekt formaterad datafil kan se ut som i följande exempel. Den här filposten anger att en användare kvalificerar sig för segmenten 24, 26 och 27. Ett blanksteg separerar UUID och segment-ID. Ett annat utrymme avgränsar uppsättningarna med segment-ID:n. I det här exemplet tillhör en användare segmenten 24, 26 och 27. De har tagits bort från segmenten 25 och 28.

59767559181262060060278870901087098252  24,26,27  25,28
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695