Saltar al contenido
Tecrübetecrube.com
Herramientas del asistente · Configuración y campañas

Herramientas de Reddit Ads

Cuentas publicitarias, campañas, grupos de anuncios e informes de rendimiento de Reddit; los cambios de estado y presupuesto pasan por vista previa y aprobación y se pueden deshacer.

Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son la traducción del texto que ve el asistente, los nombres de herramientas y parámetros no cambian.

Herramientas de lectura11 herramientas

list_reddit_ad_accounts

Lectura1 créditos

Cuentas de Reddit Ads accesibles con el inicio de sesión de Reddit conectado: account_id, nombre, moneda, estado de aprobación y cuál está seleccionada. Solo lectura; connected=false si Reddit no está conectado.

Esta herramienta no recibe parámetros.

list_reddit_campaigns

Lectura1 créditos

Campañas de Reddit Ads de la cuenta: id, nombre, estado, objetivo, dónde está el presupuesto (campaña o grupo de anuncios), presupuesto diario o total, además de gasto, impresiones, clics y conversiones de los últimos N días (UTC, moneda de la cuenta). Solo lectura; nunca inventa cifras.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
daysOpcionalinteger (1–730)últimos N días; por defecto 30
statusOpcionalactive | paused | archived—

list_reddit_ad_groups

Lectura1 créditos

Grupos de anuncios de Reddit Ads de la cuenta: id, nombre, campaña, estado, presupuesto diario o total y puja. Sirve para encontrar el grupo de anuncios cuyo presupuesto se va a cambiar. Solo lectura.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
campaign_idOpcionalstringsolo los grupos de anuncios de esta campaña

reddit_performance_report

Lectura1 créditos

Informe de entrega de Reddit Ads por cuenta, campaña o grupo de anuncios: gasto (moneda de la cuenta), impresiones, clics, conversiones clave, CTR y CPC con totales, opcionalmente por día. Las fechas están en UTC; los datos llegan a 24 meses atrás. Solo lectura; nunca inventa cifras.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
daysOpcionalinteger (1–730)últimos N días; por defecto 30
levelOpcionalaccount | campaign | ad_group—
campaign_idOpcionalstring—
ad_group_idOpcionalstring—
start_dateOpcionalstringYYYY-MM-DD (UTC); sustituye a days
end_dateOpcionalstringYYYY-MM-DD (UTC)
by_dateOpcionalbooleanuna fila por día

list_reddit_ads

Lectura1 créditos

Anuncios de Reddit Ads de la cuenta: estado, entrega, motivo de rechazo, enlaces de publicación y vista previa. Solo lectura.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
campaign_idOpcionalstring—
ad_group_idOpcionalstring—

reddit_details

Lectura1 créditos

Todos los detalles de un objeto de Reddit Ads: campaña, grupo de anuncios, anuncio, publicación, trabajo de publicación, audiencia, formulario, perfil, catálogo, feed, conjunto de productos, recurso o último disparo del píxel. Solo lectura.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
kindObligatoriocampaign | ad_group | ad | post | structured_post | post_job | custom_audience | saved_audience | lead_gen_form | profile | product_catalog | product_feed | product_set | creative_asset | business | pixel_last_fired | upload—
idObligatoriostring—

list_reddit_assets

Lectura1 créditos

Lista recursos de la cuenta de Reddit Ads por tipo: métodos de pago, píxeles, perfiles, apps, audiencias personalizadas y guardadas, formularios, catálogos, publicaciones, recursos creativos, productos, feeds, conjuntos de productos. Solo lectura.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
kindObligatoriostring—
profile_idOpcionalstring—
catalog_idOpcionalstring—
business_idOpcionalstring—
funding_instrument_idOpcionalstring—

reddit_forecast

Lectura1 créditos

Genera una estimación de audiencia y entrega de Reddit Ads o una sugerencia de puja; no publica nada. Solo lectura.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
kindObligatoriodelivery | bid—
configObligatorioobjectobject as documented by the Reddit Ads API v3

reddit_account_history

Lectura1 créditos

Historial de cambios de la cuenta de Reddit Ads en el periodo: quién cambió qué. Solo lectura.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
daysOpcionalinteger (1–730)last N days; default 30
start_dateOpcionalstring—
end_dateOpcionalstring—

diagnose_reddit_delivery

Lectura1 créditos

Averigua por qué no se entrega una campaña de Reddit Ads: aprobación de la cuenta, método de pago, estados de campaña, grupo y anuncio, motivos de rechazo y piezas faltantes, por urgencia. Solo lectura.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
campaign_idOpcionalstring—

