DIL create-metod dil-create

WARNING
Från och med juli 2023 har Adobe upphört med utvecklingen av Data Integration Library (DIL) och DIL tillägg.
Befintliga kunder kan fortsätta använda sina DIL implementering. Adobe kommer dock inte att utvecklas DIL bortom denna punkt. Kunder uppmanas att utvärdera Experience Platform Web SDK för deras långsiktiga strategi för datainsamling.
Kunder som vill implementera integreringar för datainsamling efter juli 2023 bör använda Experience Platform Web SDK i stället.

Skapa DIL dil-create-new

Skapar en partnerspecifik DIL -instans.

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

initConfig-element

IMPORTANT
The visitorService egenskapen är alltid krävs. Andra egenskaper som anges här är valfria, såvida inte annat anges.

initConfig använder 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-synkronisering. Du skulle ställa in containerNSID om du har DIL distribueras på 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 Service, egenskapen idSyncContainerID motsvarar containerNSID in 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åda DIL och ID-tjänsten kommer att försöka skicka ID-synkroniseringar till vår datainsamling iFrame. Men iFrame säkerställer att DIL aktiverar inte en ID-synkronisering. Detta förhindrar duplicering.
  • Endast DIL skickar data till en URL-mål.

Se även idSyncContainerID.

declaredId
Objekt

declaredId används för att skicka in

  • dpid : Dataparameterns 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 Service, ange kund-ID:n med setCustomerIDs i stället för DIL . Se Kund-ID och autentiseringstillstånd.

delayAllUntilWindowLoad
Boolean
Om true avbryts alla begäranden (IFRAME, händelseanrop, ID-synkronisering och mål) från att köras tills Page Load utlöses. Standard är false .
disableDeclaredUUIDCookie
Boolean
Falskt som standard, vilket betyder 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 identitetstjänst i stället.

If true , kommer inte att bifoga destinationspubliceringen IFRAME till DOM eller branddestinationerna. Standard ä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 identitetstjänst 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. The visitorService funktionen (se exempelkoden nedan) hanterar den här åtgärden.

enableErrorReporting
Boolean
Ange till true aktivera felrapportering för alla DIL instanser på sidan. Fungerar med Boolean true endast.
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 identitetstjänst 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.

The namespace nyckelvärdepar innehåller Experience Cloud Organisations-ID. Om du inte har detta ID kan du hitta det i Administration i Experience Cloud kontrollpanel. Du behöver administratörsbehörighet för att kunna visa den här instrumentpanelen. Se Funktioner och funktioner Frågor och svaroch Administration - Användarhantering och vanliga frågor och svar.

partner
Sträng

Obligatoriskt.

Partnernamn enligt Audience Manager .

removeFinishedScriptsAndCallbacks
Boolean
Tar bort skript och återanrop. Standard är False . Gäller den aktuella DIL Endast instans. 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 använder setCustomerIDs funktionen i Adobe Experience Platform Identity Service skicka deklarerade ID:n till Audience Manager . Se Kund-ID och autentiseringstillståndför mer information.

Exempelkod

Ett exempel DIL 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 godkänt svar returnerar DIL -instans. 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 uuidCookie variabel. Variabeln är en del av DIL.create -metod.

uuidCookie har följande egenskaper:

Namn
Beskrivning
name
Cookie-namn ( 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 visitorService variabel. Variabeln är en del av DIL.create -metod.

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.

Exempel på kod:

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