[null,null,["上次更新時間:2025-08-31 (世界標準時間)。"],[[["\u003cp\u003eCampaign Manager 360's Conversions API allows advertisers to import offline conversions, bridging the gap between online interactions and offline sales.\u003c/p\u003e\n"],["\u003cp\u003eOffline conversions must be linked to an existing Floodlight activity and attributed to a click, device, or user ID for accurate tracking.\u003c/p\u003e\n"],["\u003cp\u003eVarious methods for attributing offline conversions are available, including Display Click IDs, Google Click IDs, match IDs, mobile device IDs, and encrypted user IDs.\u003c/p\u003e\n"],["\u003cp\u003eWhen using encrypted user IDs for attribution, it's crucial to understand their encryption method, which can be obtained from your Campaign Manager 360 account representative.\u003c/p\u003e\n"],["\u003cp\u003eData Transfer can be utilized to connect online ad server events with offline events using custom Floodlight variables for a comprehensive view of the customer journey.\u003c/p\u003e\n"]]],[],null,["# Overview\n\nIn Campaign Manager 360 a conversion is recorded by a tag, known as a [Floodlight\nactivity](//support.google.com/dcm/answer/2823400), when a user performs a predefined action\nafter being served an ad. Commonly tagged actions include tracking when a user\npurchases an item from an online store, or visits a webpage to request more\ninformation through an online form. In general, conversions tracked by Google\nboth begin and end online.\n\nConversions for some advertisers, however, may start online and finish offline.\nAn example of this is a user that begins researching a product online, clicks on\nan ad, and then completes their purchase over the phone or in a retail store. In\nthis scenario, Campaign Manager 360 will have data about the online portion of the\ntransaction, but not the offline portion, resulting in the conversion going\nunrecorded.\n\nTo address this, the Campaign Manager 360 API's [`Conversions`](/doubleclick-advertisers/current/conversions) service lets\nadvertisers provide information about the offline portion of these conversions\ndirectly to Campaign Manager 360.\n\nPrerequisites\n-------------\n\nBefore you can start working with the `Conversions` service, you'll need to\ncomplete the following steps:\n\n1. Create and authorize an API project as outlined in our [Get\n Started](/doubleclick-advertisers/getting_started) guide.\n\n2. Ensure your Campaign Manager 360 user profile has the necessary user role\n permissions. Contact your Campaign Manager 360 account administrator to have\n these permissions enabled, if necessary.\n\n - **Insert offline conversions** : Permits uploading new offline\n conversions using [`batchinsert`](/doubleclick-advertisers/current/conversions/batchinsert).\n\n - **Update offline conversions** : Permits modifying existing\n offline conversions using [`batchupdate`](/doubleclick-advertisers/current/conversions/batchupdate).\n\nMatch conversions to activities\n-------------------------------\n\nOffline conversions must be matched to a corresponding online activity in\nCampaign Manager 360. You'll refer to these activities by their\n`floodlightActivityId` and corresponding `floodlightConfigurationId`.\n\nIf you don't yet have an activity for tracking offline conversions, you can use\nthe API's [`FloodlightActivities`](/doubleclick-advertisers/current/floodlightActivities) service to\ncreate one. See the [Common Trafficking Tasks](/doubleclick-advertisers/trafficking_tasks#floodlighttag) guide for an\nexample of how to do this. Creating dedicated activities for offline conversions\nis highly recommended.\n\nObtain click, device, and user IDs\n----------------------------------\n\nOffline conversions must also be attributed to a click, device, or user ID (only\none of which can be used at a time). The most common ways to obtain these IDs\nare covered below.\n\n### Using Display Click ID\n\nConversions can be attributed to ad clicks through the use of Display Click IDs\n(DCLIDs). DCLIDs can be obtained from [Enhanced Attribution](//support.google.com/campaignmanager/answer/9182069).\n| **Important:** Offline conversions can not be attributed to the specific click identified by a DCLID. Instead, each conversion will be associated with the user responsible for the click. If a more recent click was recorded from the same user, for example, the conversion can be attributed to that click instead.\n\nDisplay Click IDs must be passed in the [`dclid`](/doubleclick-advertisers/current/conversions#dclid)\nfield.\n\n### Using Google Click ID\n\nConversions can be attributed to ad clicks through the use of Google Click IDs\n(GCLIDs). GCLIDs can be obtained from [Google Ads](//support.google.com/adwords/answer/3095550) or [Search Ads\n360](//support.google.com/ds/answer/7342044).\n| **Important:** Offline conversions can not be attributed to the specific click identified by a GCLID. Instead, each conversion will be associated with the user responsible for the click. If a more recent click was recorded from the same user, for example, the conversion can be attributed to that click instead.\n\nGoogle Click IDs must be passed in the [`gclid`](/doubleclick-advertisers/current/conversions#gclid)\nfield.\n\n### Using match ID\n\nConversions can be attributed through your own first-party identifier that has\nbeen synced with Google using the [`match_id`](//support.google.com/campaignmanager/answer/7554821#custom) feature in\nFloodlight.\n\n### Using mobile device ID\n\nConversions can be directly attributed to mobile or Connected TV devices through\nthe use of advertising device identifiers. The following identifiers are\nsupported:\n\n- [AdID](//developer.android.com/google/play-services/id.html)\n- IDFA\n- Identifiers for Advertising from CTV devices:\n - RIDA (Roku)\n - AFAI (Fire TV)\n - AdID (Android TV)\n - IDFA (Apple TV)\n - MSAI (Xbox)\n - TIFA (Samsung)\n - VIDA (Vizio)\n\nThese identifiers must be passed in the\n[`mobileDeviceId`](/doubleclick-advertisers/current/conversions#mobileDeviceId) field.\n\n### Using the %m match macro\n\n| **Warning:** As of May 25, 2018, encrypted user IDs won't be populated in the %m macro for users in the European Economic Area. [Learn more](//support.google.com/dcm/answer/9006418)\n\nThe [%m macro](//support.google.com/dcm/table/6096962#match) can be inserted into click-through or redirect\nURLs for a creative. The ad server will expand this macro into a user's\n[encrypted user ID](//support.google.com/dcm/answer/6206106) following a click event. The encrypted user\nID can then be captured directly from the redirect URL, or from server logs.\n\nIDs captured using the %m macro must be passed in the\n[`encryptedUserId`](/doubleclick-advertisers/current/conversions#encryptedUserId) or\n[`encryptedUserIdCandidates[]`](/doubleclick-advertisers/current/conversions#encryptedUserIdCandidates)\nfields.\n| **Important:** If you plan to work with encrypted user IDs you'll need to know how the IDs are encrypted (that is, their [`encryptionInfo`](/doubleclick-advertisers/current/conversions/batchinsert#encryptionInfo)). Contact your Campaign Manager 360 account representative or [Campaign Manager 360 support](mailto:dcm-support@google.com) for help determining this.\n\n### Using Data Transfer\n\n| **Warning:** As of May 25, 2018, encrypted user IDs won't be populated in Data Transfer files for users in the European Economic Area. [Learn more](//support.google.com/dcm/answer/9006418).\n\n[Data Transfer](/doubleclick-advertisers/dtv2/overview) is a Campaign Manager 360 feature that provides access to\nevent-level ad server log data. This data is delivered through separate feeds,\neach comprising a single Data Transfer file. Within these files, each recorded\nevent is associated with an [encrypted user ID](//support.google.com/dcm/answer/6206106).\n\nTo make use of user IDs provided in Data Transfer files, you'll need a way to\nmatch an online ad server event with some event in your offline system. This is\ncommonly done using [custom Floodlight variables](//support.google.com/dcm/answer/2823222), which\nyou can dynamically populate with values that uniquely identify a user action. A\nsimplified workflow might look like this:\n\n1. A Floodlight activity tag fires, indicating the start of a transaction. The\n tag contains a custom variable value you've provided that uniquely identifies\n the transaction.\n\n2. The transaction continues and completes offline, maintaining the same\n identifier.\n\n3. Using the identifier recorded when the transaction completed, a matching\n entry is located in the Data Transfer activity log file that recorded the\n original Floodlight activity.\n\nIDs retrieved from Data Transfer files must be passed in the\n[`encryptedUserId`](/doubleclick-advertisers/current/conversions#encryptedUserId) or\n[`encryptedUserIdCandidates[]`](/doubleclick-advertisers/current/conversions#encryptedUserIdCandidates)\nfields.\n| **Important:** If you plan to work with encrypted user IDs you'll need to know how the IDs are encrypted (that is, their [`encryptionInfo`](/doubleclick-advertisers/current/conversions/batchinsert#encryptionInfo)). Contact your Campaign Manager 360 account representative or [Campaign Manager 360 support](mailto:dcm-support@google.com) for help determining this."]]