Herramientas de escritura18 herramientas

update_reddit_campaign_status

Escritura2 créditos

Pausa o activa una campaña de Reddit Ads. Se aplica cuando el usuario lo pide, queda en el registro de auditoría y se puede deshacer con undo_action.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
campaign_idObligatoriostring—
statusObligatoriopause | activate—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_reddit_campaign_budget

Escritura2 créditos

Establece el presupuesto diario de una campaña de Reddit Ads que usa optimización del presupuesto de campaña (budget_level=campaign). Las demás campañas tienen el presupuesto en los grupos de anuncios: usa update_reddit_ad_group_budget. Se bloquean los aumentos superiores al 50 % por cambio o 2× en 24 horas; se puede deshacer con undo_action.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
campaign_idObligatoriostring—
daily_budgetObligatorionumbernuevo presupuesto diario en la moneda de la cuenta

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_reddit_ad_group_budget

Escritura2 créditos

Establece el presupuesto diario de un grupo de anuncios de Reddit Ads (campañas sin optimización del presupuesto de campaña). Se bloquean los aumentos superiores al 50 % por cambio o 2× en 24 horas; se puede deshacer con undo_action.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
ad_group_idObligatoriostring—
daily_budgetObligatorionumbernuevo presupuesto diario en la moneda de la cuenta

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_reddit_campaign

Escritura2 créditos

Crea una campaña de Reddit Ads siempre en pausa. Un presupuesto aquí activa la optimización del presupuesto; si no, va en los grupos de anuncios. Deshacer la archiva.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
nameObligatoriostring—
objectiveObligatorioapp_installs | brand_awareness | catalog_sales | clicks | conversions | impressions | lead_generation | sales | video_viewable_impressions—
daily_budgetOpcionalnumbercampaign budget (enables campaign budget optimization), account currency
lifetime_budgetOpcionalnumbercampaign lifetime budget, account currency
funding_instrument_idOpcionalstring—
special_ad_categoriesOpcionalarray<string>—
start_timeOpcionalstringISO 8601 UTC
end_timeOpcionalstringISO 8601 UTC
scheduleOpcionalarray<object>—
bid_strategyOpcionalstring—
bid_typeOpcionalstring—
bid_valueOpcionalnumberaccount currency
optimization_goalOpcionalstring—
spend_capOpcionalnumberaccount currency
app_idOpcionalstring—
view_through_conversion_typeOpcionalstring—
invoice_labelOpcionalstring—
conversion_pixel_idOpcionalstring—
use_catalogOpcionalboolean—
campaign_typeOpcionalstringAUTOMATED for a Reddit Max campaign

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_reddit_campaign

Escritura2 créditos

Actualiza una campaña de Reddit Ads: nombre, calendario, puja, método de pago, límite de gasto o presupuesto total (50 % por paso). El diario usa update_reddit_campaign_budget. Se puede deshacer con undo_action.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
campaign_idObligatoriostring—
nameOpcionalstring—
funding_instrument_idOpcionalstring—
bid_strategyOpcionalstring—
bid_typeOpcionalstring—
bid_valueOpcionalnumber—
spend_capOpcionalnumber—
start_timeOpcionalstringISO 8601 UTC
end_timeOpcionalstringISO 8601 UTC
scheduleOpcionalarray<object>—
invoice_labelOpcionalstring—
objectiveOpcionalstring—
use_catalogOpcionalboolean—
lifetime_budgetOpcionalnumber—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_reddit_ad_group

Escritura2 créditos

Crea un grupo de anuncios de Reddit Ads en pausa con segmentación, presupuesto, puja, calendario y objetivo de optimización. Los id se obtienen con reddit_targeting_search. Deshacer lo archiva.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
nameObligatoriostring—
targetingObligatorioobjectcommunities, geolocations, interests, keywords, custom_audience_ids, devices, gender, languages, platforms, locations and excluded_* lists; ids come from reddit_targeting_search
daily_budgetOpcionalnumberaccount currency; not for campaign-budget campaigns
lifetime_budgetOpcionalnumberaccount currency
bid_strategyOpcionalstring—
bid_typeOpcionalstring—
bid_valueOpcionalnumberaccount currency
optimization_goalOpcionalstring—
start_timeOpcionalstringISO 8601 UTC
end_timeOpcionalstringISO 8601 UTC
scheduleOpcionalarray<object>—
app_idOpcionalstring—
conversion_pixel_idOpcionalstring—
view_through_conversion_typeOpcionalstring—
product_set_idOpcionalstring—
saved_audience_idOpcionalstring—
shopping_targetingOpcionalobjectobject as documented by the Reddit Ads API v3
shopping_typeOpcionalstring—
optimization_strategy_typeOpcionalstring—
campaign_idObligatoriostring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_reddit_ad_group

