Kontakte in Massen zu einer Audience hinzufügen
Legt bis zu 200 Kontakte in einem Aufruf in eine Audience, nach Adresse. Wie das einzelne Hinzufügen nimmt es Adressen, die bereits im Adressbuch des Workspace stehen, und legt nie einen Kontakt an: Eine Adresse, die keiner ist, kommt in `missing` zurück, für sie wird nichts geschrieben, und der Rest des Aufrufs geht trotzdem durch.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
POST /audiences/{id}/contacts/batch
Legt bis zu 200 Kontakte in einem Aufruf in eine Audience, nach Adresse. Wie das einzelne Hinzufügen nimmt es Adressen, die bereits im Adressbuch des Workspace stehen, und legt nie einen Kontakt an: Eine Adresse, die keiner ist, kommt in missing zurück, für sie wird nichts geschrieben, und der Rest des Aufrufs geht trotzdem durch.
Beispiel
Erfordert audiences:write. emails fasst 1 bis 200 Adressen, die vor dem Abgleich getrimmt und kleingeschrieben werden.
curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/batch" -H "$AUTH" -H 'content-type: application/json' -d '{ "emails": ["[email protected]", "[email protected]", "[email protected]"]}'{ "object": "audience_batch", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "added": 1, "unchanged": 1, "missing": ["[email protected]"]}added zählt die neuen Mitgliedschaften, unchanged die Kontakte, die schon in der Audience waren, und missing listet die Adressen, die keine Kontakte sind, kleingeschrieben und ohne Wiederholungen. Speichern Sie diese mit POST /contacts oder senden Sie sie an POST /audiences/{id}/import, das sie anlegt.
Sicher wiederholbar. Ein zweiter identischer Aufruf fügt nichts hinzu und meldet alle als unchanged. Hinzufügen zur Standard-Audience ergibt immer added: 0, weil jeder Kontakt schon darin ist.
Ein leeres emails, mehr als 200 Adressen oder ein anderer Schlüssel im Body ergibt ein 422, und nichts wird geschrieben.