ลงทะเบียนวันนี้เพื่อเข้าร่วม Performance Max และเวิร์กช็อป Google Ads API ซึ่งจะจัดขึ้นในวันที่ 17 กรกฎาคม

หน้านี้ได้รับการแปลโดย Cloud Translation API

สร้างการกระทําที่ถือเป็น Conversion

คู่มือนี้จะแสดงรายการการกระทำที่ถือเป็น Conversion ประเภทต่างๆ ที่คุณสามารถสร้างได้โดยใช้ Google Ads API ข้อมูลเกี่ยวกับวิธีแมปเหล่านี้กับอินเทอร์เฟซเว็บของ Google Ads และตัวอย่างโค้ดโดยละเอียดที่สาธิตวิธีสร้างการกระทำที่ถือเป็น Conversion ใหม่

หากต้องการวัด Conversion ให้ตั้งค่า ConversionAction สําหรับ type ของการกระทําที่ถือเป็น Conversion ที่ต้องการติดตาม ตัวอย่างเช่น การซื้อออนไลน์และการโทร ต้องมีการกระทำที่ถือเป็น Conversion แตกต่างกัน

วิธีที่ดีที่สุดในการสร้างการกระทําที่ถือเป็น Conversion ใหม่ใน API คือการใช้ตัวอย่างโค้ดการเพิ่มโค้ดการกระทําที่ถือเป็น Conversion ด้านล่าง ตัวอย่างนี้จะจัดการงานการตรวจสอบสิทธิ์ในเบื้องหลังทั้งหมดให้คุณและแนะนำขั้นตอนการสร้าง ConversionAction

การกระทำที่ถือเป็น Conversion ส่วนใหญ่ยังต้องมีขั้นตอนเพิ่มเติมเพื่อติดตาม เช่น หากต้องการติดตาม Conversion ในเว็บไซต์ คุณต้องเพิ่มข้อมูลโค้ดที่เรียกว่าแท็กลงในหน้า Conversion ในเว็บไซต์ ดูข้อกําหนดอื่นๆ ของการกระทําที่ถือเป็น Conversion ได้ที่บทความในศูนย์ช่วยเหลือ

Conversion ของเว็บไซต์

Conversion ในเว็บไซต์ช่วยให้คุณติดตามการกระทำในเว็บไซต์ เช่น ยอดขายออนไลน์ การคลิกลิงก์ การดูหน้าเว็บ และการลงชื่อสมัครใช้

ในการติดตาม Conversion ในเว็บไซต์ คุณต้องสร้าง ConversionAction โดยตั้งค่า ConversionActionType เป็น WEBPAGE แล้วเพิ่มข้อมูลโค้ดที่เรียกว่าแท็กลงในหน้า Conversion ในเว็บไซต์

ConversionAction ประกอบด้วย Conversion ในเว็บไซต์หลายประเภทซึ่งแยกความแตกต่างภายใน API ได้ที่ช่อง type ในแต่ละ TagSnippet ที่ระบุไว้ในช่อง tag_snippets ของ ConversionAction

TagSnippet ให้โค้ดติดตามที่ต้องรวมอยู่ในเว็บไซต์เพื่อติดตามการกระทำที่ถือเป็น Conversion Conversion เว็บไซต์และการคลิกหมายเลขโทรศัพท์ต้องมี event_snippet ซึ่งควรวางไว้ในหน้าเว็บที่ระบุการกระทําที่ถือเป็น Conversion เช่น การยืนยันการชําระเงินหรือหน้าการส่งแบบฟอร์มโอกาสในการขาย และ global_site_tag ซึ่งต้องติดตั้งในทุกหน้าของเว็บไซต์ คุณดึงแอตทริบิวต์ทั้ง 2 รายการนี้ได้ด้วย ConversionActionService ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือ เกี่ยวกับวิธีติดแท็กหน้าเว็บ

ตารางต่อไปนี้แสดงพารามิเตอร์ API ที่เทียบเท่าซึ่งใช้สำหรับแหล่งที่มาแต่ละรายการในอินเทอร์เฟซเว็บของ Google Ads

ประเภทโค้ดติดตาม	แหล่งที่มาของ Google Ads
`WEBPAGE`	เว็บไซต์ (Google Analytics (GA4))
`WEBPAGE_ONCLICK`	เว็บไซต์ (Google Analytics (GA4))
`CLICK_TO_CALL`	การคลิกหมายเลขโทรศัพท์
`---`	เว็บไซต์ (Google Analytics (UA))

Conversion ในแอป

Conversion ของแอปช่วยให้คุณติดตามการติดตั้งแอปบนอุปกรณ์เคลื่อนที่หรือการซื้อในแอปจาก Google Play Store ได้

