create_microsoft_image_extension

Attach visual imagery (1-20 product / lifestyle shots) to a Microsoft Ads (Bing) text ad to lift click-through. BETA. Re-uses assets already uploaded to the Metadata image library — pass their IDs, not raw files.

                ALSO KNOWN AS: image extension, image asset, ad image, visual extension, picture extension, photo extension, hero image

                KEYWORDS: image, image extension, photo, picture, visual, hero, asset, library, BETA, microsoft ads, bing, extension, CTR

                WHEN TO USE:
                - "Attach images to our Microsoft Ads text ad"
                - "Add image library IDs 123 and 456 as a Bing image extension"
                - "Create a Microsoft Ads image extension showing product photos under our search ads"

                WHEN NOT TO USE:
                - The image is a logo / brand mark → use create_microsoft_business_logo_extension
                - You haven't uploaded the assets yet — image extensions reference library IDs, so upload to the image library first.
                - Want to drive clicks via text snippets → use create_microsoft_sitelink_extension / callout
                - Same images for Google Ads → use create_google_image_extension

                INPUTS:
                - image_library_ids (required): 1-20 IDs from the Metadata image library.
                - alternative_text:  accessibility alt text (≤90 chars).
                - display_text:      short caption overlaid on the image (≤35 chars). E.g. "Shop Now".
                - destination_url:   landing page when the image is clicked.

                EXAMPLE:
                create_microsoft_image_extension(
                    image_library_ids=[123, 456],
                    alternative_text="Product hero shot",
                    display_text="Shop Now",
                    destination_url="https://example.com/landing",
                )