Detalles de Conexión de Microsoft Advertising

Introducción

Versión del conector

Esta documentación se basa en la versión 21.0.8383 del conector.

Empezando

Compatibilidad con la versión de Bing Ads

El conector modela informes y otras entidades en la API de Bing Ads como vistas relacionales.

Establecer una Conexión

Conexión a Bing Ads

Debe registrar una cuenta de Bing Ads, obtener un token de desarrollador y autenticarse mediante OAuth para conectarse a las APIs de Bing Ads.

Registrar una Cuenta de Anuncios de Bing

Complete los siguientes pasos para registrarse en una cuenta de Bing Ads y obtener el CustomerId y (opcional) AccountId:

1. Regístrese para obtener una cuenta de Bing Ads en la aplicación web de Bing Ads o en el Sitio Sandbox para una cuenta de espacio aislado.
2. Seleccione Settings > Accounts and Billing y seleccione una sola cuenta. El AccountId y CustomerId (cid) se muestran en la página de la cuenta y en la URL de la página.

Obtenga un Token de Desarrollador

Para usar las APIs de Bing Ads, debe tener un DeveloperToken además de CustomerId. Debe tener el rol de superadministrador en Bing Ads para crear un token de desarrollador, aunque no necesita permisos especiales para usar el token.

1. Inicie sesión en el Portal para desarrolladores de Bing Ads como usuario de una cuenta de Microsoft con la rol de superadministrador de Bing Ads.
2. Haga clic en Request Token y toma nota de tu token de desarrollador. Lo establecerás en el DeveloperToken propiedad de conexión.

Autenticar a Través de Autenticación OAuth

Las APIs de Bing Ads utilizan el estándar OAuth 2. Puede conectarse sin configurar ninguna propiedad de conexión para sus credenciales de usuario. Después de configurar lo siguiente, está listo para conectarse:

• InitiateOAuth: Establecer en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
• DeveloperToken: establezca el token que generó en la sección Obtener un token de desarrollador.
• AccountId: establezca el valor de ID de cuenta que se encuentra en la aplicación web de Bing Ads, en Settings > Accounts and Billing > Your Account > Account.
• CustomerId: establezca el valor de ID de cliente que se encuentra en la aplicación web de Bing Ads, en Settings > Accounts and Billing > Your Account > Customer.
• UseSandbox: Ajustado a true para usar una cuenta de espacio aislado de Bing Ads.

Cuando se conecta, el conector abre el extremo de OAuth de Bing Ads en su navegador predeterminado. Inicie sesión y otorgue permisos al conector. Luego, el conector completa el proceso de OAuth.

Consulte Uso de la autenticación OAuth para otros flujos de autenticación OAuth.

Uso de la Autenticación OAuth

OAuth requiere que el usuario que se autentica interactúe con Bing Ads mediante el navegador. El conector facilita esto de varias maneras, como se describe a continuación.

Credenciales Integradas

Consulte Credenciales integradas para conectarse con las credenciales incrustadas del conector y omitir la creación de una aplicación OAuth personalizada. El conector tiene credenciales de OAuth integradas tanto para sandbox como para producción.

Credenciales Personalizadas

En lugar de conectarse con las credenciales integradas del conector, puede registrar una aplicación para obtener OAuthClientId y OAuthClientSecret.

Cuándo Crear una Aplicación OAuth Personalizada

La creación de una aplicación OAuth personalizada es opcional, ya que el conector ya está registrado en Bing Ads y puede conectarse con sus credenciales integradas. Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en el extremo de OAuth de Bing Ads para otorgar permisos al conector.

Creación de una Aplicación OAuth Personalizada

Consulte Crear una aplicación OAuth personalizada para un procedimiento.

Credenciales Integradas

Autenticarse con las Credenciales de OAuth Integradas

Registrar una Cuenta de Anuncios de Bing

Siga los pasos a continuación para registrarse en una cuenta de Bing Ads y obtener el CustomerId y AccountId:

1. Regístrese para obtener una cuenta de Bing Ads en la aplicación web de Bing Ads o en el Sitio Sandbox para una cuenta de espacio aislado.
2. Haga clic en Configuración -> Cuentas y facturación y seleccione una sola cuenta. El AccountId y CustomerId (cid) se muestran en la página de la cuenta y en la URL de la página.

