DIL-methode maken dil-create

WARNING
Vanaf juli 2023 heeft Adobe de ontwikkeling van de extensie Data Integration Library (DIL) en DIL stopgezet.
Bestaande klanten kunnen hun DIL -implementatie blijven gebruiken. Adobe ontwikkelt DIL echter niet verder dan dit punt. De klanten worden aangemoedigd om SDK van het Web van Experience Platformvoor hun lange termijn strategie van de gegevensinzameling te evalueren.
De klanten die nieuwe integratie van de gegevensinzameling na Juli 2023 willen uitvoeren zouden SDK van het Web van Experience Platformin plaats daarvan moeten gebruiken.

DIL maken dil-create-new

Maakt een partnerspecifieke DIL -instantie.

de Handtekening van de Functie: DIL.create: function (initConfig) {}

initConfig Elementen

IMPORTANT
Het visitorService bezit is altijd vereist. Andere hier vermelde eigenschappen zijn optioneel, tenzij anders aangegeven.

initConfig accepteert de volgende elementen:

Naam
Type
Beschrijving
containerNSID
Geheel

Deze eigenschap stelt de container-id in die door Audience Manager wordt gebruikt voor id-syncs. U stelt containerNSID in als u DIL hebt geïmplementeerd voor meerdere sites. Elk van deze sites heeft een eigen container-id en id-syncs. Als u slechts 1 site hebt, is de container-id standaard 0 en hoeft u dit niet op de juiste wijze in te stellen. Neem contact op met uw consultant voor een lijst met uw sites en de bijbehorende container-id's.

In de Adobe Experience Platform Identity Servicekomt de eigenschap idSyncContainerID overeen met containerNSID in DIL . Neem nota van het volgende als u DIL en de dienst van identiteitskaart over veelvoudige plaatsen gebruikt:

  • Stel voor elke site dezelfde container-id's in op containerNSID en idSyncContainerID .
  • Zowel DIL als de id-service proberen id-syncs naar ons iFrame voor gegevensverzameling te verzenden. De iFrame zorgt er echter voor dat DIL geen id-sync start. Zo voorkomt u dubbel werk.
  • Alleen DIL verzendt gegevens naar een URL-doel.

Zie ook idSyncContainerID.

declaredId
Object

declaredId wordt gebruikt om de volgende twee waarden door te geven:

  • dpid : ID van gegevenspartner die aan u is toegewezen door Audience Manager .
  • dpuuid : Uw unieke id voor een gebruiker.

Belangrijk: gebruik alleen niet-gecodeerde waarden voor uw id's. Bij codering worden dubbelgecodeerde id's gemaakt.

Opmerking: als u de Adobe Experience Platform Identity Servicegebruikt, stelt u de id's van de klant in met de methode setCustomerIDs in plaats van met DIL . Zie Klantnamen en verificatiestatus.

delayAllUntilWindowLoad
Boolean
Indien waar (true), worden alle aanvragen (IFRAME, gebeurtenisaanroepen, id-synchronisatie en doel) uitgesteld van uitvoering tot de gebeurtenis Page Load wordt geactiveerd. De standaardwaarde is false .
disableDeclaredUUIDCookie
Boolean
Standaard false, wat betekent dat Audience Manager een cookie in het domein van de partner instelt (een cookie van de eerste partij instelt).
disableDestinationPublishingIframe
Boolean

Belangrijk: dit element is vervangen door DIL versie 8.0 (uitgebracht in augustus 2018). Gebruik in plaats hiervan de visitor.disableIdSyncs functionin de Adobe Experience Platform Identity Service.

Indien true , wordt de IFRAME voor het publiceren van de bestemming niet gekoppeld aan de DOM- of branddoelen. De standaardwaarde is false .

disableIDSyncs
Boolean

Belangrijk: dit element is vervangen door DIL versie 8.0 (uitgebracht in augustus 2018). Gebruik in plaats hiervan de visitor.disableIdSyncs functionin de Adobe Experience Platform Identity Service.

Schakelt id-synchronisatie uit. U moet ID-syncs uitschakelen bij gebruik van DIL v6.2+ en de Bezoeker-id-service. Deze bewerking wordt uitgevoerd door de functie visitorService (zie de voorbeeldcode hieronder).