Escritura2 créditos

Actualiza un grupo de anuncios de Reddit Ads: nombre, segmentación, puja, calendario, píxel, objetivo, audiencia guardada o presupuesto total. El diario usa update_reddit_ad_group_budget. Se puede deshacer con undo_action.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
nameOpcionalstring—
targetingOpcionalobjectcommunities, geolocations, interests, keywords, custom_audience_ids, devices, gender, languages, platforms, locations and excluded_* lists; ids come from reddit_targeting_search
daily_budgetOpcionalnumberaccount currency; not for campaign-budget campaigns
lifetime_budgetOpcionalnumberaccount currency
bid_strategyOpcionalstring—
bid_typeOpcionalstring—
bid_valueOpcionalnumberaccount currency
optimization_goalOpcionalstring—
start_timeOpcionalstringISO 8601 UTC
end_timeOpcionalstringISO 8601 UTC
scheduleOpcionalarray<object>—
app_idOpcionalstring—
conversion_pixel_idOpcionalstring—
view_through_conversion_typeOpcionalstring—
product_set_idOpcionalstring—
saved_audience_idOpcionalstring—
shopping_targetingOpcionalobjectobject as documented by the Reddit Ads API v3
shopping_typeOpcionalstring—
optimization_strategy_typeOpcionalstring—
ad_group_idObligatoriostring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_reddit_ad

Escritura2 créditos

Crea un anuncio de Reddit Ads en pausa desde una publicación (create_reddit_post), un catálogo o recursos de Reddit Max. Los de apps requieren click_url y app_store_id. Deshacer lo archiva.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
nameObligatoriostring—
post_idOpcionalstringt3_ post id from create_reddit_post
profile_idOpcionalstring—
click_urlOpcionalstring—
click_url_query_parametersOpcionalarray<object>—
event_trackersOpcionalarray<object>—
productsOpcionalarray<object>—
shopping_creativeOpcionalobjectobject as documented by the Reddit Ads API v3
asset_identifiersOpcionalarray<object>—
thumbnail_asset_identifiersOpcionalarray<object>—
destinationOpcionalobjectobject as documented by the Reddit Ads API v3
supplementary_textOpcionalstring—
enhancementsOpcionalobjectobject as documented by the Reddit Ads API v3
app_store_idOpcionalstring—
ad_typeOpcionalstringDYNAMIC_CREATIVE_AD_TEMPLATE for Reddit Max
ad_group_idObligatoriostring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_reddit_ad

Escritura2 créditos

Actualiza un anuncio de Reddit Ads: nombre, publicación, URL de clic, parámetros, rastreadores o destino. Se puede deshacer con undo_action.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
nameOpcionalstring—
post_idOpcionalstringt3_ post id from create_reddit_post
profile_idOpcionalstring—
click_urlOpcionalstring—
click_url_query_parametersOpcionalarray<object>—
event_trackersOpcionalarray<object>—
productsOpcionalarray<object>—
shopping_creativeOpcionalobjectobject as documented by the Reddit Ads API v3
asset_identifiersOpcionalarray<object>—
thumbnail_asset_identifiersOpcionalarray<object>—
destinationOpcionalobjectobject as documented by the Reddit Ads API v3
supplementary_textOpcionalstring—
enhancementsOpcionalobjectobject as documented by the Reddit Ads API v3
app_store_idOpcionalstring—
ad_typeOpcionalstringDYNAMIC_CREATIVE_AD_TEMPLATE for Reddit Max
ad_idObligatoriostring—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

reddit_status

EscrituraIrreversible2 créditos

Pausa, activa o archiva una campaña, grupo o anuncio de Reddit Ads. Pausar y activar se pueden deshacer; archivar no, así que confírmalo antes con el usuario.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
levelObligatoriocampaign | ad_group | ad—
idObligatoriostring—
statusObligatoriopause | activate | archive—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_reddit_post

Escritura2 créditos

