get

Возвращает параметры объявлений, отвечающих заданным критериям.

  1. Ограничения
  2. Запрос
  3. Ответ

Ограничения

Метод возвращает не более 10 000 объектов.

Запрос

Структура запроса в формате JSON:

{
  "method": "get",
  "params": { /* params */
    "SelectionCriteria": {  /* AdsSelectionCriteria */
      "Ids": [(long), ... ],
      "States": [( "OFF" | ... | "ARCHIVED" ), ... ],
      "Statuses": [( "ACCEPTED" | ... | "REJECTED" ), ... ],
      "CampaignIds": [(long), ... ],
      "AdGroupIds": [(long), ... ],
      "Types": [( "TEXT_AD" | "MOBILE_APP_AD" | "DYNAMIC_TEXT_AD" | "IMAGE_AD" | "CPC_VIDEO_AD" | "CPM_BANNER_AD" ), ... ],
      "Mobile": ( "YES" | "NO" ),
      "VCardIds": [(long), ... ],
      "SitelinkSetIds": [(long), ... ],
      "AdImageHashes": [(string), ... ],
      "VCardModerationStatuses": [( "ACCEPTED" | ... | "REJECTED" ), ... ],
      "SitelinksModerationStatuses": [( "ACCEPTED" | ... | "REJECTED" ), ... ],
      "AdImageModerationStatuses": [( "ACCEPTED" | ... | "REJECTED" ), ... ],
      "AdExtensionIds": [(long), ... ]
    }, /* required */
    "FieldNames": [( "AdCategories" | ... | "Subtype" ), ... ], /* required */
    "TextAdFieldNames": [( "Title" | ... | "VideoExtension" ), ... ],
    "MobileAppAdFieldNames": [( "Title" | ... | "TrackingUrl" ), ... ],
    "DynamicTextAdFieldNames": [( "Text" | ... | "AdExtensions" )],
    "TextImageAdFieldNames": [( "AdImageHash" | "Href" ), ... ],
    "MobileAppImageAdFieldNames": [( "AdImageHash" | "TrackingUrl" ), ... ],
    "TextAdBuilderAdFieldNames": [( "Creative" | "Href" ), ... ],
    "MobileAppAdBuilderAdFieldNames": [( "Creative" | "TrackingUrl" ), ... ],
    "CpcVideoAdBuilderAdFieldNames": [( "Creative" | "Href" ), ... ], 
    "CpmBannerAdBuilderAdFieldNames": [( "Creative" | "Href" | "TrackingPixels" ), ... ],
    "Page": {  /* LimitOffset */
      "Limit": (long),
      "Offset": (long)
    }
  } 
}

Ниже приведено описание параметров.

ПараметрТипОписаниеОбязательный
Структура params (для JSON) / GetRequest (для SOAP)
SelectionCriteriaAdsSelectionCriteria

Критерий отбора объявлений.

Да
FieldNamesarray of AdFieldEnum

Имена параметров верхнего уровня, которые требуется получить.

