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

Herramientas de Microsoft Advertising

Campañas de búsqueda de Bing, palabras clave, segmentación, etiquetas UET, objetivos de conversión e informes.

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 lectura16 herramientas

list_microsoft_accounts

Lectura1 créditos

Cuentas de anuncios de Microsoft Advertising a las que puede acceder el usuario conectado (id, nombre, número, customer_id, moneda, estado) y cuál está seleccionada. Úsalo en configuraciones de administrador/agencia antes de escribir. Requiere una cuenta de Microsoft Advertising conectada; de lo contrario devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
all_accessibleOpcionalbooleandefault true; false returns only the selected account

list_microsoft_ad_groups

Lectura1 créditos

Grupos de anuncios de una campaña de Microsoft Advertising (id, nombre, estado, puja CPC predeterminada). Usa los ids para palabras clave, anuncios y segmentación a nivel de grupo de anuncios. Requiere una cuenta de Microsoft Advertising conectada; de lo contrario devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
campaign_idObligatoriostring—
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

list_microsoft_audiences

Lectura1 créditos

Audiencias de la cuenta de Microsoft Advertising (listas de remarketing, en el mercado, personalizadas) con tamaños y etiqueta UET. Requiere una cuenta de Microsoft Advertising conectada; de lo contrario devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

list_microsoft_conversion_goals

Lectura1 créditos

Objetivos de conversión de la cuenta de Microsoft Advertising con tipo, estado, estado de seguimiento, categoría y ajustes de ingresos. Requiere una cuenta de Microsoft Advertising conectada; de lo contrario devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

list_microsoft_uet_tags

Lectura1 créditos

Etiquetas UET (Universal Event Tracking) de la cuenta de Microsoft Advertising con estado de seguimiento y script. Requiere una cuenta de Microsoft Advertising conectada; de lo contrario devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

microsoft_search_terms_report

Lectura2 créditos

Términos de búsqueda de Microsoft Advertising (consultas que activaron anuncios) con gasto, clics, conversiones, palabra clave y tipo de concordancia de los últimos N días, más los términos desperdiciados (sin conversiones). Requiere una cuenta de Microsoft Advertising conectada; de lo contrario devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
daysOpcionalinteger (1–90)—
campaign_idOpcionalstring—
start_dateOpcionalstringYYYY-MM-DD (overrides days)
end_dateOpcionalstringYYYY-MM-DD, default today
min_wasteOpcionalnumberonly count zero-conversion terms spending at least this much as wasted
limitOpcionalinteger (1–500)—
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

microsoft_performance_report

Lectura2 créditos

Rendimiento de Microsoft Advertising por campaña, grupo de anuncios o dispositivo (gasto, clics, impresiones, conversiones, ingresos, CTR, CPC, CPA, ROAS) con totales; compare_previous añade el período anterior. Requiere una cuenta de Microsoft Advertising conectada; de lo contrario devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
daysOpcionalinteger (1–365)—
start_dateOpcionalstringYYYY-MM-DD (overrides days)
end_dateOpcionalstringYYYY-MM-DD, default today
breakdownOpcionalcampaign | ad_group | device—
campaign_idOpcionalstring—
compare_previousOpcionalbooleandevuelve también el período anterior de la misma duración
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

list_microsoft_campaigns

Lectura1 créditos

Campañas leídas en directo de la cuenta de Microsoft Advertising (id, nombre, estado, tipo, presupuesto diario, pujas). raw_status es el estado propio de Microsoft (Active, Paused, BudgetPaused, BudgetAndManualPaused, Suspended); bidding_settings incluye el CPA objetivo / ROAS objetivo / CPC máximo de la estrategia cuando Microsoft los devuelve; además budget_type y shared_budget_id. Requiere una cuenta de Microsoft Advertising conectada; de lo contrario devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
statusOpcionalstringfiltro opcional: live | paused | ended (o estado de Microsoft)
account_idOpcionalstringopcional: ejecuta solo esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (customer) de account_id

diagnose_microsoft_delivery

Lectura2 créditos

