Naam- en contentvereisten voor id-synchronisatiebestanden name-and-content-requirements-for-id-synchronization-files

Beschrijft de vereiste gebieden, de syntaxis, en de noemende overeenkomsten die voor op dossier-gebaseerde synchronisatie van identiteitskaart worden gebruikt. Geef de bestandsinhoud een naam en ordent deze volgens deze specificaties.

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 en voorbeelden van bestandsnaam file-name-syntax

Namen van id-bestanden bevatten de volgende vereiste en optionele elementen:

[adobe_id_] [c2c_id_]MASTERDPID_DPID[_DPID]_TIMESTAMP.sync[.SPLIT_NUMBER][.gz]

Parameter
Beschrijving
adobe_id
Een statisch voorvoegsel dat het bestand identificeert als een ID-synchronisatiebestand. Gebruik dit voorvoegsel wanneer apparaat-id's overeenkomen met andere apparaat-id's of klant-id's (DPUUID's).
c2c_id
Een statisch voorvoegsel dat het bestand identificeert als een ID-synchronisatiebestand voor op mensen gebaseerde doelen. Gebruik dit voorvoegsel wanneer u id's van klanten (DPUUID's) afstemt op gehashte e-mailadressen voor op mensen gebaseerde doelen.
MASTERDPID

De master gegevensleverancier ID is ouderidentiteitskaart van DPIDs in het dossier - naam. De eerste gebruiker-id in het gegevensbestand komt ook overeen met de master id. Verdere DPIDs is andere herkenningstekens die tot master behoren. Door synchronisatie worden DPID's in de bestandsnaam toegewezen aan UUID's in het bestand.

Deze DPID mag alleen apparaat-id's bevatten, zoals AAM UUID, GAID, IDFA enzovoort. Het kan geen DPUUIDs bevatten. Dit kan resulteren in een onjuiste synchronisatie.

DPID

ID's van gegevensaanbieder. Deze id's vertegenwoordigen entiteiten of gegevensbronnen die zijn gekoppeld aan de master DPID. Door synchronisatie worden DPID's in de bestandsnaam toegewezen aan UUID's in het bestand.

Het aantal DPID's in de bestandsnaam moet overeenkomen met het aantal UUID's in het gegevensbestand. Stel dat uw bestandsnaam een master DPID en 3 DPID's bevat. Uw gegevensbestand moet vier overeenkomstige kolommen van UUIDs omvatten, die zoals die in de hieronder sectie van de dossierinhoud wordt beschreven wordt geformatteerd.

timestamp
Een UNIX-tijdstempel van 10 cijfers in seconden. Met de tijdstempel kunt u elke bestandsnaam uniek maken.
.sync
Geeft een normale, volledige synchronisatie aan.
[.SPLIT_NUMBER]
Een geheel getal. Wordt gebruikt wanneer u grote bestanden in meerdere kleinere bestanden splitst. Dit helpt verwerkingstijden te verbeteren. Het nummer geeft aan welk deel van het oorspronkelijke bestand u wilt invoeren. Zie de voorbeelden van de bestandsnaam hieronder.
[.gz]
Geeft aan dat het bestand wordt gecomprimeerd met optionele gzip-compressie.

Voorbeelden van bestandsnamen

In de volgende voorbeelden worden bestandsnamen met de juiste indeling getoond. De bestandsnamen kunnen er ongeveer hetzelfde uitzien.

  • adobe_id_111_222_333_444_1454442149.sync
  • adobe_id_123_898_456_1454442149.sync.1.gz
  • adobe_id_123_898_456_1454442149.sync.2.gz
  • c2c_id_123_898_1454442149.sync.gz
NOTE
Voor de naam van het dossier van de synchronisatie van identiteitskaart (c2c prefix) voor Mensen-Gebaseerde Doelen, zie Workflow A - Personalisatie gebaseerd op alle online activiteiten gecombineerd met offlinegegevens of Workflow B - Personalisatie gebaseerd op gegevens die alleen offline beschikbaar zijn.