ตารางต่อไปนี้แสดงพารามิเตอร์ API ของ ConversionActionType ที่เทียบเท่าซึ่งใช้สําหรับแหล่งที่มาแต่ละรายการในอินเทอร์เฟซเว็บของ Google Ads

ประเภทการกระทำที่ถือเป็น Conversion	แหล่งที่มาของ Google Ads
`GOOGLE_PLAY_DOWNLOAD`	Google Play > การติดตั้ง
`GOOGLE_PLAY_IN_APP_PURCHASE`	Google Play > การซื้อในแอป

หากต้องการติดตามการกระทำอื่นๆ ของแอปบนอุปกรณ์เคลื่อนที่โดยใช้พร็อพเพอร์ตี้ Google Analytics 4 หรือการวิเคราะห์แอปจากบุคคลที่สาม ดูประเภทการกระทำที่ถือเป็น Conversion เพิ่มเติม

Conversion การโทร

การวัด Conversion การโทร ช่วยให้คุณติดตามการโทรจากโฆษณา การโทรไปยังหมายเลขในเว็บไซต์ และ การคลิกหมายเลขในเว็บไซต์บนอุปกรณ์เคลื่อนที่

ประเภทการกระทำที่ถือเป็น Conversion	แหล่งที่มาของ Google Ads
`AD_CALL`	การโทรจากโฆษณาโดยใช้ส่วนขยายการโทรหรือโฆษณาแบบโทรออกเท่านั้น
`WEBSITE_CALL`	การโทรไปยังหมายเลขโทรศัพท์ในเว็บไซต์
`CLICK_TO_CALL`	การคลิกหมายเลขในเว็บไซต์บนอุปกรณ์เคลื่อนที่

ประเภท CLICK_TO_CALL แตกต่างจากประเภท AD_CALL ตรงที่ไม่ติดตามการโทรจริง แต่จะCLICK_TO_CALLติดตามเฉพาะการคลิกหมายเลขโทรศัพท์จากอุปกรณ์เคลื่อนที่เท่านั้น วิธีนี้มีประโยชน์เมื่อคุณไม่สามารถใช้หมายเลขโอนสายของ Google เพื่อติดตามการโทร

`AD_CALL`

การกระทำที่ถือเป็น Conversion AD_CALL จะปรากฏเป็น Conversion การโทรจากโฆษณาในอินเทอร์เฟซเว็บของ Google Ads หลังจากสร้างการกระทําที่ถือเป็น Conversion AD_CALL แล้ว ให้ระบุชื่อทรัพยากรในช่อง call_conversion_action เมื่อคุณสร้างCallAsset ชิ้นงานการโทรให้คุณแสดงหมายเลขโทรศัพท์ในโฆษณาโดยตรง

ระบบจะรายงานการโทรเป็น Conversion หากมีระยะเวลานานกว่าระยะเวลาที่ระบุ ค่าเริ่มต้นคือ 60 วินาที

`WEBSITE_CALL`

การกระทำที่ถือเป็น Conversion WEBSITE_CALL จะปรากฏเป็น Conversion การโทรจากเว็บไซต์ในอินเทอร์เฟซเว็บของ Google Ads

เครื่องมือติดตามนี้แตกต่างจาก AD_CALL เครื่องมือติดตามนี้จำเป็นต้องมีการเพิ่ม event_snippet และ global_site_tag ลงในเว็บไซต์ เพื่อเรียกหมายเลขโอนสายของ Google แบบไดนามิกสำหรับการติดตามการโทร สำหรับหมายเลขที่แสดงบนเว็บไซต์ของคุณ นอกจากนี้ คุณยังต้องตั้งค่าชิ้นงานการโทรและลิงก์ชิ้นงานดังกล่าวที่ระดับองค์กร แคมเปญ หรือกลุ่มโฆษณาด้วย

นำเข้า Conversion ออฟไลน์

ตารางต่อไปนี้แสดงพารามิเตอร์ API ConversionActionType ที่เทียบเท่าเพื่อใช้สําหรับแหล่งที่มาแต่ละรายการในอินเทอร์เฟซเว็บของ Google Ads และลิงก์ไปยังเอกสารประกอบสําหรับการกระทําที่ถือเป็น Conversion แต่ละประเภทที่เฉพาะเจาะจง

ประเภทการกระทำที่ถือเป็น Conversion	แหล่งที่มาของ Google Ads	คู่มือการตั้งค่า API
`UPLOAD_CLICKS`	ติดตาม Conversion จากการคลิกและ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย	คู่มือการอัปโหลดการคลิก คู่มือ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย
`UPLOAD_CALLS`	ติดตาม Conversion จากการโทร	คู่มือการตั้งค่า API
`STORE_SALES`	ติดตาม Conversion ยอดขายในร้าน	คู่มือการตั้งค่า API

