For the complete documentation index, see llms.txt. This page is also available as Markdown.

Carga masiva de recursos

Usa la herramienta de cargas masivas para subir varios activos a la vez usando un archivo CSV, en lugar de subir los activos individualmente. Los campos de información son similares a los de objeto Ads para ayudarte a coordinar qué información va en cada lugar.

Necesitarás dos archivos para realizar una carga masiva de anuncios:

  • Un archivo de metadatos del activo (CSV)

  • Archivos creativos (p. ej., imágenes o videos)

1

Paso 1: Prepara el archivo de metadatos del activo

Hay campos obligatorios y valores aceptados para el archivo CSV que subas. Tus activos aparecerán exactamente como en tu archivo, así que cualquier espacio, signo de puntuación o carácter especial estará presente si se usa. Para empezar, copia la plantilla CSV que se muestra a continuación y pégala en una aplicación de hoja de cálculo odescárgala aquí e impórtala directamente.

Operation,AdID,State,Name,Description,ProgramId,AdType,HostedBy,Creative,IabAdUnit,ThirdPartyServableAdCreativeHeight,ThirdPartyServableAdCreativeWidth,Labels,AllowDeepLinking,AllowCustomPromoCode,CustomisationCharge,ImageAlternativeTag,LandingPage,iOSMobileFallbackAppId,AndroidMobileFallbackAppId,Language,LimitedTimeStartDate,LimitedTimeEndDate,FallbackAd,GetHtmlCodeType,Season,TopSeller,LinkText,ThirdPartyImpressionPixel,RestrictedToPartners,RestrictedToGroups,Metadata,DealId,DealName,DealType,DealScope,DealDescription,DealProducts,DealCategories,DealDefaultDiscountCode,DealLandingPage,DealMetadata,DealAllowDeepLinking,DealDiscountType,DealDiscountAmount,DealDiscountPercent,DealDiscountStartPercent,DealDiscountEndPercent,DealDiscountMaximumPercent,DealGift,DealRebate,DealMinimumPurchaseAmount,DealMaximumPurchaseAmount,DealBogoPurchaseLimit,DealBogoBuyQty,DealBogoBuyType,DealBogoBuyName,DealBogoGetQty,DealBogoGetType,DealBogoGetName,DealBogoGetDiscountType,DealBogoGetDiscountAmount,DealBogoGetDiscountPercent,DealSyncAdsPromoCodes

Consejo: Recomendamos usar la formato de archivo detalles disponibles en la Carga masiva pantalla para revisar tus entradas antes de subirlas.

Antes de crear o actualizar activos mediante un archivo de metadatos, ten en cuenta los siguientes puntos importantes sobre las actualizaciones parciales:

  • Se admiten actualizaciones parciales. Si dejas una celda vacía, ese campo se ignorará y su valor existente permanecerá sin cambios.

  • Para borrar o eliminar un valor, introduce explícitamente $CLEAR$ en esa celda. Esto elimina cualquier valor almacenado previamente para ese campo.

Operation,AdID,Name,Description,ProgramId,AdType,HostedBy,Creative,IabAdUnit,ThirdPartyServableAdCreativeHeight,ThirdPartyServableAdCreativeWidth,Labels,AllowDeepLinking,AllowCustomPromoCode,CustomisationCharge,ImageAlternativeTag,LandingPage,iOSMobileFallbackAppId,AndroidMobileFallbackAppId,Language,LimitedTimeStartDate,LimitedTimeEndDate,LimitedTimeZone,FallbackAd,GetHtmlCodeType,Season,TopSeller,LinkText,ThirdPartyImpressionPixel,RestrictedToPartners,RestrictedToGroups,Metadata,DealId,DealName,DealType,DealScope,DealDescription,DealProducts,DealCategories,DealDefaultDiscountCode,DealLandingPage,DealMetadata,DealAllowDeepLinking,DealDiscountType,DealDiscountAmount,DealDiscountPercent,DealDiscountStartPercent,DealDiscountEndPercent,DealDiscountMaximumPercent,DealGift,DealRebate,DealMinimumPurchaseAmount,DealMaximumPurchaseAmount,DealBogoPurchaseLimit,DealBogoBuyQty,DealBogoBuyType,DealBogoBuyName,DealBogoGetQty,DealBogoGetType,DealBogoGetName,DealBogoGetDiscountType,DealBogoGetDiscountAmount,DealBogoGetDiscountPercent,DealSyncAdsPromoCodes
CREATE,,Ejemplo de banner,Este es un ejemplo de un nuevo anuncio de banner que subirías.,12345,BANNER,IR,Banner_Creative1,,,,"Banner, NuevoBanner",TRUE,,,,,,,ENGLISH,2020-07-01T00:00:00-08:00,2038-09-19T03:14:00-08:00,FRAME_ONLY,,,,,"1234567, 8901234",,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,,,,,
UPDATE,123456,Ejemplo de enlace de texto,Este es un ejemplo de actualización de un anuncio de enlace de texto.,34567,TEXT_LINK,,,,,,"Funtext, GoodDay",FALSE,,,,,https://alwayslovewhatyoudo.com,,,ENGLISH_GB,,,,,,,,¡Haz clic aquí para ver más!,,,,,,,,,,,,,,"https://example.com/deal-landing-page","utm_source=impact",TRUE,,,,,,,,,,,,,,,,,,,
  • El CREATE la fila muestra un nuevo activo de banner.

  • El UPDATE la fila demuestra una actualización parcial — solo los campos completados se actualizarán.

  • Si quisieras borrar un valor (por ejemplo, quitar Labels), usarías $CLEAR$ en esa columna.

