DIL create-metod dil-create

WARNING
Från och med juli 2023 har Adobe upphört med utvecklingen av tillägget Data Integration Library (DIL) och DIL.
Befintliga kunder kan fortsätta använda sin DIL-implementering. Adobe kommer dock inte att utveckla DIL efter den här punkten. Kunder uppmuntras att utvärdera Experience Platform Web SDK för sin långsiktiga datainsamlingsstrategi.
Kunder som vill implementera integreringar för datainsamling efter juli 2023 bör använda Experience Platform Web SDK i stället.

DIL create dil-create-new

Skapar en partnerspecifik DIL-instans.

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

initConfig-element

IMPORTANT
Egenskapen visitorService är always obligatoriskt. Andra egenskaper som anges här är valfria, såvida inte annat anges.

initConfig accepterar följande element:

Namn
Typ
Beskrivning
containerNSID
Heltal

Den här egenskapen anger behållar-ID som används av Audience Manager för ID-synkroniseringar. Du skulle ange containerNSID om du har DIL distribuerat över flera platser. Var och en av dessa platser kommer att ha sina egna behållar-ID- och ID-synkroniseringar. När du bara har en plats är behållar-ID 0 som standard och du behöver inte ange detta korrekt. Kontakta din konsult för att få en lista över dina webbplatser och deras behållar-ID.

I Adobe Experience Platform Identity Servicemotsvarar egenskapen idSyncContainerID ``containerNSID i DIL . Observera följande om du använder DIL och ID-tjänsten på flera platser:

  • För varje plats anger du samma behållar-ID på containerNSID och idSyncContainerID .
  • Både DIL och ID-tjänsten kommer att försöka skicka ID-synkroniseringar till vår datainsamling iFrame. iFrame säkerställer dock att DIL inte startar en ID-synkronisering. Detta förhindrar duplicering.
  • Endast DIL skickar data till ett URL-mål.

Se även idSyncContainerID.

declaredId
Objekt

declaredId används för att skicka in:

  • dpid : Datapartner-ID tilldelat dig av Audience Manager .
  • dpuuid : Ditt unika ID för en användare.

Viktigt: Använd endast okodade värden för dina ID:n. Kodningen skapar dubbelkodade identifierare.

Obs! Om du använder Adobe Experience Platform Identity Serviceanger du kundens ID med metoden setCustomerIDs i stället för DIL . Se Kund-ID och autentiseringstillstånd.

delayAllUntilWindowLoad
Boolean
Om värdet är true avbryts alla begäranden (IFRAME, händelseanrop, ID-synkronisering och mål) från att köras tills händelsen Page Load aktiveras. Standardvärdet är false .
disableDeclaredUUIDCookie
Boolean
Falskt som standard, vilket innebär att Audience Manager anger en cookie i partnerdomänen (anger en cookie för första part).
disableDestinationPublishingIframe
Boolean

Viktigt: Det här elementet har ersatts med DIL version 8.0 (släppt augusti 2018). Använd visitor.disableIdSyncs functioni Adobe Experience Platform Identity Service i stället.

Om true bifogas inte målpubliceringens IFRAME till DOM- eller brandmålen. Standardvärdet är false .

disableIDSyncs
Boolean

Viktigt: Det här elementet har ersatts med DIL version 8.0 (släppt augusti 2018). Använd visitor.disableIdSyncs functioni Adobe Experience Platform Identity Service i stället.

Inaktiverar ID-synkronisering. Du måste inaktivera ID-synkronisering när du använder DIL v6.2+ och Visitor ID-tjänsten. Funktionen visitorService (se exempelkod nedan) hanterar den här åtgärden.

enableErrorReporting
Boolean
Ange true om du vill aktivera felrapportering för alla DIL -instanser på sidan. Fungerar endast med Boolean true .
iframeAkamaiHTTPS
Boolean

Viktigt: Det här elementet har ersatts med DIL version 8.0 (släppt augusti 2018). Använd visitor.idSyncSSLUseAkamai functioni Adobe Experience Platform Identity Service i stället.

Anger om målpubliceringsmallen ska använda Akamai för HTTPS-anslutningar. Aktiverat per partner.

mappings
Objekt
Associerar värdet från ett nyckelvärdepar till ett annat. Se Mappa nyckelvärden till andra nycklar. Släppt med v2.4.
namespace
Sträng

Obligatoriskt.

Nyckelvärdepar namespace innehåller ditt organisations-ID Experience Cloud . Om du inte har det här ID:t kan du hitta det i avsnittet Administration på kontrollpanelen Experience Cloud . Du behöver administratörsbehörighet för att kunna visa den här instrumentpanelen. Se Frågor och svar om produktfunktioneroch Administration - Användarhantering och vanliga frågor.

partner
Sträng

Obligatoriskt.

Partnernamn som anges av Audience Manager .

removeFinishedScriptsAndCallbacks
Boolean
Tar bort skript och återanrop. Standardvärdet är False . Gäller endast den aktuella DIL -instansen. Har släppts med v3.3.
uuidCookie
Objekt
Anger en cookie med det unika användar-ID som returneras från Audience Manager . Se uidCookie-egenskaper.
visitorService
Objekt

Krävs med DIL 6.2 eller senare.

DIL förlitar sig på funktionen setCustomerIDs i Adobe Experience Platform Identity Service för att skicka deklarerade ID:n till Audience Manager . Mer information finns i Kund-ID och autentiseringstillstånd.

Exempelkod

Ett exempel på DIL-anrop kan se ut ungefär så här:

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

Ett svar returnerar instansen DIL. Ett misslyckat försök returnerar ett felobjekt (kastas inte) om koden har konfigurerats felaktigt eller om ett fel påträffas.

uidCookie-egenskaper uuidcookie-props

Definierar egenskaperna som används av variabeln uuidCookie. Den här variabeln ingår i metoden DIL.create.

uuidCookie har följande egenskaper:

Namn
Beskrivning
name
Cookie-namnet ( aam_did är standard).
days
Cookie-livstid (100 dagar är standard).
path
Cookie-sökväg, t.ex. '/test' ( / är standard).
domain
Domänen som cookien är inställd i, t.ex. 'adobe.com' ( '.'+document.domain är standard).
secure
Anger en flagga som endast skickar data via en HTTPS-anslutning.

visitorService-egenskaper visitor-service-props

Definierar egenskaperna som används av variabeln visitorService. Den här variabeln ingår i metoden DIL.create.

visitorService har följande egenskaper:

Namn
Typ
Beskrivning
namespace
Sträng
Obligatoriskt. Representerar Org-ID:t för Experience Cloud. Detta krävs för Experience Cloud Core Service-funktionaliteten. Samma parameter som används för att instansiera funktionaliteten för besökar-ID.

Kodexempel:

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