.. include:: Includes.txt .. _preparation: Preparation =========== .. _preparation-google_ads_account: Create a new Google Ads Account ------------------------------- Before you can start using the Google Ads Integration for TYPO3, you need a Google Ads account to your name. The Google Ads account is a service provided by Google, therefore you need to navigate to `Google Ads `_ and log in with your Google Account. What you see next depends on whether an account already exists. If so, and you want to use it, there is not much more to be done. Please review the payment settings to make sure ads can be delivered (more information at :ref:`preparation-google_ads_account-payment_settings`). If an account exists, but you don't want to use it, you can create a new one by clicking on the right hand avatar picture and select ``Google Ads accounts +``. .. figure:: Images/Preparations/GoogleAdsAccount/001-create-new-ads-account.png :alt: Create a new Ads Account after logging into https://ads.google.com Upper right hand avatar image reveals context menu on right click, providing option to create a new Google Ads Account Afterwards your are presented with the setup routine. To keep this tutorial to its minimum, we go the route of a bare setup without any unnecessary presets. You have all freedom to adjust any settings later on in the Google Ads UI, it will not influence how the TYPO3 integration will interact with your account. Here is the setup routine in screenshots, with markers where to click: .. figure:: Images/Preparations/GoogleAdsAccount/002-step1-account-creation-wizard.png :alt: Step 1 of the Account Creation Wizard Click ``Switch to Expert Mode`` to not set any specific goals .. figure:: Images/Preparations/GoogleAdsAccount/003-step2-account-creation-wizard.png :alt: Step 2 of the Account Creation Wizard Click ``Create an account without a campaign`` to skip the example campaign creation. .. figure:: Images/Preparations/GoogleAdsAccount/004-step3-account-creation-wizard.png :alt: Step 3 of the Account Creation Wizard Adjust the settings, these can **not** be adjusted later. Press ``Submit`` .. figure:: Images/Preparations/GoogleAdsAccount/005-step4-account-creation-wizard.png :alt: Step 4 of the Account Creation Wizard - all done All set. The account has been created. Congratulations, you created a Google Ads account. This is not enough, though, because Google will want to know about a credit card to cover the cost of online advertising. Click ``Explore your account`` to continue. .. _preparation-google_ads_account-payment-settings: Provide Payment Settings ~~~~~~~~~~~~~~~~~~~~~~~~ Depending on any existing configuration, you will now see either option next. .. figure:: Images/Preparations/GoogleAdsAccount/006-step1-payment-settings.png :alt: Billing Information menu entry in easy mode Menu entry to update Billing Information Next is a form that takes all the information about your business and your payment information. Please fill this in the best you could. Any missing or wrong information might lead to your ads not being delivered. .. figure:: Images/Preparations/GoogleAdsAccount/007-step2-payment-settings.png :alt: Payment Setup form upper part .. _preparation-google_ads_account-account_name: Bonus: Set a Google Ads account name ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When you skip the presets as described above, you end up with an account that has no explicit name. There might be no need for any, especially when it remains the only one. Should you ever want to set or change a name, the preferences section holds an entry for the value like this: .. figure:: Images/Preparations/GoogleAdsAccount/008-step1-set-account-name.png :alt: Preferences section with account edit entry Preferences section with account edit entry .. figure:: Images/Preparations/GoogleAdsAccount/009-step2-set-account-name.png :alt: Set or edit the account name Set or edit the Google Ads account name As a little preview, the name set here will later on also show up in Google Ads for TYPO3 in order to make it easy for you to identify the Google Ads account to use. .. _preparation-middleware_account: Create a Google Ads for TYPO3 Account ------------------------------------- This is the tool that handles all requests both to and from any instance and also to and from Google Ads. No consumer instance will use the Google Ads API directly, what makes it so small and lightweight and easy to use. So in order to get the power of Google Ads into your TYPO3 instance, the extension needs to be connected to a valid Google Ads for TYPO3 account, and here is how. Navigate to `GOOGLE ADS FOR TYPO3 `_ (you will also find a button in the management view of the extension once installed, so don't bother too much with the URL). Register an account in 5 steps: .. figure:: Images/Preparations/MiddlewareAccount/001-step1-register-account.png :alt: Initial log in screen on Google Ads for TYPO3 Initial log in screen on Google Ads for TYPO3 .. figure:: Images/Preparations/MiddlewareAccount/002-step2-register-account.png :alt: Registration form on Google Ads for TYPO3 Registration form on Google Ads for TYPO3 .. figure:: Images/Preparations/MiddlewareAccount/003-step3-register-account.png :alt: A confirmation email is sent A confirmation email is sent .. figure:: Images/Preparations/MiddlewareAccount/004-step4-register-account.png :alt: Confirmation email Confirmation email .. figure:: Images/Preparations/MiddlewareAccount/005-step5-register-account.png :alt: Continue to the dashboard Continue to the dashboard .. figure:: Images/Preparations/MiddlewareAccount/006-step6-register-account.png :alt: All set All set .. _preparation-connect_ads_account_to_middleware: Connect your Google Ads Account to Google Ads for TYPO3 ------------------------------------------------------- After both accounts are prepared, they need to be connected. This will allow the Google Ads for TYPO3 application to execute commands in name of your Google Ads account. So expect an email from Google in this regard. We come to that shortly. Please take note of the consequences of connecting a Google Ads account to your Google Ads for TYPO3 account by reading :ref:`introduction-account-connection`. Starting out from where we left in :ref:`preparation-middleware_account` or directly after login into `GOOGLE ADS FOR TYPO3 `_, enter the Google Accounts section and follow the steps as described: .. figure:: Images/Preparations/ConnectAccounts/001-step1-connect_accounts.png :alt: Enter the Google Accounts section Enter the Google Accounts section .. figure:: Images/Preparations/ConnectAccounts/002-step2-connect_accounts.png :alt: Open the form to enter the Google Ads Account ID Open the form to enter the Google Ads Account ID .. figure:: Images/Preparations/ConnectAccounts/003-step3-connect_accounts.png :alt: temporary name will be overridden once the account can be managed temporary name will be overridden once the account can be managed .. note:: You can connect as many Google Ads accounts as you wish, there is no limitation applied. But if several Google Ads for TYPO3 accounts wish to connect the same Google Ads account, the system will decline the second connection. Should you have a use case for this setup, please `give us a call `_. Technical and legal causes make manual interference necessary for this. .. figure:: Images/Preparations/ConnectAccounts/004-step4-connect_accounts.png :alt: Now an email from Google Ads asks permission for the request of management Now an email from Google Ads asks permission for the request of management .. _preparation-connect_accounts-allow_management_email: .. figure:: Images/Preparations/ConnectAccounts/005-step5-connect_accounts.png :alt: Email from Google Ads asking confirmation. Mind the asking party and the ID of the Management Account Email from Google Ads asking confirmation. Mind the asking party and the ID of the Management Account .. _preparation-connect_accounts-allow_management_access: .. figure:: Images/Preparations/ConnectAccounts/006-step6-connect_accounts.png :alt: Allow the Management Access for the Ads for TYPO3 management account .. figure:: Images/Preparations/ConnectAccounts/006-step7-connect_accounts.png :alt: Confirm that you grant management access Allow the Management Access for the Ads for TYPO3 management account .. figure:: Images/Preparations/ConnectAccounts/007-step8-connect_accounts.png :alt: Waiting for Google Ads to acknowledge the Management access Waiting for Google Ads to acknowledge the Management access .. figure:: Images/Preparations/ConnectAccounts/008-step9-connect_accounts.png :alt: Done and done. Google Ads connected both accounts, you are ready to go Done and done. Google Ads connected both accounts, you are ready to go Once the account connection has been confirmed by Google Ads and picked up by Google Ads for TYPO3 (allow some 10 minutes for this process), you are ready to set up the extension. If the connection can not be confirmed, but you are sure that all necessary steps have been taken (especially the part that needs execution directly in Google Ads, see :ref:`preparation-connect_accounts-allow_management_email` and :ref:`preparation-connect_accounts-allow_management_access`), please `give us a call `_. Our dedicated support team will happily help you investigate the cause of the delay and bring the process back on track.