Создание источников

Что такое источник?

Источники в AIO обозначают места, откуда приходят визиты. Каждый источник в AIO состоит из набора полей, необходимых именно для этого источника. Без источника нельзя сгенерировать ссылку кампании.

В общем виде источники это заранее настроенные шаблоны ссылок, по которым направляется трафик с разных рекламных платформ: Facebook Ads, Google Ads, TikTok и других.

Как создать источник из шаблона (рекомендуется)

Чтобы просматривать, создавать и редактировать источники, перейдите в раздел Sources.

Нажмите кнопку +Source, чтобы создать новый источник.

Появится окно Choose Source Template, в котором можно выбрать рекламную платформу, для которой будет использоваться источник.

Окно Source Template в разделе Add Source.

После выбора платформы источник автоматически настраивается в вашем Tenant со всеми обязательными полями и готов к работе. Если же вы хотите его доработать, отредактируйте JSON-код вручную в блоке Raw или используйте Source Builder, чтобы менять настройки визуально в блоках Links, Rewrites и Replaces.

Создание источника вручную в Source Builder

Обратите внимание: код вашего источника должен включать поля, настроенные в AIO для этого источника, иначе параметры из трекинговых ссылок не будут считываться. При создании источника из шаблона все обязательные поля уже настроены. Если же вы собираете источник с нуля, обязательные поля нужно добавить вручную.

У пользователей версии MTK нет доступа к системным полям, поэтому обратитесь за помощью в нашу поддержку.

Для примера создадим источник для Facebook с нуля с помощью конструктора источников.

Убедитесь, что в вашем Tenant есть все необходимые поля. Каждый параметр, получаемый из трекинговых ссылок, должен быть сопоставлен с полем AIO, поэтому первый шаг при создании нового источника это добавление нужных полей. У пользователей версии MTK нет доступа к системным полям, поэтому обратитесь за помощью в нашу поддержку.
Перейдите в Sources→нажмите +Source.

Выберите Manual Placement.

Созданный источник автоматически включает все основные трекинговые параметры AIO (cuuid, suuid, launcher), без которых наши ссылки не работают.

Links

Ссылка с основными параметрами AIO уже настроена, поэтому создавать её с нуля не нужно. При этом в ссылку можно добавить дополнительные параметры.

Если нужно добавить ещё одну ссылку, выберите её Type (Link, Naming или URL Parameters) и нажмите Add Link.

Введите подсказку, которая будет показываться для вашего источника в Link Generator, и при желании описание. Затем нажмите Add Parameter, чтобы добавить в источник параметры шаблона.

Поля подсказки и описания в блоке Links.

Включите переключатель luuid, чтобы ссылку можно было использовать в режиме Encrypted. Включайте его, если планируете позже использовать ссылку как зашифрованную.

Переключатель Short включает шифрование параметров. Если он включён, параметр будет скрыт в зашифрованных ссылках.

Основные трекинговые параметры AIO в блоке Links.

Включайте переключатель Short только для основных трекинговых параметров AIO (таких как cuuid, suuid и launcher) или для параметров, которые заполняются в Link Generator (например, Pixel или CAPI Token). Не включайте Short для параметров, которые заполняет сам источник (например, FB Campaign Name или FB Ad ID). Эти значения подставляются на стороне источника, поэтому зашифрованные плейсхолдеры не будут распознаны, и параметры останутся незаполненными.

Добавьте все остальные параметры, которые будут использоваться в трекинговых ссылках, в следующем формате:

Field slug from AIO → Field type (для параметров, которые заполняет источник, используйте Simple String) → Field placeholder со стороны источника.

Пример параметров Facebook в блоке Links.

Если какие-то параметры должны заполняться из Link Generator, используйте From Replace и плейсхолдер {{aio.replace}}.

Создание источника вручную в Source Builder

Replaces

Чтобы создать специальные поля для параметров, которые должны заполняться из Link Generator (например, FB Pixel или FB CAPI Token), перейдите в блок Replaces. Нажмите Add Replace.

Создайте Replaces, которые должны входить в ваш источник и заполняться в Link Generator.

Key: введите slug поля из AIO или значение из блока Rewrites (если применимо).
Placeholder: введите значение, которое будет показываться в Link Generator.
Tooltip: введите подсказку, которая будет показываться в Link Generator.
Type: выберите Text или Select в зависимости от задачи.
Default Value: введите значение, которое будет использоваться по умолчанию, если поле пустое, или оставьте поле незаполненным.
Required: включите этот переключатель, чтобы параметр стал обязательным в Link Generator.

Rewrites

(Необязательно) Добавьте Rewrites.

Если вы не хотите использовать в трекинговых ссылках slug полей, создайте rewrites и используйте вместо них свои значения. Перейдите в блок Rewrites и нажмите Add Rewrite.

Заполните поля From и To в следующем формате:

