Krav för namn och filstorlek för FTP för inkommande datafiler ftp-name-and-file-size-requirements-for-inbound-data-files

Beskriver obligatoriska fält, syntax, namnkonventioner och filstorlekar som du måste följa när du skickar data till Audience Manager. Ange namn och storlek för filerna enligt dessa specifikationer när du skickar data till en FTP-katalog i Audience Manager.

WARNING
Vi fasar ut stödet för FTP konfigurationer. Inläsning av inkommande datafiler stöds fortfarande i befintliga FTP-integreringar, men vi rekommenderar starkt att du använder Amazon S3 för att lägga in offlinedata för nya integreringar. Mer information finns i Krav på Amazon S3-namn och filstorlekar för inkommande datafiler.
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 file-name-syntax

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

ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]

Information om andra godkända filnamnsformat finns i Anpassade partnerintegreringar.

NOTE
Audience Manager bearbetar bara ASCII- och UTF-8-kodade filer.

Namnge element

Tabellen definierar elementen i ett FTP-filnamn.

Filnamnselement
Beskrivning
ftp_dpm_
Sökvägen till och namnet på FTP-katalogen Audience Manager. Kontakta kontohanteraren för att få information om FTP-katalogen och autentiseringsuppgifter.
DPID

Ett ID som meddelar Audience Manager om en datafil innehåller dina egna användar-ID:n, Android-ID:n, iOS-ID:n eller andra ID:n som tillhör globala datakällor. Följande alternativ godkänns:

  • Data-Source-id (kallas även dataproviderns-ID): Detta är ett unikt ID som Audience Manager tilldelar en datakälla (se Audience Manager -index för ID:n). Använd det här tilldelade ID:t i ett filnamn när du skickar in data som innehåller dina egna användar-ID:n. ...ftp_dpm_21_123456789.sync instruerar till exempel Audience Manager att inhämta data till ID:n som tillhör datakällan 21.
  • Android ID (GAID): Använd ID 2014 i ett datafilnamn om det innehåller Android ID. Du måste använda fältet _DPID_TARGET_DATA_OWNER när du använder Android ID:n. ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync meddelar till exempel Audience Manager att datafilen bara innehåller Android ID:n och att ID:n ska kvalificera sig för de egenskaper som tillhör datakällan _DPID_TARGET_DATA_OWNER.
  • iOS ID:n (IDFA): Använd ID 20915 i ett datafilnamn om det innehåller iOS ID:n. Du måste använda fältet _DPID_TARGET_DATA_OWNER när du använder iOS ID:n. ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync meddelar till exempel Audience Manager att datafilen bara innehåller iOS ID:n och att ID:n ska kvalificera sig för de egenskaper som tillhör datakällan _DPID_TARGET_DATA_OWNER.
  • ID:n som tillhör andra globala datakällor: Du kan lägga till Roku ID:n för Advertising (RIDA), Microsoft Advertising ID:n (MAID) och andra ID:n. Använd det ID som motsvarar varje datakälla, så som beskrivs i artikeln för globala datakällor i .

Obs! Blanda inte ID-typer i dina datafiler. Om ditt filnamn till exempel innehåller Android-identifieraren ska du inte ange iOS-ID:n eller dina egna ID:n i datafilen.

_DPID_TARGET_DATA_OWNER

Det här fältet anger för Audience Manager vilken datakälla data ska sparas i. Det här fältet är obligatoriskt om du ställer in DPID på ett Android-id, ett iOS-id eller ett annat ID som tillhör globala datakällor. Detta gör att Audience Manager kan länka fildata tillbaka till din organisation.
Den här måldatakällan måste ägas av ditt företag. För datadelning med andra företag måste du ha en åtkomstmappning mellan ditt företag och måldatakällan för att kunna importera data till en måldatakälla som tillhör ett annat företag. Kontakta din Adobe-konsult eller kundsupport för att konfigurera mappningen.

Viktigt! Du behöver inte begära en mappning för befintliga datautdelningsrelationer (för måldatakällor som tillhör andra företag som du överförde data till före den 14 mars 2022). Mappningen behövs inte heller när du registrerar data i måldatakällor som tillhör ditt PID.

Exempel:

  • ...ftp_dpm_33_21_1234567890.sync meddelar Audience Manager att du kvalificerar kund-ID:n som tillhör datakällan 33 för egenskaper eller signaler som tillhör datakällan 21.
  • Android ID (GAID): ...ftp_dpm_20914_21_1234567890.sync säger till Audience Manager att datafilen endast innehåller Android ID:n och att ID:n ska vara kvalificerade för de egenskaper som tillhör datakällan 21.
  • iOS ID:n (IDFA): ...ftp_dpm_20915_21_1234567890.sync säger till Audience Manager att datafilen endast innehåller iOS ID:n och att ID:n ska vara kvalificerade för de egenskaper som tillhör datakällan 21.
  • ID:n som tillhör andra globala datakällor: ...ftp_dpm_121963_21_1234567890.sync anger för Audience Manager att datafilen endast innehåller Roku ID:n och att ID:n ska vara kvalificerade för de egenskaper som tillhör datakällan 21. Använd det ID som motsvarar varje datakälla, så som beskrivs i artikeln för globala datakällor i .

(.sync |.overwrite)

Synkroniseringsalternativ som inkluderar:

  • sync: Normalt scenario när tredjepartsdataleverantörer skickar egenskaper per användare för att läggas till eller tas bort i Audience Manager-systemet.
  • overwrite: Gör att kunder och dataleverantörer kan skicka en lista över egenskaper per användare som ska skriva över alla användarens befintliga egenskaper för en viss datakälla i Audience Manager. Du behöver inte inkludera alla användare i en överskrivningsfil. Inkludera endast de användare som du vill ändra. Traits som inte har tilldelats måldatakällan raderas inte.
[SPLIT_NUMBER]

Ett heltal. Används när du delar upp stora filer i flera delar för att förbättra bearbetningstiden. Talet anger vilken del av originalfilen du skickar in.

För effektiv filbearbetning kan du dela datafilerna på det sätt som anges:

  • Okomprimerad: 1 GB
  • Komprimerad: 200-300 MB

Se de första 2 exemplen på filnamnnedan.

TIMESTAMP
En 10-siffrig UTC UNIX-tidsstämpel i sekunder. Tidsstämpeln gör varje filnamn unikt.
[.gz]

Gzip är det tillåtna komprimeringsformatet för ett FTP-filnamn. Om du använder filkomprimering bör du kontrollera att filnamnet har rätt filtillägg.

Komprimerade filer måste vara 3 GB eller mindre. Om filerna är större bör du kontakta kundtjänst. Även om Audience Manager kan hantera stora filer kan vi hjälpa dig att minska filstorleken och effektivisera dataöverföringen. Se Filkomprimering för inkommande dataöverföringsfiler.

Exempel på filnamn file-name-examples

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

  • ftp_dpm_478_1366545717.sync.1.gz
  • ftp_dpm_478_1366545717.sync.2.gz
  • ftp_dpm_478_1366545717.overwrite

Hämta exempelfilen om du behöver fler exempel. Filen sparas med filtillägget .overwrite. Öppna med en enkel textredigerare.

Godkända filstorlekar accepted-file-sizes

Titta på bilderna nedan om du vill ha snabb/tidigaste bearbetning av dina filer och om du vill ha filstorleksbegränsningar när du skickar data till en Audience Manager / FTP -katalog.

Filtyp
Optimal storlek
Maximal storlek
Komprimerad
200-300 MB
3 GB
Okomprimerad
1 GB
5 GB
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695