Amazon S3 Naam- en bestandsgroottevereisten voor binnenkomende gegevensbestanden amazon-s-name-and-file-size-requirements-for-inbound-data-files

Beschrijft de vereiste gebieden, syntaxis, noemende overeenkomsten en dossiergrootte u moet volgen wanneer het verzenden van gegevens naar Audience Manager. Stel de namen en grootten van uw bestanden in op basis van deze specificaties wanneer u gegevens naar een Audience Manager / Amazon S3 directory.

NOTE
De tekststijlen (monospaced text, cursief, haakjes [ ] ( ), enz.) in dit document de elementen en opties van de code aangeven. Zie Stijlconventies voor code- en tekstelementen voor meer informatie.

Syntaxis bestandsnaam file-name-syntax

S3 bestandsnamen bevatten de volgende vereiste en optionele elementen:

  • S3voorvoegsel: s3n://AWS_directory/partner_name/date=yyyy-mm-dd/

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

Voor andere geaccepteerde bestandsnaamindelingen raadpleegt u Aangepaste partnerintegratie.

NOTE
Audience Manager alleen processen ASCII en UTF-8 gecodeerde bestanden.

Naamelementen

De tabel definieert de elementen in een S3 bestandsnaam.

Name Element
Beschrijving
AWS_directory
Het pad naar en de naam van uw Amazon S3-emmertje. Neem contact op met uw accountmanager voor uw S3-mapnaam, -pad en -referenties.
date=yyyy-mm-dd
Een tijdstempel (op basis van UTC-tijd) van wanneer u de bestanden naar uw S3-emmertje verzendt.
DPID

