Manage ad network accounts
Following are instructions for creating and editing ad network account details, refreshing the oAuth token for an account, and disabling accounts.
For details about the functionality available for each ad network, see “Supported Inventory.”
Create ad network account details create-account
Agency account manager, Adobe account manager, and administrator user roles only
To enable syncing or tracking of an account, you must create a corresponding account record containing the account access credentials and tracking options and with the status active.
- Support isn’t available for new Baidu accounts.
- To create an actual account on the ad network, go to the ad network’s website.
-
In the main menu, click Search > Campaigns > Campaigns. In the submenu, click Live > Accounts.
-
In the toolbar above the data table, click .
-
Specify the account settings:
-
Click the name of the ad network, and then click Next.
-
In the Account Details section, enter the account details.
For ad networks that use the login authorization type “oAuth,” allow Search, Social, & Commerce to access the account using the OAuth authorization protocol:
-
Enter the Login value for the account, optionally enter the password, and then click Authenticate.
The best practice is to use the login for API access to the account. Enter the password when you want to encrypt and save it, so that the Adobe Account Team can refresh tokens as needed.
-
(If you’re not logged in to the advertiser’s account) Log in to the advertiser’s ad account. The best practice is to use the credentials for API access to the account.
-
In the request for permission/access screen, click the button to confirm permission.
-
Copy the authentication string in the pop-up window that opens, and paste the string into the oAuth Token field.
-
Specify the remaining account details.
-
-
Click Set Account Tracking, and enter the tracking settings.
-
-
Click Post.
Recent cost and click data for all campaigns in the account is available within Search, Social, & Commerce in about 24 hours. By default, data is available for the last 5-10 days, depending on the ad network. When necessary, however, the project launch team may retrieve data for up to the last 60 days.
Edit ad network account details edit-account
Agency account manager, Adobe account manager, and administrator user roles only
If account credentials change, you want to change the default tracking parameters across an account, or you want to enable or disable activity on an account, then edit the account details.
-
In the main menu, click Search > Campaigns > Campaigns. In the submenu, click Live > Accounts.
-
Hold the cursor over the account name, click , and then select Edit.
-
Edit the account settings:
-
(Optional) Edit the account details.
-
(Optional) Click Set Account Tracking, and edit the tracking settings.
-
-
Click Post.
note note NOTE Search, Social, & Commerce must synchronize the new account data with that on the ad network. This happens automatically once a day, or more often when Search, Social, & Commerce detects changes on the ad network.
Refresh oAuth access tokens for search accounts refresh-oauth-tokens
Agency account manager, Adobe account manager, and administrator user roles only
If Search, Social, & Commerce accesses the account using the OAuth authorization protocol and the account credentials change, or if additional access is required to support new features in Search, Social, & Commerce, then you must get a new access token for the account.
Your Adobe Account Team will inform you if new features require a new token.
-
(If you’re logged in to another account for the same ad network in the same browser application) Log out of any account other than the advertiser’s.
-
In the main menu, click Search > Campaigns > Campaigns. In the submenu, click Live > Accounts.
-
Hold the cursor over the account name, click , and then select Edit.
-
Get a new access token:
-
Click Get oAuth Token.
-
(If you’re not logged in to the advertiser’s account) Log in to the advertiser’s ad account. The best practice is to use the credentials for API access to the account.
-
In the request for permission/access screen, click the button to confirm permission.
-
Copy the authentication string in the pop-up window that opens, and paste the string into the oAuth Token field.
-
-
Click Post.
Enable or disable ad network accounts enable-disable-account
Agency account manager, Adobe account manager, and administrator user roles only
When you enable an ad network account, Search, Social, & Commerce synchronizes campaign data with the account (when supported) and pushes automated bids and/or campaign budgets for campaigns in portfolios.When you disable an ad network account, Search, Social, & Commerce stops all activity on the account. Data collected while the account was active is still stored, but the campaign management views and reports don’t include data for the time period in which the account is disabled. You can later re-enable the account to resume activity with the account.
-
In the main menu, click Search > Campaigns > Campaigns. In the submenu, click Live > Accounts.
-
Do either of the following:
-
(To change the status for a single account) Hold the cursor over the account name, click , and then select Edit. Change the Status to Enabled or Disabled, and then click Post.
-
(To change the status for one or more accounts) Do the following:
-
Select the check box next to each account.
For tips on selecting multiple rows, see “Select multiple rows.”
-
In the toolbar above the data table, click to enable the account or to disable the account.
-
-
Ad network account settings account-settings
Account Details
SE Account ID: (All accounts except for Naver and Yandex accounts; editable for new accounts only) The account ID assigned by the ad network.
Account Name: The name to be displayed for the account within Search, Social, & Commerce.
Login Details: [Login Type] - (Microsoft Advertising/Microsoft Merchant Center only) Whether to authorize logins to the account using:
-
oAuth (the default): To use the OAuth authorization protocol.
-
Password: To use the client’s password.
For Microsoft Advertising accounts, only oAuth-authorized logins can be used.
Login Details: Login: (All ad networks except Naver) The login name or ID to enable API access to the account.
Login Details: OAuth Token: (Microsoft Advertising oAuth-enabled and all other networks except for Meta and Yandex) The account’s token to authorize logins using the OAuth authorization protocol.
Login Details: Password: (All ad networks except Naver) The password for the account. For password-enabled accounts on Microsoft Advertising, Yahoo! Japan Ads, and Yandex, this field is required. For oAuth-enabled accounts, this field is optional; use it when you want to encrypt and save the password so that the account manager can refresh tokens as needed.
Login Details: Access Key: (Yandex accounts only) The access key for the developer account to be used.
Currency: The abbreviation for the currency used for the account. This field is editable for new Naver accounts. For all other search networks, the value is filled automatically with the currency configured for the account on the ad network once you save the record.
Landing Page Suffix (Google Ads and Microsoft Advertising accounts only; optional) Any parameters to append to the end of final URLs to track information; include all parameters that your business must track.
Example: param1=value1¶m2=value2
Accounts that use Adobe Advertising click tracking must include the ad network’s click identifier (msclkid
for Microsoft Advertising; gclid
for Google) in the suffix. Accounts with an Adobe Analytics integration must use the AMO ID parameter (beginning with s_kwcid
). If the account has a server-side AMO ID implementation, then the parameter is added automatically when a user clicks an ad; otherwise, you must manually add it here. See the required suffix formats for Google Ads and required suffix formats for Microsoft Advertising.
- This field isn’t updated by the Auto Upload tracking setting.
- Final URL suffixes at lower levels override the account-level suffix. For easier maintenance, use only the account-level suffix unless different tracking for individual account components is necessary. To configure a suffix at the ad group level or lower, use the ad network’s editor.
Time Zone: (All ad networks except for Baidu and Yahoo! Display Network) The advertiser’s time zone. This field is editable and optional for new Naver accounts. For all other search networks, the value is filled automatically with the time zone configured for the advertiser’s Search, Social, & Commerce account once you save the record.
Status: The account status within Search, Social, & Commerce:
- Enabled: Search, Social, & Commerce synchronizes campaign data with the account (when supported) and pushes automated bids and/or campaign budgets for campaigns in portfolios.
- Disabled: Search, Social, & Commerce stops all activity on the account. Data collected while the account was active is still stored, but the campaign management views and reports don’t include data for the time period in which the account is paused. You can later re-activate the account to resume activity with the account.
Tracking Template - (Google Ads, Microsoft Advertising, and Yahoo! Japan Ads accounts only; optional) The default tracking template for the account, which specifies all off-landing domain redirects and tracking parameters and also embeds the final/landing page URL in a parameter. Example: {lpurl}?source={network}&id=5
or http://www.trackingservice.example.com/?url={lpurl}?source={network}&id=5
to include a redirect.
-
To embed the final URL:
-
(Google Ads and Microsoft Advertising only) For a list of parameters to indicate final URLs in tracking templates, see the (Microsoft Advertising only) Microsoft Advertising documentation or (Google Ads only) the “Tracking template only” parameters in the section on “Available ValueTrack Parameters” in the Google Ads documentation.
-
(Yahoo! Japan Ads only) Use the parameter
!{lpurl}
to indicate the landing page URL.
-
-
You can optionally include URL parameters and any custom parameters defined for the campaign, separated by ampersands (&), such as
{lpurl}?matchtype={matchtype}&device={device}
. -
You can optionally add third-party redirects and tracking.
-
When the campaign settings include “EF Redirect” and “Auto Upload,” Search, Social, & Commerce automatically prefixes its own redirect and tracking code when you save the record.
- For Google Ads, avoid using macros, which aren’t substituted for clicks from sources that enable parallel tracking. If the advertiser must use macros, the Adobe Account Team should work with Customer Support or the implementation team to add them.
- The tracking template at the most granular level overrides the values at all higher levels. For example, if both the account settings and the keyword settings include a value, then the keyword value is applied.
- If you update a tracking template at the ad, sitelink, or keyword level, then the relevant ads are resubmitted for review. You can update your tracking templates at the account, campaign, or ad group levels without resubmitting your ads for approval.
Master Account ID: (Microsoft Advertising accounts only) The ID for an agency/management account associated with the account.
MCC Account: (Yandex accounts only; optional) An agency/management account associated with the account. To remove an existing association, select “No MCC Account.”
Application ID: (Yandex accounts only) The developer token to use for the account. The same token is used for all Yandex accounts.
Purse Campaign ID: (Yandex accounts with the Shared Account setting disabled only; optional) The numeric ID for the campaign used to pay for all ad campaigns in the account.
Finance Token: (Yandex accounts with the Shared Account setting disabled only; optional) The developer token to use for finance-related API calls, such as for reallocating money from the wallet between the advertiser’s campaigns as necessary for portfolio optimization.
Account Tracking
Tracking Type: The method by which URLs are generated:
-
EF Redirect (the default): For clients who want to use the Adobe Advertising conversion tracking service. This method generates unique click-tracking IDs and redirects users to the Adobe Advertising server for tracking purposes before sending them to the client’s landing page.
This method has default tracking options that you optionally can customize, and you also can specify parameters to append to each URL.
-
No EF Redirect: For clients who want to use only their own click-tracking codes. Search, Social, & Commerce doesn’t provide click-tracking IDs or redirect codes. For accounts with destination URLs, each destination URL is the same as the base URL.
Notes:
- Only agency account manager, Adobe account manager, and administrator users can change this value.
- If you change the tracking method, you must regenerate tracking URLs for the account.
- Campaign-level tracking options override account-level settings.
Redirect Type: (For EF Redirect only) The method of redirecting end users to the final URL or destination URL. The selected option is applicable to all ads, keywords, and placements in the account or campaign. The default account-level setting is inherited from the advertiser’s tracking settings, and the default campaign-level setting is inherited from the account settings.
-
Standard: To just redirect the end user to the specified URL.
-
Token: To redirect the end user to the URL and also record the Search, Social, & Commerce ID for the click (
ef_id
) as a query string parameter, which is used as a token. Choose this option if you will report offline transactions, want Search, Social, & Commerce to exchange data with Adobe Analytics, or want to track all conversions that occur within Apple Safari browsers.
Notes:
- If you switch from Standard to Token, or vice versa, then you must regenerate tracking URLs for the account.
- You can override the account-level setting at the campaign level.
Auto Upload: (For synchronized campaigns with EF Redirect only) Automatically uploads the following to the ad network the next time Search, Social, & Commerce synchronizes with it: (a) Search, Social, & Commerce tracking parameters for tracking templates and the same parameters appended to the final URLs or (b) new destination URLs embedded with Search, Social, & Commerce tracking code. For advertisers with an Adobe Advertising-Adobe Analytics integration and a server-side AMO ID (s_kwcid) configuration, the upload also includes AMO ID parameters for your Google Ads and Microsoft Advertising accounts. The default account-level setting is inherited from the advertiser’s tracking settings. You can override the account-level setting at the campaign level.
Note: Tracking URLs are updated daily only for entities that are out of sync (that is, new entities that were added and existing entities whose properties have changed). Therefore, if you change this setting from disabled to enabled for an existing advertiser/account/campaign, then tracking URLs aren’t updated for existing entities that are already in sync. To add tracking to the URLs of existing, in-sync entities, contact your Adobe Account Team and request a one-time, manual sync process. The automatic upload process will handle future changes.
Encode Base URL: (Accounts with destination URLs and the tracking type EF Redirect only) Whether the URL within the end user’s browser address bar includes character encoding (such as %3D
instead of =
):
-
On (the default): To show character encoding in URLs.
-
Off: To show unencoded URLs.
Tracking Level: (For EF Redirect only; available at the account and campaign levels; not applicable to ad networks that are enabled for parallel tracking) The level at which clicks and revenue should be tracked by adding a redirect (when relevant) and append parameters to the relevant URLs:
-
Keyword: To track data at only the keyword level.
-
Ad: To track data at only the ad level.
Note: Changing an existing campaign to this setting deletes any existing keyword tracking IDs. Also, if you want to perform multivariate testing by using multiple landing pages for an ad, then create a bulksheet file and edit it for the required components.
-
Keyword and Ad: To track data at both the keyword and ad levels.
Notes:
- Only “Keyword” is available for Naver.
- Only “Ad” is available for Yandex.
Track Product Group: (For EF Redirect only) Not implemented
Append Parameters: (Optional) Any additional tracking parameters to append to the base URLs.. The advertiser-level append parameters are included by default at the account level and the campaign level, but you can override either.
You can use any static text string, including third-party tracking parameters, or any of the supported tracking parameters, which insert an appropriate data value in the base URL.
Separate multiple parameters with commas or ampersands (&). Nested brackets aren’t supported.
Notes:
-
Changes to append parameters aren’t controlled by the Auto Upload option. If you change the append parameters for existing base URLs, then new URLs aren’t generated automatically. Add the new parameters by downloading a bulksheet file for the account or campaign, updating the Base URL/Final URL fields, and then uploading and posting the bulksheet.
-
(Ad networks with parallel tracking) Avoid using macros, which aren’t substituted for clicks from sources that enable parallel tracking. If the advertiser must use macros, then the Adobe Account Team should work with Customer Support or the implementation team to add them.
-
(Advertisers with an Adobe Advertising-Adobe Analytics integration) To include an AMO ID parameter to send Search, Social, & Commerce data to Analytics, see the ad network-specific formats. It’s not necessary to manually add the parameter for Google Ads and Microsoft Advertising accounts with a server-side AMO ID implementation.
-
S_kwcid Format: (Existing Google Ads accounts for advertisers with an Adobe Advertising-Adobe Analytics integration and for which the AMO ID (s_kwcid) hasn’t already been migrated)
This account uses the legacy format for the AMO ID tracking code, which allows Adobe Advertising to share data about the account with Adobe Analytics. The latest format includes parameters for campaign ID and ad group ID, which are necessary to accurately report at the campaign and ad group levels for Google Ads performance max campaigns and drafts and experiments campaigns in Analytics:
s_kwcid=AL!{userid}!3!{creative}!{matchtype}!{placement}!{network}!{product_partition_id}!{keyword}!{campaignid}!{adgroupid}
If this account needs to report at the campaign and ad group levels, then click the Edit (pencil) icon and then Migrate to new s_kwcid format to change to the new format. For accounts that don’t include these campaign types, migrating to the new format is optional but recommended.
For full instructions, see “Update the AMO ID tracking code for a Google Ads account.”
Report Suite Names: (For EF Redirect with token only; advertisers with an Adobe Advertising-Adobe Analytics integration; optional) One or more Analytics report suites to which Search, Social, & Commerce sends data it collects from the ad network, including entity classifications and click data for the account. This feature is available only to supported ad networks.
For the data to appear in the report suites, either (a) the server-side AMO ID feature must be configured for the account or (b) the advertiser-level setting to “Enable tracking for SAINT feeds” must be enabled. In addition, the advertiser’s Analytics account must be configured to receive data from Search, Social, & Commerce. For more information, contact your Adobe Account Team.