{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","settings":"","results":{"codes":[]},"params":[]},"next":{"description":"","pages":[]},"title":"Common Ad Integration errors & solutions","type":"basic","slug":"common-facebook-errors","excerpt":"Integration errors when first connecting Attribution and ad channels","body":"[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"Where these errors come from!\",\n  \"body\": \"Attribution will pull ad errors from your connected ad accounts. There are typically three forms of errors: \\n\\n1. Errors on Attribution's side that may prevent the auto-tag\\n2. Errors related to the ads (they are inactive, or they have some pending FB/Google error that prevents Attribution from tagging) \\n3. Errors related to permissions. Usually these can be corrected by connecting a super admin account\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Manually tag your Facebook ads to override errors\",\n  \"body\": \"Scroll to the bottom!\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Facebook Ad errors\"\n}\n[/block]\nWhen you integrate Attribution and your ad channels, Attribution will attempt to auto-tag all of your ads via API and this may throw some errors. \n\nWhen connecting Facebook Ads some of your existing ads may fail to tag, there are number of reasons why that could happen:\n\n1) if you have Instagram connected to your Facebook Business Account and run ads manually you may still require Instagram access for your Facebook Ad Account. This is a common error that you can read more about below. \n\n2) Some ads cannot be updated once they are running and this will prevent Attribution's auto-tag. \n\n3) Facebook often changes requirements for ads, therefore ads are valid when created, but later when they are running Attribution can no longer tag the ads. This can happen rarely with linked content like pages, product assets, instagram stories and more. \n\nYou'll see a red indicator when there are errors related to any ad platform. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/0335f3b-Screen_Shot_2020-01-24_at_4.08.26_PM.png\",\n        \"Screen Shot 2020-01-24 at 4.08.26 PM.png\",\n        1440,\n        566,\n        \"#333\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Common errors & resolutions\"\n}\n[/block]\nOne common error is related to Instagram ads and permissions and it will appear as follows: \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/06aa43e-Screen_Shot_2020-01-24_at_4.09.33_PM.png\",\n        \"Screen Shot 2020-01-24 at 4.09.33 PM.png\",\n        1440,\n        550,\n        \"#333\"\n      ]\n    }\n  ]\n}\n[/block]\nThis error is usually due to Facebook's layered permissions. To fix this you'll want to be a super admin in Facebook and connect the Instagram account to the business manager. \n\nFirst there are some requirements to be aware of: \n\n1. To add an Instagram business account to your Business Manager, you must have the username and password for the account.\n\n2. The Instagram business account you’re trying to add can’t be owned by another business. \n\n3. Instagram business accounts can only be claimed by one Business Manager.\n\n4. Only admins can add Instagram business accounts in the Business Manager.\n\n5. If your Instagram business account is linked to a Facebook Page, you should add both your Facebook Page and Instagram business account to the same Business Manager. Learn how to add a Page to your Business Manager.\n\n6. To associate an ad account with an Instagram business account, the ad account and Instagram business account must already be in the same Business Manager. You can't associate ad accounts to Instagram business accounts in a different Business Manager.\n[block:api-header]\n{\n  \"title\": \"Correcting the Instagram permissions issue\"\n}\n[/block]\nAdd an Instagram account to your Business Manager\nTo add an Instagram account in your Business Manager:\n\nGo to [Business Settings](https://business.facebook.com/settings/).\nClick **Accounts.**\nClick **Instagram Accounts.**\nClick **+ Add.**\nEnter your Instagram username and password. **Click Next.**\nSelect the ad accounts and Pages you'd like to assign and click Next.\nOnce this is complete you should reconnect with Attribution app to see the permissions removed. \n\n[block:api-header]\n{\n  \"title\": \"Override Facebook errors by manually adding Facebook ad id\"\n}\n[/block]\nWith the exception of permissions issues, typically any errors thrown will be related to the ad itself rather than Attribution's tag. \n\nHowever, if you'd like you can also override ad manager and manually tag the facebook ad id for Attribution tracking. \n\nTo do this simply find your ad and add fbaid={{ad.id}} ideally in the **URL tag** section if possible. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/a15c7b9-Screen_Shot_2021-01-15_at_3.03.59_PM.png\",\n        \"Screen Shot 2021-01-15 at 3.03.59 PM.png\",\n        1440,\n        793,\n        \"#333\"\n      ]\n    }\n  ]\n}\n[/block]\nIf you have any questions please contact help:::at:::attributionapp.com","updates":[],"order":2,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"600192e5e66447006977cd62","createdAt":"2021-01-15T13:04:37.684Z","user":"560c92f2ac2859170013faa3","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"FAQ when installing","slug":"faq-when-installing","order":2,"from_sync":false,"reference":false,"_id":"600060c72dcd9d002fa13656","createdAt":"2021-01-14T15:18:31.879Z","version":"560c93ae7e9b9d0d00ca81a5","project":"560c93ad7e9b9d0d00ca81a2","__v":0},"version":{"version":"1.0","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["560c93af7e9b9d0d00ca81a6","560c9d9399bb5a0d0044f220","560d76d899bb5a0d0044f307","560d76ee1ec45619006069ed","560d86e099bb5a0d0044f32e","560dba80373c0e0d0024ff3b","57c722ecdf19130e001fba5d","57c743d1b6f94a2200659903","58995ec083f743190077bbe2","5fabfb070e9b0600424707dd","60004359deee820012dc1efc","600060c72dcd9d002fa13656","6001ac08c104fe002b933b7c","6009604d81b288001417df30","60097b7be8ec1e00334419f6","600aa98de28fae003a33108a","600aa9ee7d3e350018e7d6e4","601176819ca8c90011cfe6ac","606eef795bb7ed00790e9e68","609bf103a1334800624b7541"],"_id":"560c93ae7e9b9d0d00ca81a5","project":"560c93ad7e9b9d0d00ca81a2","createdAt":"2015-10-01T02:00:14.709Z","releaseDate":"2015-10-01T02:00:14.709Z","__v":20},"project":"560c93ad7e9b9d0d00ca81a2","__v":0,"parentDoc":null}