Conversion ที่ปรับปรุงแล้วสําหรับเว็บ

Conversion ที่ปรับปรุงแล้วสําหรับเว็บช่วยให้คุณส่งข้อมูล Conversion จากบุคคลที่หนึ่งสําหรับการกระทําที่ถือเป็น Conversion WEBPAGE รายการได้ภายใน 24 ชั่วโมงของเหตุการณ์ Conversion แทนที่จะส่งในเวลาเดียวกัน ซึ่งจะช่วยให้คุณค้นหาข้อมูลจากบุคคลที่หนึ่งจากแหล่งที่มาต่างๆ ได้ เช่น ฐานข้อมูลลูกค้าหรือระบบ CRM

ประเภทการกระทำที่ถือเป็น Conversion เพิ่มเติม

Google Ads API ทําให้การกระทําที่ถือเป็น Conversion ประเภทอื่นๆ พร้อมใช้งานในรายงาน แต่อาจจํากัดหรือห้ามการสร้างหรือแก้ไขการกระทําเหล่านั้น

Conversion ของ SKAdNetwork

หากใช้งาน App Campaign สำหรับ iOS และใช้งาน SKAdNetwork อยู่ คุณจะเข้าถึงข้อมูล SKAdNetwork ที่ได้รับจาก Google ที่ระดับ Customer และ Campaign ได้โดยใช้ แหล่งข้อมูลต่อไปนี้

ช่องรายงาน	คำอธิบาย
`metrics.sk_ad_network_installs`	จำนวนการติดตั้งที่รายงานโดย Apple เมตริกนี้สามารถแบ่งกลุ่มได้ด้วยชุดค่าผสมของ `segments.sk_ad_network_conversion_value` และกลุ่มที่เกี่ยวข้องกับวันที่เท่านั้น
`metrics.sk_ad_network_total_conversions`	จำนวน Conversion ทั้งหมด ซึ่งรวมถึงการติดตั้งและ Conversion ประเภทอื่นๆ ที่ Apple รายงาน เมตริกนี้สามารถแบ่งกลุ่มได้ตามกลุ่มที่เกี่ยวข้องกับ SKAdNetwork และกลุ่มที่เกี่ยวข้องกับวันที่เท่านั้น
`segments.sk_ad_network_ad_event_type`	ประเภทของเหตุการณ์ที่เกิดขึ้นสำหรับ Conversion หนึ่งๆ
`segments.sk_ad_network_attribution_credit`	วิธีให้เครดิตการระบุแหล่งที่มาสำหรับ Conversion หนึ่งๆ
`segments.sk_ad_network_fine_conversion_value`	มูลค่าของ Conversion ที่รายงานโดย Apple กลุ่มนี้ใช้ กับเมตริกอื่นๆ ที่ไม่ใช่ `metrics.sk_ad_network_installs`, `metrics.sk_ad_network_total_conversions` ไม่ได้ และ สามารถรวมกับกลุ่มที่เกี่ยวข้องกับวันที่เท่านั้น ระบบจะแสดงผลค่าของ `0` หาก Apple รายงานค่าเป็น `0` และจะไม่มีค่าเป็นอย่างอื่น ตรวจสอบ ช่องที่มีอยู่เพื่อแยกความแตกต่างระหว่างทั้ง 2 กรณี
`segments.sk_ad_network_coarse_conversion_value`	มูลค่าคร่าวๆ ของ Conversion แต่ละรายการ
`segments.sk_ad_network_postback_sequence_index`	ตำแหน่งของระบบรายงานผล Conversion ตามลำดับสำหรับ Conversion หนึ่งๆ
`segments.sk_ad_network_source_app.sk_ad_network_source_app_id`	รหัสแอปที่กระตุ้นการติดตั้งเครือข่ายโฆษณาใน iOS Store Kit
`segments.sk_ad_network_source_domain`	เว็บไซต์ที่มีการแสดงโฆษณาที่ขับเคลื่อนการติดตั้งเครือข่ายโฆษณา iOS Store Kit ค่า Null หมายความว่ากลุ่มนี้ไม่เกี่ยวข้อง เช่น แคมเปญที่ไม่ใช่ iOS หรือไม่แสดงในระบบรายงานผล Conversion ที่ Apple ส่ง
`segments.sk_ad_network_source_type`	ประเภทแหล่งที่มาที่แสดงโฆษณาซึ่งทําให้เกิดการติดตั้งเครือข่ายโฆษณาใน iOS Store Kit ค่า Null หมายความว่ากลุ่มนี้ไม่เกี่ยวข้อง เช่น แคมเปญที่ไม่ใช่ iOS หรือไม่มีโดเมนแหล่งที่มาหรือแอปแหล่งที่มาในระบบรายงานผล Conversion ที่ส่งจาก Apple
`segments.sk_ad_network_user_type`	ประเภทผู้ใช้ที่ทำให้เกิด Conversion หนึ่งๆ
`segments.sk_ad_network_redistributed_fine_conversion_value`	มูลค่า Conversion ในกลุ่มนี้รวมค่า Null ที่แจกจ่ายให้กับมูลค่า Conversion กลุ่มนี้แสดงผลรวมของมูลค่า Conversion อย่างละเอียดที่พบซึ่งแสดงผลโดย Apple และค่า Null โดยประมาณจาก Google

