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.

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

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.

NOTE
Audience Manager endast processer ASCII och UTF-8 kodade filer.

Namnelement

Tabellen definierar elementen i en S3 filnamn.

Namnelement
Beskrivning
AWS_directory
Sökvägen till och namnet på din Amazon S3-bucket. Kontakta din Account Manager för att få information om katalognamn, sökväg och autentiseringsuppgifter för S3.
date=yyyy-mm-dd
En tidsstämpel (baserad på UTC-tid) som anger när du skickar filerna till S3-bucket.
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
Företags- eller organisationsnamnet som du använder i Audience Manager.
TIMESTAMP
En 10-siffrig UTC UNIX-tidsstämpel i sekunder. Tidsstämpeln gör varje filnamn unikt.
(.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.

Filtyp
Optimal storlek
Maxstorlek
Komprimerad
200-300 MB
3 GB
Okomprimerad
1 GB
5 GB
NOTE
Den inkommande dataverifieringsprocessen kommer att markera tomma filer som ogiltiga och kommer inte att bearbeta dem.

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.

recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695