From: введите значение, которое хотите использовать в ссылках (например, pixel вместо fb_pixel).
To: введите slug поля, из которого будет подставляться значение.

Кроме того, источник можно посмотреть в формате JSON в блоке Raw. Нажмите кнопку Code Editor в правом нижнем углу, чтобы открыть увеличенное окно редактирования.

Пример кода, который используется для источника FB CAPI:

Код настроек источника FB CAPI

{
  "settings": {},
  "placeholders": [],
  "replace": [
    {
      "required": true,
      "key": "creative",
      "label": "Creative",
      "placeholder": "Creative Description Goes Here",
      "description": null,
      "tooltip": "Creative description using by launcher",
      "values": null,
      "dynamic-type": "text",
      "static-data-key": null,
      "dynamic-data-type": "string",
      "value": null
    },
    {
      "required": true,
      "key": "fb_account_id",
      "label": "Account ID",
      "placeholder": "Ex: 200000000002",
      "description": null,
      "tooltip": "Facebook Account ID",
      "values": null,
      "dynamic-type": "text",
      "static-data-key": null,
      "dynamic-data-type": "string",
      "value": null
    },
    {
      "required": true,
      "key": "fb_capi_token",
      "label": "FB CAPI Token",
      "placeholder": "Ex: EAAd...",
      "description": null,
      "tooltip": "EAAd Token from BM",
      "values": null,
      "dynamic-type": "text",
      "static-data-key": null,
      "dynamic-data-type": "string",
      "value": null
    },
    {
      "required": true,
      "key": "fb_pixel",
      "label": "FB Pixel",
      "placeholder": "Ex: 1000000000000000",
      "description": null,
      "tooltip": "FB ixel ID",
      "values": null,
      "dynamic-type": "text",
      "static-data-key": null,
      "dynamic-data-type": "string",
      "value": null
    },
    {
      "required": true,
      "key": "fb_lead_action",
      "label": "FB Lead Action ( CAPI )",
      "placeholder": "Select FB Events",
      "description": "Action will be fired via CAPI for AIO Leads",
      "tooltip": null,
      "values": {
        "AddPaymentInfo": "Add Payment Info",
        "AddToCart": "Add To Cart",
        "AddToWishlist": "Add To Wishlist",
        "CompleteRegistration": "Complete Registration",
        "Contact": "Contact",
        "CustomizeProduct": "Customize Product",
        "Donate": "Donate",
        "FindLocation": "Find Location",
        "InitiateCheckout": "Initiate Checkout",
        "Lead": "Lead",
        "Purchase": "Purchase",
        "Schedule": "Schedule",
        "Search": "Search",
        "StartTrial": "Start Trial",
        "SubmitApplication": "Submit Application",
        "Subscribe": "Subscribe",
        "ViewContent": "View Content"
      },
      "dynamic-type": "select",
      "dynamic-data-type": "string",
      "static-data-key": null,
      "value": "Lead"
    },
    {
      "required": true,
      "key": "fb_ftd_action",
      "label": "FB FTD Action ( CAPI )",
      "placeholder": "Select FB Events",
      "description": "Action will be fired via CAPI for AIO FTDs",
      "tooltip": null,
      "values": {
        "AddPaymentInfo": "AddPaymentInfo",
        "AddToCart": "AddToCart",
        "AddToWishlist": "AddToWishlist",
        "CompleteRegistration": "CompleteRegistration",
        "Contact": "Contact",
        "CustomizeProduct": "CustomizeProduct",
        "Donate": "Donate",
        "FindLocation": "FindLocation",
        "InitiateCheckout": "InitiateCheckout",
        "Lead": "Lead",
        "Purchase": "Purchase",
        "Schedule": "Schedule",
        "Search": "Search",
        "StartTrial": "StartTrial",
        "SubmitApplication": "SubmitApplication",
        "Subscribe": "Subscribe",
        "ViewContent": "ViewContent"
      },
      "dynamic-type": "select",
      "dynamic-data-type": "string",
      "static-data-key": null,
      "value": "Purchase"
    }
  ],
  "links": [
    {
      "type": "link",
      "title": "FB Ad Short Link",
      "tooltip": "Copy from here",
      "description": "Inserting inside fb ad link.",
      "parameters": {
        "cuuid": {
          "type": "string",
          "key": "cuuid",
          "value": "{{aio.campaign.uuid}}"
        },
        "suuid": {
          "type": "string",
          "key": "suuid",
          "value": "{{aio.source.uuid}}"
        }
      }
    },
    {
      "type": "url_parameters",
      "title": "FB AD Parameters",
      "tooltip": "Copy from here",
      "description": "Inserting isnide FB as appendix to pass fb parameters",
      "parameters": {
        "launcher": {
          "type": "placeholder",
          "key": "launcher",
          "value": "{{aio.user.uuid}}"
        },
        "fb_account_id": {
          "type": "replace",
          "key": "fb_account_id",
          "value": "{{aio.replace}}"
        },
        "creative": {
          "type": "replace",
          "key": "creative",
          "value": "{{aio.replace}}"
        },
        "fb_pixel": {
          "type": "replace",
          "key": "fb_pixel",
          "value": "{{aio.replace}}"
        },
        "fb_capi_token": {
          "type": "replace",
          "key": "fb_capi_token",
          "value": "{{aio.replace}}"
        },
        "fb_pixel_domain": {
          "type": "replace",
          "key": "fb_pixel_domain",
          "value": "{{aio.replace}}"
        },
        "fb_lead_action": {
          "type": "replace",
          "key": "fb_lead_action",
          "value": "{{aio.replace}}"
        },
        "fb_ftd_action": {
          "type": "replace",
          "key": "fb_ftd_action",
          "value": "{{aio.replace}}"
        },
        "fb_ad_id": {
          "type": "string",
          "key": "fb_ad_id",
          "value": "{{ad.id}}"
        },
        "fb_ad_set_id": {
          "type": "string",
          "key": "fb_ad_set_id",
          "value": "{{adset.id}}"
        },
        "fb_campaign_id": {
          "type": "string",
          "key": "fb_campaign_id",
          "value": "{{campaign.id}}"
        },
        "fb_site_source_name": {
          "type": "string",
          "key": "fb_site_source_name",
          "value": "{{site_source_name}}"
        },
        "fb_ad_name": {
          "type": "string",
          "key": "fb_ad_name",
          "value": "{{ad.name}}"
        },
        "fb_ad_set_name": {
          "type": "string",
          "key": "fb_ad_set_name",
          "value": "{{adset.name}}"
        },
        "fb_campaign_name": {
          "type": "string",
          "key": "fb_campaign_name",
          "value": "{{campaign.name}}"
        },
        "fb_placement": {
          "type": "string",
          "key": "fb_placement",
          "value": "{{placement}}"
        }
      }
    },
    {
      "type": "link",
      "title": "FB Ad Full Link",
      "tooltip": "Copy from here",
      "description": "Or use full link for test.",
      "parameters": {
        "cuuid": {
          "type": "string",
          "key": "cuuid",
          "value": "{{aio.campaign.uuid}}"
        },
        "suuid": {
          "type": "string",
          "key": "suuid",
          "value": "{{aio.source.uuid}}"
        },
        "fb_account_id": {
          "type": "replace",
          "key": "fb_account_id",
          "value": "{{aio.replace}}"
        },
        "launcher": {
          "type": "placeholder",
          "key": "launcher",
          "value": "{{aio.user.uuid}}"
        },
        "creative": {
          "type": "replace",
          "key": "creative",
          "value": "{{aio.replace}}"
        },
        "fb_pixel": {
          "type": "replace",
          "key": "fb_pixel",
          "value": "{{aio.replace}}"
        },
        "fb_capi_token": {
          "type": "replace",
          "key": "fb_capi_token",
          "value": "{{aio.replace}}"
        },
        "fb_pixel_domain": {
          "type": "replace",
          "key": "fb_pixel_domain",
          "value": "{{aio.replace}}"
        },
        "fb_lead_action": {
          "type": "replace",
          "key": "fb_lead_action",
          "value": "{{aio.replace}}"
        },
        "fb_ftd_action": {
          "type": "replace",
          "key": "fb_ftd_action",
          "value": "{{aio.replace}}"
        },
        "fb_ad_id": {
          "type": "string",
          "key": "fb_ad_id",
          "value": "{{ad.id}}"
        },
        "fb_ad_set_id": {
          "type": "string",
          "key": "fb_ad_set_id",
          "value": "{{adset.id}}"
        },
        "fb_campaign_id": {
          "type": "string",
          "key": "fb_campaign_id",
          "value": "{{campaign.id}}"
        },
        "fb_site_source_name": {
          "type": "string",
          "key": "fb_site_source_name",
          "value": "{{site_source_name}}"
        },
        "fb_ad_name": {
          "type": "string",
          "key": "fb_ad_name",
          "value": "{{ad.name}}"
        },
        "fb_ad_set_name": {
          "type": "string",
          "key": "fb_ad_set_name",
          "value": "{{adset.name}}"
        },
        "fb_campaign_name": {
          "type": "string",
          "key": "fb_campaign_name",
          "value": "{{campaign.name}}"
        },
        "fb_placement": {
          "type": "string",
          "key": "fb_placement",
          "value": "{{placement}}"
        }
      }
    }
  ]
}

Нажмите кнопку Confirm, чтобы сохранить источник. Теперь его можно использовать для генерации ссылок в Campaigns → Link Generator.

Подробнее о генерации ссылок читайте в руководстве Генерация ссылок .

После настройки источника обязательно настройте для него постбеки в AIO. Подробнее в руководстве Установка сторонних постбеков в AIO.