คุณยังบันทึกการแมปมูลค่า Conversion ของ SKAdNetwork สําหรับลูกค้าที่ลิงก์แบบเจาะจงด้วยแอป iOS ผ่าน CustomerSkAdNetworkConversionValueSchema ได้อีกด้วย

ตัวอย่างโค้ด Python

#!/usr/bin/env python
# Copyright 2019 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

import argparse
import sys

from google.ads.googleads.client import GoogleAdsClient
from google.ads.googleads.errors import GoogleAdsException

def main(client, customer_id):
    """Adds a keyword plan, campaign, ad group, etc. to the customer account.

    Also handles errors from the API and prints them.

    Args:
        client: An initialized instance of GoogleAdsClient
        customer_id: A str of the customer_id to use in requests.
    """

    res = update_skan_cv_schema(
        client, customer_id, "my_app_id", "account_link_id"
    )
    print(res)

def update_skan_cv_schema(client, customer_id, app_id, account_link_id):
    skan_service = client.get_service(
        "CustomerSkAdNetworkConversionValueSchemaService"
    )

    req = client.get_type(
        "MutateCustomerSkAdNetworkConversionValueSchemaRequest"
    )
    operation = client.get_type(
        "CustomerSkAdNetworkConversionValueSchemaOperation"
    )
    schema_instance = client.get_type(
        "CustomerSkAdNetworkConversionValueSchema"
    )

    new_schema = operation.update
    new_schema.resource_name = (
        skan_service.customer_sk_ad_network_conversion_value_schema_path(
            "customer_id", "account_link_id"
        )
    )
    new_schema.schema.app_id = app_id
    new_schema.schema.measurement_window_hours = 48

    skan_cv_mapping = (
        schema_instance.SkAdNetworkConversionValueSchema.FineGrainedConversionValueMappings()
    )
    skan_cv_mapping.fine_grained_conversion_value = 0  # 0 - 63
    skan_cv_mapping.conversion_value_mapping.min_time_post_install_hours = 0
    skan_cv_mapping.conversion_value_mapping.max_time_post_install_hours = 48

    skan_cv_event = schema_instance.SkAdNetworkConversionValueSchema.Event()
    skan_cv_event.mapped_event_name = "TEST"
    skan_cv_event.event_revenue_value = 10

    skan_cv_mapping.conversion_value_mapping.mapped_events.append(skan_cv_event)
    new_schema.schema.fine_grained_conversion_value_mappings.append(
        skan_cv_mapping
    )

    req.operation = operation
    req.customer_id = customer_id

    res = skan_service.mutate_customer_sk_ad_network_conversion_value_schema(
        req
    )
    return res

if __name__ == "__main__":
    # GoogleAdsClient will read the google-ads.yaml configuration file in the
    # home directory if none is specified.
    googleads_client = GoogleAdsClient.load_from_storage(
        version="v17"
    )

    parser = argparse.ArgumentParser(
        description="Creates a keyword plan for specified customer."
    )
    # The following argument(s) should be provided to run the example.
    parser.add_argument(
        "-c",
        "--customer_id",
        type=str,
        required=True,
        help="The Google Ads customer ID.",
    )
    args = parser.parse_args()

    try:
        main(googleads_client, args.customer_id)
    except GoogleAdsException as ex:
        print(
            f'Request with ID "{ex.request_id}" failed with status '
            f'"{ex.error.code().name}" and includes the following errors:'
        )
        for error in ex.failure.errors:
            print(f'\tError with message "{error.message}".')
            if error.location:
                for field_path_element in error.location.field_path_elements:
                    print(f"\t\tOn field: {field_path_element.field_name}")
        sys.exit(1)

Google Analytics

Conversion จากพร็อพเพอร์ตี้ Google Analytics ที่ลิงก์มีค่า type ค่าใดค่าหนึ่งต่อไปนี้

