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.

NOTE
De tekststijlen (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 .

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

Naamelementen

De tabel definieert de elementen in een bestandsnaam van S3 .

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 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
Het bedrijf of de organisatienaam u in Audience Manager gebruikt.
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 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.

Bestandstype
Optimale grootte
Maximale grootte
Gecomprimeerde
200-300 MB
3 GB
niet samengeperst
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