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.

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:

  • 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.

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

Namnelement

Tabellen definierar elementen i ett 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

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. 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
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 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.

Filtyp
Optimal storlek
Maximal storlek
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