Conversion ของพร็อพเพอร์ตี้ GA4:
- GOOGLE_ANALYTICS_4_CUSTOM
- GOOGLE_ANALYTICS_4_PURCHASE
คุณยังดึงข้อมูลรหัสพร็อพเพอร์ตี้ GA4, ชื่อพร็อพเพอร์ตี้ และชื่อเหตุการณ์จากช่อง google_analytics_4_settings ได้ด้วย
Conversion ของพร็อพเพอร์ตี้ Universal Analytics:
- UNIVERSAL_ANALYTICS_GOAL
- UNIVERSAL_ANALYTICS_TRANSACTION

คุณสามารถทําการเปลี่ยนแปลงต่อไปนี้กับ Conversion ของพร็อพเพอร์ตี้ GA4

นําเข้า Conversion จากพร็อพเพอร์ตี้ GA4 ไปยังบัญชี Google Ads โดยแก้ไขช่อง status จาก HIDDEN เป็น ENABLED
แก้ไขช่อง primary_for_goal และ category เพื่อระบุว่าช่องนี้จะส่งผลต่อการเสนอราคาและรายงานของ Google Ads อย่างไร
อัปเดตnameหรือvalue_settings
นำ Conversion ออกจากบัญชี Google Ads โดยใช้การดำเนินการ remove

การพยายามแก้ไขแอตทริบิวต์อื่นๆ ของ Conversion ของ GA4 ที่นําเข้าหรือแอตทริบิวต์ใดก็ได้ของ Conversion ของ Universal Analytics ที่นําเข้าจะทําให้เกิดข้อผิดพลาด MUTATE_NOT_ALLOWED คุณจะทำการเปลี่ยนแปลงได้โดยใช้ UI ของ Google Ads เท่านั้น

การวิเคราะห์แอป Firebase และแอปของบุคคลที่สาม

หากต้องการนำเข้า Conversion การวิเคราะห์แอปจากบุคคลที่สามหรือ Firebase ให้เปลี่ยน status ของ ConversionAction จาก HIDDEN เป็น ENABLED โดยใช้เมธอด mutate ของ ConversionActionService ระบบไม่รองรับการอัปเดต app_id สำหรับการกระทำที่ถือเป็น Conversion เหล่านี้

FIREBASE_ANDROID_FIRST_OPEN
FIREBASE_ANDROID_IN_APP_PURCHASE
FIREBASE_ANDROID_CUSTOM
FIREBASE_IOS_FIRST_OPEN
FIREBASE_IOS_IN_APP_PURCHASE
FIREBASE_IOS_CUSTOM
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM

ยอดขายในร้านค้า

แม้ว่าคุณจะไม่สามารถสร้างการกระทำที่ถือเป็น Conversion STORE_SALES หรือ STORE_SALES_DIRECT_UPLOAD โดยใช้ Google Ads API แต่ API จะรองรับการอัปโหลดธุรกรรมยอดขายในร้าน

STORE_SALES
STORE_SALES_DIRECT_UPLOAD

เบ็ดเตล็ด

ประเภทการกระทำที่ถือเป็น Conversion ต่อไปนี้เป็นแบบอ่านอย่างเดียวใน Google Ads API และมีไว้เพื่อวัตถุประสงค์ในการรายงาน

ANDROID_APP_PRE_REGISTRATION
ANDROID_INSTALLS_ALL_OTHER_APPS
FLOODLIGHT_ACTION
FLOODLIGHT_TRANSACTION
GOOGLE_HOSTED
LEAD_FORM_SUBMIT
SALESFORCE
SEARCH_ADS_360
SMART_CAMPAIGN_AD_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_DIRECTIONS
SMART_CAMPAIGN_TRACKED_CALLS
STORE_VISITS
WEBPAGE_CODELESS

ไม่ระบุ

หากบัญชี Google Ads มีการกระทําที่ถือเป็น Conversion ประเภทอื่นๆ คุณอาจเห็นว่าการค้นหาและรายงานส่งคืนการกระทําที่ถือเป็น Conversion โดยที่ ConversionAction.type คือUNKNOWN API ไม่รองรับการจัดการการกระทำที่ถือเป็น Conversion เหล่านี้ แต่แสดงผลในรายงานเพื่อให้ผลลัพธ์ที่สมบูรณ์สำหรับเมตริก Conversion หลัก เช่น metrics.conversions และ metrics.conversions_value

ตัวอย่างโค้ด

ตัวอย่างโค้ดต่อไปนี้จะอธิบายกระบวนการสร้างการกระทำที่ถือเป็น Conversion ใหม่ กล่าวโดยเจาะจงคือจะเป็นการสร้างการกระทำที่ถือเป็น Conversion โดยตั้งค่า type เป็น UPLOAD_CLICKS นี่คือขั้นตอน UI ของ Google Ads เดียวกันกับการสร้างการกระทําที่ถือเป็น Conversion ใหม่โดยใช้นําเข้า > นําเข้าด้วยตนเองโดยใช้ API หรือการอัปโหลด > ติดตาม Conversion จากการคลิก และยังตั้งค่า category เป็น DEFAULT ด้วย