Ejemplo de borrado de campos (CSV):

UPDATE,123456,Text Link Example,$CLEAR$,$CLEAR$,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
2

Paso 2: Sube el archivo de metadatos del activo

  1. En la barra de navegación izquierda, selecciona [Engage] v2 [Participar]ContenidoAnuncios.

  2. En la esquina superior derecha, seleccione Carga masiva.

  3. Selecciona  Elegir archivo, sube tu archivo masivo y selecciona Abrir.

    • Selecciona  Mostrar/ocultar detalles del formato de archivo para ver información sobre las columnas obligatorias, sus descripciones, valores aceptados y si son obligatorias en las columnas de encabezado del anuncio y columnas de encabezado de la oferta referencias a continuación.

  1. Selecciona Siguiente.

columnas de encabezado del anuncio
Nombre de la columna
Descripción

Operation (String)

Obligatorio: siempre.

Operación que se ejecutará sobre los detalles del activo proporcionados.

Valores permitidos:

CREATE, UPDATE, DELETE.

ProgramId (Integer)

Obligatorio: siempre.

El ID de Program de impact.com único al que pertenece el activo. Este valor no se puede actualizar y debe coincidir con el programa en el que se está ejecutando la carga masiva.

AdID (String)

Obligatorio: al ejecutar la operación sobre un activo existente.

Identificador único de impact.com para el activo. Déjalo vacío al crear un activo nuevo. Obligatorio si Operation = UPDATE, DELETE.

Estado (String)

Obligatorio: no.

El estado del activo.

Valores permitidos:

ACTIVE, PENDING, EXPIRED.

Nombre (String)

Obligatorio: al crear un activo.

Nombre del activo. Obligatorio si Operation = CREATE.

AdType (String)

Obligatorio: al crear un activo.

Al actualizar un anuncio existente, el tipo de anuncio no puede cambiar.

Obligatorio si Operation = CREATE.

Valores permitidos:

IMAGE, TEXT_LINK, COUPON.

HostedBy (String)

Obligatorio: al crear un activo.

Dónde está alojado el creativo del activo. Obligatorio si

Operation = CREATE y AdType = IMAGE.

Valores permitidos:

IR, URL, HTML.

Creative (String)

Obligatorio: al crear un activo de imagen.

Nombre del archivo creativo que se subirá. Obligatorio si

Operation = CREATE y AdType = IMAGE.

IabAdUnit (String)

Obligatorio: al crear un activo de imagen.

Tamaño estándar del activo según IAB. Obligatorio si Operation =

CREATE y AdType = IMAGE y HostedBy != IR.

Valores permitidos: UNKNOWN, MEDIUM_RECTANGLE, SQUARE_POP_UP, VERTICAL_RECTANGLE, LARGE_RECTANGLE, RECTANGLE, RECTANGLE_3_1_, POP_UNDER, FULL_BANNER, HALF_BANNER, MICRO_BANNER, BUTTON_1, BUTTON_2, VERTICAL_BANNER, SQUARE_BUTTON, LEADERBOARD, WIDE_SKYSCRAPER, SKYSCRAPER, HALF_PAGE_AD, CUSTOM.

ThirdPartyServableAdCreativeHeight (Integer)

Obligatorio: al crear un activo de imagen.

Altura de la imagen servible por terceros, en píxeles.

Obligatorio si Operation = CREATE y IabAdUnit =

CUSTOM.

ThirdPartyServableAdCreativeWidth (Integer)

Obligatorio: al crear un activo de imagen.