Diagnóstico de entrega EN VIVO de una campaña de Microsoft Advertising. Llámala primero cuando el usuario informe de que la campaña no se entrega, está en pausa por presupuesto, suspendida, limitada o rechazada. Lee el estado de la cuenta, la campaña (estado, presupuesto, estrategia de puja con CPA objetivo / ROAS objetivo / CPC máximo), sus grupos de anuncios (estado, fechas, pujas) y anuncios (estado editorial con los códigos de motivo editorial de Microsoft y el estado de apelación), el historial de cambios de los últimos 14 días y las oportunidades de presupuesto y recomendaciones de Microsoft; devuelve una lista de hallazgos (ámbito, código de Microsoft, categoría, evidencia) y cannot_read con lo que no se pudo leer. Solo lectura. Requiere una cuenta de Microsoft Advertising conectada; de lo contrario devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Microsoft (list_microsoft_campaigns) o id de campaña de Tecrübe
account_idOpcionalstringopcional: ejecuta solo esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (customer) de account_id

list_microsoft_ads

Lectura1 créditos

Anuncios de un grupo de anuncios de Microsoft Advertising con tipo, estado, estado editorial, títulos, descripciones y URL de destino. Usa los id en update_microsoft_ad_status / update_microsoft_responsive_search_ad. Requiere una cuenta de Microsoft Advertising conectada; de lo contrario devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
ad_group_idObligatoriostring—
account_idOpcionalstringopcional: ejecuta solo esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (customer) de account_id

list_microsoft_keywords

Lectura1 créditos

Palabras clave de un grupo de anuncios de Microsoft Advertising (id, texto, tipo de concordancia, estado, estado editorial, puja). Requiere una cuenta de Microsoft Advertising conectada; de lo contrario devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
ad_group_idObligatoriostring—
account_idOpcionalstringopcional: ejecuta solo esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (customer) de account_id

list_microsoft_negative_keywords

Lectura1 créditos

Palabras clave negativas definidas actualmente en una campaña o grupo de anuncios de Microsoft Advertising: compruébalas aquí cuando baje el tráfico o antes de quitar alguna. Requiere una cuenta de Microsoft Advertising conectada; de lo contrario devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
campaign_idOpcionalstring—
ad_group_idOpcionalstringnivel de grupo de anuncios; también se necesita campaign_id
entity_idOpcionalstringalias: id de campaña o de grupo de anuncios, junto con entity_type
entity_typeOpcionalCampaign | AdGroup—
account_idOpcionalstringopcional: ejecuta solo esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (customer) de account_id

list_microsoft_ad_extensions

Lectura1 créditos

Extensiones de enlaces de sitio y de texto destacado vinculadas a campañas de Microsoft Advertising (id, texto, URL, estado, estado editorial). Revísalas antes de añadir para evitar duplicados; los id alimentan remove_microsoft_ad_extensions. Requiere una cuenta de Microsoft Advertising conectada; de lo contrario devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
campaign_idOpcionalstringopcional; por defecto todas las campañas de la cuenta
account_idOpcionalstringopcional: ejecuta solo esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (customer) de account_id

microsoft_entity_performance_report

Lectura2 créditos

Rendimiento de Microsoft Advertising por debajo del nivel de campaña — por grupo de anuncios, anuncio, palabra clave (con nivel de calidad), ubicación, dispositivo o edad/género — con gasto, clics, conversiones, ingresos, CTR, CPC, CPA, ROAS y totales. Requiere una cuenta de Microsoft Advertising conectada; si no, devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
levelOpcionalad_group | ad | keyword | location | device | age_gender—
daysOpcionalinteger (1–365)—
start_dateOpcionalstringYYYY-MM-DD (anula days)
end_dateOpcionalstringYYYY-MM-DD, por defecto hoy
campaign_idOpcionalstring—
limitOpcionalinteger (1–500)—
account_idOpcionalstringopcional: ejecutar solo en esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (cliente) de account_id

microsoft_report_query

Lectura2 créditos

Lectura libre de la Microsoft Advertising Reporting API (v13): cualquier tipo de informe con las columnas que elijas; las filas llegan tal como las devuelve Microsoft. Úsala cuando los informes fijos no tengan el corte que necesitas. Requiere una cuenta de Microsoft Advertising conectada; si no, devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
report_typeObligatoriostringinforme de Reporting v13, p. ej. KeywordPerformanceReport, AdPerformanceReport, GeographicPerformanceReport
columnsObligatorioarray<string>nombres de columna de ese informe, p. ej. CampaignName, Clicks, Spend
aggregationOpcionalSummary | Hourly | Daily | Weekly | Monthly | Yearly | HourOfDay | DayOfWeek | WeeklyStartingMonday—
daysOpcionalinteger (1–365)—
start_dateOpcionalstringYYYY-MM-DD (anula days)
end_dateOpcionalstringYYYY-MM-DD, por defecto hoy
limitOpcionalinteger (1–2000)—
account_idOpcionalstringopcional: ejecutar solo en esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (cliente) de account_id

