# Nextdoor Conversion API

{% hint style="info" %}
Cette destination est actuellement en cours de dernière vérification et sera bientôt disponible.
{% endhint %}

[Nextdoor](https://nextdoor.com) exploite un service de social networking hyperlocal pour les neighborhoods.\
Avec cette destination, vous pouvez envoyer des marketing data sous forme d’events ou de conversions à Nextdoor et obtenir une vue plus complète de leurs advertising outcomes sur Nextdoor. Ceci est basé sur [Nextdoor Conversion API](https://adsmanager.help.nextdoor.com/namhelpcenter/s/article/About-the-Nextdoor-Conversion-API?language=en_US).

## Key features

La destination Nextdoor Conversion API fournit les principales fonctionnalités suivantes :

* **Events structure**: notre [Events reference](https://doc.commandersact.com/developers/tracking/events-reference) corresponds [Nextdoor events](https://adsmanager.help.nextdoor.com/namhelpcenter/s/article/Conversion-API-request-parameters?language=en_US), ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Prebuilt mappings**: le mapping des données pour les destinations basées sur les events se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Smart mapping**: le mapping des données peut être réajusté à l’aide des champs définis dans votre datalayer.
* **Event mapping**: modifiez le standard mapping entre les Nextdoor events et les vôtres ou ajoutez de nouveaux mappings.
* **Prise en charge des données multi-item**: les informations incluses dans le tableau [item](https://doc.commandersact.com/developers/tracking/events-reference#item) array est envoyé à Nextdoor.

## Configuration de la destination

{% hint style="info" %}
Avant de configurer cette destination, vous devez avoir accès à [Nextdoor Ads Manager](https://ads.nextdoor.com).
{% endhint %}

### Configuration

<table><thead><tr><th width="300">Settings</th><th>Description</th></tr></thead><tbody><tr><td><code>ID de l’annonceur</code></td><td><em><strong><code>Requis</code></strong></em><br>Votre identifiant d’annonceur NAM dans <a href="https://ads.nextdoor.com/v2/login">Nextdoor Ads Manager</a>. Plus de détails sont disponibles en suivant ce <a href="https://adsmanager.help.nextdoor.com/namhelpcenter/s/article/Conversion-API-request-parameters?language=en_US">LIEN</a> (Voir <code>client_id</code>).</td></tr><tr><td><code>Access Token</code></td><td><em><strong><code>Requis</code></strong></em><br>Votre identifiant de access token tel que généré en accédant à <a href="https://ads.nextdoor.com/v2/login">Nextdoor Ads Manager</a>. Plus de détails sont disponibles en suivant ce <a href="https://adsmanager.help.nextdoor.com/namhelpcenter/s/article/About-the-Nextdoor-Conversion-API?language=en_US&#x26;parentTab=Campaign-performance">LIEN</a>.</td></tr><tr><td><code>Mappage des événements</code></td><td>Modifiez le standard mapping entre les events de Nextdoor et les vôtres ou ajoutez de nouveaux mappings. Les noms d’events Nextdoor doivent être l’un des suivants : <code>conversion</code>, <code>lead</code>, <code>purchase</code>, <code>sign_up</code> et <code>custom_conversion_X</code>, où <code>X</code> est un nombre de 1 à 10.</td></tr></tbody></table>

## Référence rapide

| Commanders Act Events | Nextdoor Events                |
| --------------------- | ------------------------------ |
| `purchase`            | `purchase`                     |
| `generate_lead`       | `lead`                         |
| `sign_up`             | `sign_up`                      |
| `[Any Event]`         | `[Any Allowed Event]` **\[1]** |

{% hint style="info" %}
**\[1]** Voir <mark style="color:bleu;">`Mappage des événements`</mark> dans [Configuration](#configuration) pour plus de détails.
{% endhint %}

## Mappages de champs

{% hint style="info" %}
La plupart des propriétés peuvent être remappées à l’aide de notre fonctionnalité "Smart Mapping".
{% endhint %}

<table><thead><tr><th width="440.6685580062746">Propriétés Commanders Act</th><th>Nextdoor Properties</th></tr></thead><tbody><tr><td><code>ID de l’annonceur</code></td><td><code>client_id</code></td></tr><tr><td>(<code>event_name</code>)</td><td><code>event_name</code> <strong>[1]</strong></td></tr><tr><td><code>context.event_id</code></td><td><code>event_id</code></td></tr><tr><td><code>context.event_timestamp</code></td><td><code>event_time</code> <strong>[2]</strong></td></tr><tr><td><code>partners.nextdoor.event_timezone</code></td><td><code>event_timezone</code></td></tr><tr><td><code>partners.nextdoor.action_source</code></td><td><code>action_source</code> <strong>[3]</strong></td></tr><tr><td><code>context.page.url</code></td><td><code>action_source_url</code></td></tr><tr><td><code>partners.nextdoor.delivery_optimization</code></td><td><code>delivery_optimization</code></td></tr><tr><td><code>partners.nextdoor.test_event</code></td><td><code>test_event</code></td></tr><tr><td><code>user.email</code></td><td><code>email</code> <strong>[4][5][6]</strong></td></tr><tr><td><code>user.phone</code></td><td><code>phone_number</code> <strong>[4][6][7]</strong></td></tr><tr><td><code>user.firstname</code></td><td><code>first_name</code> <strong>[4][5][6]</strong></td></tr><tr><td><code>user.lastname</code></td><td><code>last_name</code> <strong>[4][5][6]</strong></td></tr><tr><td><code>user.birthdate</code></td><td><code>date_of_birth</code> <strong>[4][6][8]</strong></td></tr><tr><td><code>user.street</code></td><td><code>street_address</code> <strong>[4][6]</strong></td></tr><tr><td><code>user.city</code></td><td><code>city</code> <strong>[4][6][9]</strong></td></tr><tr><td><code>user.state_short</code></td><td><code>state</code> <strong>[4][6][10]</strong></td></tr><tr><td><code>user.zipcode</code></td><td><code>zip_code</code> <strong>[4][6][11]</strong></td></tr><tr><td><code>user.country</code></td><td><code>country</code> <strong>[4][6][12]</strong></td></tr><tr><td><code>context.device.ip</code></td><td><code>client_ip_address</code> <strong>[4]</strong></td></tr><tr><td><code>partners.nextdoor.pixel_id</code></td><td><code>pixel_id</code> <strong>[4][13]</strong></td></tr><tr><td><code>partners.nextdoor.click_id</code></td><td><code>click_id</code> <strong>[4][14]</strong></td></tr><tr><td><code>id</code></td><td><code>order_id</code> <strong>[15]</strong></td></tr><tr><td><code>currency</code> + <code>valeur</code></td><td><code>order_value</code> <strong>[15]</strong></td></tr><tr><td><code>partners.nextdoor.delivery_category</code></td><td><code>delivery_category</code> <strong>[15]</strong></td></tr><tr><td><code>items.X.id</code></td><td><code>id</code> <strong>[16]</strong></td></tr><tr><td><code>items.X.product.name</code></td><td><code>content_name</code> <strong>[16]</strong></td></tr><tr><td><code>items.X.product.price</code></td><td><code>item_price</code> <strong>[16]</strong></td></tr><tr><td><code>items.X.quantity</code></td><td><code>quantity</code> <strong>[16]</strong></td></tr><tr><td><code>context.app.namespace</code></td><td><code>app_id</code> <strong>[17]</strong></td></tr><tr><td><code>context.device.ad_tracking_enabled</code></td><td><code>app_tracking_enabled</code> <strong>[17]</strong></td></tr><tr><td><code>context.device.os.name</code></td><td><code>platform</code> <strong>[17]</strong></td></tr><tr><td><code>context.app.version</code></td><td><code>app_version</code> <strong>[17]</strong></td></tr></tbody></table>

{% hint style="info" %}

> **\[1]** Voir <mark style="color:bleu;">`Mappage des événements`</mark> dans [Configuration](#configuration) pour plus de détails.\
> \&#xNAN;**\[2]** Automatiquement converti en [format ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).\
> \&#xNAN;**\[3]** Lorsque Smart Mapping <mark style="color:bleu;">Action Source</mark> n’est pas défini, cette valeur est automatiquement définie à l’aide des informations suivantes, dans l’ordre de priorité présenté : 1. Champ Smart Mapping <mark style="color:bleu;">`Experience Type`</mark> 2. property <mark style="color:bleu;">`context.app`</mark> 3. Champ Smart Mapping <mark style="color:bleu;">`Conversion Type`</mark> .\
> \&#xNAN;**\[4]** Défini dans <mark style="color:bleu;">`customer`</mark> object.\
> \&#xNAN;**\[5]** Format pré-haché en minuscules.\
> \&#xNAN;**\[6]** Hachée automatiquement via SHA256 lorsqu’elle est fournie en texte clair.\
> \&#xNAN;**\[7]** Le format pré-haché doit comporter exactement dix chiffres, sans caractères spéciaux ni indicatifs internationaux de pays.\
> \&#xNAN;**\[8]** Format pré-haché <mark style="color:bleu;">`YYYYMMDD`</mark> .\
> \&#xNAN;**\[9]** Format pré-haché en minuscules, sans caractères spéciaux.\
> \&#xNAN;**\[10]** Format pré-haché en minuscules et en tant que [code d’abréviation ANSI à deux lettres](https://en.wikipedia.org/wiki/Federal_Information_Processing_Standard_state_code).\
> \&#xNAN;**\[11]** Format pré-haché avec cinq chiffres pour les États-Unis.\
> \&#xNAN;**\[12]** Format pré-haché en tant que [code ISO 3166-1 alpha-2 à deux caractères](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).\
> \&#xNAN;**\[13]** Permet à Nextdoor de dédupliquer les events pour un advertiser qui envoie des events via à la fois la CAPI et le pixel, ce qui en fait une exigence souple pour une implémentation de plusieurs pixels.\
> \&#xNAN;**\[14]** C’est la même chose que <mark style="color:bleu;">`ndclid`</mark> parameter attached to clickthrough URL.\
> \&#xNAN;**\[15]** Défini dans <mark style="color:bleu;">`custom`</mark> .\
> \&#xNAN;**\[16]** Défini dans <mark style="color:bleu;">`custom.product_context.X`</mark> .\
> \&#xNAN;**\[17]** Défini dans <mark style="color:bleu;">`app`</mark> .
> {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/nextdoor-conversion-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.