Kontakte in eine Audience importieren
Der CSV-Import der Audience-Seite, über die API. Jede wohlgeformte Adresse wird zum Kontakt, falls sie noch keiner ist, und jede landet in dieser Audience, bis zu 500 Zeilen pro Aufruf. Senden Sie eine längere Liste in mehreren Aufrufen.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
POST /audiences/{id}/import
Der CSV-Import der Audience-Seite, über die API. Jede wohlgeformte Adresse wird zum Kontakt, falls sie noch keiner ist, und jede landet in dieser Audience, bis zu 500 Zeilen pro Aufruf. Senden Sie eine längere Liste in mehreren Aufrufen.
Beispiel
Erfordert audiences:write und contacts:write, weil Kontakte angelegt werden. Jede Zeile ist eine email und ein optionaler name mit bis zu 200 Zeichen.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/import" -H "$AUTH" -H 'content-type: application/json' -d '{ "contacts": [ { "email": "[email protected]", "name": "Grace Hopper" }, { "email": "[email protected]", "name": "Katherine Johnson" }, { "email": "not-an-address" } ]}'{ "object": "audience_import", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "created": 1, "added": 1, "skipped": 1, "invalid": ["not-an-address"]}created zählt die neuen Kontakte, added die neuen Mitgliedschaften in dieser Audience und skipped die Zeilen, die nicht importiert wurden. invalid listet die fehlerhaften Adressen genau so, wie sie gesendet wurden. Ein neuer Kontakt wird als manual gespeichert und tritt auch der Standard-Audience bei.
Eine Adresse, die schon ein Kontakt ist, wird wiederverwendet, nie verdoppelt, und behält ihren Namen: Ein name hier füllt nur einen leeren. Eine Adresse, die aus dem Adressbuch gelöscht wurde, wird wieder zum Kontakt, und dieselbe Adresse zweimal in einem Aufruf zählt einmal.
Sicher wiederholbar: Ein zweiter identischer Aufruf legt nichts an und fügt nichts hinzu. Niemandem wird etwas gesendet, und niemand wird für irgendetwas angemeldet.