Yahoo Japan Ads

Operations on Yahoo! JAPAN Ads

Overview

This node allows you to upload offline conversion data files to Yahoo! JAPAN Ads via their API. It is designed for scenarios where you need to import offline conversion events (such as in-store purchases or phone calls) that occurred outside of online tracking, enabling more accurate ad performance measurement and attribution within Yahoo! JAPAN Ads.

Common use cases:

Uploading CSV files containing offline conversions to Yahoo! JAPAN Ads.
Automating the process of syncing CRM or POS system data with your Yahoo! JAPAN Ads account.
Integrating offline sales data into your digital marketing reporting workflows.

Practical example:
A retail business exports daily in-store purchase data from its POS system, then uses this node to upload the data file to Yahoo! JAPAN Ads for improved campaign optimization.

Properties

Name	Type	Meaning
Account ID	String	The unique identifier of your Yahoo! JAPAN Ads account where the offline conversions will be uploaded.
Upload File Name	String	The name to assign to the uploaded file in Yahoo! JAPAN Ads.
Binary Property	String	The name of the binary property on the input item that contains the file data to upload. This must match the property holding your file's binary content.

Output

The output is a JSON object containing the response from Yahoo! JAPAN Ads API after uploading the file. The structure typically includes information about the upload status, such as success confirmation or error details.

If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message.

Example output:

[
  {
    "uploadJobId": "123456789",
    "status": "ACCEPTED"
  }
]

or, in case of error:

[
  {
    "error": "No binary data property \"data\" does not exists on item!"
  }
]

Dependencies

Yahoo! JAPAN Ads OAuth2 API credentials are required. You must configure these credentials in n8n under the name yahooJpAdsOAuth2Api.
The node relies on external libraries: axios for HTTP requests and form-data for file uploads.
No additional environment variables are needed beyond standard n8n credential configuration.

Troubleshooting

Common issues:

Missing Binary Data:
Error: No binary data property "<propertyName>" does not exists on item!
Resolution: Ensure the input item contains a binary property with the specified name (default is data). This property should hold the file you want to upload.
Invalid Credentials:
If authentication fails, check that your Yahoo! JAPAN Ads OAuth2 credentials are correctly set up in n8n.
API Errors:
Any errors returned by the Yahoo! JAPAN Ads API (e.g., invalid account ID, file format issues) will be passed through in the output. Review the error message for guidance.