Да
TextAdFieldNamesarray of TextAdFieldEnumИмена параметров текстово-графического объявления, которые требуется получить. См. Тип объявления.
Примечание. Если согласно SelectionCriteria отобрано объявление другого типа, параметры из TextAdFieldNames не возвращаются.
Нет
MobileAppAdFieldNamesarray of MobileAppAdFieldEnumИмена параметров объявления для рекламы мобильных приложений, которые требуется получить.
Примечание. Если согласно SelectionCriteria отобрано объявление другого типа, параметры из MobileAppAdFieldNames не возвращаются.
Нет
DynamicTextAdFieldNamesarray of DynamicTextAdFieldEnumИмена параметров динамического объявления, которые требуется получить.
Примечание. Если согласно SelectionCriteria отобрано объявление другого типа, параметры из DynamicTextAdFieldNames не возвращаются.
Нет
TextImageAdFieldNamesarray of TextImageAdFieldEnumИмена параметров графического объявления, созданного на основе изображения (в группе текстово-графических объявлений), которые требуется получить.
Примечание. Если согласно SelectionCriteria отобрано объявление другого типа или подтипа, параметры из TextImageAdFieldNames не возвращаются.
Нет
MobileAppImageAdFieldNamesarray of MobileAppImageAdFieldEnumИмена параметров графического объявления, созданного на основе изображения (в группе для рекламы мобильных приложений), которые требуется получить.
Примечание. Если согласно SelectionCriteria отобрано объявление другого типа или подтипа, параметры из MobileAppImageAdFieldNames не возвращаются.
Нет
TextAdBuilderAdFieldNamesarray of TextAdBuilderAdFieldEnumИмена параметров графического объявления, созданного на основе креатива (в группе текстово-графических объявлений), которые требуется получить.
Примечание. Если согласно SelectionCriteria отобрано объявление другого типа или подтипа, параметры из TextAdBuilderAdFieldNames не возвращаются.
Нет
MobileAppAdBuilderAdFieldNamesarray of MobileAppAdBuilderAdFieldEnumИмена параметров графического объявления, созданного на основе креатива (в группе для рекламы мобильных приложений), которые требуется получить.
Примечание. Если согласно SelectionCriteria отобрано объявление другого типа или подтипа, параметры из MobileAppAdBuilderAdFieldNames не возвращаются.
Нет
CpcVideoAdBuilderAdFieldNamesarray of CpcVideoAdBuilderAdFieldNamesИмена параметров видеообъявления, которые требуется получить. См.
Примечание. Если согласно SelectionCriteria отобрано объявление другого типа или подтипа, параметры из CpcVideoAdBuilderAdFieldNames не возвращаются.
Нет
CpmBannerAdBuilderAdFieldNamesarray of CpmBannerAdBuilderAdFieldEnumИмена параметров медийного объявления, которые требуется получить. См. Тип объявления.
Примечание. Если согласно SelectionCriteria отобрано объявление другого типа, параметры из CpmBannerAdBuilderAdFieldNames не возвращаются.
Нет
PageLimitOffset

Структура, задающая страницу при постраничной выборке данных.

Нет
Структура AdsSelectionCriteria
Idsarray of longОтбирать объявления с указанными идентификаторами. От 1 до 10 000 элементов в массиве.Хотя бы один из параметров CampaignIds, AdGroupIds и Ids (могут присутствовать все)
AdGroupIdsarray of longОтбирать объявления указанных групп. От 1 до 1000 элементов в массиве.
CampaignIdsarray of longОтбирать объявления указанных кампаний. От 1 до 10 элементов в массиве.
Statesarray of AdStateSelectionEnumОтбирать объявления с указанными состояниями. См. Статус и состояние объявления.Нет
Statusesarray of AdStatusSelectionEnumОтбирать объявления с указанными статусами. См. Статус и состояние объявления.Нет
Typesarray of AdTypeEnum

Отбирать объявления с указанными типами. См. Тип объявления.

Примечание. Отбор объявлений по подтипу не поддерживается. При указании значения IMAGE_AD будут получены графические объявления независимо от подтипа.
Нет
MobileYesNoEnum

Отбирать объявления по признаку того, что объявление является мобильным:

  • YES — мобильные объявления.
  • NO — обычные объявления.

Если задано значение YES, будут получены только текстово-графические объявления. Не следует задавать это значение, если требуется получить объявления других типов.

Нет
VCardIdsarray of longОтбирать объявления с указанными визитками. От 1 до 50 элементов в массиве.

Если параметр задан, будут получены только текстово-графические объявления и динамические объявления. Не следует задавать его, если требуется получить объявления других типов.

Нет
SitelinkSetIdsarray of longОтбирать объявления с указанными наборами быстрых ссылок. От 1 до 50 элементов в массиве.

Если параметр задан, будут получены только текстово-графические объявления и динамические объявления. Не следует задавать его, если требуется получить объявления других типов.

