Yahoo! JAPAN Ads API | Developer Center

2023/08/30

MCC account settings will be available for multiple-level structure

Updates

• August 30, 2023: We completed this release.
• August 21, 2023: We corrected the runtime version to be limited to sending notifications when using Yahoo! JAPAN Ads Script from v11 to V202306.

• August 18, 2023: We updated the following information.

  • Impacts on the scheduled date

  • Changes to account access from "Read-only" to "Share library only"

  • Available notifications you can send when using Yahoo! JAPAN Ads Script will be limited

  • Impacts of account transfer

  • We added notes for Yahoo! JAPAN Ads API users

• July 27, 2023: We updated the following information.

  • Schedule

  • The maximum number of levels available for MCC accounts

  • About URLs in past notifications

  • About the time when the pages are not available on the scheduled date

  • Notes for Yahoo! JAPAN Ads API users

• June 28, 2023: We published this article.

Products

Yahoo! JAPAN Ads Search Ads
Yahoo! JAPAN Ads Display Ads

Tools

Campaign Management Tool
Campaign Editor

Date

August 30, 2023

Summary

The MCC account feature for Yahoo! JAPAN Ads supports a multiple-level structure. You can set up to five levels of MCC accounts, including the root MCC. See the "Root MCC" section for more information (updated on July 27, 2023).

(Before) You can only create ad accounts under MCC accounts.
(After) You can create ad accounts and MCC accounts under MCC accounts.

Additionally, we made the following improvements:

Required account selection when signing into the Campaign Management Tool
Root MCC
Changes in access when linking ad accounts with other companies
Other updates

This improvement simplifies account access for your company and for other companies. You can expect greater efficiency and convenience in access management.

Required account selection when signing into the Campaign Management Tool

Account selection is required when signing into the Campaign Management Tool.
When a user signs in, all MCC accounts and ad accounts that the person has access to will appear.

Sample image for account selection

After selecting an account, a user can use the account and its sub-accounts.
The same access applies to all accounts and their sub-accounts.
You can change your account selection anytime using the Campaign Management Tool.
Learn more about Account selection and access applied.

Root MCC

The root MCC is the top-level MCC account for all MCCs and ad accounts under the company.
The root MCC is created per company, and only the company's "Tool administrator" has "Admin" access to the root MCC. By selecting the root MCC from the list of accounts, you can manage all accounts under the company with "Admin" access.
Learn more about What is MCC account.

Changes in access when linking ad accounts with other companies

The following settings and values of MCC account access to link accounts with other companies changed.

The system migrated the "Permitted actions" values to the "Account link purpose" values.
Depending on your settings, access to other companies' ad accounts changed, so you may need to review your settings.
Learn more in the PDF document

Learn more About associations (account links) between MCC and ad accounts.

■When setting up an account link with an existing account within the same company

The existing method of "Account-link request → Accept" ended.
To set up an account link to an existing account within the same company, use the new feature to switch accounts. This feature doesn't require multiple steps of "Request" and "Accept" from the previous method, making it simpler.
Learn more about Change account link in the same company.

■ (Updated on August 18, 2023) Changes to account access from "Read-only" to "Share library only"

We changed the settings from "Read-only" to "Share library only" starting at around 18:00 on August 28, 2023, in JST.
You can't view the accounts linked using "Read-only" access from the original account. ("Share library only" doesn't have access to view the original account).

Other updates

■The URL of the Campaign Management Tool changed when you select an account.

If you have bookmarked the URL of the Campaign Management Tool with a specific account selected, update the URL.

■The account list view is longer available.
Due to the specification change, the "Accounts" view is no longer available.

To check the performance data of each account, sign into the Campaign Management Tool, select an account, then refer to the account data. The first view that appears after you select an account will show the account and its sub-account data.

To view hidden accounts, select an account or an upper-level MCC account again. You may need to review your account structure to view a list like the one that ended. Learn more

■Giving "Admin" access to users of other companies is available.

Users of other companies can't take actions related to billing and payments (make payments, register and view bank accounts, etc.).

■(Updated on August 18, 2023) Available notifications you can send when using Yahoo! JAPAN Ads Script is limited.

When using runtimes before "V202306," the available notifications you can send after setting up multi-level structures for MCC accounts is limited to the following Yahoo! JAPAN Business IDs (Business IDs):
・Business ID for the tool admin
・Business ID for the accounts that are associated with the scripts and are invited directly to ad accounts
・Business IDs directly invited to the MCC accounts linked to the ad accounts associated with the scripts.

Associating multiple MCC accounts with an ad account in the same company ended.

After July 2023, the settings that associate multiple MCC accounts in the same company with an ad account became unavailable.
Setting up new associations is no longer available after February 2023. Learn more

*You can associate only one MCC account with an ad account within the same company. You can continue associating up to five MCC accounts with an ad account, as long as they are not MCC accounts for the same company.

About Yahoo! JAPAN Ads API

The Yahoo! JAPAN Ads API will support multiple-level structures for MCC accounts in the next version (it won't support this feature in v11 and earlier versions).
Use the supported version when using multiple-level structures for MCC accounts in Yahoo! JAPAN Ads API.
Wait for more details for further announcements.

■Notes for Yahoo! JAPAN Ads API users (Updated on August 18, 2023)
We will make the following changes after applying the multiple-level structures for MCC accounts on August 29, 2023:

(1) AccountLinkService

• Affected versions: All versions (including the next and later versions)

• Changes: All responses to audienceListSharingEnabled (the flag indicating whether or not audience list sharing is an enabled link) when get is executed will return "UNKNOWN."

• Account link information won't return for the account link purpose "Library share only" when you run a "get" request for accounts directly under MCC accounts.

(2) AccountManagementService

• Affected versions: v11 and earlier

• Changes: The response when get is executed will be changed as follows.
  (Before) Accounts with the status CANCELED will be returned.
  (After) Accounts with the status CANCELED won't be returned.

(3) AccountService

• Affected versions: All versions (including the next and later versions)

• Changes:
  Account link information won't return for the account link purpose "Library share only" when you run a "get" request.

(4) If you apply multiple levels for MCC accounts using v11 or earlier, the available accounts for "Tool users" in AccountService, AccountLinkService, etc., will be limited to the following accounts:

[Available accounts for "Tool users"]

• Directly invited MCC accounts and ad accounts

• Ad accounts directly under the MCC accounts that are directly invited

*This limit doesn't apply to "Tool admin."

Comments

• (Updated on August 18, 2023) Pages in the Campaign Management Tools may not appear from 20:30 to 21:30 in JST on the scheduled date (Up to one hour).
  If you take the following actions from 18:00 to 21:30 in JST, it may take longer than usual for the data to be reflected:
  　・Set up account links
  　・Invite users
  　・Change your account name
  　・Confirm actions when creating an ad account
• (Updated on August 18, 2023) If you transfer accounts on August 1, 2023, the duration that the original company can view the transferred accounts is shorter.
  (Usual) First to last day of the month
  (Transfer on August 1) August 1-28, 2023
  When viewing reports and statements for accounts transferred by the original company, check them by August 28, 2023.
  *This change is due to the application of the MCC multiple-level structure. For transfers made on or after September 1, 2023, the "Read-only" access is given until the end of the month as usual.
• (Updated on July 27, 2023) If you click the URLs in the previous (before the change) notifications sent by the system after this change, you may see an account selection view or an error.
• Customers signed up online won't be able to use the multiple-level structures for their MCC accounts. Other features, except for the multiple-level structure, affect all customers.

• Download PDF document