Krav för namn och filstorlek för Amazon S3 för inkommande datafiler amazon-s-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 Audience Manager / Amazon S3 -katalog.
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
S3-filnamn innehåller följande obligatoriska och valfria element:
-
S3-prefix:
s3n://AWS_directory/partner_name/date=yyyy-mm-dd/
-
Filnamnselement:
ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]
Information om andra godkända filnamnsformat finns i Anpassade partnerintegreringar.
Namnelement
Tabellen definierar elementen i ett S3-filnamn.
AWS_directory
date=yyyy-mm-dd
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 .
_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. På så sätt kan Audience Manager 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 .
partner_name
TIMESTAMP
(.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 dataleverantörer kan skicka en lista över egenskaper per användare som ska skriva över den här användarens befintliga egenskaper från tredje part för den här dataleverantören i Audience Manager. Du behöver inte inkludera alla användare i en överskrivningsfil. Inkludera endast de användare som du vill ändra.
[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.
[.gz]
När du skickar filer till Amazon S3 bör du bara använda gzip-komprimering. När filerna är komprimerade får de tillägget .gz
. Använd inte ZIP-komprimering.
Komprimerade filer måste vara 3 GB eller mindre. Om filerna är större kan 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.
s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.1.gz
s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync.2.gz
s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.sync
s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_567_1366545717.sync.gz
s3n://<AWS_Bucket>/<partner_name>/date=2016-05-09/ftp_dpm_478_1366545717.overwrite
Du kan hämta exempelfilen om du vill ha fler exempel. Filen har sparats 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 / Amazon S3 -katalog.
Längdbegränsningar line-limits
Inkommande datafiler har en linjelängd på högst 102400 byte. Linjer som överskrider denna gräns tas inte med i överföringen.