Por qué son importantes los datos a nivel de artículo

af_order_info es un parámetro de evento que reporta los artículos individuales de un pedido, tanto si el pedido tiene un artículo como varios. Sustituye los campos antiguos af_content y af_content_list por un único formato más completo para el mismo fin. Es compatible con dos formatos de matriz coherentes tanto para pedidos de un solo artículo como de varios artículos, y funciona en cinco redes (Google Ads, DV360, Meta, TikTok, Snapchat y Pinterest) en lugar de requerir una estructura independiente para cada una.

Enviar este nivel de detalle es importante porque estas redes ahora optimizan las campañas usando algo más que el valor total de un pedido. Meta, Google, TikTok, Snapchat y Pinterest admiten algoritmos de optimización que funcionan a nivel de producto y usan datos como el ID del artículo, el precio, la cantidad, la categoría y la marca para mejorar el targeting y las pujas. Cuanto más completo sea el desglose de artículos que envías, más podrán usar estas redes para afinar esas campañas.

Estructura de parámetros

Cada artículo de un pedido puede describirse con hasta 7 campos. AppsFlyer es compatible con dos formas de estructurar estos campos en af_order_info, que se describen a continuación.

Se envía como parte del event_value de tu evento (o de custom_data) y funciona igual tanto si el pedido tiene un artículo como varios, así que puedes estandarizar su uso en lugar de mantener varios formatos de datos de pedidos.

Estos siete campos son:

AppsFlyer es compatible con dos formas de estructurar af_order_info, ambas anidadas en event_value:

• Un campo para todos los artículos (recomendado): cada campo, como sku, revenue y qty, se envía una vez, como una matriz que abarca todos los artículos del pedido. Así, la carga útil es más corta.
• Un objeto por artículo: cada artículo del pedido se envía como su propio objeto, con todos los campos relevantes anidados dentro de él.

El siguiente ejemplo muestra el formato recomendado, con un campo para todos los artículos:

{
  "af_order_info": {
    "sku": ["SKU-001", "SKU-002", "SKU-003"],
    "revenue": [50.00, 75.00, 25.00],
    "qty": [1, 1, 2],
    "content_name": ["Wireless Mouse", "Bluetooth Headphones", "USB-C Cable"],
    "content_type": ["product", "product", "product"],
    "content_category": ["accessories", "audio", "cables"],
    "brand": ["Logitech", "Sony", "Anker"]
  }
}

El siguiente ejemplo muestra el formato alternativo, con un objeto por artículo:

{
  "af_order_info": [
    {
      "sku": "SKU-001",
      "revenue": 50.00,
      "qty": 1,
      "content_name": "Wireless Mouse",
      "content_type": "product",
      "content_category": "accessories",
      "brand": "Logitech"
    },
    {
      "sku": "SKU-002",
      "revenue": 75.00,
      "qty": 1,
      "content_name": "Bluetooth Headphones",
      "content_type": "product",
      "content_category": "audio",
      "brand": "Sony"
    },
    {
      "sku": "SKU-003",
      "revenue": 25.00,
      "qty": 2,
      "content_name": "USB-C Cable",
      "content_type": "product",
      "content_category": "cables",
      "brand": "Anker"
    }
  ]
}

Asignación por red

AppsFlyer lee la matriz af_order_info y la reestructura automáticamente en el formato que espera la API de cada red. La compatibilidad de los campos varía según la red, así que no todos los campos que envías llegan a todas las redes. La siguiente tabla muestra los campos que admite actualmente cada red:

"app_event_data": {
  "items": [
    {"item_id": "SKU-001", "quantity": "1", "price": "50.0"},
    {"item_id": "SKU-002", "quantity": "1", "price": "75.0"},
    {"item_id": "SKU-003", "quantity": "2", "price": "25.0"}
  ]
}

"fb_content": [
  {"id": "SKU-001", "quantity": 1, "item_price": 50.00},
  {"id": "SKU-002", "quantity": 1, "item_price": 75.00},
  {"id": "SKU-003", "quantity": 2, "item_price": 25.00}
]

"properties": {
  "contents": [
    {
      "content_type": "product",
      "content_category": "accessories",
      "content_name": "Wireless Mouse",
      "quantity": 1,
      "brand": "Logitech",
      "content_id": "SKU-001",
      "price": 50.00
    }
  ],
  "currency": "USD",
  "value": 175.00
}

&item_ids=SKU-001,SKU-002,SKU-003&number_items=5&price=50.00,75.00,25.00&brands=Logitech,Sony,Anker&category=accessories,audio,cables

"contents": [
  {"id": "SKU-001", "item_price": "50.00", "quantity": 1},
  {"id": "SKU-002", "item_price": "75.00", "quantity": 1},
  {"id": "SKU-003", "item_price": "25.00", "quantity": 2}
]

Compatibilidad con versiones anteriores

Los formatos existentes también siguen funcionando, incluidos los campos basados en matrices af_content_id, af_quantity y af_price, así como los campos af_content y af_content_list. No necesitas migrar las implementaciones existentes. af_order_info estará disponible a partir de ahora en un único formato más completo. Resulta especialmente útil si quieres pasar detalles de artículos más enriquecidos, como el nombre, la categoría y la marca, que los formatos anteriores no admiten.

Características y limitaciones