ระบบจะใช้การตั้งค่าเริ่มต้นต่อไปนี้

Google Ads API จะตั้งค่าช่อง primary_for_goal โดยอัตโนมัติ แต่คุณตั้งค่าช่องนี้อย่างชัดแจ้งเพื่อควบคุมผลกระทบที่การกระทำที่ถือเป็น Conversion ส่งผลต่อการรายงานและการเสนอราคาในบัญชีได้เมื่อรวมกับเป้าหมาย Conversion
Google Ads API จะตั้งค่า counting_type เป็น MANY_PER_CLICK โดยอัตโนมัติ ดูเกี่ยวกับตัวเลือกการนับ Conversion สำหรับรายละเอียดเพิ่มเติม
Google Ads API กำหนดรูปแบบการระบุแหล่งที่มาให้อิงตามข้อมูลโดยตั้งค่าช่อง attribution_model_settings เป็น GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN ค่า AttributionModel

Java

private void runExample(GoogleAdsClient googleAdsClient, long customerId) {

  // Creates a ConversionAction.
  ConversionAction conversionAction =
      ConversionAction.newBuilder()
          // Note that conversion action names must be unique. If a conversion action already
          // exists with the specified conversion_action_name the create operation will fail with
          // a ConversionActionError.DUPLICATE_NAME error.
          .setName("Earth to Mars Cruises Conversion #" + getPrintableDateTime())
          .setCategory(ConversionActionCategory.DEFAULT)
          .setType(ConversionActionType.WEBPAGE)
          .setStatus(ConversionActionStatus.ENABLED)
          .setViewThroughLookbackWindowDays(15L)
          .setValueSettings(
              ValueSettings.newBuilder()
                  .setDefaultValue(23.41)
                  .setAlwaysUseDefaultValue(true)
                  .build())
          .build();

  // Creates the operation.
  ConversionActionOperation operation =
      ConversionActionOperation.newBuilder().setCreate(conversionAction).build();

  try (ConversionActionServiceClient conversionActionServiceClient =
      googleAdsClient.getLatestVersion().createConversionActionServiceClient()) {
    MutateConversionActionsResponse response =
        conversionActionServiceClient.mutateConversionActions(
            Long.toString(customerId), Collections.singletonList(operation));
    System.out.printf("Added %d conversion actions:%n", response.getResultsCount());
    for (MutateConversionActionResult result : response.getResultsList()) {
      System.out.printf(
          "New conversion action added with resource name: '%s'%n", result.getResourceName());
    }
  }
}AddConversionAction.java

C#

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the ConversionActionService.
    ConversionActionServiceClient conversionActionService =
        client.GetService(Services.V17.ConversionActionService);

    // Note that conversion action names must be unique.
    // If a conversion action already exists with the specified name the create operation
    // will fail with a ConversionAction.DUPLICATE_NAME error.
    string ConversionActionName = "Earth to Mars Cruises Conversion #"
        + ExampleUtilities.GetRandomString();

    // Add a conversion action.
    ConversionAction conversionAction = new ConversionAction()
    {
        Name = ConversionActionName,
        Category = ConversionActionCategory.Default,
        Type = ConversionActionType.Webpage,
        Status = ConversionActionStatus.Enabled,
        ViewThroughLookbackWindowDays = 15,
        ValueSettings = new ConversionAction.Types.ValueSettings()
        {
            DefaultValue = 23.41,
            AlwaysUseDefaultValue = true
        }
    };

    // Create the operation.
    ConversionActionOperation operation = new ConversionActionOperation()
    {
        Create = conversionAction
    };

    try
    {
        // Create the conversion action.
        MutateConversionActionsResponse response =
            conversionActionService.MutateConversionActions(customerId.ToString(),
                    new ConversionActionOperation[] { operation });

        // Display the results.
        foreach (MutateConversionActionResult newConversionAction in response.Results)
        {
            Console.WriteLine($"New conversion action with resource name = " +
                $"'{newConversionAction.ResourceName}' was added.");
        }
    }
    catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}AddConversionAction.cs

PHP