Ancho de la imagen servible por terceros, en píxeles.

Obligatorio si Operation = CREATE y IabAdUnit =

CUSTOM.

Language (String)

Obligatorio: al crear un activo.

Valores permitidos:

AFRIKAANS, ARABIC, BULGARIAN, CHINESE, CHINESE_TRADITIONAL, CZECH, DANISH, DUTCH, ENGLISH, ENGLISH_GB, ENGLISH_AU, ENGLISH_CA, ENGLISH_NZ, ENGLISH_ZA, ESTONIAN, FILIPINO, FINISH, FRENCH, FRENCH_CA, GERMAN, HEBREW, HINDI, INDONESIAN, ITALIAN, JAPANESE, KOREAN, LATVIAN, LITHUANIAN, MALAY, MALTESE, NORWEGIAN, PORTUGUESE, PORTUGUESE_BR, POLISH, RUSSIAN, SLOVENIAN, SPANISH, SPANISH_MX, SWEDISH, THAI, TURKISH, VIETNAMESE.

LimitedTimeEndDate (Date)

Obligatorio: si se proporciona LimitedTimeStartDate

Esta es una fecha ISO8601. Formato de ejemplo: 2013-06-30T00:00:00-07:00.

LinkText (String)

Obligatorio: al crear un enlace de texto o un activo de cupón.

Texto real que se muestra para el enlace. Obligatorio si Operation = CREATE y AdType = TEXT_LINK o COUPON.

Descripción

Obligatorio: no.

Descripción del activo.

Labels (cadena CSV)

Obligatorio: no.

Etiquetas del activo.

AllowDeepLinking (Booleano)

Obligatorio: no.

Determina si se permitirá enlazar a una página más profunda dentro del sitio del anunciante.

El valor predeterminado es true.

AllowCustomPromoCode (Booleano)

Obligatorio: no.

Permite que el partner solicite su propio código promocional único para esta promoción.

El valor predeterminado es false.

CustomisationCharge (Decimal 10.2)

Obligatorio: no.

Importe del cargo de personalización del activo.

ImageAlternativeTag (String)

Obligatorio: no.

Etiqueta alternativa que se usará en el código del activo de imagen.

LandingPage (String)

Obligatorio: no.

La URL de la página de destino. Debe contener el protocolo de la URL.

Por defecto usa la página de destino predeterminada del programa al crear un activo si no se proporciona.

iOSMobileFallbackAppId (String)

Obligatorio: no.

Especifica si el tráfico móvil debe redirigirse a la página de destino de tu app iOS si no se detecta ninguna app. El ID de la app debe coincidir con el ID del sistema.

AndroidMobileFallbackAppId (String)

Obligatorio: no.

Especifica si el tráfico móvil debe redirigirse a la página de destino de tu app Android si no se detecta ninguna app. El ID de la app debe coincidir con el ID del sistema.

LimitedTimeStartDate (String)

Obligatorio: no.

Esta es una fecha ISO8601. Formato de ejemplo: 2013-06-30T00:00:00-07:00.

FallbackAd (String)

Obligatorio: no.

Especifica un ID de activo de reserva, aplicable solo a IMAGE los activos.

GetHtmlCodeType (String)

Obligatorio: no.

Valores permitidos: IFRAME_ONLY, HTML_AND_IFRAME.

Season (String)

Obligatorio: no.

Valores permitidos:

WINTER, SPRING, SUMMER, FALL, NEW_YEAR, PRESIDENTS_DAY, VALENTINES_DAY, ST_PATRICKS_DAY, EASTER, MOTHERS_DAY, MEMORIAL_DAY, FATHERS_DAY, INDEPENDANCE_DAY, BACK_TO_SCHOOL, LABOR_DAY, HALLOWEEN, THANKSGIVING, BLACK_FRIDAY, CYBER_MONDAY, HANUKKAH, CHRISTMAS, FAMILY_DAY, GOOD_FRIDAY, VICTORIA_DAY, CANADA_DAY, AUGUST_CIVIC_HOLIDAY, REMEMBRANCE_DAY, BOXING_DAY, AUSTRALIA_DAY, ANZAC_DAY, QUEENS_BIRTHDAY, END_OF_FINANCIAL_YEAR, WAITANGI_DAY, OTHER.

TopSeller (Booleano)

Obligatorio: no.

Más vendido. El valor predeterminado es false.

ThirdPartyImpressionPixel (String)

Obligatorio: no.

HTML del píxel de impresión de terceros que se usará con este activo.

RestrictedToPartners (cadena CSV)

