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.
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.
Naamelementen
De tabel definieert de elementen in een S3 bestandsnaam.
AWS_directory
date=yyyy-mm-dd
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
TIMESTAMP
(.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.
Limieten voor lijnlengte line-limits
De binnenkomende gegevensdossiers hebben een lijnlengtelimiet van 102400 bytes. Lijnen die deze limiet overschrijden, worden van de overdracht uitgesloten.