Herramientas de escritura27 herramientas

select_microsoft_account

Escritura1 créditos

Elige qué cuenta de anuncios de Microsoft Advertising usarán todas las lecturas y escrituras posteriores (configuraciones de administrador/agencia). Ajuste local; no se cambia nada en Microsoft.

ParámetroTipoDescripción
account_idObligatoriostring—

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

create_microsoft_campaign

Escritura2 créditos

Crea un BORRADOR de campaña de búsqueda de Microsoft Advertising con sus grupos de anuncios, palabras clave y textos de anuncios de búsqueda responsivos de una sola vez (p. ej., replicar una estructura de Google Ads). Toda la estructura se muestra como vista previa; tras la aprobación se crea EN PAUSA en Microsoft. Actívala con update_microsoft_campaign_status(resume). Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
nameObligatoriostring—
daily_budgetObligatorionumberpresupuesto diario en la moneda de la cuenta
kindOpcionalstringsearch (predeterminado) | local_search | sales | traffic
goalOpcionalstring—
languageOpcionalstringidioma de los anuncios, p. ej. Turkish, English (predeterminado Turkish)
campaign_typeOpcionalSearchonly Search is supported
bid_strategyOpcionalmanual_cpc | enhanced_cpc | max_clicks | max_conversions | target_cpa | max_conversion_value | target_roas | target_impression_share—
target_cpaOpcionalnumber—
target_roasOpcionalnumber—
max_cpcOpcionalnumber—
final_urlOpcionalstringpágina de destino de los anuncios; por defecto, el sitio web de la marca
ad_groupsOpcionalarray<object>—
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

create_microsoft_ad_group

Escritura2 créditos

Añade un grupo de anuncios a una campaña existente de Microsoft Advertising, opcionalmente con palabras clave y un anuncio de búsqueda responsivo (títulos + descripciones + final_url). Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
campaign_idObligatoriostring—
nameObligatoriostring—
cpc_bidOpcionalnumber—
keywordsOpcionalarray<any>—
headlinesOpcionalarray<string>—
descriptionsOpcionalarray<string>—
final_urlOpcionalstring—
path1Opcionalstring—
path2Opcionalstring—
languageOpcionalstring—
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

add_microsoft_keywords

Escritura2 créditos

Añade palabras clave (texto, tipo de concordancia BROAD|PHRASE|EXACT, puja opcional) a un grupo de anuncios de Microsoft Advertising. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
ad_group_idObligatoriostring—
campaign_idOpcionalstring—
keywordsObligatorioarray<any>—
match_typeOpcionalBROAD | PHRASE | EXACTdefault for plain-text keywords (PHRASE)
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

add_microsoft_negative_keywords

Escritura2 créditos

Añade palabras clave negativas a una campaña (o grupo de anuncios) de Microsoft Advertising. Microsoft admite negativas PHRASE y EXACT. Continuación habitual de microsoft_search_terms_report. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
campaign_idOpcionalstring—
ad_group_idOpcionalstringopcional: negativas a nivel de grupo de anuncios
keywordsObligatorioarray<string>—
match_typeOpcionalPHRASE | EXACT—
entity_idOpcionalstringalias: campaign or ad group id, with entity_type
entity_typeOpcionalCampaign | AdGroup—
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

create_microsoft_responsive_search_ad

Escritura2 créditos

Crea un anuncio de búsqueda responsivo (3-15 títulos ≤30 caracteres, 2-4 descripciones ≤90 caracteres, URL de destino) en un grupo de anuncios de Microsoft Advertising. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
ad_group_idObligatoriostring—
headlinesObligatorioarray<string>—
descriptionsObligatorioarray<string>—
final_urlObligatoriostring—
path1Opcionalstring—
path2Opcionalstring—
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

update_microsoft_campaign_budget

Escritura2 créditos

