Dokumentation Experience Platform Användarhandbok om destinationer

LiveRamp - Onboarding-anslutning liveramp-onboarding

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
Destinationer

Skapat för:

Administratör
Användare

Använd anslutningen LiveRamp - Onboarding för att inkludera målgrupper från Adobe Real-time Customer Data Platform i LiveRamp Connect.

Användningsfall use-cases

För att du bättre ska kunna förstå hur och när du ska använda målet LiveRamp - Onboarding finns det ett exempel på användning som Adobe Experience Platform-kunder kan lösa genom att använda det här målet.

Som marknadsförare vill jag skicka målgrupper från Adobe Experience Platform till inbyggda identiteter till LiveRamp Connect så att jag kan inrikta mig på användare på mobiler, öppna webben, sociala medier och CTV -plattformar med hjälp av identifieraren Ramp ID.

Förhandskrav prerequisites

Anslutningen LiveRamp - Onboarding exporterar filer med LiveRamps SFTP-lagring.

Innan du kan skicka data från Experience Platform till LiveRamp - Onboarding behöver du dina LiveRamp-autentiseringsuppgifter. Kontakta din LiveRamp-representant för att få dina autentiseringsuppgifter, om du inte redan har dem.

Identiteter som stöds supported-identities

LiveRamp - Onboarding stöder aktivering av identiteter som PII-baserade identifierare, kända identifierare och anpassade ID:n, som beskrivs i den officiella LiveRamp-dokumentationen.

I mappningssteget i aktiveringsarbetsflödet måste du definiera målmappningarna som anpassade attribut.

Målgrupper supported-audiences

I det här avsnittet beskrivs vilka typer av målgrupper du kan exportera till det här målet.

Målgruppsursprung

Stöds

Beskrivning

Segmentation Service

✓

Publiker som genererats via Experience Platform segmenteringstjänsten.

Anpassade överföringar

✓

Publikerna importerade till Experience Platform från CSV-filer.

Exportera typ och frekvens export-type-frequency

Se tabellen nedan för information om exporttyp och frekvens för destinationen.

Objekt

Typ

Anteckningar

Exporttyp

Audience export

Du exporterar alla medlemmar i en målgrupp med identifierarna (namn, telefonnummer eller andra) som används i målet LiveRamp - Onboarding.

Exportfrekvens

Daily batch

När profiler uppdateras i Experience Platform baserat på målgruppsutvärdering uppdateras profilerna (identiteterna) en gång om dagen nedströms målplattformen. Läs mer om gruppfilsbaserade mål.

Anslut till målet connect

IMPORTANT

Om du vill ansluta till målet behöver du behörigheterna View Destinations och Manage Destinations åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.

Om du vill ansluta till det här målet följer du stegen som beskrivs i självstudiekursen för destinationskonfiguration. I arbetsflödet för att konfigurera mål fyller du i fälten som listas i de två avsnitten nedan.

Autentisera till mål authenticate

Fyll i de obligatoriska fälten och välj Connect to destination om du vill autentisera mot målet.

SFTP-autentisering med lösenord

Exempelbild som visar hur du autentiserar till målet med SFTP med lösenord

Port: Den port som används för din LiveRamp - Onboarding-lagringsplats. Använd den port som motsvarar din geografiska plats enligt beskrivningen nedan:
- NA: Använd port 22
- AU: Använd port 2222
Username: Användarnamnet för lagringsplatsen LiveRamp - Onboarding.
Password: Lösenordet för lagringsplatsen LiveRamp - Onboarding.
PGP/GPG encryption key: Om du vill kan du bifoga den RSA-formaterade offentliga nyckeln för att lägga till kryptering i de exporterade filerna. Visa ett exempel på en korrekt formaterad krypteringsnyckel i bilden nedan.
Subkey ID:Om du anger en krypteringsnyckel måste du även ange en kryptering Subkey ID. Läs LiveRamp krypteringsdokumentationen om du vill veta mer om hur du hämtar undernyckel-ID:t.

SFTP med SSH-nyckelautentisering

Exempelbild som visar hur du autentiserar till målet med SSH-tangenten

Port: Den port som används för din LiveRamp - Onboarding-lagringsplats. Använd den port som motsvarar din geografiska plats enligt beskrivningen nedan:
- EU: Använd port 4222
Username: Användarnamnet för lagringsplatsen LiveRamp - Onboarding.
SSH Key: Den privata SSH-nyckeln som används för att logga in på din LiveRamp - Onboarding-lagringsplats. Den privata nyckeln måste vara formaterad som en Base64-kodad sträng och får inte vara lösenordsskyddad.
- Om du vill ansluta din SSH-nyckel till LiveRamp - Onboarding-servern måste du skicka in en biljett via LiveRamps tekniska supportportal och ange din offentliga nyckel. Mer information finns i LiveRamp-dokumentationen.
PGP/GPG encryption key: Om du vill kan du bifoga den RSA-formaterade offentliga nyckeln för att lägga till kryptering i de exporterade filerna. Visa ett exempel på en korrekt formaterad krypteringsnyckel i bilden nedan.
Subkey ID:Om du anger en krypteringsnyckel måste du även ange en kryptering Subkey ID. Läs LiveRamp krypteringsdokumentationen om du vill veta mer om hur du hämtar undernyckel-ID:t.

