{"_id":"57d698404340330e00953c84","category":{"_id":"57d698404340330e00953c72","project":"564f643f33082f0d001bb714","version":"57d698404340330e00953c6c","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-12-10T19:30:55.729Z","from_sync":false,"order":5,"slug":"дополнительные-интеграции","title":"Интеграции DDM"},"__v":2,"parentDoc":null,"version":{"_id":"57d698404340330e00953c6c","project":"564f643f33082f0d001bb714","__v":2,"createdAt":"2016-09-12T11:57:52.437Z","releaseDate":"2016-09-12T11:57:52.437Z","categories":["57d698404340330e00953c6d","57d698404340330e00953c6e","57d698404340330e00953c6f","57d698404340330e00953c70","57d698404340330e00953c71","57d698404340330e00953c72","57d698404340330e00953c73","58a5711c79ac232f00cbadb5"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.1.0","version":"1.1"},"user":"564f641651f2ec0d001d6998","project":"564f643f33082f0d001bb714","updates":["587e05e9db3b0319007af0cc"],"next":{"pages":[],"description":""},"createdAt":"2015-12-10T19:49:34.746Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":9,"body":"[Digital Data Manager](https://github.com/driveback/digital-data-manager) позвляет реализовать интеграцию DDL с системой товарных рекомендаций Retail Rocket в один клик.\n\nИнтеграция автоматически активирует следующие трекеры Retail Rocket:\n- Основной трекинг-код системы\n- Трекер просмотра карточки товара\n- Трекер просмотра страницы товарной категории\n- Трекер добавления товаров в корзину\n- Трекер совершения транзакции\n- Трекер поиска по сайту\n- Трекер получения email\n- Трекер кликов по рекомендациям\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Инициализация\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"ddManager.initialize({\\n\\t\\\"integrations\\\": {\\n    {\\n      \\\"Retail Rocket\\\": {\\n      \\t\\\"partnerId\\\": \\\"XXX\\\",\\n        \\\"userIdProperty\\\": \\\"user.userId\\\",\\n        \\\"trackAllEmails\\\": true,\\n        \\\"listMethods\\\": {\\n          \\\"listing_recom\\\": \\\"Popular\\\",\\n          \\\"product_recom\\\": \\\"Related\\\"\\n        },\\n        \\\"customVariables\\\": {\\n      \\t\\t\\\"firstName\\\": {\\n          \\t\\\"type\\\": \\\"event\\\",\\n            \\\"value\\\": \\\"user.firstName\\\"\\n          },\\n          \\\"gender\\\": {\\n          \\t\\\"type\\\": \\\"event\\\",\\n            \\\"value\\\": \\\"user.gender\\\"\\n          },\\n          \\\"lang\\\": {\\n          \\t\\\"type\\\": \\\"digitalData\\\",\\n            \\\"value\\\": \\\"website.language\\\"\\n          }\\n      \\t}\\n      }\\n    }\\n  }\\n});\",\n      \"language\": \"javascript\",\n      \"name\": \"JavaScript\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Описание опций\"\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Ключ\",\n    \"h-1\": \"Тип\",\n    \"h-2\": \"Описание\",\n    \"0-0\": \"partnerId\",\n    \"0-1\": \"String\",\n    \"0-2\": \"Идентификатор килиента Retail Rocket, который можно получить на странице [https://api.retailrocket.ru/SetupWizard/Setup3Tracking](https://api.retailrocket.ru/SetupWizard/Setup3Tracking)\\n\\n**Обязательное поле**\",\n    \"3-0\": \"trackAllEmails\",\n    \"3-1\": \"Boolean\",\n    \"3-2\": \"True - если вы хотите передавать абсолютно все email-адреса в Retail Rocket, false - если вы хотите передавать только email-адреса тех пользователь, которые дали согласие на рассылку (user.isSubscribed == true).\\n\\n**Значение по умолчанию:**  false\",\n    \"4-0\": \"listMethods\",\n    \"4-1\": \"String Mapping\",\n    \"4-2\": \"Описание рекомендательных алгоритмов, применяемых к определенному списку рекомендаций, где ключем является название списка рекомендаций, а значением - название алгоритма (метода) рекомендаций.\",\n    \"5-0\": \"customVariables\",\n    \"5-1\": \"Variable Mapping (digitalData | event | constant)\",\n    \"5-2\": \"Используется для автоматической установки пользовательских переменных, ассоциированных с емэйлом, на основе данных, переданных в событии подписки (Subscribed).\",\n    \"1-0\": \"userIdProperty\",\n    \"1-1\": \"String\",\n    \"1-2\": \"Параметр DDL, который будет использовать в качестве userId для Retail Rocket (переменная rrPartnerUserId).\\n\\n**Значение по умолчанию:**  \\\"user.userId\\\"\",\n    \"2-0\": \"noConflict\",\n    \"2-1\": \"Boolean\",\n    \"2-2\": \"Необходимо установить в значение true, если на сайте уже установлен тег Retail Rocket. В этом случае тег не будет грузиться повторно, а также не будут повторно отравляться события основных трекеров. В этом случае интеграция будет реагировать лишь на событие \\\"Subscribed\\\", автоматически передавая полученные email-адреса в Retail Rocket.\\n\\n**Значение по умолчанию:** false\"\n  },\n  \"cols\": 3,\n  \"rows\": 6\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"body\": \"Если поле noConflict=false, то partnerId обязательно должен быть передан.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Минимальные настройки Digital Data Layer\"\n}\n[/block]\n**Страница товарной категории:** \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"user\\\": {\\n    \\\"email\\\": \\\"test:::at:::driveback.ru\\\",\\n    \\\"isSubscribed\\\": true\\n  },\\n\\t\\\"page\\\": {\\n  \\t\\\"type\\\": \\\"category\\\",\\n    \\\"categoryId\\\": \\\"123\\\"\\n  }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"\"\n    }\n  ]\n}\n[/block]\n**Страница карточки товара:** \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"user\\\": {\\n    \\\"email\\\": \\\"test@driveback.ru\\\",\\n    \\\"isSubscribed\\\": true\\n  },\\n  \\\"page\\\": {\\n  \\t\\\"type\\\": \\\"product\\\"\\n  },\\n  \\\"product\\\": {\\n  \\t\\\"id\\\": \\\"123\\\"\\n  }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"\"\n    }\n  ]\n}\n[/block]\n**Страница подтверждения заказа:** \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"user\\\": {\\n    \\\"email\\\": \\\"test@driveback.ru\\\",\\n    \\\"isSubscribed\\\": true\\n  },\\n  \\\"page\\\": {\\n  \\t\\\"type\\\": \\\"confirmation\\\"\\n  },\\n  \\\"transaction\\\": {\\n  \\t\\\"lineItems\\\": [\\n      {\\n      \\t\\\"product\\\": {\\n          \\\"id\\\": \\\"123\\\",\\n          \\\"unitSalePrice\\\": 15000\\n        },\\n        \\\"quantity\\\": 1\\n      },\\n      {\\n      \\t\\\"product\\\": {\\n          \\\"id\\\": \\\"234\\\",\\n          \\\"unitSalePrice\\\": 19000\\n        },\\n        \\\"quantity\\\": 2\\n      }\\n    ]\\n  }\\n}\",\n      \"language\": \"json\",\n      \"name\": \"\"\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Минимальный набор семантических событий:\"\n}\n[/block]\n**Добавление товара в корзину:** \n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"digitalData.events.push({\\n\\t\\\"name\\\": \\\"Added Product\\\",\\n  \\\"category\\\": \\\"Ecommerce\\\",\\n  \\\"product\\\": \\\"123\\\",\\n});\\n\\n//или\\n\\ndigitalData.events.push({\\n\\t\\\"name\\\": \\\"Added Product\\\",\\n  \\\"category\\\": \\\"Ecommerce\\\",\\n  \\\"product\\\": {\\n  \\t\\\"id\\\": \\\"123\\\"\\n  },\\n});\",\n      \"language\": \"javascript\",\n      \"name\": \"JavaScript\"\n    }\n  ]\n}\n[/block]\n**Клик на товаре из блока (списка) рекоментаций**:\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"digitalData.events.push({\\n\\t\\\"name\\\": \\\"Clicked Product\\\",\\n  \\\"category\\\": \\\"Ecommerce\\\",\\n  \\\"listItem\\\": {\\n  \\t\\\"product\\\": \\\"123\\\",\\n    \\\"listName\\\": \\\"listing_recom\\\"\\n  },\\n});\",\n      \"language\": \"javascript\"\n    }\n  ]\n}\n[/block]\n**Подписка на рассылку:**\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"digitalData.events.push({\\n\\t\\\"name\\\": \\\"Subscribed\\\",\\n  \\\"category\\\": \\\"Email\\\",\\n  \\\"user\\\": {\\n  \\t\\\"email\\\": \\\"email@example.com\\\"\\n  }\\n});\",\n      \"language\": \"javascript\",\n      \"name\": \"JavaScript\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"retail-rocket","type":"basic","title":"Retail Rocket"}
[Digital Data Manager](https://github.com/driveback/digital-data-manager) позвляет реализовать интеграцию DDL с системой товарных рекомендаций Retail Rocket в один клик. Интеграция автоматически активирует следующие трекеры Retail Rocket: - Основной трекинг-код системы - Трекер просмотра карточки товара - Трекер просмотра страницы товарной категории - Трекер добавления товаров в корзину - Трекер совершения транзакции - Трекер поиска по сайту - Трекер получения email - Трекер кликов по рекомендациям [block:api-header] { "type": "basic", "title": "Инициализация" } [/block] [block:code] { "codes": [ { "code": "ddManager.initialize({\n\t\"integrations\": {\n {\n \"Retail Rocket\": {\n \t\"partnerId\": \"XXX\",\n \"userIdProperty\": \"user.userId\",\n \"trackAllEmails\": true,\n \"listMethods\": {\n \"listing_recom\": \"Popular\",\n \"product_recom\": \"Related\"\n },\n \"customVariables\": {\n \t\t\"firstName\": {\n \t\"type\": \"event\",\n \"value\": \"user.firstName\"\n },\n \"gender\": {\n \t\"type\": \"event\",\n \"value\": \"user.gender\"\n },\n \"lang\": {\n \t\"type\": \"digitalData\",\n \"value\": \"website.language\"\n }\n \t}\n }\n }\n }\n});", "language": "javascript", "name": "JavaScript" } ] } [/block] [block:api-header] { "type": "basic", "title": "Описание опций" } [/block] [block:parameters] { "data": { "h-0": "Ключ", "h-1": "Тип", "h-2": "Описание", "0-0": "partnerId", "0-1": "String", "0-2": "Идентификатор килиента Retail Rocket, который можно получить на странице [https://api.retailrocket.ru/SetupWizard/Setup3Tracking](https://api.retailrocket.ru/SetupWizard/Setup3Tracking)\n\n**Обязательное поле**", "3-0": "trackAllEmails", "3-1": "Boolean", "3-2": "True - если вы хотите передавать абсолютно все email-адреса в Retail Rocket, false - если вы хотите передавать только email-адреса тех пользователь, которые дали согласие на рассылку (user.isSubscribed == true).\n\n**Значение по умолчанию:** false", "4-0": "listMethods", "4-1": "String Mapping", "4-2": "Описание рекомендательных алгоритмов, применяемых к определенному списку рекомендаций, где ключем является название списка рекомендаций, а значением - название алгоритма (метода) рекомендаций.", "5-0": "customVariables", "5-1": "Variable Mapping (digitalData | event | constant)", "5-2": "Используется для автоматической установки пользовательских переменных, ассоциированных с емэйлом, на основе данных, переданных в событии подписки (Subscribed).", "1-0": "userIdProperty", "1-1": "String", "1-2": "Параметр DDL, который будет использовать в качестве userId для Retail Rocket (переменная rrPartnerUserId).\n\n**Значение по умолчанию:** \"user.userId\"", "2-0": "noConflict", "2-1": "Boolean", "2-2": "Необходимо установить в значение true, если на сайте уже установлен тег Retail Rocket. В этом случае тег не будет грузиться повторно, а также не будут повторно отравляться события основных трекеров. В этом случае интеграция будет реагировать лишь на событие \"Subscribed\", автоматически передавая полученные email-адреса в Retail Rocket.\n\n**Значение по умолчанию:** false" }, "cols": 3, "rows": 6 } [/block] [block:callout] { "type": "danger", "body": "Если поле noConflict=false, то partnerId обязательно должен быть передан." } [/block] [block:api-header] { "type": "basic", "title": "Минимальные настройки Digital Data Layer" } [/block] **Страница товарной категории:** [block:code] { "codes": [ { "code": "{\n \"user\": {\n \"email\": \"test@driveback.ru\",\n \"isSubscribed\": true\n },\n\t\"page\": {\n \t\"type\": \"category\",\n \"categoryId\": \"123\"\n }\n}", "language": "json", "name": "" } ] } [/block] **Страница карточки товара:** [block:code] { "codes": [ { "code": "{\n \"user\": {\n \"email\": \"test@driveback.ru\",\n \"isSubscribed\": true\n },\n \"page\": {\n \t\"type\": \"product\"\n },\n \"product\": {\n \t\"id\": \"123\"\n }\n}", "language": "json", "name": "" } ] } [/block] **Страница подтверждения заказа:** [block:code] { "codes": [ { "code": "{\n \"user\": {\n \"email\": \"test@driveback.ru\",\n \"isSubscribed\": true\n },\n \"page\": {\n \t\"type\": \"confirmation\"\n },\n \"transaction\": {\n \t\"lineItems\": [\n {\n \t\"product\": {\n \"id\": \"123\",\n \"unitSalePrice\": 15000\n },\n \"quantity\": 1\n },\n {\n \t\"product\": {\n \"id\": \"234\",\n \"unitSalePrice\": 19000\n },\n \"quantity\": 2\n }\n ]\n }\n}", "language": "json", "name": "" } ] } [/block] [block:api-header] { "type": "basic", "title": "Минимальный набор семантических событий:" } [/block] **Добавление товара в корзину:** [block:code] { "codes": [ { "code": "digitalData.events.push({\n\t\"name\": \"Added Product\",\n \"category\": \"Ecommerce\",\n \"product\": \"123\",\n});\n\n//или\n\ndigitalData.events.push({\n\t\"name\": \"Added Product\",\n \"category\": \"Ecommerce\",\n \"product\": {\n \t\"id\": \"123\"\n },\n});", "language": "javascript", "name": "JavaScript" } ] } [/block] **Клик на товаре из блока (списка) рекоментаций**: [block:code] { "codes": [ { "code": "digitalData.events.push({\n\t\"name\": \"Clicked Product\",\n \"category\": \"Ecommerce\",\n \"listItem\": {\n \t\"product\": \"123\",\n \"listName\": \"listing_recom\"\n },\n});", "language": "javascript" } ] } [/block] **Подписка на рассылку:** [block:code] { "codes": [ { "code": "digitalData.events.push({\n\t\"name\": \"Subscribed\",\n \"category\": \"Email\",\n \"user\": {\n \t\"email\": \"email@example.com\"\n }\n});", "language": "javascript", "name": "JavaScript" } ] } [/block]