Skip to content

Add documentation about using device ID as session_id for mobile apps #7

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion en/docs/5.5-ad-query.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ With the catalog synchronized, your platform requests ads to fill the ad spaces

| Field | Description | Type | Required? |
| :--- | :--- | :--- | :--- |
| `session_id` | Unique user session ID (alphanumeric). | String | Yes |
| `session_id` | Unique user session ID (alphanumeric). For mobile applications, the device ID should be sent as the session_id (GAID on Android and IDFA on iOS), so that the session is maintained indefinitely. | String | Yes |
| `user_id` | Unique ID of the logged-in user (alphanumeric). | String | No |
| `store_id` | Filters ads by a specific store's stock. | String | No |
| `channel` | Access channel: `site`, `msite`, `app`. | String | Yes |
Expand Down
2 changes: 1 addition & 1 deletion en/docs/5.6-events.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Event notification is **crucial** for attribution and measurement.

#### **User and Session Identification**

* **`session_id`:** User session ID. Required in all events. Must be consistent throughout the Browse session. The session_id should be unique per user and have a lifetime of at least 14 days due to the conversion window. Ideally, the session_id should not expire.
* **`session_id`:** User session ID. Required in all events. Must be consistent throughout the Browse session. The session_id should be unique per user and have a lifetime of at least 14 days due to the conversion window. Ideally, the session_id should not expire. For mobile applications, the device ID should be sent as the session_id (GAID on Android and IDFA on iOS), so that the session is maintained indefinitely.
* **`user_id`:** Unique customer ID on the platform, consistent across channels. Required in the conversion event. The user_id must be the same across multiple environments such as app, website, and physical store.

#### **Impression, View, and Click Notification**
Expand Down
2 changes: 1 addition & 1 deletion es/docs/5.5-consulta-de-anuncios.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Con el catálogo sincronizado, su plataforma solicita anuncios para completar lo

| Campo | Descrição | Tipo | Obligatoriedad |
| :--- | :--- | :--- | :--- |
| `session_id` | ID único de la sesión del usuario (alfanumérico). | String | Sí |
| `session_id` | ID único de la sesión del usuario (alfanumérico). Para aplicaciones móviles, se debe enviar el ID del dispositivo como session_id (GAID en Android e IDFA en iOS), de manera que la sesión se mantenga indefinidamente. | String | Sí |
| `user_id` | ID único del usuario logueado (alfanumérico). | String | No |
| `store_id` | Filtra anuncios por stock de una tienda específica. | String | No |
| `channel` | Canal de acceso: `site`, `msite`, `app`. | String | Sí |
Expand Down
2 changes: 1 addition & 1 deletion es/docs/5.6-eventos.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ La notificación de eventos es **crucial** para la atribución y la medición.

#### **Identificación de Usuario y Sesión**

* **`session_id`:** ID de la sesión del usuario. Obligatorio en todos los eventos. Debe ser consistente durante la navegación. El session_id debe ser único por usuario y tener una vida útil de al menos 14 días debido a la ventana de conversión. Lo ideal es que el session_id no expire.
* **`session_id`:** ID de la sesión del usuario. Obligatorio en todos los eventos. Debe ser consistente durante la navegación. El session_id debe ser único por usuario y tener una vida útil de al menos 14 días debido a la ventana de conversión. Lo ideal es que el session_id no expire. Para aplicaciones móviles, se debe enviar el ID del dispositivo como session_id (GAID en Android e IDFA en iOS), de manera que la sesión se mantenga indefinidamente.
* **`user_id`:** ID único del cliente en la plataforma, consistente entre canales. Obligatorio en el evento de conversión. El user_id debe ser el mismo entre múltiples entornos como app, sitio web y tienda física.

#### **Notificación de Impresión, Visualización y Clic**
Expand Down
2 changes: 1 addition & 1 deletion pt/docs/5.5-consulta-de-anuncios.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Com o catálogo sincronizado, sua plataforma requisita anúncios para preencher

| Campo | Descrição | Tipo | Obrigatoriedade |
| :--- | :--- | :--- | :--- |
| `session_id` | ID único da sessão do usuário (alfanumérico). | String | Sim |
| `session_id` | ID único da sessão do usuário (alfanumérico). Para aplicativos móveis, deve-se enviar o ID do dispositivo como session_id (GAID no Android e IDFA no iOS), de forma que a sessão seja mantida indefinidamente. | String | Sim |
| `user_id` | ID único do usuário logado (alfanumérico). | String | Não |
| `store_id` | Filtra anúncios por estoque de uma loja específica. | String | Não |
| `channel` | Canal de acesso: `site`, `msite`, `app`. | String | Sim |
Expand Down
2 changes: 1 addition & 1 deletion pt/docs/5.6-eventos.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ A notificação de eventos é **crucial** para a atribuição e mensuração.

#### **Identificação de Usuário e Sessão**

* **`session_id`:** ID da sessão do usuário. Obrigatório em todos os eventos. Deve ser consistente durante a navegação. O session_id deve ser único por usuário e ter uma vida útil de pelo menos 14 dias devido à janela de conversão. O ideal é que o session_id não expire.
* **`session_id`:** ID da sessão do usuário. Obrigatório em todos os eventos. Deve ser consistente durante a navegação. O session_id deve ser único por usuário e ter uma vida útil de pelo menos 14 dias devido à janela de conversão. O ideal é que o session_id não expire. Para aplicativos móveis, deve-se enviar o ID do dispositivo como session_id (GAID no Android e IDFA no iOS), de forma que a sessão seja mantida indefinidamente.
* **`user_id`:** ID único do cliente na plataforma, consistente entre canais. Obrigatório no evento de conversão. O user_id deve ser o mesmo entre múltiplos ambientes como app, website e loja física.

#### **Notificação de Impressão, Visualização e Clique**
Expand Down