public static function runExample(GoogleAdsClient $googleAdsClient, int $customerId)
{
    // Creates a conversion action.
    $conversionAction = new ConversionAction([
        // Note that conversion action names must be unique.
        // If a conversion action already exists with the specified conversion_action_name
        // the create operation will fail with a ConversionActionError.DUPLICATE_NAME error.
        'name' => 'Earth to Mars Cruises Conversion #' . Helper::getPrintableDatetime(),
        'category' => ConversionActionCategory::PBDEFAULT,
        'type' => ConversionActionType::WEBPAGE,
        'status' => ConversionActionStatus::ENABLED,
        'view_through_lookback_window_days' => 15,
        'value_settings' => new ValueSettings([
            'default_value' => 23.41,
            'always_use_default_value' => true
        ])
    ]);

    // Creates a conversion action operation.
    $conversionActionOperation = new ConversionActionOperation();
    $conversionActionOperation->setCreate($conversionAction);

    // Issues a mutate request to add the conversion action.
    $conversionActionServiceClient = $googleAdsClient->getConversionActionServiceClient();
    $response = $conversionActionServiceClient->mutateConversionActions(
        MutateConversionActionsRequest::build($customerId, [$conversionActionOperation])
    );

    printf("Added %d conversion actions:%s", $response->getResults()->count(), PHP_EOL);

    foreach ($response->getResults() as $addedConversionAction) {
        /** @var ConversionAction $addedConversionAction */
        printf(
            "New conversion action added with resource name: '%s'%s",
            $addedConversionAction->getResourceName(),
            PHP_EOL
        );
    }
}AddConversionAction.php

Python

def main(client, customer_id):
    conversion_action_service = client.get_service("ConversionActionService")

    # Create the operation.
    conversion_action_operation = client.get_type("ConversionActionOperation")

    # Create conversion action.
    conversion_action = conversion_action_operation.create

    # Note that conversion action names must be unique. If a conversion action
    # already exists with the specified conversion_action_name, the create
    # operation will fail with a ConversionActionError.DUPLICATE_NAME error.
    conversion_action.name = f"Earth to Mars Cruises Conversion {uuid.uuid4()}"
    conversion_action.type_ = (
        client.enums.ConversionActionTypeEnum.UPLOAD_CLICKS
    )
    conversion_action.category = (
        client.enums.ConversionActionCategoryEnum.DEFAULT
    )
    conversion_action.status = client.enums.ConversionActionStatusEnum.ENABLED
    conversion_action.view_through_lookback_window_days = 15

    # Create a value settings object.
    value_settings = conversion_action.value_settings
    value_settings.default_value = 15.0
    value_settings.always_use_default_value = True

    # Add the conversion action.
    conversion_action_response = (
        conversion_action_service.mutate_conversion_actions(
            customer_id=customer_id,
            operations=[conversion_action_operation],
        )
    )

    print(
        "Created conversion action "
        f'"{conversion_action_response.results[0].resource_name}".'
    )add_conversion_action.py

Ruby

def add_conversion_action(customer_id)
  # GoogleAdsClient will read a config file from
  # ENV['HOME']/google_ads_config.rb when called without parameters
  client = Google::Ads::GoogleAds::GoogleAdsClient.new


  # Add a conversion action.
  conversion_action = client.resource.conversion_action do |ca|
    ca.name = "Earth to Mars Cruises Conversion #{(Time.new.to_f * 100).to_i}"
    ca.type = :UPLOAD_CLICKS
    ca.category = :DEFAULT
    ca.status = :ENABLED
    ca.view_through_lookback_window_days = 15

    # Create a value settings object.
    ca.value_settings = client.resource.value_settings do |vs|
      vs.default_value = 15
      vs.always_use_default_value = true
    end
  end

  # Create the operation.
  conversion_action_operation = client.operation.create_resource.conversion_action(conversion_action)

  # Add the ad group ad.
  response = client.service.conversion_action.mutate_conversion_actions(
    customer_id: customer_id,
    operations: [conversion_action_operation],
  )

  puts "New conversion action with resource name = #{response.results.first.resource_name}."
endadd_conversion_action.rb

Perl

sub add_conversion_action {
  my ($api_client, $customer_id) = @_;

  # Note that conversion action names must be unique.
  # If a conversion action already exists with the specified conversion_action_name,
  # the create operation fails with error ConversionActionError.DUPLICATE_NAME.
  my $conversion_action_name = "Earth to Mars Cruises Conversion #" . uniqid();

  # Create a conversion action.
  my $conversion_action =
    Google::Ads::GoogleAds::V17::Resources::ConversionAction->new({
      name                          => $conversion_action_name,
      category                      => DEFAULT,
      type                          => WEBPAGE,
      status                        => ENABLED,
      viewThroughLookbackWindowDays => 15,
      valueSettings                 =>
        Google::Ads::GoogleAds::V17::Resources::ValueSettings->new({
          defaultValue          => 23.41,
          alwaysUseDefaultValue => "true"
        })});

  # Create a conversion action operation.
  my $conversion_action_operation =
    Google::Ads::GoogleAds::V17::Services::ConversionActionService::ConversionActionOperation
    ->new({create => $conversion_action});

  # Add the conversion action.
  my $conversion_actions_response =
    $api_client->ConversionActionService()->mutate({
      customerId => $customer_id,
      operations => [$conversion_action_operation]});

  printf "New conversion action added with resource name: '%s'.\n",
    $conversion_actions_response->{results}[0]{resourceName};

  return 1;
}add_conversion_action.pl

