Invoer van bulklood

{de Verwijzing van het Eindpunt van de Invoer van het BulkLood 🔗

Voor grote hoeveelheden loodverslagen, kunnen de lood asynchroon met ​ bulk API ​ worden ingevoerd. Op deze manier kunt u een lijst met records importeren naar Marketo met een plat bestand met de scheidingstekens (komma's, tabs of puntkomma's). Het bestand kan een willekeurig aantal records bevatten, mits het bestand in totaal minder dan 10 MB groot is. De recordbewerking is alleen "invoegen of bijwerken".

Verwerkingslimieten

U mag meer dan één aanvraag voor bulkimport indienen, met beperkingen. Elke aanvraag wordt als een taak toegevoegd aan een FIFO-wachtrij die moet worden verwerkt. Er worden maximaal twee banen tegelijk verwerkt. De wachtrij kan maximaal tien taken tegelijk uitvoeren (inclusief de twee momenteel verwerkte taken). Als u het maximum van tien taken overschrijdt, wordt de fout "1016, Te veel import" geretourneerd.

Bestand importeren

De eerste rij van het bestand moet een koptekst zijn met de corresponderende REST API-velden waarin de waarden van elke rij moeten worden toegewezen. Een typisch bestand volgt dit standaardpatroon:

email,firstName,lastName
test@example.com,John,Doe

Het veld externalCompanyId kan worden gebruikt om de lead record te koppelen aan een bedrijfsrecord. Het veld externalSalesPersonId kan worden gebruikt om de lead record te koppelen aan een record van een verkooppersoon.

De aanroep zelf wordt gemaakt met het inhoudstype multipart/form-data .

Dit type verzoek kan moeilijk zijn uit te voeren, zodat wordt het hoogst geadviseerd dat u een bestaande bibliotheekimplementatie gebruikt.

Een taak maken

Als u een aanvraag voor bulkimport wilt uitvoeren, moet u de koptekst van het inhoudstype instellen op "multipart/form-data" en ten minste een bestandsparameter opnemen met de bestandsinhoud en een indelingsparameter met de waarde "csv", "tsv" of "ssv" voor de bestandsindeling.

POST /bulk/v1/leads.json?format=csv

Content-Type: multipart/form-data; boundary=------WebKitFormBoundaryBQACkJZyaiIAXogC
Content-Length: 311
Host: <munchkinId>.mktorest.com

------WebKitFormBoundaryBQACkJZyaiIAXogC
Content-Disposition: form-data; name="file"; filename="leads.csv"
Content-Type: text/csv

FirstName,LastName,Email,Company
Able,Baker,ablebaker@marketo.com,Marketo
Charlie,Dog,charliedog@marketo.com,Marketo
Easy,Fox,easyfox@marketo.com,Marketo
------WebKitFormBoundaryBQACkJZyaiIAXogC--

{
    "requestId": "d01f#15d672f8560",
    "result": [
        {
            "batchId": 3404,
            "importId": "3404",
            "status": "Queued"
        }
    ],
    "success": true
}

Dit eindpunt gebruikt ​ multipart/form-data als inhoud-type ​. Dit kan lastig zijn om de juiste taal te kiezen, dus de beste praktijk is om een HTTP-ondersteuningsbibliotheek te gebruiken voor uw taal van keuze. Een eenvoudige manier om dit met cURL van de bevellijn te doen kijkt als dit:

curl -i -F format=csv -F file=@lead_data.csv -F access_token=<Access Token> <REST API Endpoint Base URL>/bulk/v1/leads.json

Waar het importbestand "lead_data.csv" het volgende bevat:

FirstName,LastName,Email,Company
Able,Baker,ablebaker@marketo.com,Marketo
Charlie,Dog,charliedog@marketo.com,Marketo
Easy,Fox,easyfox@marketo.com,Marketo

U kunt desgewenst ook de parameters lookupField , listId en partitionName in uw aanvraag opnemen. In lookupField kunt u een specifiek veld selecteren waarop u wilt dedupliceren, net als Leads synchroniseren. Standaard wordt dit veld gebruikt voor e-mail. U kunt id als lookupField opgeven om een bewerking Alleen bijwerken aan te geven. In listId kunt u een statische lijst selecteren waarnaar u de lijst met leads wilt importeren. Hierdoor worden de leads in de lijst lid van deze statische lijst, en worden deze ook gemaakt of bijgewerkt als gevolg van het importeren. partitionName selecteert een specifieke partitie waarnaar u wilt importeren. Zie de sectie Werkruimten en Partities voor meer informatie.

Bericht in het antwoord op onze vraag, dat er geen lijst van successen of mislukkingen zoals met de Leads van de Synchronisatie, maar een batchId en een statusgebied voor het verslag in de resultaatserie is. De reden hiervoor is dat deze API asynchroon is en een status in de wachtrij kan retourneren, importeren of Mislukt. U moet batchId behouden om de status van de importtaak op te halen en om fouten en/of waarschuwingen op te halen als de taak is voltooid. De batchId blijft zeven dagen geldig.

Status opiniepeilingtaak

Het wordt aanbevolen om de taak elke 5-30 seconden te opiniepeilen, afhankelijk van de vereiste latentie en beperkingen van de API-aanroep, om de status van de importtaak te zien. U kunt dit doen met de Get Import Lead Status API.

GET /bulk/v1/leads/batch/{id}.json

{
   "requestId":"8136#146daebc2ed",
   "success":true,
   "result":[
      {
         "batchId":1022,
         "status":"Complete",
         "numOfLeadsProcessed":2,
         "numOfRowsFailed":1,
         "numOfRowsWithWarning":0,
         "message":"Import completed with errors, 2 records imported (2 members), 1 failed"
      }
   ]
}

In dit antwoord wordt een voltooide importbewerking getoond, maar de status kan een van de volgende zijn:

Als de taak is voltooid, ziet u een overzicht van het aantal verwerkte rijen, dat is mislukt, op rijen met waarschuwingen. De berichtparameter kan het mislukkingsbericht ook geven als de status Ontbroken is.

Mislukt

De mislukkingen worden vermeld door het "numOfRowsFailed"attribuut in krijgen de Reactie van de Status van de Lood van de Invoer. Als "numOfRowsFailed" groter is dan nul, dan wijst die waarde op het aantal mislukkingen die voorkwamen.

Als u de records en oorzaken van mislukte rijen wilt ophalen, moet u het foutbestand ophalen:

GET /bulk/v1/leads/batch/{id}/failures.json

De API reageert met een bestand dat aangeeft welke rijen zijn mislukt, samen met een bericht dat aangeeft waarom de record is mislukt. De indeling van het bestand is gelijk aan de indeling die tijdens het maken van de taak is opgegeven in de parameter "format". Aan elke record wordt een extra veld toegevoegd met een beschrijving van de fout.

Waarschuwingen

Waarschuwingen worden aangegeven door het kenmerk "numOfRowsWithWarning" in het antwoord 'Status van lead importeren'. Als "numOfRowsWithWarning" groter is dan nul, geeft die waarde het aantal waarschuwingen aan dat is opgetreden.

Als u de records en oorzaken van waarschuwingsrijen wilt ophalen, haalt u het waarschuwingsbestand op:

GET /bulk/v1/leads/batch/{id}/warnings.json

De API reageert met een bestand dat aangeeft welke rijen waarschuwingen hebben opgeleverd, samen met een bericht dat aangeeft waarom de record is mislukt. De indeling van het bestand is gelijk aan de indeling die tijdens het maken van de taak is opgegeven in de parameter "format". Aan elke record wordt een extra veld toegevoegd met een beschrijving van de waarschuwing.