Obtenga un Token de Desarrollador

Para usar las APIs de Bing Ads, debe tener un DeveloperToken además de CustomerId y AccountId. Debe tener el rol de superadministrador en Bing Ads para crear un token de desarrollador, aunque no necesita permisos especiales para usar el token.

1. Inicie sesión en el Portal para desarrolladores de Bing Ads como usuario de una cuenta de Microsoft con la rol de superadministrador de Bing Ads.
2. Haga clic en el botón Solicitar token y tome nota de su token de desarrollador. Lo establecerás en el DeveloperToken propiedad de conexión.

Autenticación de Escritorio con la Aplicación OAuth Integrada

Puede conectarse sin configurar ninguna propiedad de conexión para sus credenciales de usuario. Después de configurar lo siguiente, está listo para conectarse:

• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
• DeveloperToken: establezca esto en el token que generó en el Portal para desarrolladores de Bing Ads. BBD37VB98 puede usarse para cuentas sandbox.
• AccountId: Establézcalo en el valor de ID de cuenta que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cuenta.
• CustomerId: Establézcalo en el valor de ID de cliente que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cliente.

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth.

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Obtiene un nuevo token de acceso cuando caduca el anterior.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Credenciales Personalizadas

Cuándo Usar una Aplicación OAuth Personalizada

La creación de una aplicación OAuth personalizada es opcional, ya que el conector ya está registrado en Bing Ads y puede conectarse con sus credenciales integradas.

Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en Bing Ads para otorgar permisos al conector.

Registro de una Cuenta de Anuncios de Bing

Siga los pasos a continuación para registrarse en una cuenta de Bing Ads y obtener el CustomerId y AccountId:

1. Regístrese para obtener una cuenta de Bing Ads en la aplicación web de Bing Ads o en el Sitio Sandbox para una cuenta de espacio aislado.
2. Haga clic en Configuración -> Cuentas y facturación y seleccione una sola cuenta. El AccountId y CustomerId (cid) se muestran en la página de la cuenta y en la URL de la página.

Obtener un Token de Desarrollador

Para usar las APIs de Bing Ads, debe tener un DeveloperToken además de CustomerId y AccountId. Debe tener el rol de superadministrador en Bing Ads para crear un token de desarrollador, aunque no necesita permisos especiales para usar el token.

1. Inicie sesión en el Portal para desarrolladores de Bing Ads como usuario de una cuenta de Microsoft con la rol de superadministrador de Bing Ads.
2. Haga clic en el botón Solicitar token y tome nota de su token de desarrollador. Lo establecerás en el DeveloperToken propiedad de conexión.

Autenticación de Escritorio con una Aplicación OAuth Personalizada

Siga los pasos a continuación para autenticarse con las credenciales de una aplicación OAuth personalizada. Consulte Crear una aplicación OAuth personalizada.

Obtenga y Actualice el Token de Acceso de OAuth

Después de configurar lo siguiente, está listo para conectarse:

• OAuthClientId: Establézcalo en el ID de cliente asignado cuando registró su aplicación.
• OAuthClientSecret: establezca esto en el secreto de cliente asignado cuando registró su aplicación.
• CallbackURL: establezca esto en el URI de redirección definido cuando registró su aplicación.
• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
• DeveloperToken: establezca esto en el token que generó en el Portal para desarrolladores de Bing Ads.
• AccountId: Establézcalo en el valor de ID de cuenta que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cuenta.
• CustomerId: Establézcalo en el valor de ID de cliente que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cliente.

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth:

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Actualiza el token de acceso cuando caduca.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Máquinas Sin Cabeza

Uso de OAuth en una Máquina Sin Cabeza

Para crear fuentes de datos de Bing Ads en servidores autónomos u otras máquinas en las que el conector no puede abrir un navegador, debe autenticarse desde otra máquina. La autenticación es un proceso de dos pasos.

