FTP Vereisten voor naam en bestandsgrootte voor binnenkomende gegevensbestanden ftp-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 formaten van uw bestanden in volgens deze specificaties wanneer u gegevens naar een Audience Manager FTP -map verzendt.

WARNING
De ondersteuning voor FTP -configuraties wordt geleidelijk afgeschaft. Hoewel de binnenkomende gegevensbestandsinvoer nog steeds wordt ondersteund in bestaande FTP -integraties, raden we u ten zeerste aan om Amazon S3 te gebruiken om offlinegegevens voor nieuwe integraties aan boord te nemen. Zie Vereisten voor naam en bestandsgrootte van binnenkomende Amazon S3-databestanden voor meer informatie.
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

FTP bestandsnamen bevatten de volgende vereiste en optionele elementen:

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.

Elementen benoemen

De tabel definieert de elementen in een bestandsnaam van FTP .

Bestandsnaamelement
Beschrijving
ftp_dpm_
Het pad naar en de naam van de Audience Manager FTP-map. Neem contact op met uw accountmanager voor de FTP-map en de referenties.
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. Dit laat Audience Manager de dossiergegevens terug naar uw organisatie verbinden.
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.
(.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: Hiermee kunnen klanten en gegevensleveranciers een lijst met kenmerken per gebruiker verzenden die alle bestaande kenmerken van deze gebruiker voor een bepaalde gegevensbron in Audience Manager moet overschrijven. U hoeft niet al uw gebruikers op te nemen in een overschrijvingsbestand. Neem alleen de gebruikers op die u wilt wijzigen. De sporen die niet aan de doelgegevensbron worden toegewezen zullen niet worden gewist.
[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.

TIMESTAMP
Een tijdstempel van 10 cijfers (UTC UNIX) in seconden. Met de tijdstempel kunt u elke bestandsnaam uniek maken.
[.gz]

Gzip is de toegestane compressie-indeling voor een FTP-bestandsnaam. Als u bestandscompressie gebruikt, moet u ervoor zorgen dat de bestandsnaam de juiste extensie heeft.

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 bestandsnamen file-name-examples

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

  • ftp_dpm_478_1366545717.sync.1.gz
  • ftp_dpm_478_1366545717.sync.2.gz
  • ftp_dpm_478_1366545717.overwrite

Downloadhet steekproefdossier als u extra voorbeelden nodig hebt. Dit bestand wordt 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 / FTP verzendt.

Bestandstype
Optimale grootte
Maximale grootte
Gecomprimeerde
200-300 MB
3 GB
niet samengeperst
1 GB
5 GB
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695