Amazon S3 Vereisten voor naam en bestandsgrootte voor binnenkomende gegevensbestanden amazon-s-name-and-file-size-requirements-for-inbound-data-files
Beschrijft de vereiste velden, syntaxis, naamgevingsconventies en bestandsgrootten die u moet volgen wanneer u gegevens naar Audience Manager verzendt. Stel de namen en grootten van de bestanden in volgens deze specificaties wanneer u gegevens naar een map Audience Manager / Amazon S3 verzendt.
monospaced text
, cursief, steunen [ ]
( )
, enz.) in dit document wijzen op codeelementen en opties. Zie Stijlconventies voor code- en tekstelementen voor meer informatie.Syntaxis bestandsnaam file-name-syntax
S3 bestandsnamen bevatten de volgende vereiste en optionele elementen:
-
S3prefix:
s3n://AWS_directory/partner_name/date=yyyy-mm-dd/
-
de naamelementen van het Dossier:
ftp_dpm_DPID[_DPID_TARGET_DATA_OWNER]_TIMESTAMP(.sync|.overwrite)[.SPLIT_NUMBER][.gz]
Voor andere toegelaten dossier - noem formaten, zie {de Integraties van de Partner van 0} Douane .
Naamelementen
De tabel definieert de elementen in een bestandsnaam van S3 .
AWS_directory
date=yyyy-mm-dd
DPID
Een lD die Audience Manager vertelt als een gegevensdossier uw eigen gebruiker IDs, Android IDs, iOS IDs, of andere IDs bevat die tot globale gegevensbronnenbehoren. Accepteert de volgende opties:
- identiteitskaart van Source van Gegevens (die ook als identiteitskaart van de Leverancier van Gegevens wordt bekend): dit is een unieke identiteitskaart die Audience Manager aan een gegevensbron toewijst (verwijs naar de Audience Manager index van IDs). Gebruik deze toegewezen id in een bestandsnaam wanneer u gegevens verzendt die uw eigen gebruikers-id's bevatten. Bijvoorbeeld, vertelt
...ftp_dpm_21_123456789.sync
Audience Manager aan binnenbordgegevens aan IDs die tot gegevensbron 21 behoren. - Android IDs (GAID): identiteitskaart 20914 van het Gebruik in een naam van het gegevensdossier als het Android IDs bevat. U moet het veld
_DPID_TARGET_DATA_OWNER
gebruiken wanneer u Android-id's gebruikt....ftp_dpm_20914_DPID_TARGET_DATA_OWNER_123456789.sync
vertelt Audience Manager bijvoorbeeld dat het gegevensbestand alleen Android-id's bevat en dat de id's in aanmerking moeten komen voor de kenmerken die bij de_DPID_TARGET_DATA_OWNER
-gegevensbron horen. - iOS IDs (IDFA): identiteitskaart 20915 van het Gebruik in een naam van het gegevensdossier als het iOS IDs bevat. U moet het veld
_DPID_TARGET_DATA_OWNER
gebruiken wanneer u iOS-id's gebruikt....ftp_dpm_20915_DPID_TARGET_DATA_OWNER_123456789.sync
vertelt Audience Manager bijvoorbeeld dat het gegevensbestand alleen iOS-id's bevat en dat de id's in aanmerking moeten komen voor de kenmerken die bij de_DPID_TARGET_DATA_OWNER
-gegevensbron horen. - IDs die tot andere globale gegevensbronnen behoren: U kunt aan boord Roku IDs voor Advertising (RIDA), Microsoft Advertising IDs (MAID), en andere IDs. Gebruik identiteitskaart die aan elke gegevensbron beantwoordt, zoals die in het globale artikel van gegevensbronnenwordt beschreven.
Opmerking: gebruik geen ID-typen in uw gegevensbestanden. Als uw bestandsnaam bijvoorbeeld de Android-id bevat, plaats dan geen iOS-id of uw eigen id in het gegevensbestand.
_DPID_TARGET_DATA_OWNER
In dit veld wordt aan Audience Manager doorgegeven welke gegevensbron aan boord van gegevens moet worden geplaatst. 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. Zo kan 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 nota: u te hoeven niet om een afbeelding voor bestaande gegevens te verzoeken delend verhoudingen (voor doelgegevensbronnen die tot andere bedrijven behoren waarin u gegevens voorafgaand aan 14 Maart, 2022) bezat. 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 die tot gegevensbron 33 behoren, kwalificeert voor kenmerken of signalen die tot gegevensbron 21 behoren.- Android IDs (GAID):
...ftp_dpm_20914_21_1234567890.sync
vertelt Audience Manager dat het gegevensdossier Android IDs slechts bevat en IDs voor de eigenschappen zou moeten kwalificeren die tot gegevensbron 21 behoren. - iOS IDs (IDFA):
...ftp_dpm_20915_21_1234567890.sync
vertelt Audience Manager dat het gegevensdossier iOS IDs slechts bevat en IDs voor de eigenschappen zou moeten kwalificeren die tot gegevensbron 21 behoren. - IDs die tot andere globale gegevensbronnen behoren:
...ftp_dpm_121963_21_1234567890.sync
vertelt Audience Manager dat het gegevensdossier slechts identiteitskaarts van Roku bevat en IDs voor de eigenschappen zou moeten kwalificeren die tot gegevensbron 21 behoren. Gebruik identiteitskaart die aan elke gegevensbron beantwoordt, zoals die in het globale artikel van gegevensbronnenwordt beschreven.
partner_name
TIMESTAMP
(.sync|.overwrite)
Synchronisatieopties met:
sync
: Normaal scenario wanneer externe gegevensproviders kenmerken per gebruiker verzenden die in het Audience Manager-systeem moeten worden toegevoegd of verwijderd.overwrite
: Laat gegevensleveranciers een lijst van eigenschappen op een per-gebruikersbasis verzenden die alle bestaande derdeeigenschappen van deze gebruiker voor deze gegevensleverancier in 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 bestandsnaamhieronder.
[.gz]
Gebruik alleen gzip-compressie wanneer u bestanden naar Amazon S3 verzendt. Wanneer deze bestanden zijn gecomprimeerd, krijgen ze de extensie .gz
. 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 misschien helpen uw bestanden kleiner te maken en gegevensoverdracht efficiƫnter te maken. Zie Bestandscompressie voor binnenkomende gegevensoverdrachtbestanden.
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 downloadenhet steekproefdossier als u extra voorbeelden wilt. Dit bestand is opgeslagen met de bestandsextensie .overwrite
. Open het met een eenvoudige teksteditor.
Geaccepteerde bestandsgrootten accepted-file-sizes
Houd rekening met de onderstaande afbeeldingen voor de snelste/vroegste verwerking van uw bestanden en voor beperkingen van de bestandsgrootte wanneer u gegevens naar een map Audience Manager / Amazon S3 verzendt.
Limieten voor lijnlengte line-limits
De binnenkomende gegevensdossiers hebben een lijnlengtelimiet van 102400 bytes. Lijnen die deze limiet overschrijden, worden van de overdracht uitgesloten.