Value Optimization Meta: что кладётся в value и currency

Два поля решают, как value optimization Meta отработает на вашем аккаунте: value и currency внутри custom_data события. Meta документирует их требования прямо - и требования строже, чем многие предполагают. Разбираем, что кладётся в каждое поле, правила формата, держащие их пригодными, частые ошибки, тихо обнуляющие value-based оптимизацию, и то, как выплата арбитражника ложится в документированную структуру.

Слой доставки вокруг этих полей - токены, постбеки и хоп в Conversions API - собран в гайде от постбека сети до CAPI; здесь - сами два поля.

Документированные требования

Документация custom-data проговаривает контракт прямо: value «требуется для purchase-событий или любых событий, использующих value optimization», и она «должна представлять денежную сумму». Сопутствующее поле currency также требуется для purchase-событий и «должно быть валидным трёхбуквенным кодом ISO 4217» (параметры custom data).

В payload пара живёт внутри custom_data:

{
  "custom_data": {
    "currency": "USD",
    "value": 42.50
  }
}

Из документации следуют три свойства. Сумма - число, а не строка с символами. Валюта - код, а не символ или название. И пара едет вместе - value без валюты в лучшем случае двусмысленна, в худшем непригодна для value-оптимизации.

Что читает оптимизация

Value-based стратегии бидят в ожидаемую выручку; их сырьё - поле value полученных событий, оцениваемое через сигналы качества площадки. Следствия, которые стоит написать на стене:

1. Purchase-события без value всё ещё считаются конверсиями - но не несут ничего для работы value-based биддинга. Событие стреляет; денежный сигнал - нет.
2. Кривое value обучает криво. Усреднённое или заглушенное значение учит оптимизатор фантазии - тот же аргумент, что в гайде о передаче выплаты, где реальная выплата на конверсию и есть число для этого поля.
3. Валютные несовпадения искажают молча. Сумма в евро с меткой USD не проваливает ничего - она просто неверно оценивает каждое оптимизационное решение, построенное на ней.

Арбитражный маппинг механичен при правильно собранной цепочке: постбек сети несёт выплату, трекер её хранит, слой доставки пересылает как value с currency - документированная пара из гайда о выплате.

Ошибки, обнуляющие оптимизацию

1. Value как строка с украшениями. "$42.50" - не числовая денежная сумма; 42.50 - именно она.
2. Валюта текстом. "dollars" или "$" проваливают требование ISO 4217 - документированная форма: "USD".
3. Нулевые value, оставленные на месте. Purchase с "value": 0 репортит конверсию, не стоящую ничего; если выплата реально нулевая, меняться должен тип события, а не значение.
4. Смешанные валюты в одном кабинете. Сумма в 42 евро с меткой USD портит каждый расчёт ROAS ниже по течению (гайд о сверке разводит проблемы счёта и проблемы валют).

Все четыре ловит один тест: одна реальная конверсия через цепочку, затем инспекция полей события в тестовом инструменте площадки (руководстве Get Started Conversions API).

Value Optimization Meta: частые вопросы

Источники