Нет
AdImageHashesarray of stringОтбирать объявления с указанными изображениями. От 1 до 50 элементов в массиве.Нет
VCardModerationStatusesarray of ExtensionStatusSelectionEnumОтбирать объявления по результату модерации визитки. Описание статусов см. в разделе Дополнения к объявлению.

Если параметр задан, будут получены только текстово-графические объявления и динамические объявления. Не следует задавать его, если требуется получить объявления других типов.

Нет
SitelinksModerationStatusesarray of ExtensionStatusSelectionEnumОтбирать объявления по результату модерации набора быстрых ссылок. Описание статусов см. в разделе Дополнения к объявлению.

Если параметр задан, будут получены только текстово-графические объявления и динамические объявления. Не следует задавать его, если требуется получить объявления других типов.

Нет
AdImageModerationStatusesarray of ExtensionStatusSelectionEnumОтбирать объявления по результату модерации изображения. Описание статусов см. в разделе Дополнения к объявлению.

Если параметр задан, будут получены только текстово-графические объявления, динамические объявления и объявления для рекламы мобильных приложений. Не следует задавать его, если требуется получить объявления других типов.

Нет
AdExtensionIdsarray of longОтбирать объявления с указанными расширениями. От 1 до 50 элементов в массиве.

Если параметр задан, будут получены только текстово-графические объявления и динамические объявления. Не следует задавать его, если требуется получить объявления других типов.

Нет

Ответ

Структура ответа в формате JSON:

{
  "result": { /* result */
    "Ads": [{  /* AdGetItem */
      "Id": (long),
      "CampaignId": (long),
      "AdGroupId": (long),
      "Status": ( "ACCEPTED" | ... | "UNKNOWN" ),
      "State": ( "OFF" | ... | "UNKNOWN" ),
      "StatusClarification": (string),
      "AdCategories": {  /* ArrayOfAdCategoryEnum */
        "Items": [( "ABORTION" | ... | "TOBACCO" ), ... ] /* required */
      }, /* nillable */ 
      "AgeLabel": ( "AGE_0" | ... | "MONTHS_12"), /* nillable */
      "Type": ( "TEXT_AD" | "MOBILE_APP_AD" | "DYNAMIC_TEXT_AD" | "IMAGE_AD" | "CPC_VIDEO_AD" | "CPM_BANNER_AD" ),
      "Subtype": ( "NONE" | "TEXT_IMAGE_AD" | "MOBILE_APP_IMAGE_AD" |  "TEXT_AD_BUILDER_AD" | "MOBILE_APP_AD_BUILDER_AD" ),
      "TextAd": {  /* TextAdGet */
        "Title": (string),
        "Title2": (string), /* nillable */ 
        "Text": (string),
        "Href": (string), /* nillable */ 
        "Mobile": ( "YES" | "NO" ),
        "DisplayDomain": (string), /* nillable */ 
        "DisplayUrlPath": (string), /* nillable */ 
        "VCardId": (long), /* nillable */ 
        "AdImageHash": (string), /* nillable */ 
        "SitelinkSetId": (long), /* nillable */
        "DisplayUrlPathModeration": {  /* ExtensionModeration */
          "Status": ( "ACCEPTED" | ... | "UNKNOWN" ), /* required */
          "StatusClarification": (string)
        }, /* nillable */ 
        "VCardModeration": {  /* ExtensionModeration */
          "Status": ( "ACCEPTED" | ... | "UNKNOWN" ), /* required */
          "StatusClarification": (string)
        }, /* nillable */ 
        "SitelinksModeration": {  /* ExtensionModeration */
          "Status": ( "ACCEPTED" | ... | "UNKNOWN" ), /* required */
          "StatusClarification": (string)
        }, /* nillable */ 
        "AdImageModeration": {  /* ExtensionModeration */
          "Status": ( "ACCEPTED" | ... | "UNKNOWN" ), /* required */
          "StatusClarification": (string)
        }, /* nillable */ 
        "AdExtensions": [{  /* AdExtensionAdGetItem */
          "AdExtensionId": (long), /* required */
          "Type": ( "CALLOUT" | "UNKNOWN" ) /* required */
        }, ... ],
        "VideoExtension": {  /* VideoExtensionGetItem */
          "CreativeId": (long), /* required */
          "Status": ( "ACCEPTED" | ... | "UNKNOWN" ),
          "ThumbnailUrl": (string), /* required */
          "PreviewUrl": (string) /* required */
        } /* nillable */
      },
      "MobileAppAd": {  /* MobileAppAdGet */
        "Title": (string),
        "Text": (string),
        "TrackingUrl": (string), /* nillable */ 
        "Features": [{  /* MobileAppAdFeatureGetItem */
          "Feature": ( "PRICE" | "ICON" | "CUSTOMER_RATING" | "RATINGS" ), /* required */
          "Enabled": ( "YES" | "NO" ), /* required */
          "IsAvailable": ( "YES" | "NO" | "UNKNOWN" ) /* required */
        }, ... ],
        "Action": ( "DOWNLOAD" | "GET" | "INSTALL" | "MORE" | "OPEN" | "UPDATE" | "PLAY" | "BUY_AUTODETECT" ),
        "AdImageHash": (string), /* nillable */ 
        "AdImageModeration": {  /* ExtensionModeration */
          "Status": ( "ACCEPTED" | ... | "UNKNOWN" ), /* required */
          "StatusClarification": (string),
        } /* nillable */ 
      }, 
      "DynamicTextAd": {  /* DynamicTextAdGet */
        "Text": (string),             
        "VCardId": (long), /* nillable */ 
        "AdImageHash": (string), /* nillable */ 
        "SitelinkSetId": (long), /* nillable */ 
        "VCardModeration": {  /* ExtensionModeration */
          "Status": ( "ACCEPTED" | ... | "UNKNOWN" ), /* required */
          "StatusClarification": (string),
        }, /* nillable */ 
        "SitelinksModeration": {  /* ExtensionModeration */
          "Status": ( "ACCEPTED" | ... | "UNKNOWN" ), /* required */
          "StatusClarification": (string), 
        } /* nillable */ 
        "AdImageModeration": {  /* ExtensionModeration */
          "Status": ( "ACCEPTED" | ... | "UNKNOWN" ), /* required */
          "StatusClarification": (string),
        }, /* nillable */ 
        "AdExtensions": [{  /* AdExtensionAdGetItem */
          "AdExtensionId": (long), /* required */
          "Type": ( "CALLOUT" | "UNKNOWN" ) /* required */
        }, ... ]
      },
      "TextImageAd": {  /* TextImageAdGet */
        "Href": (string),
        "AdImageHash": (string)
      },
      "MobileAppImageAd": {  /* MobileAppImageAdGet */
        "TrackingUrl": (string), /* nillable */
        "AdImageHash": (string)
      },
      "TextAdBuilderAd": {  /* TextAdBuilderAdGet */
        "Creative": { /* AdBuilderAdGetItem */
          "CreativeId": (long), /* required */
          "ThumbnailUrl": (string),
          "PreviewUrl": (string)
        }, 
        "Href": (string)
      },
      "MobileAppAdBuilderAd": {  /* MobileAppAdBuilderAdGet */
        "Creative": { /* AdBuilderAdGetItem */
          "CreativeId": (long), /* required */
          "ThumbnailUrl": (string),
          "PreviewUrl": (string)
        }, 
        "TrackingUrl": (string) /* nillable */
      },
      "CpcVideoAdBuilderAd": {  /* CpcVideoAdBuilderAdGet */
        "Creative": { /* AdBuilderAdGetItem */
          "CreativeId": (long), /* required */
          "ThumbnailUrl": (string),
          "PreviewUrl": (string)
        }, 
        "Href": (string)
      },
      "CpmBannerAdBuilderAd": {  /* CpmBannerAdBuilderAdGet */
        "Creative": { /* AdBuilderAdGetItem */
          "CreativeId": (long), /* required */
          "ThumbnailUrl": (string),
          "PreviewUrl": (string)
        },
        "Href": (string),
        "TrackingPixels": { /* TrackingPixelGetItem */ 
          "TrackingPixel": (string), /* required */
          "Provider": (string) /* required */
        }
      }
    }, ... ],
    "LimitedBy": (long)
  }
}

Ниже приведено описание параметров.

ПараметрТипОписание
Структура result (для JSON) / GetResponse (для SOAP)
Adsarray of AdGetItemОбъявления.
LimitedBylongПорядковый номер последнего возвращенного объекта. Передается в случае, если количество объектов в ответе было ограничено лимитом. См. раздел Постраничная выборка.
Структура AdGetItem
IdlongИдентификатор объявления.
CampaignIdlongИдентификатор кампании, к которой относится объявление.
AdGroupIdlongИдентификатор группы, к которой относится объявление.
StatusStatusEnumСтатус объявления. Описание статусов см. в разделе Статус и состояние объявления.
StatusClarificationstring

Текстовое пояснение к статусу и/или причины отклонения на модерации.

StateStateEnumСостояние объявления. Описание состояний см. в разделе Статус и состояние объявления.
AdCategoriesArrayOfString, nillableОсобая категория.
AgeLabelAgeLabelEnum, nillableВозрастная метка.
TypeAdTypeEnumТип объявления. См. Тип объявления.
SubtypeAdSubtypeEnumПодтип объявления. Для объявлений с типом, отличным от IMAGE_AD, возвращается значение NONE.
TextAdTextAdGetПараметры текстово-графического объявления.
MobileAppAdMobileAppAdGetПараметры объявления для рекламы мобильных приложений.
DynamicTextAdDynamicTextAdGetПараметры динамического объявления.
TextImageAdTextImageAdGetПараметры графического объявления, созданного на основе изображения (в группе текстово-графических объявлений).
MobileAppImageAdMobileAppImageAdGetПараметры графического объявления, созданного на основе изображения (в группе для рекламы мобильных приложений).
TextAdBuilderAdTextAdBuilderAdGetПараметры графического объявления, созданного на основе креатива (в группе текстово-графических объявлений).
MobileAppAdBuilderAdMobileAppAdBuilderAdGetПараметры графического объявления, созданного на основе креатива (в группе для рекламы мобильных приложений).
CpcVideoAdBuilderAdCpcVideoAdBuilderAdGetПараметры видеообъявления.
CpmBannerAdBuilderAdCpmBannerAdBuilderAdGetПараметры медийного объявления.
Структура TextAdGet
Titlestring

Заголовок 1.

Не более 35 символов без учета «узких» плюс не более 15 «узких» символов. Каждое слово не более 22 символов. В случае использования шаблона символы # не учитываются в длине.

Title2string, nillable

Заголовок 2.

Не более 30 символов без учета «узких» плюс не более 15 «узких» символов. Каждое слово не более 22 символов. В случае использования шаблона символы # не учитываются в длине.

Textstring

Текст объявления.

Не более 81 символа без учета «узких» плюс не более 15 «узких» символов. Каждое слово не более 23 символов. В случае использования шаблона символы # не учитываются в длине.

Hrefstring, nillable

Ссылка на сайт рекламодателя. Не более 1024 символов. В случае использования шаблона символы # не учитываются в длине.

Должна содержать протокол и доменное имя. Может содержать подстановочные переменные.

MobileYesNoEnumПризнак того, что объявление является мобильным: YES или NO. См. раздел Мобильные объявления помощи Директа.
DisplayDomainstring, nillableРекламируемый домен. Определяется автоматически на основе ссылки объявления.
DisplayUrlPathstring, nillable

Отображаемая ссылка. Допускается только при наличии параметра Href. Не более 20 символов. В случае использования шаблона символы # не учитываются в длине.

Может содержать буквы, цифры, символы -, №, /, %, #. Запрещены пробел, символ _, двойные символы --, //.

См. раздел Отображаемая ссылка помощи Директа.

VCardIdlong, nillableИдентификатор виртуальной визитки. Визитка должна принадлежать той же кампании, что и объявление.
SitelinkSetIdlong, nillableИдентификатор набора быстрых ссылок. Допускается только при наличии параметра Href.
AdImageHashstring, nillable

Хэш изображения.

Для текстово-графических объявлений подходят только изображения с типом REGULAR и WIDE, см. Тип изображения.
DisplayUrlPathModerationExtensionModeration, nillableРезультат модерации отображаемой ссылки.
VCardModerationExtensionModeration, nillableРезультат модерации визитки.
SitelinksModerationExtensionModeration, nillableРезультат модерации набора быстрых ссылок.
AdImageModerationExtensionModeration, nillableРезультат модерации изображения.
AdExtensionsarray of AdExtensionAdGetItemРасширения.
VideoExtensionVideoExtensionGetItem, nillable

Видеодополнение.

См. раздел Видеодополнения помощи Директа.

Структура ExtensionModeration
StatusStatusEnumРезультат модерации связки объявления с указанным дополнительным элементом. Описание статусов см. в разделе Дополнения к объявлению.
StatusClarificationstringТекстовое пояснение к статусу и/или причины отклонения на модерации.
Структура AdExtensionAdGetItem
AdExtensionIdlongИдентификатор расширения.
TypeAdExtensionTypeEnumТип расширения. В настоящее время доступен только один тип расширения — «Уточнение» (CALLOUT).
Структура VideoExtensionGetItem
CreativeIdlongИдентификатор креатива.
StatusStatusEnumРезультат модерации связки объявления с видеодополнением. Описание статусов см. в разделе Дополнения к объявлению.
ThumbnailUrlstringСсылка на эскиз (изображение) для предварительного просмотра.
PreviewUrlstringСсылка на видео для предварительного просмотра.
Структура MobileAppAdGet
Titlestring

Заголовок.

Не более 33 символов с учетом «узких». Каждое слово не более 22 символов. В случае использования шаблона символы # не учитываются в длине.

Textstring

Текст объявления.

Не более 75 символов с учетом «узких». Каждое слово не более 23 символов. В случае использования шаблона символы # не учитываются в длине.

Featuresarray of MobileAppAdFeatureGetItemДополнения, которые требуется автоматически загружать из магазина приложений и отображать в объявлении.
TrackingUrlstring, nillableТрекинговая ссылка для отслеживания установок приложения.
ActionMobileAppAdActionEnum

Надпись на кнопке:

  • DOWNLOAD — «Загрузить»

  • GET — «Скачать»

  • INSTALL — «Установить»

  • MORE — «Подробнее»

  • OPEN — «Открыть»

  • UPDATE — «Обновить»

  • PLAY — «Играть»

  • BUY_AUTODETECT — надпись зависит о цены приложения: «Купить», если цена отлична от нуля, или «Бесплатно», если цена равна нулю.

AdImageHashstring, nillable

Хэш изображения.

Для рекламы мобильных приложений подходят только изображения с типом WIDE, см. Тип изображения.

AdImageModerationExtensionModeration, nillableРезультат модерации изображения.
Структура MobileAppAdFeatureGetItem
FeatureMobileAppFeatureEnum

Тип дополнения:

  • PRICE — цена;
  • ICON — иконка;
  • CUSTOMER_RATING — рейтинг;
  • RATINGS — количество оценок (отображается, только если включено отображение рейтинга).
Примечание. Возвращаются данные о тех дополнениях, которые были указаны при создании или редактировании объявления, а также о дополнениях, которые были загружены из магазина приложений.
EnabledYesNoEnum

Отображать ли дополнение в объявлении.

Примечание.
  • Если дополнение не удалось загрузить из магазина приложений, для него допустимо значение YES, однако это дополнение не отображается при показе объявления.
  • Количество оценок отображается только вместе с рейтингом: если для типа CUSTOMER_RATING задано NO, а для RATINGS — YES, количество оценок не отображается.
IsAvailableYesNoUnknownEnum

