DocumentatieAudience ManagerAudience Manager-gebruikershandleiding

Naam van uitgaande-databestand: syntaxis en voorbeelden outbound-data-file-name-syntax-and-examples

Last update: Sat May 20 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Beschrijft de vereiste gebieden, de syntaxis, en de overeenkomsten die worden gebruikt om een uitgaand gegevensdossier te noemen.

NOTE
De stijlelementen (monospaced text, cursief, vierkante haken [ ] ( ), enz.) in dit document de elementen en opties van de code aangeven. Zie Stijlconventies voor code- en tekstelementen voor meer informatie.

Syntaxis en bestandsnaamelementen syntax-file-name

Uitgaande bestandsnamen bevatten de volgende elementen. Alle onderstaande elementen zijn optioneel.

[SYNC_TYPE][_DID][_MASTER_DPID][_PID_ALIAS][_SYNC-MODE][_TIMESTAMP]SPLITNUM.sync[.gz]

Parameters

De tabel definieert de elementen in de naam van een uitgaand gegevensbestand.

Bestandsnaamelement
Beschrijving
SYNC_TYPE

Verwijst naar de methoden voor gegevensoverdracht. Overdrachtsmethoden zijn onder meer:

  • FTP - Overdracht met SFTP
  • Amazon S3 - Overdracht naar Amazon AWS
DID

Doel-id.

In Audience Manager , is een doel het geval van de integratie waar u uw doelsegmenten kunt in kaart brengen. De klanten kunnen veelvoudige bestemmingen, afhankelijk van het bedrijfsvereiste hebben.

MASTER_DPID

Data-provider of gegevensbron-id. Deze id geeft het type gebruikersnaam aan dat aanwezig is in de bestandsinhoud. De meest gebruikte gebruikersnamen zijn:

  • 20914 - Google Advertiser ID (onbewerkt, ongehasht)
  • 20915 - Apple-id voor adverteerders (onbewerkt, ongehasht)
  • Leveranciers-id - gebruikers-id's van derden (web/cookie)

Zie Algemene databronnen voor meer informatie.

PID_ALIAS
De klant-id van het externe platform.
SYNC_MODE

De synchronisatiemodus is een macro-plaatsaanduiding die een label toevoegt aan de bestandsnaam op basis van het synchronisatietype. De types van synchronisatie omvatten volledig en stijgende. Ze worden in de bestandsnaam weergegeven als iter of full .

  • iter : Geeft een "iteratieve" of incrementele synchronisatie aan. Een incrementeel bestand bevat alleen nieuwe gegevens die zijn verzameld sinds de laatste synchronisatie.
  • full : Geeft een volledige synchronisatie aan. Een volledig gesynchroniseerd bestand bevat oude gegevens en eventuele nieuwe gegevens die zijn verzameld sinds de laatste synchronisatie.
TIMESTAMP
Een UNIX-tijdstempel van 13 cijfers in milliseconden, in de UTC-tijdzone.
SPLITNUM

Een geheel getal. Identificeert een deel van een dossier dat in veelvoudige delen is verdeeld om verwerkingstijden te verbeteren. Het getal geeft aan tot welk deel van het oorspronkelijke bestand de gegevens behoren.

Het gehele getal moet ten minste drie cijfers lang zijn, voorafgegaan door nullen, als de gesplitste grootte kleiner is dan 100 delen.

Het oorspronkelijke bestand heeft geen splitsingsnummer. Het eerste gesplitste bestand eindigt bij 001. Zie onderstaande voorbeelden.

.gz (optional)
GZIP-compressie.

Voorbeelden van bestandsnamen file-name-examples

Scenario 1

Bestanden verzonden naar een Amazon S3 locatie, met PID_ALIAS="XYZCustomer" en met Google Advertiser IDs in de bestandsinhoud.

Bijvoorbeeld incrementele bestanden:

  • S3_1234_20914_XYZCustomer_iter_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000001.sync.gz
  • S3_1234_20914_XYZCustomer_iter_1486140844000002.sync.gz

Bijvoorbeeld volledige bestanden:

  • S3_1234_20914_XYZCustomer_full_1486140844000.sync.gz
  • S3_1234_20914_XYZCustomer_full_1486140844000001.sync.gz

Scenario 2

Bestanden verzonden naar FTP locatie, zonder PID_ALIAS en met Apple Advertiser IDs in de bestandsinhoud:

Bijvoorbeeld incrementele bestanden:

  • ftp_1234_20915_iter_1486140843000.sync.gz
  • ftp_1234_20915_iter_1486140843000001.sync.gz

Bijvoorbeeld volledige bestanden:

  • ftp_1234_20915_full_1486140843000.sync.gz
  • ftp_1234_20915_full_1486140843000001.sync.gz

Scenario 3: Bestanden verzonden naar FTP locatie, met PID_ALIAS="XYZCustomer" en met een derde-gebruiker-id in de bestandsinhoud ( Vendor ID=45454):

Bijvoorbeeld incrementele bestanden:

  • ftp_1234_45454_XYZCustomer_iter_1486140843000.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz
  • ftp_1234_45454_XYZCustomer_iter_1486140843000001.sync.gz

Bijvoorbeeld volledige bestanden:

  • ftp_1234_45454_XYZCustomer_full_1486140843200.sync.gz
  • ftp_1234_45454_XYZCustomer_full_1486140843200001.sync.gz

Inhoud van uitgaande gegevensbestanden: Syntaxis en parameters outbound-contents-syntax

Beschrijft de vereiste gebieden, de syntaxis, en de overeenkomsten die worden gebruikt om informatie in een uitgaand gegevensdossier te organiseren. Maak uw gegevens op volgens deze specificaties.

NOTE
De stijlelementen (monospaced text, cursief, vierkante haken [ ] ( ), enz.) in dit document de elementen en opties van de code aangeven. Zie Stijlconventies voor code- en tekstelementen voor meer informatie.

Syntaxis

Velden in het gegevensbestand worden in deze volgorde weergegeven:

UUID<SPACE>SEGMENT_1,SEGMENT_2<SPACE>REMOVED_SEGMENT_,...

Parameters

De tabel bevat variabelen die de inhoud van een gegevensbestand definiëren.

Parameter
Beschrijving
UUID
Een unieke gebruikersnaam toegewezen door Audience Manager .
<SPACE>
Scheid UUID en segmentgegevens met een ruimte
SEGMENT_N
De segment-id waartoe een bezoeker behoort. Scheid meerdere segmenten met een komma.
REMOVED_SEGMENT_N
De segment-id waarvan de gebruiker is uitgesloten. Scheid meerdere segmenten met een komma. Met een volledige synchronisatie, kunt u de verwijderde segmenten negeren omdat het gegevensdossier de volledige lijst van huidige segmenten voor de gebruiker zal bevatten. Gewoonlijk, wilt u over segmenten weten een gebruiker tot eerder dan die behoort die zij uit zijn verwijderd. Zie ook Naam uitgaand gegevensbestand: Syntaxis en voorbeelden.

Voorbeeld: Basisbestandsindeling

Een gegevensbestand met de juiste indeling kan er ongeveer als volgt uitzien. Deze bestandsinvoer geeft aan dat een gebruiker voor de segmenten 24, 26 en 27 in aanmerking komt. Indien vereist wordt een spatie tussen de UUID en segment-id's. Een andere ruimte scheidt de reeksen segment IDs. In dit voorbeeld behoort een gebruiker tot de segmenten 24, 26 en 27. Ze zijn verwijderd uit segmenten 25 en 28.

59767559181262060060278870901087098252  24,26,27  25,28
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695