[Begränsad tillgänglighet]{class="badge informative"}
Konfigurera Google Cloud Storage för målgruppskälla
Följ stegen i den här guiden för att ansluta din GCS-bucket (Google Cloud Storage) till Adobe Real-Time CDP Collaboration och börja hämta förstapartsdata via användargränssnittet.
Koppla en GCS-bucket till Collaboration för att importera förstahandsdata till målgrupper direkt utan teknisk support. När Collaboration är uppkopplat kommer de att ha en återkommande målgrupp i ett svep och göra dem tillgängliga för aktivering och överlappningsanalys i samarbetsprojekten. Det är ett nödvändigt steg att skaffa fram era målgrupper innan ni kan aktivera dem eller använda dem i överlappningsanalyser med medarbetare.
Den här guiden täcker hela arbetsflödet för konfiguration: förbereda krav, autentisera GCS-bucket, granska automatiskt mappade identitetsfält, schemalägga datauppdatering och bekräfta att källan har slutförts.
Målgrupper som kommer från Google Cloud Storage följer samma regler för styrning och datahantering som målgrupper som kommer från Adobe Experience Platform.
Andra tillgängliga källmetoder är bland annat Experience Platform, Amazon S3, Snowflake och CSV-filöverföring.
Förutsättningar prerequisites
Slutför alla objekt i det här avsnittet innan du startar konfigurationsarbetsflödet. Ofullständiga förutsättningar är den vanligaste anledningen till att konfigurationen misslyckas eller att målgrupperna inte visas efter källan. Innan du följer den här guiden måste du ha slutfört kontointroduktionen och konfigurationen.
Vissa steg i det här avsnittet kräver åtgärd av en Google Cloud-administratör. Om du inte är Google Cloud-administratör för din organisation måste du identifiera rätt person innan du börjar.
GCS-åtkomst och -behörigheter gcs-access-permissions
Bekräfta följande med din Google Cloud-administratör innan du fortsätter:
- Adobe har fått de behörigheter som krävs för att autentisera mot GCS-bucket och läsa målgruppsfiler.
- Google Cloud Storage målgruppskälla är tillgänglig i din region. Tillgängligheten varierar beroende på region (NA, EMEA, ANZ). Om det inte finns någon GCS-källa i ditt område än kontaktar du Adobe för att bekräfta en tidslinje.
Förbered era målgruppsdata prepare-audience-data
Dina målgruppsfiler måste överensstämma med Audience Sourcing Specification (v1.2) innan du kan börja använda källan. Granska specifikationen för den fullständiga schemadefinitionen och exempel på fältnivå. Viktiga krav:
- Filformat: CSV, använder kommatecken som fältavgränsare och rör (
|) som avgränsare för flera värden i ett enskilt fält. - Obligatoriska fält: Varje post måste innehålla en
AUDIENCE_ID-kolumn och minst en matchande nyckelkolumn som stöds. - Matchningsnycklar som stöds:
HASHED_EMAIL_SHA_256,HASHED_PHONE_SHA_256,HASHED_IPV4_SHA_256,CRM_ID,LOYALTY_ID,ADFIXUS_ID. - Kraven för hashning: Alla matchande nyckelvärden måste trimmas, sänkas och SHA256-hash-kodas före överföringen. Collaboration hash-kodar eller normaliserar inte data före intag.
- Kolumnkonsekvens: Om din bucket innehåller flera målgruppsfiler måste alla filer använda identiska kolumnstrukturer.
Alla matchande nycklar i målgruppsfilerna måste också aktiveras för ditt Collaboration-konto. Mer information om hur du lägger till eller aktiverar matchningsnycklar finns i Konfigurera matchningsnycklar.
Värden som krävs innan du börjar required-values
Ha följande värden klara innan du startar konfigurationsguiden.
sourcing/testdata/path1/).Konfigurera din Google Cloud Storage-anslutning configure-gcs-connection
Konfigurationsarbetsflödet är en guide i flera steg i arbetsytan Setup. Slutför varje steg i följd. Du kan gå tillbaka till vilket steg som helst med pennikonen på den sista granskningsskärmen innan du skapar anslutningen.
Lägg till en ny dataanslutning add-data-connection
På fliken My audiences i arbetsytan Setup väljer du ikonen Lägg till (
) och välj sedan Audience.
Om det här är din första målgrupp kan du även välja alternativet Add.
Arbetsflödet Lägg till målgrupp visas. Välj Add a new data connection och sedan Next.
{modal="regular"}
Välj Google Cloud Storage som datakälla select-gcs
På skärmen för val av datakälla visas alla tillgängliga anslutningstyper. Välj Google Cloud Storage och sedan Next.
En dialogruta med information om nödvändiga konfigurationssteg (till exempel GCS-bucket-konfiguration och IAM-rolltilldelning) visas och noterar att data måste uppfylla Audience Sourcing Specification. Välj Start onboarding om du vill bekräfta kompatibiliteten innan du fortsätter.
Ange din Google Cloud Storage-anslutningsinformation authenticate-gcs-connection
Ange den information som krävs för att Collaboration ska kunna komma åt din Google Cloud Storage-bucket. När du har angett den obligatoriska informationen väljer du Next.
Bekräfta samtycke och bekräftelse av dataanvändning confirm-consent
Du måste bekräfta att avanmälan om samtycke har tagits bort från målgruppsdata innan Collaboration kan bearbeta den. Om du är osäker på om dina data uppfyller det här kravet kan du förhandsgranska guiden Styrningsprincip och verkställighetsåtgärder innan du fortsätter. Markera bekräftelsekryssrutan och välj sedan OK för att fortsätta.
Ange anslutningsinformation provide-connection-details
Ange ett namn och en valfri beskrivning för den här dataanslutningen. Det namn du anger visas på fliken My data connections och hjälper dig att skilja på den här källan om du hanterar flera dataanslutningar.
- Data connection name (obligatoriskt)
- Data connection description (valfritt).
Välj Next om du vill fortsätta.
Granska automatiskt mappade identitetsfält auto-mapped-fields
Skärmen Mapping är skrivskyddad. Collaboration mappar automatiskt källidentitetsfält från målgruppsfiler till målfält baserat på kolumnnamnen som definieras i specifikationen för målgruppsresurser. Du kan inte lägga till, ta bort eller tillämpa omformningar på mappade fält i det här skedet.
Bekräfta att de visade mappningarna avspeglar fälten i målgruppsfilerna. Om de inte gör det stoppar och korrigerar du filerna så att de överensstämmer med specifikationen för målgruppsresurser innan du fortsätter. Välj Next om du vill fortsätta.
Schemalägg datauppdatering schedule-data-refresh
I vyn Schedule anger du hur ofta Collaboration hämtar uppdaterade målgruppsdata från GCS-bucket och definierar det aktiva datumintervallet för källa.
Använd listrutan Frequency för att välja hur ofta Collaboration hämtar uppdaterade målgruppsdata från GCS-pytsen. Tillgängliga intervall från Daily till Every 6 days.
Ange ett datumintervall i indatafältet eller välj kalenderikonen för att ange Start date och End date för den aktiva källperioden. När slutdatumet har nåtts upphör källinköpen och de målgrupper som redan är källkodsmålgrupper att gälla och blir otillgängliga för användning i samarbetsprojekt.
Välj Next om du vill fortsätta.
Granska och slutför anslutningen review-and-complete
Granska konfigurationssammanfattningen innan du skapar anslutningen. Följande avsnitt visas på sammanfattningsskärmen:
- Data connection: GCS-bucket-autentiseringsuppgifterna och mappsökvägen som du konfigurerade.
- Details: Namnet och den valfria beskrivningen för den här dataanslutningen.
- Mapping: De automatiskt mappade käll- och målidentitetsfälten.
- Schedule: Uppdateringsfrekvensen och det aktiva datumintervallet.
Välj pennikonen (
) bredvid ett avsnitt som du vill gå tillbaka till det steget och göra ändringar i. Välj Complete när alla avsnitt är korrekta.
En bekräftelsedialogruta visas som anger att Collaboration har skapat dataanslutningen och att målgruppsinhämtning pågår.
Granska målgrupper från olika källor review-sourced-audiences
När du har slutfört konfigurationsguiden börjar Collaboration hämta målgrupper från GCS-bucket asynkront. Navigera till Setup > My audiences för att övervaka förloppet. Källan slutförs inte omedelbart. Den tid som krävs beror på storleken på dina data och den konfigurerade uppdateringsfrekvensen.
Övervaka målgruppernas källutveckling monitor-sourcing-progress
När Collaboration hämtar målgruppsdata indikerar en banderoll högst upp på arbetsytan My audiences att källning pågår. Enskilda målgrupper visas bara i listan efter att de har hämtats för varje målgrupp.
Visa information om målgrupper view-audience-details
När källan är klar visas dina Google Cloud Storage-målgrupper på fliken My audiences bredvid målgrupper som har hämtats från andra anslutningar. Markera ett radobjekt eller View audience om du vill öppna detaljvyn för en viss målgrupp.
I detaljvyn visas målgruppens status, källa och dataanslutningsnamn tillsammans med följande paneler:
- Identities: Det totala antalet identiteter och uppdelningen för målgruppen när data blir tillgängliga.
- Categories: Alla taggar som används för att ordna eller filtrera målgruppen.
- Connection access: Om målgruppen är privat, offentlig eller delad med specifika medarbetare.
- Metadata visibility: Vilken målgruppsinformation - som identitetsantal, överlappningsprocent och index - är synlig för medarbetare.
Granska de här inställningarna innan du använder målgruppen i ett samarbetsprojekt. Information om hur du uppdaterar kategorier, anslutningsåtkomst och metadatasynlighet finns i Visa och hantera enskilda målgrupper.
Redigera målgruppsinställningar edit-audience-settings
Du kan redigera målgruppsmetadata direkt från listvyn My audiences utan att öppna detaljvyn. Markera kryssrutan för en målgrupp för att visa åtgärdsverktygsfältet och välj sedan en åtgärd: Edit metadata visibility, Edit connection access, Edit name and description, Edit categories eller Delete.
Visa din GCS-dataanslutning view-gcs-connection
Om du vill granska eller hantera själva anslutningen, inklusive matchningsnycklar och schemaläggning, går du till Setup > My data connections. Din nya GCS-anslutning är omedelbart tillgänglig där. Publiken visas som Google Cloud Storage.
Kända begränsningar known-limitations
Tänk på följande begränsningar när du konfigurerar och använder målgruppskälla för Google Cloud Storage:
- Matcha nyckelbegränsningar: När en matchningsnyckel har aktiverats för en dataanslutning kan den inte tas bort. Du kan lägga till matchningsnycklar i en befintlig anslutning, men du kan inte inaktivera eller ta bort dem. Om du vill ändra de aktiva matchningsnycklarna måste du ta bort dataanslutningen och skapa en ny.
- En aktiv dataanslutning per källa: Endast en aktiv Google Cloud Storage dataanslutning stöds åt gången. Om du behöver hämta målgrupper från en annan bucket tar du bort den befintliga anslutningen och skapar en ny som pekar på den nya bucket.
- Stöd för undermappar: Målfiler måste finnas direkt i den angivna mappsökvägen. Collaboration går inte igenom undermappar i den sökvägen.
Felsökning troubleshooting
Använd det här avsnittet för att lösa problem som uppstår när du har upprättat den första anslutningen. Granska dina autentiseringsuppgifter och bucket-behörigheter för felmeddelanden som inträffar under autentiseringen eller kontakta administratören.
Publiken visas inte eller så tar det längre tid än förväntat att hämta
- Källtiden skalas med datavolymen och den konfigurerade uppdateringsfrekvensen. Utökad bearbetningstid förväntas för stora datauppsättningar.
- Om målgrupperna inte har öppnats inom 24 timmar bekräftar du att målgruppsfilerna finns på den mappsökväg du angav under installationen och att de uppfyller kraven i specifikationen för målgruppsappar.
- Gå till fliken My data connections för att se om det finns några felindikatorer för anslutningen.
- Om problemet kvarstår efter att du slutfört dessa steg kontaktar du Adobe kundsupport och anger dataanslutningsnamnet och hakinformation.
Dataanslutningen visar en misslyckad status efter att den initialt lyckades
- Bekräfta att GCS-bucket-behörigheterna och autentiseringsuppgifterna inte har ändrats sedan du skapade anslutningen. Alla ändringar som tar bort Adobe åtkomst till bucket gör att efterföljande källkörningar misslyckas.
- Kontrollera att målgruppsfiler fortfarande finns på den konfigurerade mappsökvägen och att de uppfyller specifikationen för målgruppskälla.
- Om problemet kvarstår efter att behörigheter och filtillgänglighet har bekräftats kan du ta bort anslutningen och skapa en ny, eller kontakta Adobe kundsupport.
Fel i målfilsformat inträffar under en schemalagd uppdatering
- Bekräfta att uppdaterade filer i hakparentesen uppfyller kraven för kolumnstruktur och fält i specifikationen för målgruppskälla.
- Se till att alla filer i den konfigurerade mappsökvägen använder identiska kolumnstrukturer. Blandade filer i samma sökväg kan orsaka partiella källkodsfel.
Nästa steg next-steps
Du har konfigurerat Google Cloud Storage som en datakälla i Collaboration. När källan är klar är dina målgrupper tillgängliga på arbetsytan My audiences och kan användas i samarbetsprojekt.
Här kan du:
Mer information om andra metoder för målgruppskälla finns i: