Creeer een segmentdefinitie gebruikend de Dienst API van de Segmentatie
Dit document bevat een zelfstudie voor het ontwikkelen, testen, voorvertonen en opslaan van een segmentdefinitie met behulp van de Adobe Experience Platform Segmentation Service API.
Voor informatie over hoe te om segmentdefinities te bouwen gebruikend het gebruikersinterface, gelieve te zien Handleiding Segment Builder.
Aan de slag
Deze zelfstudie vereist een goed begrip van de verschillende Adobe Experience Platform diensten betrokken bij het creëren van segmentdefinities. Voordat u met deze zelfstudie begint, raadpleegt u de documentatie voor de volgende services:
- Real-Time Customer Profile: Biedt een uniform, real-time consumentenprofiel dat is gebaseerd op geaggregeerde gegevens van meerdere bronnen.
- Adobe Experience Platform Segmentation Service: Staat u toe om publiek te bouwen gebruikend segmentdefinities of andere externe bronnen van de gegevens van het Profiel van de Klant in real time.
- Experience Data Model (XDM): Het gestandaardiseerde kader waarbinnen Platform organiseert de gegevens van de klantenervaring. Als u de segmentatie het beste wilt gebruiken, moet u ervoor zorgen dat uw gegevens als profielen en gebeurtenissen worden opgenomen volgens de best practices voor gegevensmodellering.
De volgende secties verstrekken extra informatie die u zult moeten weten om met succes vraag aan te maken Platform API's.
API-voorbeeldaanroepen lezen
Deze zelfstudie biedt voorbeeld-API-aanroepen om aan te tonen hoe uw verzoeken moeten worden opgemaakt. Dit zijn paden, vereiste kopteksten en correct opgemaakte ladingen voor aanvragen. Voorbeeld-JSON die wordt geretourneerd in API-reacties, wordt ook verschaft. Voor informatie over de conventies die worden gebruikt in documentatie voor voorbeeld-API-aanroepen raadpleegt u de sectie over voorbeeld-API-aanroepen lezen in de Experience Platform gids voor probleemoplossing.
Waarden verzamelen voor vereiste koppen
Om vraag te maken aan Platform API's, moet u eerst de verificatiezelfstudie. Het voltooien van de zelfstudie over verificatie biedt de waarden voor elk van de vereiste kopteksten in alle Experience Platform API-aanroepen, zoals hieronder wordt getoond:
- Toestemming: houder
{ACCESS_TOKEN} - x-api-key:
{API_KEY} - x-gw-ims-org-id:
{ORG_ID}
Alle bronnen in Experience Platform zijn geïsoleerd naar specifieke virtuele sandboxen. Alle verzoeken aan Platform API's vereisen een header die de naam aangeeft van de sandbox waarin de bewerking plaatsvindt:
- x-sandbox-name:
{SANDBOX_NAME}
Alle verzoeken die een nuttige lading (POST, PUT, PATCH) bevatten vereisen een extra kopbal:
- Inhoudstype: application/json
Een segmentdefinitie ontwikkelen
De eerste stap in segmentatie is een segmentdefinitie te bepalen. Een segmentdefinitie is een object waarin een query is opgenomen Profile Query Language (PQL) Dit object wordt ook wel een PQL-voorspelling genoemd. PQL voorspelt de regels voor de segmentdefinitie die zijn gebaseerd op voorwaarden met betrekking tot alle record- of tijdreeksgegevens die u opgeeft aan Real-Time Customer Profile. Zie de PQL-gids voor meer informatie over het schrijven van PQL query's.
U kunt een nieuwe segmentdefinitie tot stand brengen door een verzoek van de POST aan /segment/definitions in de Segmentation API. Het volgende voorbeeld schetst hoe te om een definitieverzoek te formatteren, die welke informatie wordt vereist opdat een segmentdefinitie met succes wordt bepaald.
Voor een gedetailleerde uitleg van het definiëren van een segmentdefinitie leest u de segmentdefinitiehandleiding.
Een publiek schatten en voorvertonen estimate-and-preview-an-audience
Terwijl u de segmentdefinitie ontwikkelt, kunt u de schatting- en voorvertoningsgereedschappen gebruiken binnen Real-Time Customer Profile om informatie op overzichtsniveau weer te geven om ervoor te zorgen dat u het verwachte publiek isoleert. Schattingen verschaffen statistische informatie over een segmentdefinitie, zoals de geprojecteerde publieksgrootte en het betrouwbaarheidsinterval. De voorproeven verstrekken gepagineerde lijsten van kwalificerende profielen voor een segmentdefinitie, die u toestaat om de resultaten tegen te vergelijken wat u verwacht.
Door een schatting en voorvertoning van uw publiek te maken, kunt u uw PQL-voorspellingen testen en optimaliseren totdat ze een gewenste uitkomst opleveren. Vervolgens kunt u deze gebruiken in een bijgewerkte segmentdefinitie.
Er zijn twee vereiste stappen om een voorvertoning van uw segmentdefinitie weer te geven of een schatting van uw segmentdefinitie te krijgen:
- Een voorbeeldtaak maken
- Schatting of voorvertoning weergeven gebruiken van identiteitskaart van de voorproefbaan
Hoe schattingen worden gegenereerd
Aangezien gegevens die voor het Profiel van de Klant in real time worden toegelaten in Platform worden opgenomen, wordt het opgeslagen binnen de gegevensopslag van het Profiel. Wanneer de opname van records in het archief Profiel het totale aantal profielen met meer dan 5% verhoogt of verlaagt, wordt een samplingtaak geactiveerd om het aantal bij te werken. Als het aantal profielen niet met meer dan 5% verandert, wordt de samplingtaak automatisch wekelijks uitgevoerd.
De wijze waarop het monster wordt geactiveerd, hangt af van het type inname dat wordt gebruikt:
- Voor het stromen gegevenswerkschema's, wordt een controle uitgevoerd op uurbasis om te bepalen als de 5% verhoging of dalingsdrempel is voldaan. Als aan deze drempel is voldaan, wordt automatisch een voorbeeldtaak geactiveerd om de telling bij te werken.
- Voor batch-opname wordt binnen 15 minuten na het correct innemen van een batch in de profielopslag een taak uitgevoerd om het aantal bij te werken als aan de drempel van 5% voor verhogen of verlagen is voldaan. Met behulp van de profiel-API kunt u een voorvertoning weergeven van de meest recente voorbeeldtaak en de distributie van het lijstprofiel via gegevensset en naamruimte op naam.
De voorbeeldgrootte is afhankelijk van het totale aantal entiteiten in de profielopslag. Deze steekproefgrootte wordt vertegenwoordigd in de volgende lijst:
De schattingen lopen over het algemeen over 10-15 seconden, beginnend met een ruwe schatting en raffinage aangezien meer verslagen worden gelezen.
Een voorbeeldtaak maken
U kunt een nieuwe voorvertoningstaak maken door een POST aan te vragen bij de /preview eindpunt.
Gedetailleerde instructies over het maken van een voorbeeldtaak vindt u in het gedeelte handleiding voor voorvertoningen en schattingen van eindpunten.
Een schatting of voorvertoning weergeven
De schattings- en voorvertoningsprocessen worden asynchroon uitgevoerd, omdat verschillende query's verschillende tijdsduur kunnen duren. Nadat een query is gestart, kunt u API-aanroepen gebruiken om de huidige status van de schatting of voorvertoning tijdens het uitvoeren op te halen (GET).
Met de Segmentation Service API, kunt u de huidige status van een voorvertoningstaak opzoeken aan de hand van de bijbehorende id. Als de status "RESULT_READY" is, kunt u de resultaten bekijken. Als u de huidige status van een voorbeeldtaak wilt opzoeken, leest u de sectie op een sectie met een voorbeeldtaak ophalen in de leidraad voor voorvertoningen en schattingen van eindpunten. Als u de huidige status van een geschatte taak wilt opzoeken, leest u de sectie over een geschatte taak ophalen in de leidraad voor voorvertoningen en schattingen van eindpunten.
Volgende stappen
Nadat u de segmentdefinitie hebt ontwikkeld, getest en opgeslagen, kunt u een segmenttaak maken om een publiek te maken met de opdracht Segmentation Service API. Zie de zelfstudie aan evalueren en tot segmentresultaten toegang hebben voor gedetailleerde stappen over hoe te om dit te verwezenlijken.