Cambia el presupuesto diario de una campaña de Microsoft Advertising. La vista previa muestra anterior → nuevo. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
campaign_idObligatoriostring—
amountOpcionalnumbernuevo presupuesto diario en la moneda de la cuenta
daily_budgetOpcionalnumberalias of amount
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

update_microsoft_campaign_status

Escritura2 créditos

Pausa o reanuda una campaña de Microsoft Advertising (reanudar también publica una campaña creada en pausa). Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
campaign_idObligatoriostring—
statusObligatoriopause | resume | paused | active—
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

update_microsoft_ad_group_status

Escritura2 créditos

Pausa o activa un grupo de anuncios de Microsoft Advertising. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
campaign_idObligatoriostring—
ad_group_idObligatoriostring—
statusObligatoriopause | resume—
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

update_microsoft_keyword

Escritura2 créditos

Modifica una palabra clave de Microsoft Advertising: puja, pausar/reanudar, tipo de concordancia (el texto de la palabra clave no puede cambiar). Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
ad_group_idObligatoriostring—
keyword_idObligatoriostring—
bidOpcionalnumber—
statusOpcionalpause | resume—
match_typeOpcionalBROAD | PHRASE | EXACT—
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

set_microsoft_bid_strategy

Escritura2 créditos

Define la estrategia de puja de una campaña de Microsoft Advertising: CPC manual/mejorado, maximizar clics/conversiones (CPA objetivo opcional), maximizar el valor de conversión (ROAS objetivo opcional), cuota de impresiones objetivo. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
campaign_idObligatoriostring—
strategyObligatoriomanual_cpc | enhanced_cpc | max_clicks | max_conversions | target_cpa | max_conversion_value | target_roas | target_impression_share—
target_cpaOpcionalnumber—
target_roasOpcionalnumberp. ej. 4.0 para 400 %
max_cpcOpcionalnumber—
target_impression_shareOpcionalnumber—
target_ad_positionOpcionalAbsoluteTopOfPage | TopOfPage | MainLine1—
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

add_microsoft_location_target

Escritura2 créditos

Segmenta (o excluye) ubicaciones en una campaña o grupo de anuncios de Microsoft Advertising. Los nombres se resuelven a ids de ubicación de Microsoft a partir del archivo geográfico oficial cuando la cuenta está conectada. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe o id de campaña de Microsoft (nivel de campaña)
ad_group_idOpcionalstringid de grupo de anuncios de Microsoft (el nivel de grupo de anuncios prevalece sobre el de campaña)
locationsOpcionalarray<string>nombres de ciudad/región/país, p. ej. İstanbul, Ankara
location_idsOpcionalarray<string>ids de ubicación de Microsoft si ya se conocen
countryOpcionalstringpista de desambiguación, predeterminado Türkiye
bid_adjustmentOpcionalnumberporcentaje -100..900
bid_multiplierOpcionalnumberalias of bid_adjustment
excludeOpcionalboolean—
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

add_microsoft_device_target

Escritura2 créditos

Define ajustes de puja por dispositivo (porcentaje -100..900; -100 excluye) en una campaña o grupo de anuncios de Microsoft Advertising. Microsoft exige los tres dispositivos; los que falten se envían como 0. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe o id de campaña de Microsoft (nivel de campaña)
ad_group_idOpcionalstringid de grupo de anuncios de Microsoft (el nivel de grupo de anuncios prevalece sobre el de campaña)
computersOpcionalnumber—
smartphonesOpcionalnumber—
tabletsOpcionalnumber—
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

add_microsoft_demographic_target

Escritura2 créditos

Define ajustes de puja por edad y género (porcentaje -100..900) en una campaña o grupo de anuncios de Microsoft Advertising. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe o id de campaña de Microsoft (nivel de campaña)
ad_group_idOpcionalstringid de grupo de anuncios de Microsoft (el nivel de grupo de anuncios prevalece sobre el de campaña)
agesOpcionalarray<object>—
gendersOpcionalarray<object>—
criterion_typeOpcionalage | gendersingle-criterion form
valueOpcionalstringsingle-criterion form: age range (e.g. 25-34) or gender
bid_multiplierOpcionalnumbersingle-criterion form: percent -100..900
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

add_microsoft_ad_schedule

Escritura2 créditos