Crea una publicación publicitaria de Reddit desde URL públicas de imagen o video, o como texto. Se prepara en segundo plano: consúltala con reddit_details(kind=post_job) y usa post_id en create_reddit_ad. No se puede deshacer.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
typeOpcionalimage | video | text—
headlineOpcionalstring—
bodyOpcionalstring—
image_urlOpcionalstring—
video_urlOpcionalstring—
thumbnail_urlOpcionalstring—
destination_urlOpcionalstring—
display_urlOpcionalstring—
call_to_actionOpcionalApply Now | Contact Us | Download | Get a Quote | Get Showtimes | Install | Learn More | Order Now | Play Now | Pre-order Now | See Menu | Shop Now | Sign Up | View More | Watch Now—
supplementary_textOpcionalstring—
allow_commentsOpcionalboolean—
profile_idOpcionalstring—
creativeOpcionalobjectraw creative for CAROUSEL or PROMOTED_POST

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

upload_reddit_creative_assets

Escritura2 créditos

Sube recursos creativos para anuncios de Reddit Max (imágenes, videos, textos, llamadas a la acción) a un perfil. Estado con reddit_details(kind=upload). No se puede deshacer.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
profile_idOpcionalstring—
itemsObligatorioarray<object>—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

manage_reddit_custom_audience

EscrituraIrreversible2 créditos

Crea audiencias personalizadas de Reddit (lista de clientes, retargeting web, interacción), añade o quita usuarios por correo o elimina la audiencia. Los correos se guardan y envían con hash; eliminar no se puede deshacer.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
actionObligatoriocreate_customer_list | create_pixel | create_engagement | add_users | remove_users | delete—
nameOpcionalstring—
audience_idOpcionalstring—
configOpcionalobjectobject as documented by the Reddit Ads API v3
emailsOpcionalarray<string>plain or SHA-256; hashed before storing or sending

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

manage_reddit_saved_audience

Escritura2 créditos

Crea una audiencia guardada de Reddit a partir de la segmentación o la actualiza con saved_audience_id; se usa en grupos de anuncios con saved_audience_id.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
saved_audience_idOpcionalstring—
nameOpcionalstring—
targetingOpcionalobjectobject as documented by the Reddit Ads API v3

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

create_reddit_lead_gen_form

Escritura2 créditos

Crea un formulario de clientes potenciales de Reddit con enlace de privacidad y preguntas. No se puede deshacer.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
nameObligatoriostring—
privacy_linkObligatoriostring—
promptOpcionalstring—
questionsObligatorioarray<object>{type: EMAIL | FIRST_NAME | LAST_NAME | PHONE_NUMBER | POSTAL_CODE | JOB_TITLE | COMPANY | COMPANY_EMAIL, required}

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

send_reddit_conversion_events

Escritura2 créditos

Envía eventos de conversión del servidor a un píxel de Reddit (Conversions API). Pruebas con test_id. El envío no se puede deshacer; el contenido no se guarda.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
pixel_idObligatoriostring—
eventsObligatorioarray<object>{event_at, action_source, type: {tracking_type}, click_id, user, metadata}
test_idOpcionalstringsend as a test

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

manage_reddit_catalog

EscrituraIrreversible2 créditos

Gestiona catálogos, feeds, conjuntos de productos y productos de Reddit: crear, actualizar, eliminar, carga masiva. Eliminar no se puede deshacer. Los feeds con contraseña se añaden en Reddit Ads.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
actionObligatoriocreate_catalog | update_catalog | delete_catalog | create_feed | update_feed | delete_feed | create_set | update_set | delete_set | upsert_products | delete_products—
business_idOpcionalstring—
catalog_idOpcionalstring—
feed_idOpcionalstring—
set_idOpcionalstring—
bodyOpcionalanyfields as documented by the Reddit Ads API v3

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.

update_reddit_account

Escritura2 créditos

Cambia ajustes de la cuenta publicitaria de Reddit: nombre, ventanas de atribución, comunidades y palabras clave excluidas. Se puede deshacer con undo_action.

ParámetroTipoDescripción
account_idOpcionalstringid de la cuenta publicitaria de Reddit; por defecto: la cuenta seleccionada en la conexión
nameOpcionalstring—
attribution_typeOpcionalstring—
app_attribution_typeOpcionalstring—
click_attribution_windowOpcionalinteger—
view_attribution_windowOpcionalinteger—
app_click_attribution_windowOpcionalinteger—
app_view_attribution_windowOpcionalinteger—
excluded_communitiesOpcionalarray<string>—
excluded_keywordsOpcionalarray<string>—

Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.