---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://yandex.com/support/metrica/en/objects/reachgoal.md
  - https://yandex.com/support/metrica/es/objects/reachgoal.md
  - https://yandex.com/support/metrica/pt/objects/reachgoal.md
  - https://yandex.com/support/metrica/ru/objects/reachgoal.md
  - https://yandex.com/support/metrica/tr/objects/reachgoal.md
  - https://yandex.com/support/metrica/zh/objects/reachgoal.md
title: reachGoal
description: 传输有关已完成目标的信息。
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/metrica/zh/llms.txt


# reachGoal

<!-- source: zh/_includes/code/counter-initialize/id-counter-initialize/rest-js.md -->
{% note warning %}

使用 JavaScript API 需要了解 HTML 和 JavaScript。 如果您不了解这些语言，请联系您的网站开发人员或站长。

{% endnote %}
<!-- endsource: zh/_includes/code/counter-initialize/id-counter-initialize/rest-js.md -->


传输有关已完成[目标](https://yandex.com/support/metrica/zh/general/goals.md)的信息。

```javascript
ym(XXXXXXXX, 'reachGoal', target[, params[, callback[, ctx]]]);
```


#|
||
**参数**
|
**默认值**
|
**类型**
|
**描述**
||
||
`目标`[*](*parametr)
|
—
|
字符串
|
目标 ID。 在[创建或更改](https://yandex.com/support/metrica/zh/general/goal-js-event.md)“JavaScript 事件”类型的目标时，在计数器编辑页面中进行设置。
||
||
`params`
|
—
|
Object
|
[会话参数](https://yandex.com/support/metrica/zh/data/visit-params-data.md)
||
||
`callback`
|
—
|
Function
|
发送页面浏览数据后调用的回调函数
||
||
`ctx`
|
—
|
Object
|
在回调函数中通过 `this` 关键字访问的上下文
||
||
`params` 对象字段：
|
>
|
>
|
>
||
||
`order_price 或 price`
|
—
|
Double
|
[目标成本](https://yandex.com/support/metrica/zh/general/goal-js-event.md)。 您可以用货币或常规单位来指定收入。
||
||
`currency`
|
—
|
字符串
|
如果您想以货币形式传递目标成本，请使用此字段。 Yandex Metrica 识别三个字母的 [ISO 4217 货币代码](https://www.six-group.com/en/products-services/financial-information/data-standards.html#scrollTo=currency-codes)。

<!-- source: zh/_includes/ecommerce/data/id-about/currency-note.md -->
如果传递不同的货币，则将发送空值，而不是货币和金额。
<!-- endsource: zh/_includes/ecommerce/data/id-about/currency-note.md -->
||
|#


如果您想在多个位置跟踪同一行动，只需[创建](https://yandex.com/support/metrica/zh/general/goal-js-event.md)一个 [JavaScript 事件](https://yandex.com/support/metrica/zh/general/goal-js-event.md)目标，并在每次完成目标时使用目标 ID 调用 `reachGoal` 方法。

如果您有多个不同的事件，请为每个事件创建单独的目标并单独进行跟踪。 在这种情况下，目标必须具有不同的 ID。


{% note alert %}

设置目标 ID 时，请勿使用以下符号： / \ & # ? = "。 如果要向 ID 添加加号，请输入 `%2B` 代替 + 字符。

{% endnote %}


## 例如： {#reach_goal_examples}

> 将目标嵌入网站源代码的选项：
> 
> 
> {% cut "表单" %}
> 
> 
> ```javascript
> ...
> <form action="" method="get" onsubmit="ym(XXXXXXXX, 'reachGoal', 'TARGET_NAME'); return true;">
>     ...
> </form>
> ...
> ```
> 
> 
> {% endcut %}
> 
> {% cut "对于按钮：" %}
> 
> 
> ```javascript
> ...
> <form action="">
>     ...
>     <input type="button" onclick="ym(XXXXXXXX, 'reachGoal', 'TARGET_NAME'); return true;" value="Order" />
> </form>
> ...
> ```
> 
> 
> {% endcut %}
> 
> {% cut "链接" %}
> 
> 
> ```javascript
> ...
> <a href="/price.zip" onclick="ym(XXXXXXXX, 'reachGoal', 'TARGET_NAME'); return true;">Price list</a>
> ...
> ```
> 
> 
> {% endcut %}
> 
> {% cut "对于传输用户参数的链接" %}
> 
> 
> ```javascript
> ...
> 
> <a href="/price.zip" onclick="ym(XXXXXXXX, 'reachGoal', 'TARGET_NAME', goalParams, goalCallback); return true;">Price list</a>
> ...
> ```
> 
> 
> {% endcut %}
> 
> {% cut "页面加载时目标完成" %}
> 
> 
> 如果您使用的是**异步**代码片段并使用 `script` 元素调用目标，请在页面的任何部分插入以下代码：
> 
> 
> {% list tabs %}
> 
> - 通用解决方案
> 
>   
>   ```javascript
>   
>   ```
>   
> 
> - jQuery 解决方案
> 
>   
>   ```javascript
>   
>   ```
> 
> {% endlist %}
> 
> 
> 
> {% endcut %}
> 
> {% cut "在表单上按目标设置收入" %}
> 
> 
> ```javascript
> ...
> <form action="">
>     ...
>     <input type="button" onclick="ym(XXXXXXXX, 'reachGoal', 'TARGET_NAME', {order_price: '1000.35', currency: 'RUB'}); return true;" value="Order"/>
> </form>
> ...
> ```
> 
> {% cut "如何使用属性选择器发送收入数据" %}
> 
> 
> 要将收入作为 `order_price` 从网站的所有设置了属性选择器（例如 `class` 或 `id`）的页面传输，请将选择器名称与收入数据一起传递到 Yandex Metrica。
> 
> 1. 在网站代码中找到设置此类选择器的片段。 示例：
>     ```html
>     <div class="ORDER">订单金额：<div class="PRICE">110</div> RUB</div>
>     ```
>     
> 1. 将选择器名称添加到向 Yandex Metrica 发送按目标划分的收入的元素代码中。 示例：
>     ```javascript
>     <input type="button" onclick="ym(XXXXXXXX, 'reachGoal', 'BUY', {order_price: document.querySelector('.PRICE')?.textContent}); return true;" value="Order" />
>     ```
>     
> 
> 
> {% endcut %}
> 
> 
> {% endcut %}
> 
> {% cut "使用 JQuery 按目标动态传递收入" %}
> 
> 
> ```javascript
> 
> <form id="cart" action="/submit_order.php" method="post">
>     <div class="item">
>       <div class="name">Dakimakura with JoJo</div>
>       <div class="price">RUB 3000.5</div>
>       <input class="price-input hidden" value="3000.5" />
>     </div>
>     ...
> </form>
> ```
> 
> 
> {% endcut %}
> 
> 
> - `XXXXXXXX` — 计数器编号。
> - `TARGET_NAME` — 目标 ID。


<!-- source: zh/_includes/buttons/chat-button.md -->
[与我们聊天](https://yandex.com/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}

<!-- source: zh/_includes/styles/href-to-button.md -->

<!-- endsource: zh/_includes/styles/href-to-button.md -->
<!-- endsource: zh/_includes/buttons/chat-button.md -->

<!-- source: zh/_includes/objects/mail-button.md -->
<div class="cut-button">

{% cut "发送电子邮件" %}

选择一个问题以查找解决方案。

{% list tabs radio %}

- 没有特定来源的数据

  Yandex Metrica 中的目标对于任何来源都以相同的方式工作。 可能还没有已从此来源完成目标的用户。      
      
  {% cut "这些建议没有帮助" %}      
    
  <!-- source: zh/_includes/popup/id-popup/wrong-sup.md -->
  请注意：我们的支持团队永远不会主动给您打电话。 请勿按照自称为 Yandex Metrica 支持团队来电者的指示操作。
  <!-- endsource: zh/_includes/popup/id-popup/wrong-sup.md -->
    
  <div style="padding: 15px;
      margin: 10px 0;
      background: #FFFFFF;
      border-radius: 10px;
      border: 1px solid var(--g-color-line-generic);">
    <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.com/surveys/1706/?&theme=Net dannyh po opredelennomu istochniku&iframe=1&lang=en">
    </iframe>
  </div>
    
  {% endcut %}
    
- 目标数据与实际数据不匹配
  
  发生这种情况的原因可能如下：
    - Yandex Metrica 中的目标条件并未涵盖所有可能性。 例如，目标设置为转到订单确认页面，但该网站还允许在不访问此页面的情况下即时结帐。
    - 网站用户的浏览器插件会阻止 Yandex Metrica 计数器，因此不会将此用户计入在内。
    - 用户的防病毒系统具有严格的隐私设置。
    - 用户的互联网连接速度较慢，导致 Yandex Metrica 计数器未加载到目标页面上。      
      
  {% cut "这些建议没有帮助" %}      
      
  <!-- source: zh/_includes/popup/id-popup/wrong-sup.md -->
  请注意：我们的支持团队永远不会主动给您打电话。 请勿按照自称为 Yandex Metrica 支持团队来电者的指示操作。
  <!-- endsource: zh/_includes/popup/id-popup/wrong-sup.md -->
          
  <div style="padding: 15px;
        margin: 10px 0;
        background: #FFFFFF;
        border-radius: 10px;
        border: 1px solid var(--g-color-line-generic);">
    <iframe style="background: #FFFFFF;"
          height="700"
          width="100%"
          frameborder="0"
          src="https://forms.yandex.com/surveys/1706/?&theme=Dannye po celi otlichayutsya ot realnyh dannyh&iframe=1&lang=en">
    </iframe>
  </div>
  
  {% endcut %}

- 目标不起作用
  
  <div style="padding: 15px;
      margin: 10px 0;
      background: #FFFFFF;
      border-radius: 10px;
      border: 1px solid var(--g-color-line-generic);">
    <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.com/surveys/10018080.618d9fdb2524ebc4674fd9e2a54cd71036f465a9/?&theme=Cel ne rabotaet&iframe=1&lang=en">
    </iframe>
  </div>

{% endlist %}

{% endcut %}

</div>

<!-- source: zh/_includes/styles/cut-button.md -->

<!-- endsource: zh/_includes/styles/cut-button.md -->
<!-- endsource: zh/_includes/objects/mail-button.md -->

<!-- source: zh/_includes/footer-links.md -->
- - -

<div class="borderless-table">

#|
||
实用链接

- [演示计数器](https://metrica.yandex.com/r/dashboard?)
- [添加计数器](https://metrica.yandex.com/add/)
- [免费计数器设置](https://yandex.com/promo/freeservice/metrica?utm_source=help_metrica_en&utm_medium=cpc&utm_campaign=1)
- [Yandex Metrica API](https://tech.yandex.com/metrika/)
- [提出您的想法](https://yandex.com/support/metrica/troubleshooting/idea.html)
|
线上培训



- [参加培训课程](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)

||
|#

</div>

<!-- source: zh/_includes/styles/table-style.md -->

<!-- endsource: zh/_includes/styles/table-style.md -->
<!-- endsource: zh/_includes/footer-links.md -->

[*parametr]: 必填参数。