1. En lugar de instalar el conector en otra máquina, puede seguir los pasos a continuación para obtener el OAuthVerifier valor. O bien, puede instalar el conector en otra máquina y transferir los valores de autenticación de OAuth, después de autenticarse a través del flujo habitual basado en el navegador.
2. A continuación, puede configurar el conector para actualizar automáticamente el token de acceso desde la máquina sin periféricos.

Puede seguir el flujo de autenticación de OAuth sin cabeza usando las credenciales de OAuth integradas del conector o usando las credenciales de OAuth para su aplicación de OAuth personalizada.

Uso de las Credenciales de OAuth Integradas

Obtenga un código verificador

Siga los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier propiedad de conexión:

1. Haga clic en el siguiente enlace para abrir el extremo de OAuth de Bing Ads en su navegador.
2. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador.
3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

En la máquina sin periféricos, establezca las siguientes propiedades de conexión para obtener los valores de autenticación de OAuth.

• OAuthVerifier: Establézcalo en el código del verificador.
• InitiateOAuth: Establézcalo en ACTUALIZAR.
• OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.
• DeveloperToken: establezca esto en el token que generó en el Portal para desarrolladores de Bing Ads.
• AccountId: Establézcalo en el valor de ID de cuenta que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cuenta.
• CustomerId: Establézcalo en el valor de ID de cliente que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cliente.

Después de generar el archivo de configuración de OAuth, configure las siguientes propiedades para conectarse a los datos:

• OAuthSettingsLocation: Establézcalo en el archivo que contiene los valores de autenticación de OAuth cifrados. Asegúrese de que este archivo otorgue permisos de lectura y escritura al proveedor para habilitar la actualización automática del token de acceso.
• InitiateOAuth: Establézcalo en ACTUALIZAR.
• DeveloperToken: establezca esto en el token que generó en el Portal para desarrolladores de Bing Ads.
• AccountId: Establézcalo en el valor de ID de cuenta que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cuenta.
• CustomerId: Establézcalo en el valor de ID de cliente que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cliente.

Transferir configuración de OAuth

Siga los pasos a continuación para instalar el conector en otra máquina, autenticar y luego transferir los valores de OAuth resultantes.

En una segunda máquina, instale el conector y conéctese con el siguiente conjunto de propiedades:

• OAuthSettingsLocation: establezca esto en un archivo de texto grabable.
• InitiateOAuth: Establézcalo en GETANDREFRESH.
• DeveloperToken: establezca esto en el token que generó en el Portal para desarrolladores de Bing Ads.
• AccountId: Establézcalo en el valor de ID de cuenta que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cuenta.
• CustomerId: Establézcalo en el valor de ID de cliente que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cliente.

Pruebe la conexión para autenticarse en el navegador. Los valores de autenticación resultantes se escriben, se cifran, en la ruta especificada por OAuthSettingsLocation. Una vez que haya probado con éxito la conexión, copie el archivo de configuración de OAuth en su máquina sin periféricos. En la máquina sin periféricos, configure las siguientes propiedades de conexión para conectarse a los datos:

• InitiateOAuth: Establézcalo en ACTUALIZAR.
• OAuthSettingsLocation: establezca esto en la ruta a su archivo de configuración de OAuth. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.
• DeveloperToken: establezca esto en el token que generó en el Portal para desarrolladores de Bing Ads.
• AccountId: Establézcalo en el valor de ID de cuenta que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cuenta.
• CustomerId: Establézcalo en el valor de ID de cliente que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cliente.

Uso de las Credenciales para una Aplicación OAuth Personalizada

Cree una aplicación OAuth personalizada

La creación de una aplicación de OAuth personalizada es opcional en el flujo de OAuth sin interfaz; puede omitir la creación de una aplicación conectándose con las credenciales de OAuth integradas del conector. Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en Bing Ads para otorgar permisos al conector.

Consulte Crear una aplicación OAuth personalizada para un procedimiento. Luego puede seguir los procedimientos a continuación para autenticarse y conectarse a los datos.

Obtenga un código verificador

Establezca las siguientes propiedades en la máquina sin periféricos:

• InitiateOAuth: Ajústelo a APAGADO.
• OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
• DeveloperToken: establezca esto en el token que generó en el Portal para desarrolladores de Bing Ads.
• AccountId: Establézcalo en el valor de ID de cuenta que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cuenta.
• CustomerId: Establézcalo en el valor de ID de cliente que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cliente.

