Selltics Docs

Русский

English

Русский

English

Оформление

Профили и аккаунты ​

Обновлено

Профиль — это один рекламодатель в одном маркетплейсе; рекламный аккаунт содержит кампании всех рекламных продуктов. Здесь — оба понятия, типы профилей и какой заголовок несёт какой идентификатор.

Как это описывает Amazon

Каждое утверждение на этой странице пересказывает публичную документацию Amazon из раздела Источники.

Коротко ​

  • Профиль — это рекламный аккаунт рекламодателя в одном конкретном маркетплейсе.
  • Id профиля передаётся в заголовке Amazon-Advertising-API-Scope.
  • GET /v2/profiles возвращает профили, доступные токену, отдельно на каждом региональном хосте.
  • Рекламный аккаунт содержит кампании и данные всех рекламных продуктов.

Профиль ​

  • Профиль — это рекламный аккаунт рекламодателя в одном конкретном маркетплейсе.
  • Рекламодатель, который рекламируется в одном маркетплейсе, может иметь один профиль. Тот, кто рекламируется в регионе или по всему миру, имеет отдельный профиль на каждый маркетплейс.
  • Больше одного профиля на маркетплейс у рекламодателя быть не может.
  • Для спонсорской рекламы профиль — это рекламный аккаунт в маркетплейсе; для Amazon DSP он представляет сущность в конкретном маркетплейсе или регионе.
  • Отчёты и все операции управления сущностями привязаны к одному профилю. Чтобы обратиться к тому же рекламодателю в другом маркетплейсе, нужен отдельный запрос с id профиля этого маркетплейса.

Id профиля ​

  • Id профиля — это реквизит, который ограничивает вызов одним рекламодателем в одном маркетплейсе.
  • Он передаётся в заголовке Amazon-Advertising-API-Scope.

Заголовок нужен всегда

Заголовок обязателен даже для рекламодателя с единственным профилем; отсутствующее или неверное значение даёт ответ 401 Unauthorized или 400 Bad Request.

Список профилей ​

  • GET /v2/profiles возвращает профили рекламодателя, чьё разрешение представляет access token. Этому вызову заголовок Amazon-Advertising-API-Scope не нужен.
  • В списке только профили, чей маркетплейс относится к региону вызванного хоста (см. Маркетплейсы и регионы).
  • По умолчанию в списке только профили с правом просматривать и изменять кампании; это меняют параметры запроса apiProgram и accessLevel.

Пример

Рекламодатель с аккаунтами только в Японии и Сингапуре получит от североамериканского хоста пустой список.

Типы профилей ​

Поле accountInfo.type профиля называет вид аккаунта за ним. Значения type:

  • seller — аккаунт продавца. Используется только с Sponsored Products, Sponsored Brands и Sponsored Display; для Sponsored Brands и Sponsored Display аккаунт также должен быть зарегистрирован в Brand Registry.
  • vendor — аккаунт вендора. Используется только с Sponsored Products, Sponsored Brands и Sponsored Display.
  • agency — аккаунт агентства. Используется только с DSP и Data Provider API.

Рекламный аккаунт и account id ​

Amazon Ads API v1 использует единую модель аккаунтов:

  • Рекламный аккаунт — основная сущность, которая содержит кампании и данные всех рекламных продуктов.
  • Id профиля идентифицирует его в операциях спонсорской рекламы (Amazon-Advertising-API-Scope).
  • Account id идентифицирует его в операциях Amazon DSP и межпродуктовых операциях (Amazon-Ads-AccountId).
  • Manager account объединяет рекламные аккаунты; его id передаётся в Amazon-Ads-Manager-AccountId для операций manager account.
  • В теле запроса advertiserAccount.id называет аккаунт, чьи данные читаются или изменяются.

Какой из двух заголовков идентичности может нести запрос, описано в Ограничениях API.

Источники ​