# Nextdoor Conversion API

{% hint style="info" %}
Cette destination est actuellement en cours de révision finale et sera bientôt disponible.
{% endhint %}

[Nextdoor](https://nextdoor.com) exploite un service de réseau social hyperlocal pour les quartiers.\
En utilisant cette destination, vous pouvez envoyer des données marketing sous forme d'événements ou de conversions vers Nextdoor et obtenir une image plus complète de leurs résultats publicitaires sur Nextdoor. Cela se base sur [Nextdoor Conversion API](https://adsmanager.help.nextdoor.com/namhelpcenter/s/article/About-the-Nextdoor-Conversion-API?language=en_US).

## Principales fonctionnalités

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

* **Structure des events**: notre [Events reference](https://doc.commandersact.com/developers/tracking/events-reference) correspondances [Événements Nextdoor](https://adsmanager.help.nextdoor.com/namhelpcenter/s/article/Conversion-API-request-parameters?language=en_US), ce qui signifie que vos données sont correctement mappées vers les champs attendus de manière optimisée.
* **Mappings préconçus**: le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les entrées 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é en utilisant vos champs définis dans le datalayer.
* **Mapping des events**: modifiez le mapping standard entre les événements Nextdoor et les vôtres ou ajoutez de nouveaux mappings.
* **Support des données multi-item**: les informations incluses dans le [item](https://doc.commandersact.com/developers/tracking/events-reference#item) array est dispatché à 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>Advertiser Id</code></td><td><em><strong><code>Requis</code></strong></em><br>Votre identifiant 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">LINK</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 token d'accès 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">LINK</a>.</td></tr><tr><td><code>Mapping d'événements</code></td><td>Changez le mapping standard entre les événements de Nextdoor et les vôtres ou ajoutez de nouveaux mappings. Les noms d'événements 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 | Événements Nextdoor            |
| --------------------- | ------------------------------ |
| `purchase`            | `purchase`                     |
| `generate_lead`       | `lead`                         |
| `sign_up`             | `sign_up`                      |
| `[Any Event]`         | `[Any Allowed Event]` **\[1]** |

{% hint style="info" %}
**\[1]** Voir <mark style="color:blue;">`Mapping d'é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 en utilisant notre fonctionnalité "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>valeurs</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:blue;">`Mapping d'événements`</mark> dans [Configuration](#configuration) pour plus de détails.  \
> \&#xNAN;**\[2]** Converti automatiquement en [format ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).  \
> \&#xNAN;**\[3]** Lorsque Smart Mapping <mark style="color:blue;">Action Source</mark> n'est pas défini, cette valeur est automatiquement définie en utilisant les informations suivantes selon l'ordre de priorité présenté : 1. champ Smart Mapping <mark style="color:blue;">`Experience Type`</mark> 2. propriété <mark style="color:blue;">`context.app`</mark> 3. champ Smart Mapping <mark style="color:blue;">`Type de conversion`</mark> .  \
> \&#xNAN;**\[4]** Défini dans <mark style="color:blue;">`customer`</mark> objet.  \
> \&#xNAN;**\[5]** Format pré-haché en minuscules.  \
> \&#xNAN;**\[6]** Haché automatiquement via SHA256 lorsqu'il est fourni en clair.  \
> \&#xNAN;**\[7]** Le format pré-haché doit consister exactement en dix chiffres, sans caractères spéciaux ni indicatifs téléphoniques internationaux.  \
> \&#xNAN;**\[8]** Format pré-haché <mark style="color:blue;">`YYYYMMDD`</mark> .  \
> \&#xNAN;**\[9]** Format pré-haché en minuscules, sans caractères spéciaux.  \
> \&#xNAN;**\[10]** Format pré-haché en minuscules et en [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 événements pour un annonceur qui envoie des événements à la fois via la CAPI et le pixel, ce qui le rend quasi obligatoire pour une implémentation avec plusieurs pixels.  \
> \&#xNAN;**\[14]** C'est la même chose que <mark style="color:blue;">`ndclid`</mark> paramètre attaché à l'URL de clickthrough.  \
> \&#xNAN;**\[15]** Défini dans <mark style="color:blue;">`custom`</mark> .  \
> \&#xNAN;**\[16]** Défini dans <mark style="color:blue;">`custom.product_context.X`</mark> .  \
> \&#xNAN;**\[17]** Défini dans <mark style="color:blue;">`app`</mark> .
> {% endhint %}