Een lD die Audience Manager als een gegevensbestand uw eigen gebruikers-id's, Android-id's, iOS-id's of andere id's bevat die tot algemene gegevensbronnen. Accepteert de volgende opties:

  • Gegevensbron-id (ook wel Data Provider-id genoemd): Dit is een unieke identiteitskaart die de Audience Manager aan een gegevensbron toewijst (verwijs naar de Audience Manager index van id's). Gebruik deze toegewezen id in een bestandsnaam wanneer u gegevens verzendt die uw eigen gebruikers-id's bevatten. Bijvoorbeeld: ...ftp_dpm_21_123456789.sync vertellen Audience Manager aan boord van gegevens naar id's die tot gegevensbron 21 behoren.
  • Android-id's (GAID): Gebruik ID 20914 in een gegevensbestandsnaam als deze Android-id's bevat. U moet het veld gebruiken _DPID_TARGET_DATA_OWNER wanneer u Android-id's gebruikt. Bijvoorbeeld: ...ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync vertellen Audience Manager dat het gegevensbestand alleen Android-id's bevat en de id's in aanmerking moeten komen voor de kenmerken die horen bij de _DPID_TARGET_DATA_OWNER gegevensbron.
  • iOS-id's (IDFA): Gebruik ID 20915 in een gegevensbestandsnaam als het iOS-id's bevat. U moet het veld gebruiken _DPID_TARGET_DATA_OWNER wanneer u iOS-id's gebruikt. Bijvoorbeeld: ...ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync vertellen Audience Manager dat het gegevensbestand alleen iOS-id's bevat en dat de id's in aanmerking moeten komen voor de kenmerken van de _DPID_TARGET_DATA_OWNER gegevensbron.
  • Id's die tot andere globale gegevensbronnen behoren: U kunt Roku-id's voor advertentie (RIDA), Microsoft-advertentie-id's (MAID) en andere id's aan boord nemen. Gebruik de id die overeenkomt met elke gegevensbron, zoals wordt beschreven in het dialoogvenster artikel met algemene gegevensbronnen.

Opmerking: Gebruik geen ID-typen in uw gegevensbestanden. Als uw bestandsnaam bijvoorbeeld de Android-id bevat, plaats dan geen iOS-id's of uw eigen id's in het gegevensbestand.

_DPID_TARGET_DATA_OWNER

Dit gebied vertelt Audience Manager welke gegevensbron aan boordgegevens aan. Dit veld is verplicht als u de DPID instelt op een Android-id of een iOS-id of een andere id die bij globale gegevensbronnen hoort. Hierdoor kan de Audience Manager de bestandsgegevens weer koppelen aan uw organisatie.
Deze doelgegevensbron moet eigendom zijn van uw bedrijf. Voor de doeleinden van het delen van gegevens van de tweede partij, om gegevens in te voeren in een doelgegevensbron die tot een ander bedrijf behoort, moet u een toegangstoewijzing tussen uw bedrijf en de doelgegevensbron hebben. Neem contact op met uw Adobe-consultant of klantenondersteuning om de toewijzing in te stellen.

Belangrijke opmerking: U niet moet een kaart aanvragen voor bestaande relaties voor gegevensuitwisseling (voor doelgegevensbronnen die toebehoren aan andere bedrijven waarin u gegevens hebt ingevoerd vóór 14 maart 2022). De toewijzing wordt ook niet vereist wanneer het aan boord gaan van gegevens in doelgegevensbronnen die tot uw PID behoren.

Bijvoorbeeld:

  • ...ftp_dpm_33_21_1234567890.sync vertelt Audience Manager dat u klant-id's kwalificeert die tot gegevensbron 33 behoren voor kenmerken of signalen die tot gegevensbron 21 behoren.
  • Android-id's (GAID): ...ftp_dpm_20914_21_1234567890.sync vertellen Audience Manager dat het gegevensbestand alleen Android-id's bevat en de id's moeten in aanmerking komen voor de kenmerken die bij gegevensbron 21 horen.
  • iOS-id's (IDFA): ...ftp_dpm_20915_21_1234567890.sync vertellen Audience Manager dat het gegevensbestand alleen iOS-id's bevat en dat de id's in aanmerking moeten komen voor de kenmerken van gegevensbron 21.
  • Id's die tot andere globale gegevensbronnen behoren: ...ftp_dpm_121963_21_1234567890.sync vertellen Audience Manager dat het gegevensbestand alleen Roku-id's bevat en dat de id's in aanmerking moeten komen voor de kenmerken van gegevensbron 21. Gebruik de id die overeenkomt met elke gegevensbron, zoals wordt beschreven in het dialoogvenster artikel met algemene gegevensbronnen.
partner_name
De naam van het bedrijf of de organisatie waarin u Audience Manager.
TIMESTAMP
Een tijdstempel van 10 cijfers (UTC UNIX) in seconden. Met de tijdstempel kunt u elke bestandsnaam uniek maken.
(.sync|.overwrite)

Synchronisatieopties met:

  • sync: Normaal scenario wanneer de derdegegevensleveranciers eigenschappen op een per-gebruikersbasis verzenden om in het systeem van de Audience Manager worden toegevoegd of worden verwijderd.
  • overwrite: Laat gegevensleveranciers een lijst van eigenschappen op een per-gebruikersbasis verzenden die alle bestaande derdeattributen van deze gebruiker voor deze gegevensleverancier in de Audience Manager zou moeten beschrijven. U hoeft niet al uw gebruikers op te nemen in een overschrijvingsbestand. Neem alleen de gebruikers op die u wilt wijzigen.
[SPLIT_NUMBER]

Een geheel getal. Wordt gebruikt wanneer u grote bestanden in meerdere onderdelen splitst om de verwerkingstijd te verbeteren. Het nummer geeft aan welk deel van het oorspronkelijke bestand u wilt invoeren.

Voor een efficiënte bestandsverwerking splitst u de gegevensbestanden zoals aangegeven:

  • Niet-gecomprimeerd: 1 GB
  • Gecomprimeerd: 200-300 MB

Zie de eerste 2 voorbeelden van bestandsnaam hieronder.

[.gz]

Gebruik alleen gzip-compressie wanneer u bestanden naar Amazon S3 verzendt. Wanneer deze bestanden zijn gecomprimeerd, worden de .gz extensie. Gebruik geen .zip-compressie.

Gecomprimeerde bestanden moeten 3 GB of kleiner zijn. Neem contact op met de klantenservice als uw bestanden groter zijn. Hoewel Audience Manager grote bestanden kan verwerken, kunnen we u helpen de bestanden te verkleinen en de gegevensoverdracht efficiënter te maken. Zie Bestandscompressie voor binnenkomende dataoverdrachtsbestanden.

Voorbeelden van bestandsnaam file-name-examples

In de volgende voorbeelden worden correct opgemaakte bestandsnamen weergegeven. De bestandsnamen kunnen er ongeveer hetzelfde uitzien.

  • 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

U kunt downloaden als u meer voorbeelden wilt. Dit bestand is opgeslagen met de .overwrite bestandsextensie. Open het met een eenvoudige teksteditor.

Geaccepteerde bestandsgrootten accepted-file-sizes

Houd rekening met de onderstaande cijfers voor de snelste/vroegste verwerking van uw bestanden en voor beperkingen van de bestandsgrootte wanneer u gegevens naar een Audience Manager / Amazon S3 directory.

Bestandstype
Optimale grootte
Maximale grootte
Gecomprimeerd
200-300 MB
3 GB
Niet gecomprimeerd
1 GB
5 GB
NOTE
Lege bestanden worden tijdens het proces voor gegevensvalidatie als ongeldig gemarkeerd en niet verwerkt.

Limieten voor lijnlengte line-limits

De binnenkomende gegevensdossiers hebben een lijnlengtelimiet van 102400 bytes. Lijnen die deze limiet overschrijden, worden van de overdracht uitgesloten.

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