Удалось ли загрузить дополнение из магазина приложений:

  • YES — дополнение загружено;
  • NO — дополнение не удалось загрузить;
  • UNKNOWN — попытка загрузить дополнения еще не производилась.
Структура DynamicTextAdGet
Textstring

Текст объявления.

Не более 81 символа без учета «узких» плюс не более 15 «узких» символов. Каждое слово не более 23 символов. В случае использования шаблона символы # не учитываются в длине.

VCardIdlong, nillableИдентификатор виртуальной визитки. Визитка должна принадлежать той же кампании, что и объявление.
SitelinkSetIdlong, nillableИдентификатор набора быстрых ссылок.
AdImageHashstring, nillable

Хэш изображения.

Для динамических объявлений подходят только изображения с типом REGULAR и WIDE, см. Тип изображения.

VCardModerationExtensionModeration, nillableРезультат модерации визитки.
SitelinksModerationExtensionModeration, nillableРезультат модерации набора быстрых ссылок.
AdImageModerationExtensionModeration, nillableРезультат модерации изображения.
AdExtensionsarray of AdExtensionAdGetItemРасширения.
Структура TextImageAdGet
Hrefstring

Ссылка на сайт рекламодателя. Не более 1024 символов. В случае использования шаблона символы # не учитываются в длине.

Должна содержать протокол и доменное имя. Может содержать подстановочные переменные.

AdImageHashstring

Хэш изображения.

Для графических объявлений подходят только изображения с типом FIXED_IMAGE, см. Тип изображения.

Структура MobileAppImageAdGet
TrackingUrlstring, nillableТрекинговая ссылка для отслеживания установок приложения.
AdImageHashstring

Хэш изображения.

Для графических объявлений подходят только изображения с типом FIXED_IMAGE, см. Тип изображения.

Структура TextAdBuilderAdGet
CreativeAdBuilderAdGetItem

Креатив, созданный в конструкторе креативов.

См. раздел Конструктор креативов для графических объявлений помощи Директа.

Hrefstring

Ссылка на сайт рекламодателя. Не более 1024 символов. В случае использования шаблона символы # не учитываются в длине.

Должна содержать протокол и доменное имя. Может содержать подстановочные переменные.

Структура MobileAppAdBuilderAdGet
CreativeAdBuilderAdGetItem

Креатив, созданный в конструкторе креативов.

См. раздел Конструктор креативов для графических объявлений помощи Директа.

TrackingUrlstring, nillableТрекинговая ссылка для отслеживания установок приложения.
Структура CpcVideoAdBuilderAdGet
CreativeAdBuilderAdGetItem

Креатив, созданный в конструкторе креативов.

См. раздел Конструктор креативов для видеодополнений помощи Директа.

Hrefstring

Ссылка на сайт рекламодателя. Не более 1024 символов. В случае использования шаблона символы # не учитываются в длине.

Должна содержать протокол и доменное имя. Может содержать подстановочные переменные.

Структура CpmBannerAdBuilderAdGet
CreativeAdBuilderAdGetItem

Креатив, загруженный в веб-интерфейсе или созданный в конструкторе креативов.

См. раздел Создание медийной кампании помощи Директа.

Hrefstring

Ссылка на сайт рекламодателя. Не более 1024 символов. В случае использования шаблона символы # не учитываются в длине.

Должна содержать протокол и доменное имя. Может содержать подстановочные переменные.

TrackingPixelsarray of TrackingPixelGetItemПиксель Яндекс.Аудиторий и/или счетчик показов ADFOX, TNS или Gemius.
Структура AdBuilderAdGetItem
CreativeIdlongИдентификатор креатива.
ThumbnailUrlstringСсылка на миниатюру для предварительного просмотра.
PreviewUrlstringСсылка на изображение для предварительного просмотра.
Структура TrackingPixelGetItem
TrackingPixelstringСсылка на пиксель Яндекс.Аудиторий или счетчик показов ADFOX, TNS или Gemius.
ProviderstringПровайдер пикселя или счетчика показов.