Fyll i målinformation destination-details

Om du vill konfigurera information för målet fyller du i de obligatoriska och valfria fälten nedan. En asterisk bredvid ett fält i användargränssnittet anger att fältet är obligatoriskt.

Plattformsgränssnitt, bild som visar hur du fyller i information för ditt mål

Name: Ett namn som du känner igen det här målet med i framtiden.
Description: En beskrivning som hjälper dig att identifiera det här målet i framtiden.
Region: Geografiskt område för din instans av LiveRamp SFTP-lagringen.
Folder path: Sökvägen till undermappen LiveRamp uploads som ska vara värd för de exporterade filerna. Prefixet uploads läggs automatiskt till i mappsökvägen. LiveRamp rekommenderar att du skapar en dedikerad undermapp för leveranser från Adobe Real-Time CDP för att hålla filerna åtskilda från andra befintliga feeds och för att säkerställa att all automatisering går smidigt.
- Om du till exempel vill exportera dina filer till uploads/my_export_folder skriver du my_export_folder i fältet Folder path.
Compression format: Välj den komprimeringstyp som Experience Platform ska använda för de exporterade filerna. Tillgängliga alternativ är GZIP eller None.

Aktivera aviseringar enable-alerts

Du kan aktivera varningar för att få meddelanden om dataflödets status till ditt mål. Välj en avisering i listan om du vill prenumerera och få meddelanden om statusen för ditt dataflöde. Mer information om varningar finns i guiden prenumerera på destinationsvarningar med användargränssnittet.

Välj Next när du är klar med att ange information för målanslutningen.

Aktivera målgrupper till det här målet activate

IMPORTANT

För att aktivera data behöver du behörigheterna View Destinations, Activate Destinations, View Profiles och View Segments åtkomstkontroll. Läs åtkomstkontrollsöversikten eller kontakta produktadministratören för att få den behörighet som krävs.

Läs Aktivera målgruppsdata för att batchprofilera exportmål om du vill ha instruktioner om hur du aktiverar målgrupper till det här målet.

Schemaläggning scheduling

I steget Scheduling skapar du ett exportschema för varje målgrupp, med inställningarna nedan.

File export options: Export full files. Inkrementell filexport stöds för närvarande inte för målet LiveRamp.
Frequency: Daily
Date: Välj start- och sluttider för exporten.

Skärmbild för plattformsgränssnitt som visar steg för målgruppsplanering.

Det går inte att konfigurera det exporterade filnamnet för tillfället. Alla filer som exporteras till målet LiveRamp - Onboarding får automatiskt namn baserat på följande mall:

%ORGANIZATION_NAME%_%DESTINATION%_%DESTINATION_INSTANCE_ID%_%DATETIME%

Plattformsanvändargränssnittet visar den exporterade filnamnsmallen.

Namnet på en exporterad fil för en organisation med namnet Luma kan till exempel se ut ungefär så här:

Luma_LiveRamp_52137231-4a99-442d-804c-39a09ddd005d_20230330_153857.csv

Mappa attribut och identiteter map

I steget Mapping kan du välja vilka attribut och identiteter du vill exportera för dina profiler.

IMPORTANT

Detta mål stöder aktivering av ett källidentitetsnamnutrymme per aktiveringsflöde. Om du behöver exportera flera identitetsnamnutrymmen, som Email och Phone, måste du skapa ett separat aktiveringsflöde för varje identitet.

I steget Mapping definierar mappningen Target field namnet på kolumnrubriken i den exporterade CSV-filen. Du kan ändra CSV-kolumnrubrikerna i den exporterade filen till vilket eget namn du vill genom att ange ett anpassat namn för Target field.

IMPORTANT

Om målfälten ändras efter den första filleveransen till LiveRamp ska du kontakta ditt LiveRamp-kontoteam eller skicka en biljett till LiveRamp-support för att se till att ändringarna återspeglas i automatiseringsprocessen.

Välj Add new mapping i steget Mapping. En ny mappningsrad visas på skärmen.
Välj kategorin Select attributes i fönstret Select source field och markera det XDM-attribut som du vill mappa, eller välj kategorin Select identity namespace och välj en identitet som du vill mappa till målet.
I fönstret Select target field anger du det attributnamn som du vill mappa det markerade källfältet till. Attributnamnet som definieras här återspeglas i den exporterade CSV-filen som en kolumnrubrik.

Du kan också ange attributnamnet genom att skriva det direkt i Target field.

När du har lagt till alla dina önskade mappningar väljer du Next och slutför aktiveringsarbetsflödet.

Exporterade data/Validera dataexport exported-data