Syntaxis bestandsinhoud en voorbeelden file-content-syntax

De inhoud van een id-bestand bevat de volgende elementen:

UUID <tab>UUID<tab>UUID<tab>UUID

Het bestand bevat gebruikers-id's (UUID). Plaats in elke rij een tab tussen de id's. In het volgende voorbeeld wordt een correct opgemaakt id-bestand getoond. De inhoud kan er ongeveer hetzelfde uitzien.

abc123 def456 ghi789 xyz987

Overwegingen bij bestandsinhoud considerations

Wanneer u binnenkomende bestanden maakt, moet u ervoor zorgen dat de eerste kolom alleen apparaat-id's bevat, zoals AAM UUID, GAID, IDFA, enzovoort. Zie Index van id's in Audience Manager voor een gedetailleerde uitleg van id's die door Audience Manager worden ondersteund.

IMPORTANT
Niet gebruiken DPUUID's in de eerste kolom. Dit kan resulteren in een onjuiste synchronisatie.

Synchronisatie stemt overeen met DPUUID's met UUID's sync-matches-dpuuids-uuids

Het doel van een ID-synchronisatiebestand is het synchroniseren van de DPUUID's van uw eigen Gegevensbronnen met Audience Manager UUID's. Synchronisatie wijst de DPUUIDs van de master DPID en de daarmee verband houdende DPIDs naar de Audience Manager UUIDs. Wanneer u de id's in de bestandsnaam en de hoofdtekst plaatst, bepaalt u hoe deze id's aan elkaar worden toegewezen. Neem bijvoorbeeld de volgende twee voorbeeldbestanden:

  • Bestand 1: adobe_id_0_12345_1476312152.sync

  • Bestand 2: adobe_id_12345_67890_1476312876.sync

Op basis van de naam en inhoud van het voorbeeld worden de id's als volgt toegewezen:

Bestand 1 ( Voorbeeldbestand downloaden)

DPID 0 = Adobe Audience Manager UUIDs
DPID 12345
68079982765673198504052656074456196039
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR.38
67412682083411995725538770443620307584
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
89159024796760343733111707646026765593
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
66552757407517449462805881945288602094
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLworgJU2M
66184778222667870903738139438735041506
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw

Stap 1: het synchronisatieproces van de id de DPUUIDs van DPID 12345 met de Audience Manager UUIDs in de linkerkolom. De DPID "0" in de bestandsnaam staat voor Audience Manager UUIDs.

Bestand 2 ( Voorbeeldbestand downloaden)

DPID 12345
DPID 67890
XYZ3017D_2kzkTOXkFYIAgwbajoqWRcqkXl-TTrj6E4njaMR.38
4598060374
XYZ3017BBR4DAFJWfM6D4Gb4lN_T5jk_f7rdEcqNs9wfnA7h70
4581274262
XYZ3017PryPID8tzfhkEE-gE034LI-53Jde0utCYcIwd0A2OlM
4392434426
XYZ3017QvBddD-bLJS28DPxiqUfmIBxE3_55bvQJMLworgJU2M
2351382994
XYZ3017q9r60kuHPOca_Ek-btCN2iu1HyVaUe0rd412TzbyCMw
4601584763

Stap 2: de DPUUIDs van DPID 12345 zijn gesynchroniseerd in stap 1 met de Audience Manager UUIDs. Deze id-synchronisatie synchroniseert de DPUUIDs van DPID 67890 met de Audience Manager UUIDvanaf stap 1.

Overige indelingsvereisten other-format-reqs

Gebruikersnamen kunnen niet:

  • Plaats tabs in de id zelf. Tabs worden alleen gebruikt om afzonderlijke id's in het gegevensbestand te scheiden.
  • Persoonlijk identificeerbare gegevens bevatten (PII).
  • Gebruiken URL coderen. Alleen niet-gecodeerde id's doorgeven.

Rijen die eindigen met tabs of spaties, worden niet verwerkt of uitgevoerd. Zorg er doorgaans voor dat het einde van de rijen ongewijzigd blijft.

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