Luego puede seguir los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier propiedad de conexión.

1. Llame a GetOAuthAuthorizationURL procedimiento almacenado* con el parámetro de entrada CallbackURL establecido en el URI de redirección exacto que especificó en la configuración de su aplicación.
2. Abra la URL devuelta en un navegador. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador.
3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

En la máquina sin periféricos, establezca las siguientes propiedades de conexión para obtener los valores de autenticación de OAuth:

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthVerifier: Establézcalo en el código del verificador.
• OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.
• InitiateOAuth: Establézcalo en ACTUALIZAR.
• DeveloperToken: establezca esto en el token que generó en el Portal para desarrolladores de Bing Ads.
• AccountId: Establézcalo en el valor de ID de cuenta que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cuenta.
• CustomerId: Establézcalo en el valor de ID de cliente que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cliente.

Conectarse a datos

Después de generar el archivo de configuración de OAuth, configure las siguientes propiedades para conectarse a los datos:

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthSettingsLocation: Establézcalo en el archivo que contiene los valores de autenticación de OAuth cifrados. Asegúrese de que este archivo otorgue permisos de lectura y escritura al proveedor para habilitar la actualización automática del token de acceso.
• InitiateOAuth: Establézcalo en ACTUALIZAR.
• DeveloperToken: establezca esto en el token que generó en el Portal para desarrolladores de Bing Ads.
• AccountId: Establézcalo en el valor de ID de cuenta que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cuenta.
• CustomerId: Establézcalo en el valor de ID de cliente que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cliente.

Transferir configuración de OAuth

Siga los pasos a continuación para instalar el conector en otra máquina, autenticar y luego transferir los valores de OAuth resultantes.

En una segunda máquina, instale el conector y conéctese con el siguiente conjunto de propiedades:

• OAuthSettingsLocation: establezca esto en un archivo de texto grabable.
• InitiateOAuth: Establézcalo en GETANDREFRESH.
• OAuthClientId: Establézcalo en el ID de cliente asignado cuando registró su aplicación.
• OAuthClientSecret: establezca esto en el secreto de cliente asignado cuando registró su aplicación.
• CallbackURL: establezca esto en el URI de redirección que especificó en la configuración de su aplicación.
• DeveloperToken: establezca esto en el token que generó en el Portal para desarrolladores de Bing Ads.
• AccountId: Establézcalo en el valor de ID de cuenta que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cuenta.
• CustomerId: Establézcalo en el valor de ID de cliente que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cliente.

Pruebe la conexión para autenticarse. Los valores de autenticación resultantes se escriben, se cifran, en la ruta especificada por OAuthSettingsLocation. Una vez que haya probado con éxito la conexión, copie el archivo de configuración de OAuth en su máquina sin periféricos. En la máquina sin periféricos, configure las siguientes propiedades de conexión para conectarse a los datos:

• InitiateOAuth: Establézcalo en ACTUALIZAR.
• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthSettingsLocation: establezca esto en la ruta a su archivo de configuración de OAuth. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.
• DeveloperToken: establezca esto en el token que generó en el Portal para desarrolladores de Bing Ads.
• AccountId: Establézcalo en el valor de ID de cuenta que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cuenta.
• CustomerId: Establézcalo en el valor de ID de cliente que se encuentra en la aplicación web de Bing Ads, en Configuración -> Cuentas y facturación -> Su cuenta -> Cliente.

Creación de una Aplicación OAuth Personalizada

Cuándo Crear una Aplicación OAuth Personalizada

La creación de una aplicación OAuth personalizada es opcional, ya que el conector ya está registrado en Bing Ads y puede conectarse con sus credenciales integradas.

Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en el extremo de OAuth de Bing Ads para otorgar permisos al conector.

Siga los pasos a continuación para crear una aplicación OAuth personalizada y obtener las propiedades de conexión en un flujo de autenticación OAuth específico.

Crear una Aplicación OAuth Personalizada: Escritorio