enableErrorReporting
Boolean
Stel in op true om foutmeldingen in te schakelen voor alle DIL -instanties op de pagina. Werkt alleen met Boolean true .
iframeAkamaiHTTPS
Boolean

Belangrijk: dit element is vervangen door DIL versie 8.0 (uitgebracht in augustus 2018). Gebruik in plaats hiervan de visitor.idSyncSSLUseAkamai functionin de Adobe Experience Platform Identity Service.

Hiermee wordt opgegeven of de doelpublicatiesjabloon Akamai moet gebruiken voor HTTPS-verbindingen. Toegelaten op een per-partnerbasis.

mappings
Object
Koppelt de waarde van het ene sleutelwaardepaar aan een ander. Zie Toetswaarden toewijzen aan andere toetsen. Uitgegeven met v2.4.
namespace
String

Vereist.

Het sleutelwaardepaar namespace bevat uw Experience Cloud -organisatie-id. Als u deze id niet hebt, kunt u deze vinden in de sectie Beheer van het Experience Cloud -dashboard. U hebt beheerdersmachtigingen nodig om dit dashboard weer te geven. Zie Veelgestelde vragen over productfuncties en -functiesen Beheer - Gebruikersbeheer en Veelgestelde vragen.

partner
String

Vereist.

De partnernaam zoals opgegeven door Audience Manager .

removeFinishedScriptsAndCallbacks
Boolean
Hiermee verwijdert u scripts en callbacks. De standaardwaarde is False . Is alleen van toepassing op de huidige DIL -instantie. Uitgegeven met v3.3.
uuidCookie
Object
Stelt een cookie in met de unieke gebruikersnaam die door Audience Manager wordt geretourneerd. Zie uuidCookie-eigenschappen.
visitorService
Object

Vereist met DIL 6.2 of hoger.

DIL vertrouwt op de setCustomerIDs functie in de Adobe Experience Platform Identity Service om gedeclareerde id's door te geven aan Audience Manager . Zie Klantnamen en verificatiestatusvoor meer informatie.

Code van de Steekproef

Een voorbeeldaanroep DIL kan er ongeveer als volgt uitzien:

var partnerObject1 = DIL.create({
  partner: "partner name",
  visitorService:{
    namespace: "INSERT-ORGANIZATION-ID-HERE"
  },
  containerNSID: 3,
  uuidCookie:{
    name:'ad_uuid',
    days:200,
    path:'/test',
    domain:'adobe.com',
    secure:true
  }
});

var partnerObject2 = DIL.create({
  partner: "partner name",
  visitorService:{
    namespace: "INSERT-MCORG-ID-HERE"
  },
  containerNSID: 3
});

Een geslaagde reactie retourneert de instantie DIL . Een mislukte poging retourneert een foutobject (niet gegenereerd) als de code onjuist is geconfigureerd of als er een fout optreedt.

uuidCookie-eigenschappen uuidcookie-props

Definieert de eigenschappen die door de variabele uuidCookie worden gebruikt. Deze variabele maakt deel uit van de methode DIL.create .

uuidCookie heeft de volgende eigenschappen:

Naam
Beschrijving
name
De naam van het cookie ( aam_did is standaard).
days
Het leven van het cookie (100 dagen is gebrek).
path
Cookie-pad, bijvoorbeeld '/test' ( / is standaard).
domain
Het domein waarin de cookie wordt ingesteld, bijvoorbeeld 'adobe.com' ( '.'+document.domain is default).
secure
Hiermee stelt u een markering in voor het verzenden van gegevens via alleen een HTTPS-verbinding.

eigenschappen van bezoekerService visitor-service-props

Definieert de eigenschappen die door de variabele visitorService worden gebruikt. Deze variabele maakt deel uit van de methode DIL.create .

visitorService heeft de volgende eigenschappen:

Naam
Type
Beschrijving
namespace
String
Vereist. Vertegenwoordigt de Experience Cloud Org ID. Dit is nodig voor de Experience Cloud Core Service-functionaliteit. Dezelfde parameter die wordt gebruikt om de functie Bezoekersidentiteitskaart te instantiëren.

Steekproef van de Code:

var vDil = DIL.create({
    partner: 'demofirst',
    visitorService: {
        namespace: "INSERT-EXPCLOUD-ORG-ID-HERE"
    }
});
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695