> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/nextdoor-conversion-api.md).

# Nextdoor Conversion API

{% hint style="info" %}
Cette destination fait actuellement l’objet d’un examen final et sera bientôt disponible.
{% endhint %}

[Nextdoor](https://nextdoor.com) exploite un service de réseau social hyperlocal destiné aux quartiers.\
Cette destination vous permet d'envoyer des données marketing sous forme d'événements ou de conversions à Nextdoor et d'obtenir une vision plus complète des résultats publicitaires sur Nextdoor. Cette fonctionnalité s'appuie sur [Nextdoor Conversion API](https://adsmanager.help.nextdoor.com/namhelpcenter/s/article/About-the-Nextdoor-Conversion-API?language=en_US).

## Fonctionnalités clés

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

* **Structure des événements** : notre [référence des événements](https://doc.commandersact.com/developers/tracking/events-reference) correspond aux [événements Nextdoor](https://adsmanager.help.nextdoor.com/namhelpcenter/s/article/Conversion-API-request-parameters?language=en_US), ce qui permet d'associer correctement vos données aux champs attendus de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur les événements s’effectue automatiquement, ce qui simplifie la saisie.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Mappage intelligent**: le mappage des données peut être ajusté à l’aide des champs définis dans votre datalayer.
* **Mappage des événements** : modifiez le mappage standard entre les événements Nextdoor et les vôtres, ou ajoutez de nouveaux mappages.
* **Prise en charge des données à plusieurs éléments** : les informations incluses dans le tableau [item](https://doc.commandersact.com/developers/tracking/events-reference#item) sont transmises à 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">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Advertiser Id</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre identifiant d'annonceur NAM dans <a href="https://ads.nextdoor.com/v2/login">Nextdoor Ads Manager</a>. Pour plus d'informations, suivez 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>Obligatoire</code></strong></em><br>L'identifiant de votre jeton d'accès, généré lors de l'accès à <a href="https://ads.nextdoor.com/v2/login">Nextdoor Ads Manager</a>. Pour plus d'informations, suivez 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>Event Mapping</code></td><td>Modifiez le mappage standard entre les événements Nextdoor et les vôtres, ou ajoutez de nouveaux mappages. Les noms d'événements Nextdoor doivent être parmi les 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 compris entre 1 et 10.</td></tr></tbody></table>

## Référence rapide

| Événements Commanders Act | Événements Nextdoor            |
| ------------------------- | ------------------------------ |
| `purchase`                | `purchase`                     |
| `generate_lead`           | `lead`                         |
| `sign_up`                 | `sign_up`                      |
| `[Any Event]`             | `[Any Allowed Event]` **\[1]** |

{% hint style="info" %}
**1.** Consultez <mark style="color:bleu;">`Event Mapping`</mark> dans [Configuration](#configuration) pour plus de détails.
{% endhint %}

## Correspondances des champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l’aide de notre fonctionnalité [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) .
{% endhint %}

<table><thead><tr><th width="440.6685580062746">Propriétés Commanders Act</th><th>Propriétés Nextdoor</th></tr></thead><tbody><tr><td><code>Advertiser Id</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>value</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;">`Event Mapping`</mark> dans [Configuration](#configuration) pour plus de détails.\
**2.** Converti automatiquement au format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).\
**3.** Lorsque <mark style="color:bleu;">Action Source</mark> n’est pas défini dans Smart Mapping, cette valeur est automatiquement définie à partir des informations suivantes, selon l’ordre de priorité indiqué : 1. Champ Smart Mapping <mark style="color:bleu;">`Experience Type`</mark> 2. propriété <mark style="color:bleu;">`context.app`</mark> 3. Champ Smart Mapping <mark style="color:bleu;">`Conversion Type`</mark> .\
**4.** Défini dans <mark style="color:bleu;">`customer`</mark> objet.\
**5.** Format préhaché en minuscules.\
**6.** Haché automatiquement avec SHA256 lorsque la valeur est fournie en clair.\
**7.** Le format préhaché doit comporter exactement dix chiffres, sans caractères spéciaux ni indicatif international.\
**8.** Format préhaché <mark style="color:bleu;">`YYYYMMDD`</mark> .\
**9.** Format préhaché en minuscules, sans caractères spéciaux.\
**10.** Format préhaché en minuscules et sous la forme [d’un code d’abréviation ANSI à deux lettres](https://en.wikipedia.org/wiki/Federal_Information_Processing_Standard_state_code).\
**11.** Format préhaché comportant cinq chiffres pour les États-Unis.\
**12.** Format préhaché sous la forme [d’un code à deux caractères ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).\
**13.** Permet à Nextdoor de dédupliquer les événements pour un annonceur qui envoie des événements via la CAPI et le pixel. Ce paramètre devient ainsi facultatif mais recommandé lorsque plusieurs pixels sont implémentés.\
**14.** Il s’agit du même paramètre que <mark style="color:bleu;">`ndclid`</mark> paramètre ajouté à l’URL de destination après un clic.\
**15.** Défini dans <mark style="color:bleu;">`custom`</mark> .\
**16.** Défini dans <mark style="color:bleu;">`custom.product_context.X`</mark> .\
**17.** Défini dans <mark style="color:bleu;">`app`</mark> .
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