Dina data exporteras till lagringsplatsen LiveRamp - Onboarding som du konfigurerade som CSV-filer.

Exporterade filer har en maxstorlek på 10 miljoner rader. Experience Platform genererar flera filer per leverans om de valda målgrupperna överstiger 10 miljoner rader. Om du förväntar dig att överskrida gränsen för en enda fil kontaktar du LiveRamp-representanten och ber dem konfigurera gruppintagning åt dig.

När du exporterar filer till målet LiveRamp - Onboarding genererar Plattform en CSV-fil för varje ID för sammanfogningsprincip.

Låt oss titta på följande målgrupper:

Målgrupp A (sammanfogningsprincip 1)
Målgrupp B (sammanfogningspolicy 2)
Målgrupp C (sammanfogningspolicy 1)
Målgrupp D (sammanfogningspolicy 1)

Plattformen exporterar två CSV-filer till LiveRamp - Onboarding:

En CSV-fil som innehåller målgrupperna A, C och D.
En CSV-fil som innehåller målgrupp B.

Exporterade CSV-filer innehåller profiler med de valda attributen och motsvarande målgruppsstatus, i separata kolumner, med attributnamnet och audience_namespace:audience_ID par som kolumnrubriker, vilket visas i exemplet nedan:

ATTRIBUTE_NAME, AUDIENCE_NAMESPACE_1_AUDIENCE_ID_1, AUDIENCE_NAMESPACE_2_AUDIENCE_ID_2,..., AUDIENCE_NAMESPACE_X_AUDIENCE_ID_X

Profilerna som ingår i de exporterade filerna kan matcha ett av följande kvalificeringstillstånd för målgruppen:

Active: Profilen är för närvarande kvalificerad för målgruppen.
Expired: Profilen är inte längre kvalificerad för målgruppen, men har tidigare kvalificerats.
""(tom sträng): Profilen har aldrig kvalificerats för målgruppen.

En exporterad CSV-fil med till exempel ett email-attribut, två målgrupper som kommer från Experience Platform segmenteringstjänsten och en importerad extern målgrupp kan se ut så här:

email,ups_aa2e3d98-974b-4f8b-9507-59f65b6442df,ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f,CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e
abc117@testemailabc.com,active,,
abc111@testemailabc.com,,,active
abc102@testemailabc.com,,,active
abc116@testemailabc.com,active,,
abc107@testemailabc.com,active,expired,active
abc101@testemailabc.com,active,active,

I exemplet ovan beskriver avsnitten ups_aa2e3d98-974b-4f8b-9507-59f65b6442df och ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f målgrupper som härrör från segmenteringstjänsten, medan CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e beskriver en målgrupp som importerats till Platform som en anpassad överföring.

Eftersom Platform genererar en CSV-fil för varje ID för sammanfogningsprincip genereras även en separat dataflödeskörning för varje ID för sammanfogningsprincip.

Det innebär att Identities activated- och Profiles received-måtten på dataflödet körs-sidan aggregeras för varje grupp av målgrupper som använder samma sammanfogningsprincip, i stället för att visas för varje målgrupp.

Som en följd av att dataflöden genereras för en grupp målgrupper som använder samma sammanfogningsprincip visas inte målgruppsnamnen på kontrollpanelen.

Experience Platform-gränssnittsskärmbild som visar de identiteter som aktiverats.

Överför exporterade data till LiveRamp upload-to-liveramp

När dina data har exporterats till lagringsutrymmet LiveRamp - Onboarding måste du överföra dem till plattformen LiveRamp.

Mer information om hur du överför filer från LiveRamp - Onboarding-lagringen till en LiveRamp-målgrupp finns i följande dokumentation: Att tänka på när du överför den första filen till en målgrupp.

Dataanvändning och styrning data-usage-governance

Alla Adobe Experience Platform-mål är kompatibla med dataanvändningsprinciper när data hanteras. Mer information om hur Adobe Experience Platform använder datastyrning finns i Översikt över datastyrning.

Ytterligare resurser additional-resources

Mer information om hur du konfigurerar ditt LiveRamp - Onboarding-lagringsutrymme finns i den officiella dokumentationen.

Changelog changelog

I det här avsnittet beskrivs funktionaliteten och viktiga dokumentationsuppdateringar för den här målanslutningen.

Visa ändringslogg

table 0-row-3 1-row-3 2-row-3 layout-auto
Releasamånad	Uppdateringstyp	Beskrivning
Mars 2024	Funktioner och dokumentation	Stöd har lagts till för leveranser till Europa och Australien LiveRamp SFTP instanser. Uppdaterad dokumentation som beskriver specifika konfigurationer för nyligen stödda regioner. Ökade maximal filstorlek till 10 miljoner rader (från 5 miljoner tidigare). Uppdaterad dokumentation för att återspegla ökad filstorlek.
Juli 2023	Inledande version	Ursprunglig målrelease och dokumentation publicerad.

recommendation-more-help

7f4d1967-bf93-4dba-9789-bb6b505339d6