Adobe Target Bulk Profile Update API

Laatst bijgewerkt: 18 september 2024

Gemaakt voor:

  • Ontwikkelaar

Met Adobe Target Bulk Profile Update API kunt u gebruikersprofielen voor meerdere bezoekers van een website in bulk bijwerken met behulp van een batchbestand.

Met de Bulk Profile Update API kunt u eenvoudig gedetailleerde gegevens van het bezoekersprofiel in de vorm van profielparameters voor veel gebruikers naar Target verzenden vanuit een externe bron. Externe bronnen kunnen systemen van het Beheer van de Verhouding van de Klant (CRM) of van het Verkooppunt (POS) omvatten, die gewoonlijk niet op een Web-pagina beschikbaar zijn.

VersieURL-voorbeeldFuncties
v1http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/profile/batchUpdateAlleen ondersteuning voor bulkprofielupdate.
v2http://CLIENTCODE.tt.omtrdc.net/m2/CLIENTCODE/v2/profile/batchUpdate
  • Profiel maken indien niet gevonden.
  • Status per rij bijwerken.
NOTE
Versie 2 (v2) van de Bulk Profile Update API is de huidige versie. Target ondersteunt echter nog steeds versie 1 (v1).

Voordelen van de Bulk Profile Update API

  • Geen limiet voor het aantal profielkenmerken.
  • Profielkenmerken die via de site worden verzonden, kunnen via de API worden bijgewerkt en omgekeerd.

Caveats

  • Het batchbestand moet kleiner zijn dan 50 MB. Bovendien mag het totale aantal rijen niet groter zijn dan 500.000 rijen per upload.
  • Updates vinden meestal plaats binnen een uur, maar het kan 24 uur duren voordat ze worden gereflecteerd.
  • Er is geen limiet voor het aantal rijen dat of de rijen die u kunt uploaden over een periode van 24 uur in volgende batches. Nochtans, zou het innameproces tijdens kantooruren kunnen worden vertraagd om ervoor te zorgen dat andere processen efficiënt lopen.
  • Opeenvolgende v2 vraag van de partijupdate zonder mbox vraag binnen tussen voor zelfde thirdPartyIds treedt de eigenschappen met voeten die in de eerste vraag van de partijupdate worden bijgewerkt.
  • Adobe garandeert niet dat 100% van de gegevens van het batchprofiel in Target wordt gecontroleerd en bewaard en dus beschikbaar is voor gebruik bij het zoeken naar gegevens. In het huidige ontwerp bestaat de mogelijkheid dat een klein percentage gegevens (tot 0,1% van de grote productiepartijen) niet wordt opgetekend of bewaard.

Batchbestand

Als u profielgegevens bulksgewijs wilt bijwerken, maakt u een batchbestand. Het batchbestand is een tekstbestand met waarden gescheiden door komma's die lijken op het volgende voorbeeldbestand.

\ batch=pcId,param1,param2,param3,param4\ 123,value1\ 124,value1,value4\ 125,value2\ 126,value1,value2,value3,value4\

NOTE
De parameter batch= is vereist en moet aan het begin van het bestand worden opgegeven.

U verwijst dit bestand in de aanroep van de POST naar Target servers om het bestand te verwerken. Houd rekening met het volgende wanneer u het batchbestand maakt:

  • In de eerste rij van het bestand moeten kolomkoppen worden opgegeven.
  • De eerste header moet een pcId of thirdPartyId zijn. Marketing Cloud visitor ID wordt niet ondersteund. pcId is een door Target gegenereerde bezoeker-id. thirdPartyId is een id die door de clienttoepassing is opgegeven en die via een mbox-aanroep als mbox3rdPartyId aan Target wordt doorgegeven. U moet hier naar dit item verwijzen als thirdPartyId .
  • Parameters en waarden die u in het batchbestand opgeeft, moeten uit veiligheidsoverwegingen URL-gecodeerd zijn met UTF-8. Parameters en waarden kunnen naar andere randknooppunten worden doorgestuurd voor verwerking door HTTP-aanvragen.
  • De parameters mogen alleen de notatie paramName hebben. Parameters worden weergegeven in Target als profile.paramName .
  • Als u Bulk Profile Update API v2 gebruikt, hoeft u niet alle parameterwaarden voor elke pcId op te geven. Profielen worden gemaakt voor pcId of mbox3rdPartyId die niet worden gevonden in Target . Als u v1 gebruikt, worden er geen profielen gemaakt voor ontbrekende pcIds of mbox3rdPartyIds.
  • Het batchbestand moet kleiner zijn dan 50 MB. Bovendien mag het totale aantal rijen niet groter zijn dan 500.000. Deze limiet zorgt ervoor dat servers niet overstroomd raken met te veel verzoeken.
  • U kunt meerdere bestanden verzenden. Het totaal van de rijen van alle bestanden die u op een dag verzendt, mag echter niet hoger zijn dan 1 miljoen voor elke client.
  • Er is geen beperking op het aantal kenmerken dat u kunt uploaden. De totale grootte van de externe profielgegevens, die klantkenmerken, profiel-API, In-Mbox-profielparameters en profielscriptuitvoer bevatten, mag echter niet groter zijn dan 64 kB.
  • Parameters en waarden zijn hoofdlettergevoelig.