Amazon S3 krav på namn och filstorlek 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 dina filer 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:
-
S3prefix:
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 en S3 filnamn.
AWS_directory
date=yyyy-mm-dd
DPID
En programmerare som säger 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:
- ID för datakälla (även kallat Data Provider ID): Detta är ett unikt ID som Audience Manager tilldelar en datakälla (se Audience Manager index för ID). 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. Till exempel:
...ftp_dpm_21_123456789.sync
visar Audience Manager att lägga in data i ID:n som tillhör datakälla 21. - Android ID (GAID): Använd ID 20914 i ett datafilnamn om det innehåller Android-ID:n. Du måste använda fältet
_DPID_TARGET_DATA_OWNER
när du använder Android-ID:n. Till exempel:...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync
visar Audience Manager att datafilen endast innehåller Android ID:n och ID:n ska kvalificera sig för de egenskaper som tillhör_DPID_TARGET_DATA_OWNER
datakälla. - iOS ID (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. Till exempel:...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync
visar Audience Manager att datafilen endast innehåller iOS ID:n och ID:n ska vara kvalificerade för de egenskaper som tillhör_DPID_TARGET_DATA_OWNER
datakälla. - ID:n som tillhör andra globala datakällor: Du kan lägga in 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, enligt beskrivningen i global datakälla, artikel.
Obs! Blanda inte ID-typer i datafilerna. Om ditt filnamn t.ex. innehåller en Android-identifierare, ska du inte placera 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. 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 inte behöver begära en mappning för befintliga datautbytesrelationer (för måldatakällor som tillhör andra företag som du har registrerat data i 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
anger för 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
visar Audience Manager att datafilen endast innehåller Android ID:n och ID:n ska kvalificera sig för egenskaperna som tillhör datakällan 21. - iOS ID (IDFA):
...ftp_dpm_20915_21_1234567890.sync
visar Audience Manager att datafilen endast innehåller iOS ID:n och 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
visar Audience Manager att datafilen endast innehåller Roku-ID:n och ID:n ska vara kvalificerade för de egenskaper som tillhör datakällan 21. Använd det ID som motsvarar varje datakälla, enligt beskrivningen i global datakälla, artikel.
partner_name
TIMESTAMP
(.sync|.overwrite)
Synkroniseringsalternativ som inkluderar:
sync
: Normalt scenario när externa dataleverantö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 exempel på filnamn nedan.
[.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 .gz
tillägg. 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 ladda ned exempelfilen om du vill ha fler exempel. Den här filen har sparats med .overwrite
filtillägg. Öppna med en enkel textredigerare.
Godkända filstorlekar accepted-file-sizes
Titta på bilderna nedan för att få snabb/tidigaste bearbetning av dina filer och för att se om det finns 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.