DIL, methode maken dil-create

WARNING
Vanaf juli 2023 heeft Adobe de ontwikkeling van de Data Integration Library (DIL) en de DIL extensie.
Bestaande klanten kunnen hun DIL uitvoering. Adobe zal zich echter niet ontwikkelen DIL verder dan dit punt. Klanten worden aangemoedigd om te evalueren Experience Platform Web SDK voor hun strategie voor het verzamelen van gegevens op lange termijn.
Klanten die na juli 2023 nieuwe integratie voor gegevensverzameling willen implementeren, moeten Experience Platform Web SDK in plaats daarvan.

DIL maken dil-create-new

Creeert partner-specifiek DIL -instantie.

Functiehandtekening: DIL.create: function (initConfig) {}

initConfig Elements

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

initConfig aanvaardt de volgende elementen:

Naam
Type
Beschrijving
containerNSID
Geheel

Met deze eigenschap wordt de container-id ingesteld die door Audience Manager voor ID-syncs. U kunt instellen containerNSID als u DIL opgesteld over veelvoudige plaatsen. 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 Service, de eigenschap idSyncContainerID komt overeen met containerNSID in DIL . Let op het volgende als u werkt DIL en de dienst van identiteitskaart over veelvoudige plaatsen:

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

Zie ook: idSyncContainerID.

declaredId
Object

declaredId wordt gebruikt voor het passeren van:

  • dpid : Identiteitskaart van de partner van Gegevens die aan u door wordt toegewezen Audience Manager .
  • dpuuid : Je 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 Service, klant-id's instellen met de setCustomerIDs methode in plaats van DIL . Zie Klant-id's en verificatiestatus.

delayAllUntilWindowLoad
Boolean
Indien waar (true), worden alle aanvragen (IFRAME, gebeurtenisaanroepen, id-synchronisatie en bestemming) uitgesteld van uitvoering tot de Page Load gebeurtenis wordt geactiveerd. Standaard is false .
disableDeclaredUUIDCookie
Boolean
Standaard false, wat betekent Audience Manager plaatst een koekje in het domein van de partner (plaatst een eerste partijkoekje).
disableDestinationPublishingIframe
Boolean

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

Indien true , zal IFRAME voor het publiceren van de bestemming niet aan de DOM- of branddoelen koppelen. Standaard is false .

disableIDSyncs
Boolean

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

Schakelt id-synchronisatie uit. U moet de syncs van identiteitskaart onbruikbaar maken wanneer het gebruiken van DIL v6.2+ en de Dienst van identiteitskaart van de Bezoeker. De visitorService Deze bewerking wordt uitgevoerd door een functie (zie de voorbeeldcode hieronder).

enableErrorReporting
Boolean
Instellen op true om foutenrapportering voor allen toe te laten DIL op de pagina. Werken met Boolean true alleen.
iframeAkamaiHTTPS
Boolean

Belangrijk: dit element is vervangen door DIL versie 8.0 (uitgebracht in augustus 2018). Gebruik de visitor.idSyncSSLUseAkamai functionin plaats daarvan in 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 Sleutelwaarden toewijzen aan andere toetsen. Uitgegeven met v2.4.
namespace
String

Vereist.

De namespace sleutelwaardepaar bevat uw Experience Cloud Organisatie-id. Als u deze id niet hebt, kunt u deze vinden in het dialoogvenster Administratie van de Experience Cloud dashboard. U hebt beheerdersmachtigingen nodig om dit dashboard weer te geven. Zie de Veelgestelde vragen over productfunctiesen Beheer - Gebruikersbeheer en veelgestelde vragen.

partner
String

Vereist.

De naam van de partner zoals verstrekt door Audience Manager .

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

Vereist met DIL 6.2 of hoger.

DIL is afhankelijk van de setCustomerIDs in de Adobe Experience Platform Identity Service gedeclareerde id's doorgeven in Audience Manager . Zie Klant-id's en verificatiestatusvoor meer informatie .

Voorbeeldcode

Een monster DIL De vraag zou gelijkaardig aan het volgende kunnen kijken:

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
});

Als de reactie succesvol was, worden de DIL -instantie. 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 worden gebruikt door de uuidCookie variabele. Deze variabele maakt deel uit van de DIL.create methode.

uuidCookie heeft de volgende eigenschappen:

Naam
Beschrijving
name
De cookienaam ( 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 is ingesteld, bijvoorbeeld: 'adobe.com' ( '.'+document.domain is standaard).
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 worden gebruikt door de visitorService variabele. Deze variabele maakt deel uit van de DIL.create methode.

visitorService heeft de volgende eigenschappen:

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

Codevoorbeeld:

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