Añade una programación de anuncios (franjas de día/hora con ajuste de puja) a una campaña o grupo de anuncios de Microsoft Advertising; los anuncios no se muestran fuera de las franjas. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe o id de campaña de Microsoft (nivel de campaña)
ad_group_idOpcionalstringid de grupo de anuncios de Microsoft (el nivel de grupo de anuncios prevalece sobre el de campaña)
scheduleOpcionalarray<object>—
daysOpcionalanyshort form (instead of schedule): weekdays | weekend | all or a list of day names
from_hourOpcionalinteger—
to_hourOpcionalinteger—
bid_adjustmentOpcionalnumber—
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

create_microsoft_remarketing_list

Escritura2 créditos

Crea una lista de remarketing (regla de visitantes de páginas sobre la etiqueta UET) en la cuenta de Microsoft Advertising. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
nameObligatoriostring—
descriptionOpcionalstring—
url_containsObligatoriostringvisitantes de páginas cuya URL coincida
operatorOpcionalContains | Equals | BeginsWith | EndsWith | DoesNotContain—
membership_durationOpcionalintegerdías 1-180, predeterminado 30
tag_idOpcionalstringid de etiqueta UET; por defecto, la primera etiqueta
uet_tag_idOpcionalstringalias of tag_id
valueOpcionalstringAlias of url_contains
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

create_microsoft_conversion_goal

Escritura2 créditos

Crea un objetivo de conversión (objetivo de URL: página de agradecimiento; objetivo de evento: evento UET personalizado) en la cuenta de Microsoft Advertising. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
nameObligatoriostring—
goal_typeOpcionalurl | event—
categoryOpcionalPurchase | Signup | Contact | SubmitLeadForm | RequestQuote | BookAppointment | AddToCart | BeginCheckout | Subscribe | PageView | OutboundClick | GetDirections | Other—
url_expressionOpcionalstring—
url_operatorOpcionalContains | Equals | BeginsWith | RegularExpression—
actionOpcionalstring—
category_expressionOpcionalstring—
labelOpcionalstring—
valueOpcionalnumber—
action_operatorOpcionalstringevent goals: Equals | BeginsWith | Contains | RegularExpression
category_expression_operatorOpcionalstringevent goals: Equals | BeginsWith | Contains | RegularExpression
label_operatorOpcionalstringevent goals: Equals | BeginsWith | Contains | RegularExpression
value_operatorOpcionalstringevent goals: Equals | GreaterThan | LessThan
count_typeOpcionalall | unique—
conversion_window_daysOpcionalnumber—
revenue_valueOpcionalnumber—
revenue_typeOpcionalfixed | variable—
currencyOpcionalstring—
tag_idOpcionalstring—
uet_tag_idOpcionalstringalias of tag_id
operatorOpcionalstringalias of url_operator
goal_categoryOpcionalstringalias of category
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

create_microsoft_uet_tag

Escritura2 créditos

Crea una etiqueta UET; el resultado incluye el script de seguimiento que hay que añadir al sitio web. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
nameObligatoriostring—
descriptionOpcionalstring—
account_idOpcionalstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idOpcionalstringoptional: manager account (customer) id of account_id

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

delete_microsoft_campaign

EscrituraIrreversible2 créditos

Elimina PERMANENTEMENTE una campaña de Microsoft Advertising (no se puede deshacer; si no estás seguro, mejor pausa). Siempre espera la aprobación explícita del usuario, sea cual sea la política de aprobación. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (si no, simulación).

ParámetroTipoDescripción
campaign_idObligatoriostring—
account_idOpcionalstringopcional: ejecuta solo esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (customer) de account_id

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

delete_microsoft_audience

EscrituraIrreversible2 créditos

Elimina PERMANENTEMENTE una audiencia de Microsoft Advertising (p. ej. una lista de remarketing). Siempre espera la aprobación explícita del usuario. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (si no, simulación).

ParámetroTipoDescripción
audience_idObligatoriostring—
account_idOpcionalstringopcional: ejecuta solo esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (customer) de account_id

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

update_microsoft_ad_status

Escritura2 créditos

Pausa o activa un único anuncio de Microsoft Advertising. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
ad_group_idObligatoriostring—
ad_idObligatoriostring—
statusObligatoriopause | resume | paused | active—
ad_typeOpcionalResponsiveSearch | ExpandedText | Text | DynamicSearch | ResponsiveAd | Image | Product | AppInstall | Hotelpor defecto ResponsiveSearch (ver list_microsoft_ads)
account_idOpcionalstringopcional: ejecutar solo en esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (cliente) de account_id

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