1. Si aún no lo ha hecho, regístrese para obtener una cuenta de Bing Ads en la aplicación web de Bing Ads o en el Sitio Sandbox para una cuenta de espacio aislado.
2. Vaya al Portal de Azure ( Portal de prueba de Azure para cuentas de espacio aislado) e inicie sesión con las credenciales de su cuenta de Microsoft cuando se le solicite.
3. En Azure Active Directory --> Registros de aplicaciones, haga clic en Nuevo registro.
4. Proporcione el nombre de la aplicación y seleccione un tipo de cuenta compatible adecuado. Si no selecciona permitir cuentas personales de Microsoft, los usuarios con cuentas personales no podrán autenticarse.
5. En la sección URI de redirección, debe establecer una URL adecuada. Para aplicaciones de escritorio, un valor como "http://localhost:33333 o se puede configurar otro puerto de su elección.
6. Registre su aplicación y tome nota de su ID de aplicación (cliente). Lo usarás como OAuthClientId valor en el flujo de concesión de OAuth.
7. En la sección Certificados y secretos, haga clic en Nuevo secreto de cliente para generar un secreto de cliente y tome nota del valor resultante. Lo usarás como OAuthClientSecret valor.

Características Avanzadas

Esta sección detalla una selección de funciones avanzadas del conector de Bing Ads.

Vistas definidas por el usuario

El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.

Configuración SSL

Usar Configuración SSL para ajustar cómo el conector maneja las negociaciones de certificados TLS/SSL. Puede elegir entre varios formatos de certificado; ver el SSLServerCert propiedad en "Opciones de cadena de conexión" para obtener más información.

Apoderado

Para configurar el conector mediante Configuración de proxy de Agente Privado, Selecciona el Use Proxy Settings casilla de verificación en la pantalla de configuración de la conexión.

Vistas Definidas por el Usuario

El Jitterbit Connector para Bing Ads te permite definir una tabla virtual cuyos contenidos se deciden mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

• Cree un archivo de configuración con formato JSON que defina las vistas que desea.
• Declaraciones DDL.

Definición de Vistas Utilizando un Archivo de Configuración

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