ตัวอย่างนี้ยังอยู่ในโฟลเดอร์รีมาร์เก็ตติ้งของไลบรารีไคลเอ็นต์และในคอลเล็กชันตัวอย่างโค้ด: Add Conversion Action code example

การตรวจสอบความถูกต้อง

Google Ads และ Google Ads API รองรับการกระทำที่ถือเป็น Conversion หลายรูปแบบ กฎการตรวจสอบความถูกต้องบางกฎจึงแตกต่างกันไปตามการดำเนินการ type

โดยข้อผิดพลาดที่พบบ่อยที่สุดในการสร้างการกระทําที่ถือเป็น Conversion คือ DUPLICATE_NAME ตรวจสอบว่าคุณใช้ชื่อที่ไม่ซ้ำกันสําหรับการกระทําที่ถือเป็น Conversion แต่ละรายการ

เคล็ดลับในการตั้งค่าช่อง ConversionAction มีดังนี้

ช่อง enum ทั้งหมด

การพยายามตั้งค่าช่อง enum เป็น UNKNOWN จะทำให้เกิดข้อผิดพลาด RequestError.INVALID_ENUM_VALUE

app_id

แอตทริบิวต์ app_id จะเปลี่ยนแปลงไม่ได้และจะตั้งค่าได้เมื่อสร้าง Conversion แอปใหม่เท่านั้น

attribution_model_settings

การตั้งค่านี้เป็นตัวเลือกที่เลิกใช้งานแล้วจะส่งผลให้เกิดข้อผิดพลาด CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS Google Ads รองรับเฉพาะ GOOGLE_ADS_LAST_CLICK และ GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN

click_through_lookback_window_days

การตั้งค่าแอตทริบิวต์นี้เป็นค่านอกช่วงที่อนุญาตจะทำให้เกิดข้อผิดพลาด RangeError.TOO_LOW หรือ RangeError.TOO_HIGH

แอตทริบิวต์นี้ต้องอยู่ในช่วง [1,60] สำหรับการกระทำที่ถือเป็น Conversion AD_CALL หรือ WEBSITE_CALL สำหรับการกระทำที่ถือเป็น Conversion อื่นๆ ส่วนใหญ่ ช่วงที่อนุญาตคือ [1,30]

include_in_conversions_metric

การตั้งค่านี้ในการดำเนินการ create หรือ update ล้มเหลวโดยมีข้อผิดพลาด FieldError.IMMUTABLE_FIELD ให้ตั้งค่า primary_for_goal ตามที่อธิบายไว้ในคู่มือเป้าหมาย Conversion แทน

phone_call_duration_seconds

การพยายามตั้งค่าแอตทริบิวต์นี้ในการกระทำที่ถือเป็น Conversion ที่ไม่ใช่สำหรับการโทรทำให้เกิดข้อผิดพลาด FieldError.VALUE_MUST_BE_UNSET

type

แอตทริบิวต์ type จะเปลี่ยนแปลงไม่ได้และจะตั้งค่าได้เมื่อสร้าง Conversion ใหม่เท่านั้น

การอัปเดตการกระทำที่ถือเป็น Conversion ที่มี type เท่ากับ UNKNOWN จะทำให้เกิดข้อผิดพลาด MutateError.MUTATE_NOT_ALLOWED

value_settings

value_settings สำหรับการกระทำที่ถือเป็น Conversion WEBSITE_CALL หรือ AD_CALL ต้องตั้งค่า always_use_default_value เป็น true การระบุค่า false เมื่อสร้างหรืออัปเดตค่านี้จะส่งผลให้เกิดข้อผิดพลาด INVALID_VALUE

view_through_lookback_window_days

การตั้งค่าแอตทริบิวต์นี้เป็นค่านอกช่วงที่อนุญาตจะทำให้เกิดข้อผิดพลาด RangeError.TOO_LOW หรือ RangeError.TOO_HIGH สำหรับการกระทำที่ถือเป็น Conversion ส่วนใหญ่ ช่วงที่อนุญาตคือ [1,30]

ตั้งค่าแอตทริบิวต์นี้ในการกระทำที่ถือเป็น Conversion AD_CALL หรือ WEBSITE_CALL ไม่ได้ การระบุค่าจะทำให้เกิดข้อผิดพลาด VALUE_MUST_BE_UNSET

เริ่มต้นใช้งาน

อัปโหลด Conversion การคลิก