{"title":"Donation campaigns","category":"default","creationDate":1631710800,"content":"<div class=\"additional-info-block output-inline\">\n<h5 class=\"article__heading additional-info-block__title\">Read more<\/h5><div class=\"additional-info-block__body\"><p><img style=\"width: 28px;\" alt=\"\" src=\"\/user\/pages\/docs\/11.reporting\/17.donation-campaigns\/giving.svg?decoding=auto&amp;fetchpriority=auto\" \/>&nbsp;Learn more about <a href=\"https:\/\/www.adyen.com\/giving\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Adyen Giving on adyen.com<\/a>.<\/p><\/div><\/div>\n\n<p>When processing donations with Adyen Giving, you can monitor, analyze, share insights, and optimize the impact of donations. Use the <a href=\"#campaign-insights\">Campaign dashboard<\/a> and generate the <a href=\"#processed-donations-report\">Processed Donations Report<\/a> to find detailed information on the performance of your donation campaigns.<\/p>\n<p>If you are a nonprofit that is receiving donations, you can generate the <a href=\"#received-donations-report\">Received Donations Report<\/a> to get an overview of the donations that you received raised by each <a href=\"\/pt\/account\/account-structure\/\">Adyen company account<\/a>.<\/p>\n<h2>Prerequisites<\/h2>\n<p>To view the report and the dashboard, you must first <a href=\"\/pt\/online-payments\/donations\">set up campaigns in your Customer Area<\/a>.<\/p>\n<p>The following table shows which <a href=\"\/pt\/account\/user-roles\">user roles<\/a> are required for which actions:<\/p>\n<table>\n<thead>\n<tr>\n<th>User actions<\/th>\n<th>User roles<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>View campaigns, access campaign insights, and generate Processed Donations Report<\/td>\n<td>Donation Campaigns Viewer<\/td>\n<\/tr>\n<tr>\n<td>Manage campaigns, access campaign insights, and generate Processed Donations Report<\/td>\n<td>Donation Campaigns Manager<\/td>\n<\/tr>\n<tr>\n<td>Generate Received Donations Report<\/td>\n<td>Merchant financial<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>These user roles do not give access to any other payment information.<\/p>\n<h2 id=\"campaign-insights\">Campaign insights dashboard<\/h2>\n<p>Each active or past campaign has its own Campaign insights dashboard that shows its performance. It shows online and in-store performance, and includes a breakdown per shopper location.<\/p>\n<div class=\"notices green\">\n<p>The information on the dashboard is not real-time. It can take up to four hours for a donation to show up on the dashboard. For real-time information, we recommend that you <a href=\"\/pt\/development-resources\/webhooks\/webhook-types\/#other-webhooks\">listen to <strong>DONATION<\/strong> webhooks<\/a>.<\/p>\n<\/div>\n<p>In your <a href=\"https:\/\/ca-live.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>:<\/p>\n<ol>\n<li>Go to <strong>Giving<\/strong> &gt; <strong>Campaigns<\/strong>.<\/li>\n<li>In the box for the specific campaign, select <strong>See campaign insights<\/strong>.<\/li>\n<\/ol>\n<p>You can filter the data in the dashboard. For example, you can filter by the following:<\/p>\n<ul>\n<li>Date range<\/li>\n<li>Processing currency<\/li>\n<li>Merchant account<\/li>\n<li>Shopper location<\/li>\n<li>Donation channel<\/li>\n<\/ul>\n<h2 id=\"processed-donations-report\">Processed Donations Report<\/h2>\n<p>The Processed Donations Report gives you a granular perspective on donations. This report is a line-item report of individual processed donations from your account, allowing you analyze and report on all donation activity on your account.<\/p>\n<p>You can download it in the following formats:<\/p>\n<ul>\n<li>Comma-Separated Values (<code>.CSV<\/code>)<\/li>\n<li>Excel (<code>.XLS<\/code> or <code>.XLSX<\/code>)<\/li>\n<\/ul>\n<h3>Report generation and availability<\/h3>\n<p><strong>Generating and downloading<\/strong>: Get this report <a href=\"\/pt\/reporting\/manually-get-reports\">manually<\/a> or <a href=\"\/pt\/reporting\/automatically-get-reports\">automatically<\/a>.<\/p>\n<p><strong>Time zone<\/strong>: The <a href=\"\/pt\/reporting\/time-zone-setting\">time zone setting<\/a> of your account.<\/p>\n<p><strong>Date range<\/strong>: Select the date range of data included when you generate the report in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/p>\n<p><strong>Availability<\/strong>: Only available for <a href=\"\/pt\/account\/account-structure#company-account\">company accounts<\/a>.<\/p>\n<h3 id=\"report-structure\">Report structure<\/h3>\n<h4 id=\"entries\">Entries<\/h4>\n<p>Under the header line, each line in the report is a separate entry.<\/p>\n<p>Each entry is a line-item that represents a single donation settled to the nonprofit. No data is aggregated in this report.<\/p>\n<h4 id=\"columns\">Columns<\/h4>\n<p>Each column shows specific information about the entries.<\/p>\n<h5 id=\"standard-columns\">Standard columns<\/h5>\n<div class=\"sticky-table-container\">\n    \n<table>\n<thead>\n<tr>\n<th><\/th>\n<th>Column name<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>Company account<\/td>\n<td>The name of the company account from which the donation was offered.<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>Merchant account<\/td>\n<td>The name of the merchant account from which the donation was offered.<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>Store ID<\/td>\n<td>For in-person donations, the <a href=\"\/pt\/point-of-sale\/design-your-integration\/determine-account-structure\/automate-store-management\/#store-identification\">store reference<\/a>.<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>Terminal number<\/td>\n<td>For in-person donations, the <a href=\"\/pt\/point-of-sale\/design-your-integration\/terminal-api\/#get-the-terminal-id\">unique terminal identifier<\/a>.<\/td>\n<\/tr>\n<tr>\n<td>5<\/td>\n<td>Donation account<\/td>\n<td>The nonprofit account to which the donation was settled. (Only for Giving integrations not using Campaign Manager.)<\/td>\n<\/tr>\n<tr>\n<td>6<\/td>\n<td>Campaign name<\/td>\n<td>The name of the campaign.<\/td>\n<\/tr>\n<tr>\n<td>7<\/td>\n<td>Campaign ID<\/td>\n<td>The unique identifier of the campaign.<\/td>\n<\/tr>\n<tr>\n<td>8<\/td>\n<td>Nonprofit name<\/td>\n<td>The name of the nonprofit.<\/td>\n<\/tr>\n<tr>\n<td>9<\/td>\n<td>Cause name<\/td>\n<td>The name of the donation cause.<\/td>\n<\/tr>\n<tr>\n<td>10<\/td>\n<td>Donation origin country<\/td>\n<td>The country where the shopper made the donation from. <br> In-person payments: the store country. <br> Online payments: the shopper's IP address.<\/td>\n<\/tr>\n<tr>\n<td>11<\/td>\n<td>PSP reference<\/td>\n<td>Our unique reference for the donation.<\/td>\n<\/tr>\n<tr>\n<td>12<\/td>\n<td>Payment method<\/td>\n<td>The payment method used to donate.<\/td>\n<\/tr>\n<tr>\n<td>13<\/td>\n<td>Creation date (AMS time)<\/td>\n<td>The timestamp of the donation in the <a href=\"https:\/\/en.wikipedia.org\/wiki\/Central_European_Time\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">CET time zone<\/a>.<\/td>\n<\/tr>\n<tr>\n<td>14<\/td>\n<td>Donation channel<\/td>\n<td>The donation channel. Possible values: <strong>Instore<\/strong> or <strong>Ecommerce<\/strong><\/td>\n<\/tr>\n<tr>\n<td>15<\/td>\n<td>Type<\/td>\n<td>The type of donation settlement.<\/td>\n<\/tr>\n<tr>\n<td>16<\/td>\n<td>Currency<\/td>\n<td>The currency used to process the donation.<\/td>\n<\/tr>\n<tr>\n<td>17<\/td>\n<td>Amount<\/td>\n<td>The donation amount, in the donation currency.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<\/div>\n\n<h2>Received Donations Report<\/h2>\n<div class=\"notices green\">\n<p>The Received Donations Report can only be generated and viewed by nonprofits.<\/p>\n<\/div>\n<p>The Received Donations Report is an aggregated overview of the donation amounts that were paid out to you. You can use this report to reconcile the funds raised by donation campaigns by each Adyen company account and the countries\/regions from where the donations were received.<\/p>\n<p>You can download it in the following formats:<\/p>\n<ul>\n<li>Comma-Separated Values (<code>.CSV<\/code>)<\/li>\n<li>Excel (<code>.XLS<\/code> or <code>.XLSX<\/code>)<\/li>\n<\/ul>\n<h3>Report generation and availability<\/h3>\n<p><strong>Generating and downloading<\/strong>: Get this report <a href=\"\/pt\/reporting\/manually-get-reports\">manually<\/a> or <a href=\"\/pt\/reporting\/automatically-get-reports\">automatically<\/a>.<\/p>\n<p><strong>Time zone<\/strong>: The <a href=\"\/pt\/reporting\/time-zone-setting\">time zone setting<\/a> of your account.<\/p>\n<p><strong>Date range<\/strong>: Select the date range of data included when you generate the report in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/p>\n<p><strong>Availability<\/strong>: Only available for <a href=\"\/pt\/account\/account-structure#company-account\">company accounts<\/a>.<\/p>\n<h3 id=\"report-structure\">Report structure<\/h3>\n<h4 id=\"entries\">Entries<\/h4>\n<p>Under the header line, each line in the report is a separate entry.<\/p>\n<p>Each entry is a line-item that summarizes donation data grouped by donation attributes.<\/p>\n<h4 id=\"columns\">Columns<\/h4>\n<p>Each column shows specific information about the entries.<\/p>\n<h5 id=\"standard-columns\">Standard columns<\/h5>\n<div class=\"sticky-table-container\">\n    \n<table>\n<thead>\n<tr>\n<th><\/th>\n<th>Column name<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>Company account<\/td>\n<td>The name of the company account from which the donation was offered.<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>Donation origin country<\/td>\n<td>The country from which the shopper made the donation. <br> In-person payments: the store country. <br> Online payments: the shopper's IP address.<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>Type<\/td>\n<td>The <a href=\"\/pt\/reporting\/settlement-reconciliation\/transaction-level\/settlement-details-report\/#journal-types\">journal type<\/a> of the donation settlement.<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>Total count<\/td>\n<td>The total count of transactions in the line-item that summarizes donations grouped by donation attributes.<\/td>\n<\/tr>\n<tr>\n<td>5<\/td>\n<td>Gross Currency<\/td>\n<td>The three-character <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_4217\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">ISO currency code<\/a> for the currency in which the donation transaction was initiated.<\/td>\n<\/tr>\n<tr>\n<td>6<\/td>\n<td>Gross Credit<\/td>\n<td>The amount received in the original donation currency.<\/td>\n<\/tr>\n<tr>\n<td>7<\/td>\n<td>Gross Debit<\/td>\n<td>The amount debited in the original donation transaction currency.<\/td>\n<\/tr>\n<tr>\n<td>8<\/td>\n<td>Exchange Rate<\/td>\n<td>The exchange rate used for converting the gross amount into the net amount. This will be 1 if the currency used to initiate the donation transaction is the same as the currency you settle donations.<\/td>\n<\/tr>\n<tr>\n<td>9<\/td>\n<td>Net Currency<\/td>\n<td>The three-character <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_4217\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">ISO currency code<\/a> for the settlement currency.<\/td>\n<\/tr>\n<tr>\n<td>10<\/td>\n<td>Net Credit<\/td>\n<td>The amount submitted in the donation transaction request minus transaction costs and fees.<\/td>\n<\/tr>\n<tr>\n<td>11<\/td>\n<td>Net Debit<\/td>\n<td>The amount debited in the donation settlement currency.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<\/div>\n\n<h2 id=\"configure-report-columns\">Configure report columns<\/h2>\n<p>If you want to add additional columns or change the order of columns in a report, you can do so in the <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>. If you have an automated system that uses the report's data, configuring the report columns can affect your automated system.<\/p>\n<p>To configure report columns, you need to have one of the following <a href=\"\/pt\/account\/user-roles\">user roles<\/a>:<\/p>\n<ul>\n<li>Merchant admin<\/li>\n<li>Merchant report role<\/li>\n<li>Merchant financial<\/li>\n<li>Merchant POS Report role<\/li>\n<\/ul>\n<p>To configure report columns:<\/p>\n<ol>\n<li>Log in to your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/li>\n<li>Go to <strong>Settings<\/strong> &gt; <strong>Report columns<\/strong>.<br \/>\nThis opens a page with all the reports that you can configure.<\/li>\n<li>Find the report that you want to configure and select <strong>Configure<\/strong>.<\/li>\n<li>Select checkboxes to indicate which columns you want to include in the report.<\/li>\n<li>Drag the columns into the order you want them to appear in.<\/li>\n<li>Select <strong>Save configuration<\/strong>.<\/li>\n<\/ol>\n<h2 id=\"see-also-giving\">See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/online-payments\/donations\/\"\n                        target=\"_self\"\n                        >\n                    Donations using Giving (Online payments)\n                <\/a><\/li><li><a href=\"\/point-of-sale\/donate\/\"\n                        target=\"_self\"\n                        >\n                    Donations using Giving (In-person payments)\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/reporting\/donation-campaigns","articleFields":{"description":"Get insights on your donation campaigns using our dashboard and report.","feedback_component":true,"parameters":{"report_name":"Giving report","additional_columns":"false","ca_type":"ca","automatic":"yes","dates":"range","company_level":"only"},"last_edit_on":"15-09-2021 15:00"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/reporting\/donation-campaigns","title":"Donation campaigns","content":"\nRead more&nbsp;Learn more about Adyen Giving on adyen.com.\n\nWhen processing donations with Adyen Giving, you can monitor, analyze, share insights, and optimize the impact of donations. Use the Campaign dashboard and generate the Processed Donations Report to find detailed information on the performance of your donation campaigns.\nIf you are a nonprofit that is receiving donations, you can generate the Received Donations Report to get an overview of the donations that you received raised by each Adyen company account.\nPrerequisites\nTo view the report and the dashboard, you must first set up campaigns in your Customer Area.\nThe following table shows which user roles are required for which actions:\n\n\n\nUser actions\nUser roles\n\n\n\n\nView campaigns, access campaign insights, and generate Processed Donations Report\nDonation Campaigns Viewer\n\n\nManage campaigns, access campaign insights, and generate Processed Donations Report\nDonation Campaigns Manager\n\n\nGenerate Received Donations Report\nMerchant financial\n\n\n\nThese user roles do not give access to any other payment information.\nCampaign insights dashboard\nEach active or past campaign has its own Campaign insights dashboard that shows its performance. It shows online and in-store performance, and includes a breakdown per shopper location.\n\nThe information on the dashboard is not real-time. It can take up to four hours for a donation to show up on the dashboard. For real-time information, we recommend that you listen to DONATION webhooks.\n\nIn your Customer Area:\n\nGo to Giving &gt; Campaigns.\nIn the box for the specific campaign, select See campaign insights.\n\nYou can filter the data in the dashboard. For example, you can filter by the following:\n\nDate range\nProcessing currency\nMerchant account\nShopper location\nDonation channel\n\nProcessed Donations Report\nThe Processed Donations Report gives you a granular perspective on donations. This report is a line-item report of individual processed donations from your account, allowing you analyze and report on all donation activity on your account.\nYou can download it in the following formats:\n\nComma-Separated Values (.CSV)\nExcel (.XLS or .XLSX)\n\nReport generation and availability\nGenerating and downloading: Get this report manually or automatically.\nTime zone: The time zone setting of your account.\nDate range: Select the date range of data included when you generate the report in your Customer Area.\nAvailability: Only available for company accounts.\nReport structure\nEntries\nUnder the header line, each line in the report is a separate entry.\nEach entry is a line-item that represents a single donation settled to the nonprofit. No data is aggregated in this report.\nColumns\nEach column shows specific information about the entries.\nStandard columns\n\n    \n\n\n\n\nColumn name\nDescription\n\n\n\n\n1\nCompany account\nThe name of the company account from which the donation was offered.\n\n\n2\nMerchant account\nThe name of the merchant account from which the donation was offered.\n\n\n3\nStore ID\nFor in-person donations, the store reference.\n\n\n4\nTerminal number\nFor in-person donations, the unique terminal identifier.\n\n\n5\nDonation account\nThe nonprofit account to which the donation was settled. (Only for Giving integrations not using Campaign Manager.)\n\n\n6\nCampaign name\nThe name of the campaign.\n\n\n7\nCampaign ID\nThe unique identifier of the campaign.\n\n\n8\nNonprofit name\nThe name of the nonprofit.\n\n\n9\nCause name\nThe name of the donation cause.\n\n\n10\nDonation origin country\nThe country where the shopper made the donation from.  In-person payments: the store country.  Online payments: the shopper's IP address.\n\n\n11\nPSP reference\nOur unique reference for the donation.\n\n\n12\nPayment method\nThe payment method used to donate.\n\n\n13\nCreation date (AMS time)\nThe timestamp of the donation in the CET time zone.\n\n\n14\nDonation channel\nThe donation channel. Possible values: Instore or Ecommerce\n\n\n15\nType\nThe type of donation settlement.\n\n\n16\nCurrency\nThe currency used to process the donation.\n\n\n17\nAmount\nThe donation amount, in the donation currency.\n\n\n\n\n\n\nReceived Donations Report\n\nThe Received Donations Report can only be generated and viewed by nonprofits.\n\nThe Received Donations Report is an aggregated overview of the donation amounts that were paid out to you. You can use this report to reconcile the funds raised by donation campaigns by each Adyen company account and the countries\/regions from where the donations were received.\nYou can download it in the following formats:\n\nComma-Separated Values (.CSV)\nExcel (.XLS or .XLSX)\n\nReport generation and availability\nGenerating and downloading: Get this report manually or automatically.\nTime zone: The time zone setting of your account.\nDate range: Select the date range of data included when you generate the report in your Customer Area.\nAvailability: Only available for company accounts.\nReport structure\nEntries\nUnder the header line, each line in the report is a separate entry.\nEach entry is a line-item that summarizes donation data grouped by donation attributes.\nColumns\nEach column shows specific information about the entries.\nStandard columns\n\n    \n\n\n\n\nColumn name\nDescription\n\n\n\n\n1\nCompany account\nThe name of the company account from which the donation was offered.\n\n\n2\nDonation origin country\nThe country from which the shopper made the donation.  In-person payments: the store country.  Online payments: the shopper's IP address.\n\n\n3\nType\nThe journal type of the donation settlement.\n\n\n4\nTotal count\nThe total count of transactions in the line-item that summarizes donations grouped by donation attributes.\n\n\n5\nGross Currency\nThe three-character ISO currency code for the currency in which the donation transaction was initiated.\n\n\n6\nGross Credit\nThe amount received in the original donation currency.\n\n\n7\nGross Debit\nThe amount debited in the original donation transaction currency.\n\n\n8\nExchange Rate\nThe exchange rate used for converting the gross amount into the net amount. This will be 1 if the currency used to initiate the donation transaction is the same as the currency you settle donations.\n\n\n9\nNet Currency\nThe three-character ISO currency code for the settlement currency.\n\n\n10\nNet Credit\nThe amount submitted in the donation transaction request minus transaction costs and fees.\n\n\n11\nNet Debit\nThe amount debited in the donation settlement currency.\n\n\n\n\n\n\nConfigure report columns\nIf you want to add additional columns or change the order of columns in a report, you can do so in the Customer Area. If you have an automated system that uses the report's data, configuring the report columns can affect your automated system.\nTo configure report columns, you need to have one of the following user roles:\n\nMerchant admin\nMerchant report role\nMerchant financial\nMerchant POS Report role\n\nTo configure report columns:\n\nLog in to your Customer Area.\nGo to Settings &gt; Report columns.\nThis opens a page with all the reports that you can configure.\nFind the report that you want to configure and select Configure.\nSelect checkboxes to indicate which columns you want to include in the report.\nDrag the columns into the order you want them to appear in.\nSelect Save configuration.\n\nSee also\n\n\n                    Donations using Giving (Online payments)\n                \n                    Donations using Giving (In-person payments)\n                \n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Reporting","lvl2":"Donation campaigns"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/reporting","lvl2":"\/pt\/reporting\/donation-campaigns"},"levels":3,"category":"Reporting","category_color":"green","tags":["Donation","campaigns"]},"articleFiles":{"giving.svg":"<img style=\"width: 28px;\" alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/11.reporting\/17.donation-campaigns\/giving.svg?decoding=auto&amp;fetchpriority=auto\" \/>"}}
