Search Ads 360 Conversion API의 get 및 getByCustomerId 메서드는 2025년 3분기에 지원 중단됩니다. 전환 데이터에 계속 액세스하려면 새 Search Ads 360 Reporting API를 사용하여 전환 리소스를 사용하여 보고서를 만들어야 합니다. 자세한 내용은 여기를 참고하세요.
고객이 광고주의 웹사이트에서 상품 구매 또는 추가 정보 요청과 같은 사전 정의된 액션을 완료하면 Search Ads 360에서 전환을 보고합니다.
일부 광고주의 전환은 온라인에서 시작하여 오프라인에서 끝납니다. 예를 들어 소비자가 구매를 위해 온라인에서 제품을 검색하고 광고를 클릭한 후 콜센터에 전화하여 구매를 완료하는 경우나, 또는 스마트폰을 사용하는 소비자가 광고에 표시된 '지금 통화하기' 버튼을 탭하고 전화로 상품을 구입하는 경우를 예로 들 수 있습니다. 이러한 전환의 경우 Search Ads 360는 온라인 측면에 대한 데이터를 자동으로 보유하게 됩니다. 보고서를 개선하거나, 자동 규칙에서 사용하거나, 입찰 전략에서 최적화하기 위해 오프라인 부분에 관한 데이터를 제공하려면 Search Ads 360에 업로드하면 됩니다.
경우에 따라 기존 전환의 값을 수정해야 할 수도 있습니다. 예를 들어 온라인 구매 후 적용된 할인 (예: 우편 환급), 재입고 수수료가 부과된 반품 또는 구매 후 적용된 크레딧을 고려하여 전환 가치를 수정할 수 있습니다.
첫 번째 앱에 설명된 대로 클라이언트 앱을 설정한 후 (전환 서비스 활성화 포함) 다음 전환 관련 요청을 Search Ads 360 API로 보낼 수 있습니다.
모든 변환 요청은 동기식입니다. 단일 클라이언트에서 동기 요청을 병렬로 (프로젝트의 한도까지) 만들 수 있습니다.
Search Ads 360 ID 및 전환
전환은 특정 캠페인, 광고, 키워드에 기여도가 부여되어야 하며, 선택적으로 방문에 기여도가 부여될 수도 있으므로 각 전환은 광고, 키워드, 캠페인의 Search Ads 360 ID와 Search Ads 360 계층 구조의 상위 객체 ID를 지정합니다.
전환을 가져오거나, 추가하거나, 업데이트할 때는 요청에 이러한 ID를 대부분 지정해야 합니다.
Search Ads 360 ID 가져오기
이러한 ID를 찾으려면 다음 중 하나를 수행하세요.
Search Ads 360 UI를 사용하여 광고주, 엔진 계정, 캠페인, 광고 그룹, 키워드, 광고의 ID가 포함된 보고서를 다운로드합니다.
방문 페이지 URL에 CampaignID, TrackerID과 같은 Search Ads 360 매크로를 추가합니다. 고객이 광고를 클릭하면 각 매크로가 Search Ads 360에 ID를 URL 매개변수로 광고주의 방문 페이지에 전달하도록 지시합니다.
광고주의 웹 로그에서 이러한 ID를 검색하여 Conversion 요청에 사용할 수 있습니다.
Search Ads 360에서는 방문 페이지로 키워드 ID를 전송하기 위한 몇 가지 매크로를 제공합니다. 전환을 키워드에 기여도로 부여하려면 방문 페이지 URL에 TrackerID 매크로를 추가해야 합니다.
클릭 ID
클릭 ID는 광고 클릭을 추적하며, 이를 사용하여 Search Ads 360 객체의 전체 ID 계층 구조를 제공하는 대신 특정 방문에 전환 기여도를 부여할 수 있습니다. Search Ads 360은 클릭 ID를 사용하여 적절한 키워드와 광고를 찾아 기여도를 부여합니다.
클릭 ID는 대소문자를 구분하므로 웹 로그와 추적 소프트웨어에서 클릭 ID의 대소문자가 변경되지 않도록 하세요.
클릭 ID 생성
Search Ads 360 또는 Google Ads에서 클릭 ID를 생성합니다.
Google Ads 계정에서 자동 태그 추가를 사용 설정하면 광고가 게재될 때 Google Ads에서 클릭 ID를 생성합니다. 따라서 사용자가 특정 광고 노출을 여러 번 클릭하는 경우 해당 클릭은 하나의 클릭 ID에만 연결됩니다. 정확하게 동일한 노출에 대한 방문 페이지 방문도 동일한 클릭 ID를 공유합니다.
전환 API 서비스를 활성화하면 Search Ads 360에서 클릭 ID를 생성할 수 있습니다. 클릭이 Google Ads에서 리디렉션되고 Google Ads에서 이미 클릭 ID를 생성한 경우 Search Ads 360은 새 ID를 생성하는 대신 Google Ads ID를 사용합니다. 클릭이 지원되는 다른 유형의 엔진에서 리디렉션되는 경우 Search Ads 360에서 ID를 생성합니다.
클릭 ID 매개변수
각 클릭 ID는 두 개의 매개변수로 구성됩니다. 예를 들면 다음과 같습니다.
gclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds
gclid 매개변수에는 클릭의 대소문자를 구분하는 ID가 포함됩니다. Search Ads 360은 생성된 각 클릭 ID의 기여 분석 정보 (예: 키워드, 광고, 캠페인, 광고 그룹)를 유지합니다.
gclsrc 매개변수는 클릭 ID의 소스를 나타냅니다. 현재는 다음 값 중 하나를 가질 수 있습니다.
gclsrc=ds: 클릭 ID가 Search Ads 360에 의해 생성되었습니다. 또한 클릭이 Google 이외의 엔진에서 발생했거나 Google에서 클릭이 발생했지만 Google Ads 계정에서 자동 태그 추가를 사용하지 않는 경우입니다.
gclsrc=aw.ds: 자동 태그 추가 기능을 사용하는 Google Ads에서 클릭 ID가 생성되었으며 클릭이 Search Ads 360 클릭 서버를 통과했습니다.
gclsrc=: 클릭이 발생했을 때 Google Ads에 의해 클릭 ID가 생성되었지만 Search Ads 360에서 전환 API 서비스가 사용 설정되지 않은 경우 매개변수가 비어 있습니다.
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\u003cp\u003eSearch Ads 360 reports a conversion when a customer completes a pre-defined action on an advertiser's website, such as purchasing an item or requesting information.\u003c/p\u003e\n"],["\u003cp\u003eYou can upload offline conversion data to Search Ads 360 to enhance reports, use in automated rules, or for bid strategy optimization.\u003c/p\u003e\n"],["\u003cp\u003eConversion values can be modified to account for factors like discounts, returns, or credits applied after a purchase.\u003c/p\u003e\n"],["\u003cp\u003eThe Search Ads 360 API allows you to get, insert, and update conversions, but it cannot be used to send personally identifiable information or for advertising targeting.\u003c/p\u003e\n"],["\u003cp\u003eTo attribute conversions, each conversion needs to specify the Search Ads 360 ID of an ad, keyword, and campaign, or utilize a click ID to track the click and attribute accordingly.\u003c/p\u003e\n"]]],["Search Ads 360 reports a conversion when a customer completes a specified action. Advertisers can upload offline conversion data to enhance reports and optimize bid strategies. The Search Ads 360 API allows getting, adding, and updating conversions. Conversions require Search Ads 360 IDs of relevant entities or a click ID to attribute to specific ads. Click IDs, generated by either Search Ads 360 or Google Ads, track ad clicks. Advertisers should maintain the click ID case from the landing page.\n"],null,["# Upload Data About Conversions\n\nWhen a customer completes a pre-defined action on an advertiser's website, such as\npurchasing an item or requesting more information, Search Ads 360 reports a **conversion**.\n\nConversions for some advertisers start online and finish offline. For example, a\nconsumer initiates research online for a purchase, clicks on an ad, and then telephones a\ncall center to complete the purchase. Or a consumer with a smartphone taps a \"call now\"\nbutton in an ad and purchases an item over the telephone. For these conversions,\nSearch Ads 360 will automatically have data about the online portion. If you want to\nprovide data about the offline portion---to enhance reports, for use in automated\nrules, or for optimization in a bid strategy---you can upload it to Search Ads 360.\n\nIn some cases, you might need to modify the value of an existing conversion. For\nexample, you might edit a conversion value to account for discounts that were applied\nafter an online purchase was made (such as a mail-in-rebate), returns that occurred with\na restocking fee, or credits that were applied after the purchase.\n\n\nAfter you've set up your client app as described in [My First App](/search-ads/v2/first-app) (including [activating the\nconversion service](/search-ads/v2/prereqs#activate-conversion-service)), you can send the following conversion-related requests to the\nSearch Ads 360 API:\n\n\n[Insert](/search-ads/v2/how-tos/conversions/insert)\n\n:\n Adds new conversions.\n\n\n[Update](/search-ads/v2/how-tos/conversions/update)\n\n: Modifies existing conversions.\n\n| **Advertisers are prohibited** from using the Search Ads 360 API to send personally identifiable information, as outlined by the [Terms of Service](/search-ads/terms) for the API. Further, this API provides no ability to target advertising. The conversion data is used by advertisers to better manage and report on the amount they pay for advertising and the ROI they get from it.\n\n### Synchronous Requests\n\nAll conversion requests are synchronous. You can make parallel synchronous requests (up to your project's limit) in a single client.\n\nSearch Ads 360 IDs and Conversions\n----------------------------------\n\n\nBecause conversions need to be attributed to a specific campaign, ad, keyword, and\noptionally to a visit, each conversion specifies the Search Ads 360 ID of an ad,\nkeyword, and campaign, along with the IDs of the parent objects in the [Search Ads 360 hierarchy](https://support.google.com/searchads/answer/2491240).\nWhen you get, add, or update a conversion, you'll need to specify most of these IDs in\nthe request.\n\n### Obtaining Search Ads 360 IDs\n\nTo find these IDs, do any of the following:\n\n-\n Use the Search Ads 360 UI to [download\n a report](https://support.google.com/searchads/answer/1184146) that contains IDs for the advertiser, engine accounts, campaigns, ad\n groups, keywords, and ads.\n\n-\n [Add\n Search Ads 360 macros](https://support.google.com/searchads/answer/1649566#macros) such as `CampaignID` and `TrackerID`\n to your landing page URLs. When a customer clicks an ad, each macro will instruct\n Search Ads 360 to pass its ID to the advertiser's landing page as URL parameter.\n You can retrieve these IDs from the advertiser's web logs and use them in your `Conversion`\n requests.\n\n\n Search Ads 360 provides a few different macros for sending keyword IDs to a landing\n page. To attribute conversions to a keyword, you'll need to add the **TrackerID**\n macro to the landing page URLs.\n\n### Click IDs\n\nA **click ID** tracks a click on an ad, and you can use it to attribute a\nconversion to a specific visit instead of providing the entire hierarchy of IDs for\nSearch Ads 360 objects. Search Ads 360 will use the click ID to find and attribute the\nappropriate keyword and ad.\n\nClick IDs are case-sensitive, so **make sure your web logs and tracking software\ndo not change the case of the click ID**.\n\n#### Generating a Click ID\n\nEither Search Ads 360 or Google Ads generates the click ID.\n\nIf [auto-tagging](https://support.google.com/google-ads/answer/3095550) is enabled\nin an Google Ads account, Google Ads generates a click ID when an ad is shown. As a result, if a\nuser clicks on a particular ad impression multiple times, those clicks will be associated\nwith only one click ID. Landing page visits for the exact same impression will share the\nsame click ID.\n\nSearch Ads 360 can generate a click ID if you [activate the conversion API service](https://support.google.com/searchads/answer/2604604#activate). If a click is redirected from Google Ads and Google Ads has\nalready generated a click ID, Search Ads 360 uses the Google Ads ID instead of generating a new one. If a\nclick is redirected from another type of supported engine, Search Ads 360 generates the ID.\n\n#### Click ID Parameters\n\nEach click ID consists of two parameters. For example: \n\n```\ngclid=CJjsqefUkAJSHDJ_gPdDiEAAA&gclsrc=ds\n```\n\n\nThe `gclid` parameter contains a case-sensitive ID for the click. Search Ads 360\nmaintains the attribution information (such as keyword, ad, campaign, ad group) for\neach click ID generated.\n\n\nThe `gclsrc` parameter indicates the source of the click ID. Currently, it\ncan have one of the following values:\n\n-\n `gclsrc=ds`: the click ID was generated by Search Ads 360. In addition, the\n click was either on an engine other than Google, or the click was on Google but the\n Google Ads account is not using auto-tagging.\n\n-\n `gclsrc=aw.ds`: the click ID was generated by Google Ads that is using\n auto-tagging, and the click went through the Search Ads 360 clickserver.\n\n-\n `gclsrc=`: the parameter is empty if the click ID was generated by Google Ads,\n but the conversion API service was not enabled in Search Ads 360 when the click occurred.\n\n| **Tip**: We recommend you use the landing page of the website to keep track of the customer's offline contact information (such as phone number called) together with the click ID. When an offline conversion happens, the click ID can then be used to report the conversion back to Search Ads 360."]]