Obligatorio: no.

IDs de partner separados por comas que deben tener acceso a este activo.

RestrictedToGroups (cadena CSV)

Obligatorio: no.

IDs de grupo de partner separados por comas que deben tener acceso a este activo.

Metadata (cadena CSV)

Obligatorio: no.

Parámetros de cadena de consulta separados por comas que se añadirán a la URL de seguimiento.

columnas de encabezado de la oferta
Nombre de la columna
Descripción

DealName (String)

Obligatorio: al crear una nueva oferta.

Nombre de la oferta que se creará y vinculará al activo. Obligatorio si DealId no se proporciona.

DealType (String)

Obligatorio: al crear una nueva oferta.

Tipo de oferta que se creará. Obligatorio si DealId no se proporciona y DealName sí.

Valores permitidos:

GENERAL_SALE,FREE_SHIPPING, GIFT_WITH_PURCHASE, REBATE, BOGO, PRODUCT_LAUNCH.

DealScope (String)

Obligatorio: al crear una nueva oferta.

Obligatorio si DealId no se proporciona, DealName sí, y DealType != BOGO.

Valores permitidos:

ENTIRE_STORE, CATEGORY, PRODUCT, PRODUCTS.

DealProducts (cadena CSV)

Obligatorio: al crear una nueva oferta.

Productos de la oferta. Obligatorio si DealId no se proporciona, DealName sí, y DealScope = PRODUCT.

Valores permitidos:

Opción 1: lista de nombres de productos, por ejemplo: "Product1, Product2".

Opción 2: lista de pares clave-valor de productos, por ejemplo: "name=Product1;regularPrice=10;dealPrice=9.50; image=prodimg1.jpg, name=Product2;" donde varios productos se separan por comas y los distintos campos de producto se separan por punto y coma.

Campos válidos: name - nombre del producto, image - nombre de archivo de imagen del producto que tienes intención de subir en el segundo paso de la carga masiva, limit - cantidad permitida, regularPrice - precio antes del descuento, dealPrice - precio después del descuento.

DealCategories (cadena CSV)

Obligatorio: al crear una nueva oferta.

Categorías de la oferta. Obligatorio si DealId no se proporciona, DealName sí, y DealScope = CATEGORY.

DealLandingPage (String) Obligatorio: no

La URL de la página de destino para esta oferta. Si se deja en blanco al crear una nueva oferta, se usará la página de destino predeterminada del programa.

DealMetadata (cadena CSV) Obligatorio: no

Parámetros de cadena de consulta separados por comas para el enlace de seguimiento de la oferta. Si se deja en blanco, no se añadirán parámetros extra.

DealAllowDeepLinking (Booleano) Obligatorio: no

Determina si se permite el deep linking para la página de destino de la oferta. Si se deja en blanco, el valor predeterminado será FALSE.

DealDiscountType (cadena CSV)

Obligatorio: al crear una nueva oferta.

Obligatorio si DealId no se proporciona, DealName sí, y DealType = GENERAL_SALE.

Valores permitidos:

FIXED, PERCENT, PERCENT_RANGE, PERCENT_MAXIMUM.

DealDiscountAmount (Decimal 10.2)

Obligatorio: al crear una nueva oferta.

Importe del descuento de la venta. Obligatorio si DealId no se proporciona, DealName es, DealType = GENERAL_SALE, y DealDiscountType = FIXED.

DealDiscountPercent (Decimal 10.2)

Obligatorio: al crear una nueva oferta.

Porcentaje de descuento de la venta. Obligatorio si DealId no se proporciona, DealName es, DealType = GENERAL_SALE, y DealDiscountType = PERCENT.

DealDiscountStartPercent (Decimal 10.2)

Obligatorio: al crear una nueva oferta.

Porcentaje inicial del rango de descuento de la oferta. Obligatorio si DealId no se proporciona, DealName es, DealType = GENERAL_SALE, y DealDiscountType = PERCENT_RANGE.

DealDiscountEndPercent (Decimal 10.2)

Obligatorio: al crear una nueva oferta.

Porcentaje inicial del rango de descuento de la oferta. Obligatorio si DealId no se proporciona, DealName es, DealType = GENERAL_SALE, y DealDiscountType = PERCENT_RANGE.

DealDiscountMaximumPercent (Decimal 10.2)

Obligatorio: al crear una nueva oferta.

Porcentaje máximo de descuento de la oferta. Obligatorio si DealId no se proporciona, DealName es, DealType = GENERAL_SALE, y DealDiscountType = PERCENT_MAXIMUM.

DealGift (Decimal 10.2)

