.. include:: Includes.txt .. _usage: Usage ===== .. _create-ad: Create a new ad --------------- To create a new ad a user can use one of different entry points: .. warning:: Not all pages are supported for ad creation. By default, only pages with dokType 1 (default pages) are allowed. This means e.g. for folders and other page types the following entry points do not exist. As an administrator you can add more dokTypes (e.g. own types, or types from extensions like blog post type from EXT:blog by extending the array of allowed types: :php:`$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['google_ads']['createAd']['allowedPageDokTypes'][] = \T3G\AgencyPack\Blog\Constants::DOKTYPE_BLOG_POST; // 137` .. note:: At this time of development, only pages can be used as targets for ads. This means, you can create ads for regular landing pages or for your blog, if you enabled this page type as described above. But you can not use a record based target, so single tx_news articles can not serve as an Google Ads target. Context Menu ~~~~~~~~~~~~ .. figure:: Images/Usage/EntryPoint/contextmenu.png :alt: In the context menu you find the entry "Create ad" :class: with-border In the context menu you find the entry "Create ad" Button in Page module ~~~~~~~~~~~~~~~~~~~~~ .. figure:: Images/Usage/EntryPoint/page_module.png :alt: In the page module you find the button "Create ad" :class: with-border In the page module you find the button "Create ad" Button in Edit page record ~~~~~~~~~~~~~~~~~~~~~~~~~~ .. figure:: Images/Usage/EntryPoint/edit_page.png :alt: In the page edit view you find the button "Create ad" as well :class: with-border In the page edit view you find the button "Create ad" as well Button in List module ~~~~~~~~~~~~~~~~~~~~~ .. figure:: Images/Usage/EntryPoint/list_module.png :alt: In the list module you find the button "Create ad" :class: with-border In the list module you find the button "Create ad" The create form ~~~~~~~~~~~~~~~ If you have found the way into the create form you will see for example the following form. Some of the fields will be pre-filled with data from the page where you started, but you can change anything you like. .. figure:: Images/Usage/AdCreate/preview.png :alt: First part of ad-create form with input for text and headlines, as well as preview for mobile and desktop :class: with-border First part of ad-create form with input for text and headlines, as well as preview for mobile and desktop .. figure:: Images/Usage/AdCreate/keywords.png :alt: Part of ad-create form with keyword suggest wizard and input fields for keywords. :class: with-border Part of ad-create form with keyword suggest wizard and input fields for keywords. .. figure:: Images/Usage/AdCreate/locations.png :alt: Part of ad-create form with input for location targeting. Define countries and / or radius locations in any amount. :class: with-border Part of ad-create form with input for location targeting. Define countries and / or radius locations in any amount. .. figure:: Images/Usage/AdCreate/extensions.png :alt: Part of ad-create form with ad extensions to enrich the ad with additional information. :class: with-border Part of ad-create form with ad extensions to enrich the ad with additional information. .. figure:: Images/Usage/AdCreate/schedule.png :alt: Part of ad-create form with input schedule targeting. Define in detail when your ad will be shown to customers. :class: with-border Part of ad-create form with input schedule targeting. Define in detail when your ad will be shown to customers. .. figure:: Images/Usage/AdCreate/budget.png :alt: Part of ad-create form with input for budget and Submit button. :class: with-border Part of ad-create form with input for budget and Submit button. .. _pause-ad: Pause a running campaign ------------------------ .. figure:: Images/Usage/Campaign/pause.png :alt: In the campaign module you'll find the pause button :class: with-border In the campaign module you'll find the pause button .. _resume-ad: Resume a paused campaign ------------------------ .. figure:: Images/Usage/Campaign/resume.png :alt: In the campaign module you'll find the resume button :class: with-border In the campaign module you'll find the resume button .. _delete-ad: Delete an ad ------------ .. figure:: Images/Usage/Campaign/delete.png :alt: In the campaigns detail view you'll find the delete button :class: with-border In the campaign detail view you'll find the delete button Message Center ~~~~~~~~~~~~~~ The message center is the place where messages created during operations will be displayed. Messages can be read, (un)marked as read and deleted. The detail can be opened by clicking on a message. The top bar of the TYPO3 backend contains a menu item that lists all unread messages and links each message to its detail view. Messages are created on **Google Ads for TYPO3** and delivered to the TYPO3 instance initiating the operation. This does not necessarily happen in real time. A delay up to 10 minutes is common. .. figure:: Images/Usage/MessageCenter/overview.png :alt: Overview of all messages :class: with-border Overview of all messages Mark message as read -------------------- .. figure:: Images/Usage/MessageCenter/mark_read.png :alt: Button to mark a message as read :class: with-border Button to mark a message as read Mark message as unread ---------------------- .. figure:: Images/Usage/MessageCenter/mark_unread.png :alt: Button to mark a message as unread :class: with-border Button to mark a message as unread Delete a message ---------------- .. figure:: Images/Usage/MessageCenter/delete.png :alt: Button to delete a message :class: with-border Button to delete a message Detail view ----------- .. figure:: Images/Usage/MessageCenter/detail.png :alt: Detail view of a message :class: with-border Detail view of a message Top bar menu item ----------------- .. figure:: Images/Usage/MessageCenter/topbar_menu.png :alt: Top bar menu item listing all unread messages :class: with-border Top bar menu item listing all unread messages