update_microsoft_responsive_search_ad

Escritura2 créditos

Cambia en el sitio el texto de un anuncio de búsqueda adaptable de Microsoft Advertising existente (conserva el id del anuncio y su historial de rendimiento, a diferencia de rehacerlo). Las listas indicadas sustituyen a las actuales. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
ad_group_idObligatoriostring—
ad_idObligatoriostring—
headlinesOpcionalarray<string>conjunto nuevo completo, 3-15, ≤30 caracteres
descriptionsOpcionalarray<string>conjunto nuevo completo, 2-4, ≤90 caracteres
final_urlOpcionalstring—
path1Opcionalstring—
path2Opcionalstring—
account_idOpcionalstringopcional: ejecutar solo en esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (cliente) de account_id

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

update_microsoft_ad_group

Escritura2 créditos

Edita un grupo de anuncios de Microsoft Advertising: nombre, puja de CPC predeterminada, fecha de inicio/fin, estado, red de búsqueda. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
campaign_idObligatoriostring—
ad_group_idObligatoriostring—
nameOpcionalstring—
cpc_bidOpcionalnumber—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
statusOpcionalpause | resume | paused | active—
networkOpcionalall | microsoft_only | syndicated_only—
account_idOpcionalstringopcional: ejecutar solo en esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (cliente) de account_id

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

add_microsoft_ad_extensions

Escritura2 créditos

Añade extensiones de enlaces de sitio y/o de texto destacado a una campaña de Microsoft Advertising (se crean en la biblioteca de la cuenta y luego se vinculan a la campaña). Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (si no, simulación).

ParámetroTipoDescripción
campaign_idObligatoriostring—
sitelinksOpcionalarray<object>—
calloutsOpcionalarray<string>—
account_idOpcionalstringopcional: ejecuta solo esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (customer) de account_id

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

remove_microsoft_ad_extensions

EscrituraIrreversible2 créditos

Elimina extensiones de enlace de sitio/texto destacado: las desvincula de la campaña y las borra de la biblioteca de la cuenta (permanente; desaparecen de todas las campañas). Siempre espera la aprobación explícita del usuario. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
extension_idsObligatorioarray<string>—
campaign_idOpcionalstringdesvincular primero de esta campaña (opcional)
account_idOpcionalstringopcional: ejecutar solo en esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (cliente) de account_id

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

remove_microsoft_negative_keywords

EscrituraIrreversible2 créditos

Quita palabras clave negativas (por texto, opcionalmente con un tipo de concordancia) de una campaña o grupo de anuncios de Microsoft Advertising — p. ej. para deshacer una negativa que bloquea tráfico bueno. Solo se quitan las negativas que existen realmente. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
campaign_idOpcionalstring—
ad_group_idOpcionalstringnivel de grupo de anuncios; también se necesita campaign_id
keywordsObligatorioarray<string>—
match_typeOpcionalPHRASE | EXACT—
entity_idOpcionalstringalias: id de campaña o de grupo de anuncios, con entity_type
entity_typeOpcionalCampaign | AdGroup—
account_idOpcionalstringopcional: ejecutar solo en esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (cliente) de account_id

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

upload_microsoft_offline_conversions

Escritura2 créditos

Envía conversiones offline (p. ej. ventas del CRM) a Microsoft Advertising por id de clic, para que las pujas aprendan de resultados reales. Hasta 1000 filas por llamada; el objetivo debe existir y los clics deben tener menos de 90 días. Crea un elemento de aprobación con vista previa; se aplica en Microsoft solo tras la aprobación y solo con una cuenta conectada (simulación en caso contrario).

ParámetroTipoDescripción
conversion_nameObligatoriostringnombre de un objetivo de conversión offline de la cuenta
conversionsObligatorioarray<object>—
currencyOpcionalstringmoneda predeterminada para las filas sin moneda
account_idOpcionalstringopcional: ejecutar solo en esta llamada en esta cuenta publicitaria de Microsoft (configuraciones de agencia)
customer_idOpcionalstringopcional: id de la cuenta de administrador (cliente) de account_id

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