Obligatorio: al crear una nueva oferta.

Detalles del regalo. Obligatorio si DealId no se proporciona, DealName sí, y DealType = GIFT_WITH_PURCHASE.

DealRebate (Decimal 10.2)

Obligatorio: al crear una nueva oferta.

Importe del reembolso. Obligatorio si DealId no se proporciona, DealName sí, y DealType = REBATE.

DealMinimumPurchaseAmount (Decimal 10.2)

Obligatorio: al crear una nueva oferta.

Importe mínimo de compra de la oferta. Obligatorio si DealId no se proporciona, DealName sí, y DealType = BOGO.

DealMaximumSavingsAmount (Decimal 10.2)

Obligatorio: al crear una nueva oferta.

Importe máximo de ahorro de la oferta. Requerido si DealId no se proporciona, DealName sí, y DealType = BOGO.

DealBogoPurchaseLimit (Integer)

Obligatorio: al crear una nueva oferta.

Cantidad máxima de artículos permitidos a este precio. Requerido si DealId no se proporciona, DealName sí, y DealType = BOGO.

DealBogoBuyQty (Integer)

Obligatorio: al crear una nueva oferta.

Cantidad de compra BOGO. Requerido si DealId no se proporciona, DealName sí, y DealType = BOGO.

DealBogoBuyType (String)

Obligatorio: al crear una nueva oferta.

Tipo de artículo de compra BOGO. Requerido si DealId no se proporciona, DealName sí, y DealType = BOGO.

Valores permitidos:

PRODUCT, CATEGORY.

DealBogoBuyName (String)

Obligatorio: al crear una nueva oferta.

Nombre del producto o categoría de compra. Requerido si DealId no se proporciona, DealName sí, y DealType = BOGO.

DealBogoGetQty (Integer)

Obligatorio: al crear una nueva oferta.

Cantidad de obtención BOGO. Requerido si DealId no se proporciona, DealName sí, y DealType = BOGO.

DealBogoGetType (String)

Obligatorio: al crear una nueva oferta.

Tipo de artículo de obtención BOGO. Requerido si DealId no se proporciona, DealName sí, y DealType = BOGO.

Valores permitidos:

PRODUCT, CATEGORY.

DealBogoGetName (String)

Obligatorio: al crear una nueva oferta.

Nombre del producto o categoría de obtención. Requerido si DealId no se proporciona, DealName sí, y DealType = BOGO.

DealBogoGetDiscountType (String)

Obligatorio: al crear una nueva oferta.

Tipo de descuento de la oferta BOGO. Requerido si DealId no se proporciona, DealName sí, y DealType = BOGO.

Valores permitidos:

GRATIS, IMPORTE, PERCENT.

DealBogoGetDiscountAmount (Decimal 10.2)

Obligatorio: al crear una nueva oferta.

Importe de descuento de la oferta BOGO. Requerido si DealId no se proporciona, DealName es, DealType = BOGO, y DealBogoGetDiscountType = IMPORTE.

DealBogoGetDiscountPercent (Decimal 10.2)

Obligatorio: al crear una nueva oferta.

Porcentaje de descuento de la oferta BOGO. Requerido si DealId no se proporciona, DealName es, DealType = BOGO, y DealBogoGetDiscountType = PERCENT.

DealId (String)

Obligatorio: no.

Identificador único de impact.com para la oferta a la que se vinculará el recurso.

DealDefaultDiscountCode (String)

Obligatorio: no.

Código de descuento predeterminado de la oferta.

DealSyncAdsPromoCodes (Booleano)

Obligatorio: no.

Mantenga sincronizados los anuncios y códigos promocionales asociados con esta oferta. La sincronización se aplica a fechas de tiempo limitado, acceso restringido para socios y estado.

3

Paso 3: Cargue los archivos creativos del activo

A continuación, deberá tener listos los archivos creativos de su activo para poder cargarlos.

  1. En la Especifique imágenes página, seleccione Elegir archivos para cargar en lote los archivos creativos del activo. Los nombres de los archivos cargados deben coincidir exactamente con los nombres del campo creativo de su archivo de metadatos (por ejemplo, si el campo creativo contiene Example.jpg, el archivo creativo del activo que cargue también debe llamarse Example.jpg).

    • Mantenga presionada Command ⌘ en macOS o CTRL en PC para seleccionar varios archivos creativos del activo y cargarlos todos a la vez.

  2. Selecciona Aceptar y crear anuncios. Una vez que todos los activos se hayan cargado, aparecerán en la Anuncios página.

Última actualización

¿Te fue útil?