Common Ad Integration errors & solutions

Integration errors when first connecting Attribution and ad channels

[block:callout] { "type": "danger", "title": "Where these errors come from!", "body": "Attribution will pull ad errors from your connected ad accounts. There are typically three forms of errors: \n\n1. Errors on Attribution's side that may prevent the auto-tag\n2. Errors related to the ads (they are inactive, or they have some pending FB/Google error that prevents Attribution from tagging) \n3. Errors related to permissions. Usually these can be corrected by connecting a super admin account" } [/block] [block:callout] { "type": "warning", "title": "Manually tag your Facebook ads to override errors", "body": "Scroll to the bottom!" } [/block] [block:api-header] { "title": "Facebook Ad errors" } [/block] When you integrate Attribution and your ad channels, Attribution will attempt to auto-tag all of your ads via API and this may throw some errors. When connecting Facebook Ads some of your existing ads may fail to tag, there are number of reasons why that could happen: 1) if you have Instagram connected to your Facebook Business Account and run ads manually you may still require Instagram access for your Facebook Ad Account. This is a common error that you can read more about below. 2) Some ads cannot be updated once they are running and this will prevent Attribution's auto-tag. 3) Facebook often changes requirements for ads, therefore ads are valid when created, but later when they are running Attribution can no longer tag the ads. This can happen rarely with linked content like pages, product assets, instagram stories and more. You'll see a red indicator when there are errors related to any ad platform. [block:image] { "images": [ { "image": [ "https://files.readme.io/0335f3b-Screen_Shot_2020-01-24_at_4.08.26_PM.png", "Screen Shot 2020-01-24 at 4.08.26 PM.png", 1440, 566, "#333" ] } ] } [/block] [block:api-header] { "title": "Common errors & resolutions" } [/block] One common error is related to Instagram ads and permissions and it will appear as follows: [block:image] { "images": [ { "image": [ "https://files.readme.io/06aa43e-Screen_Shot_2020-01-24_at_4.09.33_PM.png", "Screen Shot 2020-01-24 at 4.09.33 PM.png", 1440, 550, "#333" ] } ] } [/block] This error is usually due to Facebook's layered permissions. To fix this you'll want to be a super admin in Facebook and connect the Instagram account to the business manager. First there are some requirements to be aware of: 1. To add an Instagram business account to your Business Manager, you must have the username and password for the account. 2. The Instagram business account you’re trying to add can’t be owned by another business. 3. Instagram business accounts can only be claimed by one Business Manager. 4. Only admins can add Instagram business accounts in the Business Manager. 5. If your Instagram business account is linked to a Facebook Page, you should add both your Facebook Page and Instagram business account to the same Business Manager. Learn how to add a Page to your Business Manager. 6. To associate an ad account with an Instagram business account, the ad account and Instagram business account must already be in the same Business Manager. You can't associate ad accounts to Instagram business accounts in a different Business Manager. [block:api-header] { "title": "Correcting the Instagram permissions issue" } [/block] Add an Instagram account to your Business Manager To add an Instagram account in your Business Manager: Go to [Business Settings](https://business.facebook.com/settings/). Click **Accounts.** Click **Instagram Accounts.** Click **+ Add.** Enter your Instagram username and password. **Click Next.** Select the ad accounts and Pages you'd like to assign and click Next. Once this is complete you should reconnect with Attribution app to see the permissions removed. [block:api-header] { "title": "Override Facebook errors by manually adding Facebook ad id" } [/block] With the exception of permissions issues, typically any errors thrown will be related to the ad itself rather than Attribution's tag. However, if you'd like you can also override ad manager and manually tag the facebook ad id for Attribution tracking. To do this simply find your ad and add fbaid={{ad.id}} ideally in the **URL tag** section if possible. [block:image] { "images": [ { "image": [ "https://files.readme.io/a15c7b9-Screen_Shot_2021-01-15_at_3.03.59_PM.png", "Screen Shot 2021-01-15 at 3.03.59 PM.png", 1440, 793, "#333" ] } ] } [/block] If you have any questions please contact [email protected]