{
    "MyView": {
        "query": "SELECT * FROM AdGroups WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Vistas Definidas por el Usuario

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con Vistas Definidas por el Usuario

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Dando como resultado la consultar efectiva a la fuente:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Configuración SSL

Personalización de la Configuración SSL

De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.

Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Modelo de Datos

El Conector Jitterbit para Bing Ads modela entidades en la API de Bing Ads como vistas de base de datos y procedimientos almacenados. Estos se definen en archivos de esquema, que son archivos de configuración simples basados en texto.

Las siguientes secciones brindan información sobre cómo ejecutar SQL en los objetos API disponibles. El conector descarga la mayor parte posible del procesamiento de la declaración SELECT a Bing Ads y luego procesa el resto de la consultar en la memoria; Las limitaciones y los requisitos de la API se documentan en esta sección.

Ver SupportEnhancedSQL para obtener más información sobre cómo el conector elude las limitaciones de la API con el procesamiento del lado del cliente en memoria.

Puntos de vista

El conector Bing Ads objeta como Vistas, incluidos los informes.

Puede consultar informes en función de una agregación y un período de tiempo. El período de tiempo predeterminado es este año; para cambiar el período de tiempo, consulte la siguiente sección Filtro de tiempo.

Al recuperar solo algunas columnas del informe, todas las columnas marcadas como "Seleccionar requisito" y al menos una de las columnas marcadas como "Métrica" deben seleccionarse para emitir una solicitud de informe válida. Por otro lado, si está recuperando todas las columnas, el controlador incluirá de manera predeterminada las columnas mínimamente requeridas en la solicitud.

Consulta de Agregaciones de Informes

De manera predeterminada, los datos del informe se agregarán por todo el tiempo del informe especificado y el informe no incluirá una columna de período de tiempo. Los datos, de forma predeterminada, se recuperarán solo para el último mes. Si desea cambiar este comportamiento, consulte el 'Specifying a Time Filter' sección a continuación.

Además, puede agregar los datos del informe seleccionando una de las siguientes columnas de agregación:

• Daily: Cada fila del informe identifica el mes, día y año en que ocurrió la transacción. Los datos del informe se agregarán por cada día. El informe incluirá una columna llamada Diariamente que contiene el día con el formato aaaa-mm-dd.

  SELECT Daily, AccountName, AccountStatus, Impressions, Clicks, ConversionRate  FROM [AccountPerformanceReport ]
  

• DayOfWeek: Cada fila del informe identifica el día de la semana en que ocurrió la transacción. Los datos del informe se agregarán por cada uno de los siete días de una semana. El informe incluirá una columna denominada DayOfWeek, y los valores posibles son 1 - 7, donde 1 representa el domingo y 7 representa el sábado.

  Si el tiempo del informe abarca varias semanas, los datos de rendimiento de todas las semanas para un día determinado de la semana se agregarán en una fila. Por ejemplo, si la Campaña A tiene 5 impresiones todos los lunes (día 2) durante cada una de las 3 semanas incluidas en el intervalo de tiempo del informe, el informe incluirá una fila con el Día de la semana establecido en 2 y las impresiones en esa fila con un total de 15.

  SELECT DayOfWeek, AccountName, AccountStatus, Impressions, Clicks, ConversionRate  FROM [AccountPerformanceReport ]
  

• Hourly: Cada fila del informe identifica la hora en que ocurrió la transacción. Los datos del informe se agregarán por cada hora del día. El informe incluirá una columna denominada Cada hora, y los valores posibles son 0 - 23.

  SELECT Hourly, AccountName, AccountStatus, Impressions, Clicks, ConversionRate  FROM [AccountPerformanceReport ]
  

• HourOfDay: Cada fila del informe identifica la hora del día en que ocurrió la transacción. Los datos del informe se agregarán por cada una de las 24 horas en todos los días. El informe incluirá una columna denominada HourOfDay, y los valores posibles son 0 - 23.

  Si el tiempo del informe abarca varios días, los datos de rendimiento de todos los días para una hora determinada se agregarán en una fila. Por ejemplo, si la Campaña A tiene 5 impresiones durante la hora 7 en cada uno de los 3 días incluidos en el intervalo de tiempo del informe, el informe incluirá una fila con impresiones para HourOfDay con un total de 15.

  SELECT HourOfDay, AccountName, AccountStatus, Impressions, Clicks, ConversionRate  FROM [AccountPerformanceReport ]
  

• Monthly: Cada fila del informe identifica el mes en que ocurrió la transacción. Los datos del informe se agregarán cada mes. El informe incluirá una columna denominada Mensualmente que contiene el primer día del mes con el formato aaaa-mm-dd.

  SELECT Monthly, AccountName, AccountStatus, Impressions, Clicks, ConversionRate  FROM [AccountPerformanceReport ]
  

• Weekly: Cada fila del informe identifica la semana en que ocurrió la transacción. Los datos del informe se agregarán cada semana. El informe incluirá una columna denominada Semanal que contiene la fecha del domingo de cada semana con el formato aaaa-mm-dd.

  SELECT Weekly, AccountName, AccountStatus, Impressions, Clicks, ConversionRate  FROM [AccountPerformanceReport ]
  

• Yearly: Cada fila del informe identifica el año en que ocurrió la transacción. Los datos del informe se agregarán cada año. El informe incluirá una columna denominada Anualmente que contiene el año en formato aaaa.

  SELECT Yearly, AccountName, AccountStatus, Impressions, Clicks, ConversionRate  FROM [AccountPerformanceReport ]
  

Especificación de un Filtro de Tiempo

Puede especificar un rango de fechas personalizado o especificar un rango de fechas predefinido.

• Para buscar en un intervalo de fechas predefinido, establezca la pseudocolumna DatePreset en la cláusula WHERE en uno de los siguientes valores: Hoy, Ayer, Últimos siete días, Esta semana, Última semana, Últimas cuatro semanas, Este mes, Último mes, Últimos tres meses, Últimos seis meses, Este año o Último año. El valor predeterminado de DatePreset es "Este año".

  SELECT Monthly, AccountName, AccountStatus, Impressions, Clicks, ConversionRate  FROM [Informe de rendimiento de la cuenta] WHERE DatePreset = 'LastYear'
  

• Para especificar un intervalo de fechas personalizado, especifique las pseudocolumnas StartDate y EndDate en la cláusula WHERE.

  SELECT Monthly, AccountName, AccountStatus, Impressions, Clicks, ConversionRate  FROM [Informe de rendimiento de la cuenta] WHERE StartDate = '2014-01-01' AND EndDate = '2017-09-19'
  

Procedimientos almacenados

NOTE: Los procedimientos almacenados no se admiten actualmente. Consulte la nota anterior para detalles.

Procedimientos almacenados son interfaces similares a funciones para la fuente de datos. Se pueden utilizar para buscar, actualizar y modificar información en la fuente de datos.

Puntos de Vista

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido. Para obtener más información sobre las tablas y los procedimientos almacenados, vaya a sus entradas correspondientes en este documento de ayuda.

Conector Jitterbit para Vistas de Bing Ads

Informe de Rendimiento de la Cuenta

Utilice este informe para observar el rendimiento y las tendencias de la cuenta a largo plazo.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Cuentas

Consulta las cuentas disponibles en Bing Ads.

Información Específica de la Tabla

Seleccionar

El conector procesa las búsquedas en esta tabla del lado del cliente; la siguiente consultar se procesa en el lado del servidor.

SELECT * FROM [Accounts ]

La ejecución del lado del cliente de la consultar se puede desactivar configurando SupportEnhancedSQL a falso, en cuyo caso cualquier consultar que no sea SELECT * devolverá un error.

Columnas

Informe de Rendimiento de Texto Dinámico de Anuncio

Utilice este informe para identificar qué cadenas de texto dinámico están funcionando bien y qué cadenas debe considerar cambiar.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

AdExtensionByAdReport

Utilice este informe para comparar el rendimiento de las diferentes versiones de sus extensiones de anuncios con cada anuncio.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Informe de Extensión de Anuncio por Palabra Clave

Utilice este informe para comparar el rendimiento de las diferentes versiones de sus extensiones de anuncios para cada palabra clave.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Informe de Detalle de Extensión de Anuncio

Utilice este informe para descubrir la efectividad de elementos de extensión de anuncios individuales, por ejemplo, cada enlace de una extensión de enlace de sitio.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Informe de Rendimiento del Grupo de Anuncios

Utilice este informe para comparar de forma más amplia las estadísticas de rendimiento de entrega por grupo de anuncios, campaña o atributos de cuenta en lugar de a nivel de palabra clave.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Grupos de Anuncios

Consulta los grupos de anuncios disponibles en Bing Ads.

Información Específica de la Tabla

Seleccionar

Debe especificar la columna CampaignId en la cláusula WHERE para consultar esta tabla. El conector usará la API de Bing Ads para filtrar los resultados por CampaignId mientras que el resto del filtro se ejecuta en el lado del cliente dentro del conector.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM [Grupos de anuncios] WHERE CampaignId = '234505536'

La ejecución del lado del cliente de la consultar se puede desactivar configurando SupportEnhancedSQL a falso, en cuyo caso cualquier criterio de búsqueda con columnas en la cláusula WHERE que no sea CampaignId generará un error.

Columnas

Informe de Rendimiento de Anuncios

Use este informe para ayudarlo a determinar qué anuncios generan clics y conversiones, y cuáles no están funcionando. Tener anuncios de bajo rendimiento en su cuenta puede reducir la calidad de sus campañas.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Anuncios

Consulta los anuncios disponibles en Bing Ads.

Información Específica de la Tabla

Seleccionar

Debes especificar el AdGroupId y Type columnas en la cláusula WHERE para consultar esta tabla. El conector usa la API de Bing Ads para filtrar los resultados por AdGroup y Type, mientras que el resto del filtro se ejecuta en el lado del cliente dentro del conector.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM [Anuncios] WHERE AdGroupId = '5179946006' AND Type = 'Text'
SELECT * FROM Ads WHERE AdGroupId='1297424037031698' AND Type='DynamicSearch' AND AccountId='135093022'
SELECT * from Ads where AdGroupId='1302921473177959' AND Type='Text' AND AccountId in ('2562405', '141163457','180394748')

Puede desactivar la ejecución del lado del cliente configurando SupportEnhancedSQL a falso, en cuyo caso cualquier criterio de búsqueda que se refiera a columnas que no sean AdGroupId y Type provoca un error.

Columnas

EdadGéneroPúblicoInforme

Use este informe para descubrir cómo sus campañas y grupos de anuncios están resonando con audiencias de diversas edades y géneros.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Informe de Rendimiento de la Audiencia

Utilice este informe para comparar estadísticas de rendimiento de entrega por audiencia, grupo de anuncios, campaña o atributos de cuenta.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Audiencias

Consulta las Audiencias disponibles en Bing Ads.

Información Específica de la Tabla

Seleccionar

El conector procesa las búsquedas en esta tabla del lado del cliente; la siguiente consultar se ejecuta en el lado del servidor.

SELECT * FROM [Audiences]
SELECT * FROM Audiences WHERE AccountId='65098547' AND Type='RemarketingList'

La ejecución del lado del cliente de la consultar se puede desactivar configurando SupportEnhancedSQL a falso, en cuyo caso cualquier consultar de búsqueda devolverá un error.

Columnas

Oportunidades de Oferta

Consulta las oportunidades de oferta disponibles en Bing Ads.

Información Específica de la Tabla

Seleccionar

Debe especificar la columna OpportunityType en la cláusula WHERE para consultar esta tabla. Puede especificar los siguientes valores para OpportunityType: FirstPage, MainLine y MainLine1.

El conector utilizará la API de Bing Ads para filtrar los resultados por OpportunityType mientras que el resto del filtro se ejecuta en el lado del cliente dentro del conector. Por ejemplo, la siguiente consultar se procesa del lado del servidor.

SELECT * FROM [Oportunidades de oferta] WHERE OpportunityType = 'FirstPage'

Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL a falso, en cuyo caso cualquier criterio de búsqueda que haga referencia a columnas que no sean OpportunityType generará un error.

Columnas

PresupuestoOportunidades

Consulta las Oportunidades de Presupuesto disponibles en Bing Ads.

Información Específica de la Tabla

Seleccionar

Debe especificar la columna CampaignId en la cláusula WHERE para consultar esta tabla. El conector usará la API de Bing Ads para filtrar los resultados por CampaignId mientras que el resto del filtro se ejecuta en el lado del cliente dentro del conector.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM [Oportunidades Presupuestarias] WHERE CampaignId = '234505536'

Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL a falso, en cuyo caso cualquier criterio de búsqueda en la cláusula WHERE que haga referencia a columnas que no sean CampaignId generará un error.

Columnas

Presupuestos

Consulta los Presupuestos disponibles en Bing Ads.

Información Específica de la Tabla

Seleccionar

El conector procesa las búsquedas en esta tabla del lado del cliente; la siguiente consultar se procesa en el lado del servidor:

SELECT * FROM [Budgets]
SELECT * FROM Budgets WHERE CampaignId='431046229' AND AccountId='65098547'

La ejecución del lado del cliente de la consultar se puede desactivar configurando SupportEnhancedSQL a falso, en cuyo caso cualquier consultar de búsqueda devuelve un error.

Columnas

PresupuestoResumenInforme

Utilice este informe para descubrir el rendimiento mensual del presupuesto de su campaña. Por ejemplo, el informe muestra su presupuesto mensual, cuánto ha gastado hasta la fecha y si está en el objetivo de gastar su presupuesto mensual.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Informe de Rendimiento de la Campaña

Utilice este informe para ver estadísticas de rendimiento de alto nivel y atributos de calidad para cada campaña o cuenta. Esta es también una forma rápida de señalar cualquier problema importante de campaña o cuenta.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Campañas

Consulta las Campañas disponibles en Bing Ads.

Información Específica de la Tabla

Seleccionar

El conector procesa las búsquedas en esta tabla del lado del cliente; la siguiente consultar se procesa en el lado del servidor:

SELECT * FROM [Campaigns ]

Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL a falso, en cuyo caso cualquier consultar de búsqueda devolverá un error.

Columnas

Informe de Rendimiento de Conversiones

Utilice este informe para comprender qué campañas y palabras clave están llevando a una audiencia a completar una compra u otra acción de conversión.

Columnas