จัดการ Conversion ออฟไลน์

คุณสามารถใช้ Google Ads API เพื่อนําเข้า Conversion ออฟไลน์ไปยัง Google Ads เพื่อติดตามโฆษณาที่ทําให้เกิดยอดขายแบบออฟไลน์ เช่น ทางโทรศัพท์หรือผ่านตัวแทนฝ่ายขาย

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

หมายเหตุ: หากรวบรวมและนําเข้าข้อมูลที่ได้จากผู้ใช้ไม่ได้ คุณสามารถ ใช้การนําเข้า Conversion ออฟไลน์เดิมได้โดยทําตามคู่มือการนําเข้า Conversion ออฟไลน์เดิม

Conversion ที่ปรับปรุงแล้ว

Conversion ที่ปรับปรุงแล้วช่วยเพิ่มความแม่นยำของการวัด Conversion โดยการเสริม Conversion ด้วยข้อมูล Conversion จากบุคคลที่หนึ่ง เช่น อีเมล ชื่อ ที่อยู่บ้าน และหมายเลขโทรศัพท์

Conversion ที่ปรับปรุงแล้วมี 2 ประเภท ดูรายละเอียดเพิ่มเติมได้ที่บทความเกี่ยวกับ Conversion ที่ปรับปรุงแล้วในศูนย์ช่วยเหลือ

ส่วนต่อไปนี้อธิบายวิธีปรับปรุง Conversion ออฟไลน์ ซึ่งเป็นฟีเจอร์ที่เรียกอีกอย่างว่า Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย

Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขายคืออะไร

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

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

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

ข้อกำหนดเบื้องต้น

ก่อนอื่น โปรดตรวจสอบว่าคุณได้ทำตามขั้นตอนในส่วนการเริ่มต้นใช้งานแล้ว

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

SELECT
  customer.id,
  customer.conversion_tracking_setting.accepted_customer_data_terms,
  customer.conversion_tracking_setting.enhanced_conversions_for_leads_enabled
FROM customer

หาก accepted_customer_data_terms หรือ enhanced_conversions_for_leads_enabled เป็น false ให้ทำตามวิธีการในศูนย์ช่วยเหลือเพื่อ ทำข้อกำหนดเบื้องต้นเหล่านี้ให้เสร็จสมบูรณ์

กำหนดค่าการติดแท็ก

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

การใช้งาน API

ต่อไปนี้คือขั้นตอนโดยรวมสําหรับการนําเข้า Conversion ที่ปรับปรุงแล้วสําหรับโอกาสในการขายโดยใช้ Google Ads API

1. จัดรูปแบบและแฮชข้อมูลที่ได้จากผู้ใช้ เช่น อีเมล หมายเลขโทรศัพท์ และที่อยู่จัดส่ง

2. ป้อนข้อมูลลงในClickConversionออบเจ็กต์ ด้วยข้อมูลที่ได้จากผู้ใช้ซึ่งเป็นมาตรฐานและแฮชแล้ว

3. นำเข้าออบเจ็กต์ ClickConversion ไปยัง Google Ads API โดยใช้ ConversionUploadService

4. ตรวจสอบการนำเข้า

ลดความซ้ำซ้อนและแฮชข้อมูลที่ได้จากผู้ใช้

ข้อมูลต่อไปนี้ต้องได้รับการแฮชโดยใช้ SHA-256 ก่อนที่จะนำเข้า เพื่อคำนึงถึงความเป็นส่วนตัว

• อีเมล
• หมายเลขโทรศัพท์
• ชื่อ
• นามสกุล
• ที่อยู่

ก่อนแฮชค่าเหล่านี้ คุณต้องทำสิ่งต่อไปนี้เพื่อให้ผลลัพธ์การแฮชเป็นมาตรฐาน

• นําช่องว่างขึ้นต้นและต่อท้ายออก
• แปลงข้อความให้เป็นตัวพิมพ์เล็ก
• จัดรูปแบบหมายเลขโทรศัพท์ตามมาตรฐาน E164
• นําจุด (.) ที่อยู่ก่อนชื่อโดเมนในอีเมล gmail.com และ googlemail.com ออกทั้งหมด

อย่าแฮชข้อมูลต่อไปนี้

• ประเทศ
• รัฐ
• เมือง
• รหัสไปรษณีย์

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

ตัวอย่างนี้แสดงวิธีทำให้ข้อมูลที่ได้จากผู้ใช้เป็นมาตรฐานและแฮช

Java

private String normalizeAndHash(MessageDigest digest, String s)
    throws UnsupportedEncodingException {
  // Normalizes by first converting all characters to lowercase, then trimming spaces.
  String normalized = s.toLowerCase();
  // Removes leading, trailing, and intermediate spaces.
  normalized = normalized.replaceAll("\\s+", "");
  // Hashes the normalized string using the hashing algorithm.
  byte[] hash = digest.digest(normalized.getBytes("UTF-8"));
  StringBuilder result = new StringBuilder();
  for (byte b : hash) {
    result.append(String.format("%02x", b));
  }

  return result.toString();
}

/**
 * Returns the result of normalizing and hashing an email address. For this use case, Google Ads
 * requires removal of any '.' characters preceding {@code gmail.com} or {@code googlemail.com}.
 *
 * @param digest the digest to use to hash the normalized string.
 * @param emailAddress the email address to normalize and hash.
 */
private String normalizeAndHashEmailAddress(MessageDigest digest, String emailAddress)
    throws UnsupportedEncodingException {
  String normalizedEmail = emailAddress.toLowerCase();
  String[] emailParts = normalizedEmail.split("@");
  if (emailParts.length > 1 && emailParts[1].matches("^(gmail|googlemail)\\.com\\s*")) {
    // Removes any '.' characters from the portion of the email address before the domain if the
    // domain is gmail.com or googlemail.com.
    emailParts[0] = emailParts[0].replaceAll("\\.", "");
    normalizedEmail = String.format("%s@%s", emailParts[0], emailParts[1]);
  }
  return normalizeAndHash(digest, normalizedEmail);
}
UploadEnhancedConversionsForLeads.java
      

C#

/// <summary>
/// Normalizes the email address and hashes it. For this use case, Google Ads requires
/// removal of any '.' characters preceding <code>gmail.com</code> or
/// <code>googlemail.com</code>.
/// </summary>
/// <param name="emailAddress">The email address.</param>
/// <returns>The hash code.</returns>
private string NormalizeAndHashEmailAddress(string emailAddress)
{
    string normalizedEmail = emailAddress.ToLower();
    string[] emailParts = normalizedEmail.Split('@');
    if (emailParts.Length > 1 && (emailParts[1] == "gmail.com" ||
        emailParts[1] == "googlemail.com"))
    {
        // Removes any '.' characters from the portion of the email address before
        // the domain if the domain is gmail.com or googlemail.com.
        emailParts[0] = emailParts[0].Replace(".", "");
        normalizedEmail = $"{emailParts[0]}@{emailParts[1]}";
    }
    return NormalizeAndHash(normalizedEmail);
}

/// <summary>
/// Normalizes and hashes a string value.
/// </summary>
/// <param name="value">The value to normalize and hash.</param>
/// <returns>The normalized and hashed value.</returns>
private static string NormalizeAndHash(string value)
{
    return ToSha256String(digest, ToNormalizedValue(value));
}

/// <summary>
/// Hash a string value using SHA-256 hashing algorithm.
/// </summary>
/// <param name="digest">Provides the algorithm for SHA-256.</param>
/// <param name="value">The string value (e.g. an email address) to hash.</param>
/// <returns>The hashed value.</returns>
private static string ToSha256String(SHA256 digest, string value)
{
    byte[] digestBytes = digest.ComputeHash(Encoding.UTF8.GetBytes(value));
    // Convert the byte array into an unhyphenated hexadecimal string.
    return BitConverter.ToString(digestBytes).Replace("-", string.Empty);
}

/// <summary>
/// Removes leading and trailing whitespace and converts all characters to
/// lower case.
/// </summary>
/// <param name="value">The value to normalize.</param>
/// <returns>The normalized value.</returns>
private static string ToNormalizedValue(string value)
{
    return value.Trim().ToLower();
}
UploadEnhancedConversionsForLeads.cs
      

PHP

private static function normalizeAndHash(string $hashAlgorithm, string $value): string
{
    // Normalizes by first converting all characters to lowercase, then trimming spaces.
    $normalized = strtolower($value);
    // Removes leading, trailing, and intermediate spaces.
    $normalized = str_replace(' ', '', $normalized);
    return hash($hashAlgorithm, strtolower(trim($normalized)));
}

/**
 * Returns the result of normalizing and hashing an email address. For this use case, Google
 * Ads requires removal of any '.' characters preceding "gmail.com" or "googlemail.com".
 *
 * @param string $hashAlgorithm the hash algorithm to use
 * @param string $emailAddress the email address to normalize and hash
 * @return string the normalized and hashed email address
 */
private static function normalizeAndHashEmailAddress(
    string $hashAlgorithm,
    string $emailAddress
): string {
    $normalizedEmail = strtolower($emailAddress);
    $emailParts = explode("@", $normalizedEmail);
    if (
        count($emailParts) > 1
        && preg_match('/^(gmail|googlemail)\.com\s*/', $emailParts[1])
    ) {
        // Removes any '.' characters from the portion of the email address before the domain
        // if the domain is gmail.com or googlemail.com.
        $emailParts[0] = str_replace(".", "", $emailParts[0]);
        $normalizedEmail = sprintf('%s@%s', $emailParts[0], $emailParts[1]);
    }
    return self::normalizeAndHash($hashAlgorithm, $normalizedEmail);
}
UploadEnhancedConversionsForLeads.php
      

Python

def normalize_and_hash_email_address(email_address):
    """Returns the result of normalizing and hashing an email address.

    For this use case, Google Ads requires removal of any '.' characters
    preceding "gmail.com" or "googlemail.com"

    Args:
        email_address: An email address to normalize.

    Returns:
        A normalized (lowercase, removed whitespace) and SHA-265 hashed string.
    """
    normalized_email = email_address.strip().lower()
    email_parts = normalized_email.split("@")

    # Check that there are at least two segments
    if len(email_parts) > 1:
        # Checks whether the domain of the email address is either "gmail.com"
        # or "googlemail.com". If this regex does not match then this statement
        # will evaluate to None.
        if re.match(r"^(gmail|googlemail)\.com$", email_parts[1]):
            # Removes any '.' characters from the portion of the email address
            # before the domain if the domain is gmail.com or googlemail.com.
            email_parts[0] = email_parts[0].replace(".", "")
            normalized_email = "@".join(email_parts)

    return normalize_and_hash(normalized_email)


def normalize_and_hash(s):
    """Normalizes and hashes a string with SHA-256.

    Private customer data must be hashed during upload, as described at:
    https://support.google.com/google-ads/answer/7474263

    Args:
        s: The string to perform this operation on.

    Returns:
        A normalized (lowercase, removed whitespace) and SHA-256 hashed string.
    """
    return hashlib.sha256(s.strip().lower().encode()).hexdigest()
upload_enhanced_conversions_for_leads.py
      

Ruby

# Returns the result of normalizing and then hashing the string using the
# provided digest.  Private customer data must be hashed during upload, as
# described at https://support.google.com/google-ads/answer/7474263.
def normalize_and_hash(str)
  # Remove leading and trailing whitespace and ensure all letters are lowercase
  # before hashing.
  Digest::SHA256.hexdigest(str.strip.downcase)
end

# Returns the result of normalizing and hashing an email address. For this use
# case, Google Ads requires removal of any '.' characters preceding 'gmail.com'
# or 'googlemail.com'.
def normalize_and_hash_email(email)
  email_parts = email.downcase.split("@")
  # Removes any '.' characters from the portion of the email address before the
  # domain if the domain is gmail.com or googlemail.com.
  if email_parts.last =~ /^(gmail|googlemail)\.com\s*/
    email_parts[0] = email_parts[0].gsub('.', '')
  end
  normalize_and_hash(email_parts.join('@'))
end
upload_enhanced_conversions_for_leads.rb
      

Perl

sub normalize_and_hash {
  my $value = shift;

  # Removes leading, trailing, and intermediate spaces.
  $value =~ s/\s+//g;
  return sha256_hex(lc $value);
}

# Returns the result of normalizing and hashing an email address. For this use
# case, Google Ads requires removal of any '.' characters preceding 'gmail.com'
# or 'googlemail.com'.
sub normalize_and_hash_email_address {
  my $email_address = shift;

  my $normalized_email = lc $email_address;
  my @email_parts      = split('@', $normalized_email);
  if (scalar @email_parts > 1
    && $email_parts[1] =~ /^(gmail|googlemail)\.com\s*/)
  {
    # Remove any '.' characters from the portion of the email address before the
    # domain if the domain is 'gmail.com' or 'googlemail.com'.
    $email_parts[0] =~ s/\.//g;
    $normalized_email = sprintf '%s@%s', $email_parts[0], $email_parts[1];
  }
  return normalize_and_hash($normalized_email);
}
upload_enhanced_conversions_for_leads.pl
      

ป้อนข้อมูลออบเจ็กต์ ClickConversion

คอลเล็กชันของออบเจ็กต์ ClickConversion ใน UploadClickConversionRequest แสดงชุด Conversion ที่คุณต้องการนำเข้า โปรดคำนึงถึงรายละเอียดต่อไปนี้เมื่อสร้างออบเจ็กต์ ClickConversion

gclid

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

สำคัญ: เราขอแนะนำให้ใส่ GCLID ในคำขอนำเข้าเมื่อเป็นไปได้ แม้ว่าคุณจะตั้งค่าแท็ก Google เพื่อติดตาม Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขายแล้วก็ตาม

user_identifiers

เมื่อใช้ Conversion ที่ปรับปรุงแล้วสําหรับโอกาสในการขาย คุณต้องระบุค่าในฟิลด์ user_identifiers ด้วยข้อมูลที่ได้จากผู้ใช้ที่ผ่านการแฮชและปรับให้เป็นมาตรฐาน หากมีตัวระบุผู้ใช้หลายรายการ ให้สร้าง UserIdentifier แยกกันสำหรับแต่ละตัวระบุ โดยสร้างได้สูงสุด 5 ตัวระบุ

สำคัญ: คุณสามารถและควรส่งข้อมูลที่เกี่ยวข้องทั้งหมดสําหรับ Conversion ที่กําหนด แม้ว่าจะไม่มี GCLID สําหรับ Conversion นั้นก็ตาม Conversion ที่มี เฉพาะข้อมูลที่ได้จากผู้ใช้ยังคงมีประโยชน์และช่วยเพิ่มประสิทธิภาพแคมเปญได้

conversion_date_time

วันที่และเวลาของ Conversion

ค่าต้องระบุเขตเวลาและรูปแบบต้องเป็น yyyy-mm-dd HH:mm:ss+|-HH:mm เช่น 2022-01-01 19:32:45-05:00 (ไม่สนใจเวลาออมแสง)

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

หมายเหตุ: หากนําเข้า Conversion สําหรับค่าคอมมิชชัน (จ่ายต่อ Conversion) สําหรับโฆษณาโรงแรม คุณจะนําเข้าได้เฉพาะ Conversion สําหรับการคลิกที่เกิดขึ้นในเดือนเดียวกัน ระบบจะไม่สนใจ Conversion ที่ นําเข้าหลังจากเวลา 04:00 น.ตามเวลาแปซิฟิก (PT) ในวันที่ 1 ของเดือนถัดไป เมื่อเกิดการคลิก

conversion_action

ชื่อทรัพยากรของ ConversionAction สําหรับ Conversion ออฟไลน์

การกระทําที่ถือเป็น Conversion ต้องมี type เป็น UPLOAD_CLICKS และต้องอยู่ในลูกค้า Conversion ของ Google Ads ของบัญชี Google Ads ที่เชื่อมโยงกับคลิก

conversion_value

มูลค่าของ Conversion

currency_code

รหัสสกุลเงินของ conversion_value

consent

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

order_id

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

custom_variables

ค่าของตัวแปร Conversion ที่กําหนดเอง

Google Ads ไม่รองรับตัวแปร Conversion ที่กำหนดเองร่วมกับ wbraid หรือ gbraid

conversion_environment

ระบุสภาพแวดล้อมที่บันทึก Conversion นี้ เช่น APP หรือ WEB

session_attributes_encoded และ session_attributes_key_value_pairs

แอตทริบิวต์เซสชันแสดงถึงตัวระบุแบบรวมที่ใช้สำหรับการระบุแหล่งที่มาของ Conversion ซึ่งจะทำงานเพิ่มเติมจากตัวระบุคลิก (เช่น GCLID และ GBRAID) และข้อมูลที่ได้จากผู้ใช้ ซึ่งเป็นหัวใจสำคัญของ Conversion ที่ปรับปรุงแล้วสำหรับ โอกาสในการขาย การนําเข้าแอตทริบิวต์เซสชันทําได้ 2 วิธี ได้แก่ การระบุโทเค็นที่เข้ารหัสซึ่งสร้างโดยโค้ด JavaScript ในเบราว์เซอร์ หรือการระบุคู่คีย์-ค่าแต่ละคู่สําหรับตัวระบุแต่ละรายการ

เราขอแนะนําให้นําเข้าตัวระบุคลิก ข้อมูลที่ได้จากผู้ใช้ และแอตทริบิวต์เซสชันพร้อมกับ Conversion ทั้งหมด หากเป็นไปได้ เพื่อเพิ่มประสิทธิภาพแคมเปญให้ได้สูงสุด

Java

// Sets one of the sessionAttributesEncoded or sessionAttributesKeyValuePairs if either is
// provided.
if (rawRecord.containsKey("sessionAttributesEncoded")) {
  clickConversionBuilder.setSessionAttributesEncoded(
      ByteString.copyFromUtf8(rawRecord.get("sessionAttributesEncoded")));
} else if (rawRecord.containsKey("sessionAttributesMap")) {
  List<String> pairings =
      Arrays.stream(rawRecord.get("sessionAttributesMap").split(" "))
          .map(String::trim)
          .collect(Collectors.toList());
  SessionAttributesKeyValuePairs.Builder sessionAttributePairs =
      SessionAttributesKeyValuePairs.newBuilder();
  for (String pair : pairings) {
    String[] parts = pair.split("=", 2);
    if (parts.length != 2) {
      throw new IllegalArgumentException(
          "Failed to read the sessionAttributesMap. SessionAttributesMap must use a "
              + "space-delimited list of session attribute key value pairs. Each pair should be"
              + " separated by an equal sign, for example: 'gad_campaignid=12345 gad_source=1'");
    }
    sessionAttributePairs.addKeyValuePairs(
        SessionAttributeKeyValuePair.newBuilder()
            .setSessionAttributeKey(parts[0])
            .setSessionAttributeValue(parts[1])
            .build());
  }
  clickConversionBuilder.setSessionAttributesKeyValuePairs(sessionAttributePairs.build());
}
UploadEnhancedConversionsForLeads.java
      

C#

if (!string.IsNullOrEmpty(sessionAttributesEncoded))
{
    clickConversion.SessionAttributesEncoded =
        ByteString.CopyFrom(sessionAttributesEncoded, Encoding.Unicode);
}
else if (!string.IsNullOrEmpty(sessionAttributes))
{
    IEnumerable<SessionAttributeKeyValuePair> parsedSessionAttributes =
        sessionAttributes.Split(';').Select(pair => {
            string[] split = pair.Split('=');
            return new SessionAttributeKeyValuePair()
            {
                SessionAttributeKey = split[0],
                SessionAttributeValue = split[1]
            };
        });

    clickConversion.SessionAttributesKeyValuePairs =
        new SessionAttributesKeyValuePairs();
    clickConversion.SessionAttributesKeyValuePairs.KeyValuePairs
        .AddRange(parsedSessionAttributes);
}
UploadEnhancedConversionsForLeads.cs
      

PHP

This example is not yet available in PHP; you can take a look at the other languages.
    

Python

# Set one of the session_attributes_encoded or
# session_attributes_key_value_pairs fields if either are provided.
if session_attributes_encoded:
    click_conversion.session_attributes_encoded = session_attributes_encoded
elif session_attributes_dict:
    for key, value in session_attributes_dict.items():
        pair = client.get_type("SessionAttributeKeyValuePair")
        pair.session_attribute_key = key
        pair.session_attribute_value = value
        click_conversion.session_attributes_key_value_pairs.key_value_pairs.append(
            pair
        )
upload_enhanced_conversions_for_leads.py
      

Ruby

This example is not yet available in Ruby; you can take a look at the other languages.
    

Perl

# Set one of the session_attributes_encoded or session_attributes_key_value_pairs
# fields if either are provided.
if (defined $session_attributes_encoded) {
  $click_conversion->{sessionAttributesEncoded} = $session_attributes_encoded;
} elsif (defined $session_attributes_hash) {
  while (my ($key, $value) = each %$session_attributes_hash) {
    my $pair =
      Google::Ads::GoogleAds::V20::Services::ConversionUploadService::SessionAttributeKeyValuePair
      ->new({sessionAttributeKey => $key, sessionAttributeValue => $value});
    push @{$click_conversion->{sessionAttributesKeyValuePairs}{keyValuePairs}
    }, $pair;
  }
}
upload_enhanced_conversions_for_leads.pl
      

user_ip_address

ที่อยู่ IP ของลูกค้าเมื่อมาถึงหน้า Landing Page หลังจากคลิกโฆษณาและก่อนเหตุการณ์ Conversion นี่คือที่อยู่ IP ของ อุปกรณ์ของลูกค้า ไม่ใช่เซิร์ฟเวอร์ของผู้ลงโฆษณา

ฟิลด์นี้เป็นสตริงที่แสดงที่อยู่ IP ในรูปแบบ IPv4 หรือ IPv6 เช่น

• IPv4: "192.0.2.0"
• IPv6: "2001:0DB8:1234:5678:9999:1111:0000:0001"

หมายเหตุ: Google Ads ไม่รองรับการจับคู่ที่อยู่ IP สำหรับผู้ใช้ปลายทางใน เขตเศรษฐกิจยุโรป (EEA), สหราชอาณาจักร (UK) หรือสวิตเซอร์แลนด์ (CH) เพิ่มตรรกะเพื่อยกเว้นการแชร์ที่อยู่ IP จากผู้ใช้จาก ภูมิภาคเหล่านี้แบบมีเงื่อนไข และตรวจสอบว่าคุณให้ข้อมูลที่ชัดเจนและครอบคลุม แก่ผู้ใช้เกี่ยวกับข้อมูลที่คุณเก็บรวบรวมในเว็บไซต์ แอป และพร็อพเพอร์ตี้อื่นๆ พร้อมทั้งได้รับความยินยอมตามที่กฎหมายหรือนโยบายที่เกี่ยวข้องของ Google กำหนด ดูรายละเอียดเพิ่มเติมได้ที่หน้าเกี่ยวกับการนำเข้า Conversion ออฟไลน์

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

ตัวอย่างนี้แสดงวิธีตั้งค่าข้อมูลที่ได้จากผู้ใช้ซึ่งเป็นมาตรฐานและแฮชแล้วในออบเจ็กต์ ClickConversion

Java

// Creates an empty builder for constructing the click conversion.
ClickConversion.Builder clickConversionBuilder = ClickConversion.newBuilder();

// Extracts user email and phone from the raw data, normalizes and hashes it, then wraps it in
// UserIdentifier objects.
// Creates a separate UserIdentifier object for each. The data in this example is hardcoded, but
// in your application you might read the raw data from an input file.

// IMPORTANT: Since the identifier attribute of UserIdentifier
// (https://developers.google.com/google-ads/api/reference/rpc/latest/UserIdentifier) is a
// oneof
// (https://protobuf.dev/programming-guides/proto3/#oneof-features), you must set only ONE of
// hashedEmail, hashedPhoneNumber, mobileId, thirdPartyUserId, or addressInfo. Setting more
// than one of these attributes on the same UserIdentifier will clear all the other members
// of the oneof. For example, the following code is INCORRECT and will result in a
// UserIdentifier with ONLY a hashedPhoneNumber.
//
// UserIdentifier incorrectlyPopulatedUserIdentifier =
//     UserIdentifier.newBuilder()
//         .setHashedEmail("...")
//         .setHashedPhoneNumber("...")
//         .build();

ImmutableMap.Builder<String, String> rawRecordBuilder =
    ImmutableMap.<String, String>builder()
        .put("email", "[e-mail]")
        // Phone number to be converted to E.164 format, with a leading '+' as required.
        .put("phone", "[phone]")
        // This example lets you put conversion details as arguments, but in reality you might
        // store this data alongside other user data, so we include it in this sample user
        // record.
        .put("conversionActionId", Long.toString(conversionActionId))
        .put("conversionDateTime", conversionDateTime)
        .put("conversionValue", Double.toString(conversionValue))
        .put("currencyCode", "USD");

// Adds entries for the optional fields.
if (orderId != null) {
  rawRecordBuilder.put("orderId", orderId);
}
if (gclid != null) {
  rawRecordBuilder.put("gclid", gclid);
}
if (adUserDataConsent != null) {
  rawRecordBuilder.put("adUserDataConsent", adUserDataConsent.name());
}
if (sessionAttributesEncoded != null) {
  rawRecordBuilder.put("sessionAttributesEncoded", sessionAttributesEncoded);
}
if (sessionAttributesMap != null) {
  rawRecordBuilder.put("sessionAttributesMap", sessionAttributesMap);
}

// Builds the map representing the record.
Map<String, String> rawRecord = rawRecordBuilder.build();

// Creates a SHA256 message digest for hashing user identifiers in a privacy-safe way, as
// described at https://support.google.com/google-ads/answer/9888656.
MessageDigest sha256Digest = MessageDigest.getInstance("SHA-256");

// Creates a list for the user identifiers.
List<UserIdentifier> userIdentifiers = new ArrayList<>();

// Creates a user identifier using the hashed email address, using the normalize and hash method
// specifically for email addresses.
UserIdentifier emailIdentifier =
    UserIdentifier.newBuilder()
        // Optional: specify the user identifier source.
        .setUserIdentifierSource(UserIdentifierSource.FIRST_PARTY)
        // Uses the normalize and hash method specifically for email addresses.
        .setHashedEmail(normalizeAndHashEmailAddress(sha256Digest, rawRecord.get("email")))
        .build();
userIdentifiers.add(emailIdentifier);

// Creates a user identifier using normalized and hashed phone info.
UserIdentifier hashedPhoneNumberIdentifier =
    UserIdentifier.newBuilder()
        .setHashedPhoneNumber(normalizeAndHash(sha256Digest, rawRecord.get("phone")))
        .build();
// Adds the hashed phone number identifier to the UserData object's list.
userIdentifiers.add(hashedPhoneNumberIdentifier);

// Adds the user identifiers to the conversion.
clickConversionBuilder.addAllUserIdentifiers(userIdentifiers);
UploadEnhancedConversionsForLeads.java
      

C#

// Adds a user identifier using the hashed email address, using the normalize
// and hash method specifically for email addresses.
clickConversion.UserIdentifiers.Add(new UserIdentifier()
{
    HashedEmail = NormalizeAndHashEmailAddress("[e-mail]"),
    // Optional: Specifies the user identifier source.
    UserIdentifierSource = UserIdentifierSource.FirstParty
});

// Adds a user identifier using normalized and hashed phone info.
clickConversion.UserIdentifiers.Add(new UserIdentifier()
{
    HashedPhoneNumber = NormalizeAndHash("[phone]"),
    // Optional: Specifies the user identifier source.
    UserIdentifierSource = UserIdentifierSource.FirstParty
});

// Adds a user identifier with all the required mailing address elements.
clickConversion.UserIdentifiers.Add(new UserIdentifier()
{
    AddressInfo = new OfflineUserAddressInfo()
    {
        // FirstName and LastName must be normalized and hashed.
        HashedFirstName = NormalizeAndHash("Alex"),
        HashedLastName = NormalizeAndHash("Quinn"),
        // CountryCode and PostalCode are sent in plain text.
        CountryCode = "US",
        PostalCode = "94045"
    }
});
UploadEnhancedConversionsForLeads.cs
      

PHP

// Creates a click conversion with the specified attributes.
$clickConversion = new ClickConversion();

// Extract user email and phone from the raw data, normalize and hash it, then wrap it in
// UserIdentifier objects. Creates a separate UserIdentifier object for each.
// The data in this example is hardcoded, but in your application you might read the raw
// data from an input file.

// IMPORTANT: Since the identifier attribute of UserIdentifier
// (https://developers.google.com/google-ads/api/reference/rpc/latest/UserIdentifier) is a
// oneof
// (https://protobuf.dev/programming-guides/proto3/#oneof-features), you must set only ONE
// of hashedEmail, hashedPhoneNumber, mobileId, thirdPartyUserId, or addressInfo. Setting
// more than one of these attributes on the same UserIdentifier will clear all the other
// members of the oneof. For example, the following code is INCORRECT and will result in a
// UserIdentifier with ONLY a hashedPhoneNumber.
//
// $incorrectlyPopulatedUserIdentifier = new UserIdentifier([
//    'hashed_email' => '...',
//    'hashed_phone_number' => '...'
// ]);

$rawRecord = [
    // Email address that includes a period (.) before the Gmail domain.
    'email' => '[e-mail]',
    // Phone number to be converted to E.164 format, with a leading '+' as required.
    'phone' => '[phone]',
    // This example lets you input conversion details as arguments, but in reality you might
    // store this data alongside other user data, so we include it in this sample user
    // record.
    'orderId' => $orderId,
    'gclid' => $gclid,
    'conversionActionId' => $conversionActionId,
    'conversionDateTime' => $conversionDateTime,
    'conversionValue' => $conversionValue,
    'currencyCode' => 'USD',
    'adUserDataConsent' => $adUserDataConsent,
    'sessionAttributesEncoded' => $sessionAttributesEncoded,
    'sessionAttributesDict' => $sessionAttributesDict
];

// Creates a list for the user identifiers.
$userIdentifiers = [];

// Uses the SHA-256 hash algorithm for hashing user identifiers in a privacy-safe way, as
// described at https://support.google.com/google-ads/answer/9888656.
$hashAlgorithm = "sha256";

// Creates a user identifier using the hashed email address, using the normalize and hash
// method specifically for email addresses.
$emailIdentifier = new UserIdentifier([
    // Uses the normalize and hash method specifically for email addresses.
    'hashed_email' => self::normalizeAndHashEmailAddress(
        $hashAlgorithm,
        $rawRecord['email']
    ),
    // Optional: Specifies the user identifier source.
    'user_identifier_source' => UserIdentifierSource::FIRST_PARTY
]);
$userIdentifiers[] = $emailIdentifier;

// Checks if the record has a phone number, and if so, adds a UserIdentifier for it.
if (array_key_exists('phone', $rawRecord)) {
    $hashedPhoneNumberIdentifier = new UserIdentifier([
        'hashed_phone_number' => self::normalizeAndHash(
            $hashAlgorithm,
            $rawRecord['phone'],
            true
        )
    ]);
    // Adds the hashed email identifier to the user identifiers list.
    $userIdentifiers[] = $hashedPhoneNumberIdentifier;
}

// Adds the user identifiers to the conversion.
$clickConversion->setUserIdentifiers($userIdentifiers);
UploadEnhancedConversionsForLeads.php
      

Python

# Extract user email and phone from the raw data, normalize and hash it,
# then wrap it in UserIdentifier objects. Create a separate UserIdentifier
# object for each. The data in this example is hardcoded, but in your
# application you might read the raw data from an input file.

# IMPORTANT: Since the identifier attribute of UserIdentifier
# (https://developers.google.com/google-ads/api/reference/rpc/latest/UserIdentifier)
# is a oneof
# (https://protobuf.dev/programming-guides/proto3/#oneof-features), you must
# set only ONE of hashed_email, hashed_phone_number, mobile_id,
# third_party_user_id, or address_info. Setting more than one of these
# attributes on the same UserIdentifier will clear all the other members of
# the oneof. For example, the following code is INCORRECT and will result in
# a UserIdentifier with ONLY a hashed_phone_number:
#
# incorrectly_populated_user_identifier = client.get_type("UserIdentifier")
# incorrectly_populated_user_identifier.hashed_email = "...""
# incorrectly_populated_user_identifier.hashed_phone_number = "...""

raw_record = {
    # Email address that includes a period (.) before the Gmail domain.
    "email": "[e-mail]",
    # Phone number to be converted to E.164 format, with a leading '+' as
    # required.
    "phone": "[phone]",
    # This example lets you input conversion details as arguments,
    # but in reality you might store this data alongside other user data,
    # so we include it in this sample user record.
    "order_id": order_id,
    "gclid": gclid,
    "conversion_action_id": conversion_action_id,
    "conversion_date_time": conversion_date_time,
    "conversion_value": conversion_value,
    "currency_code": "USD",
    "ad_user_data_consent": ad_user_data_consent,
}

# Constructs the click conversion.
click_conversion = client.get_type("ClickConversion")
# Creates a user identifier using the hashed email address, using the
# normalize and hash method specifically for email addresses.
email_identifier = client.get_type("UserIdentifier")
# Optional: Specifies the user identifier source.
email_identifier.user_identifier_source = (
    client.enums.UserIdentifierSourceEnum.FIRST_PARTY
)
# Uses the normalize and hash method specifically for email addresses.
email_identifier.hashed_email = normalize_and_hash_email_address(
    raw_record["email"]
)
# Adds the user identifier to the conversion.
click_conversion.user_identifiers.append(email_identifier)

# Checks if the record has a phone number, and if so, adds a UserIdentifier
# for it.
if raw_record.get("phone") is not None:
    phone_identifier = client.get_type("UserIdentifier")
    phone_identifier.hashed_phone_number = normalize_and_hash(
        raw_record["phone"]
    )
    # Adds the phone identifier to the conversion adjustment.
    click_conversion.user_identifiers.append(phone_identifier)
upload_enhanced_conversions_for_leads.py
      

Ruby

# Extract user email and phone from the raw data, normalize and hash it,
# then wrap it in UserIdentifier objects. Create a separate UserIdentifier
# object for each. The data in this example is hardcoded, but in your
# application you might read the raw data from an input file.

# IMPORTANT: Since the identifier attribute of UserIdentifier
# (https://developers.google.com/google-ads/api/reference/rpc/latest/UserIdentifier)
# is a oneof
# (https://protobuf.dev/programming-guides/proto3/#oneof-features), you must
# set only ONE of hashed_email, hashed_phone_number, mobile_id,
# third_party_user_id, or address_info. Setting more than one of these
# attributes on the same UserIdentifier will clear all the other members of
# the oneof. For example, the following code is INCORRECT and will result in
# a UserIdentifier with ONLY a hashed_phone_number:
#
# incorrectly_populated_user_identifier.hashed_email = "...""
# incorrectly_populated_user_identifier.hashed_phone_number = "...""

raw_record = {
  # Email address that includes a period (.) before the Gmail domain.
  "email" => "[e-mail]",
  # Phone number to be converted to E.164 format, with a leading '+' as
  # required.
  "phone" => "[phone]",
  # This example lets you input conversion details as arguments,
  # but in reality you might store this data alongside other user data,
  # so we include it in this sample user record.
  "order_id" => order_id,
  "gclid" => gclid,
  "conversion_action_id" => conversion_action_id,
  "conversion_date_time" => conversion_date_time,
  "conversion_value" => conversion_value,
  "currency_code" => "USD",
  "ad_user_data_consent" => ad_user_data_consent,
  "session_attributes_encoded" => session_attributes_encoded,
  "session_attributes_hash" => session_attributes_hash
}

click_conversion = client.resource.click_conversion do |cc|
  cc.conversion_action = client.path.conversion_action(customer_id, conversion_action_id)
  cc.conversion_date_time = conversion_date_time
  cc.conversion_value = conversion_value.to_f
  cc.currency_code = 'USD'

  unless order_id.nil?
    cc.order_id = order_id
  end

  unless raw_record["gclid"].nil?
    cc.gclid = gclid
  end

  # Specifies whether user consent was obtained for the data you are
  # uploading. For more details, see:
  # https://www.google.com/about/company/user-consent-policy
  unless raw_record["ad_user_data_consent"].nil?
    cc.consent = client.resource.consent do |c|
      c.ad_user_data = ad_user_data_consent
    end
  end

  # Set one of the session_attributes_encoded or
  # session_attributes_key_value_pairs fields if either are provided.
  if session_attributes_encoded != nil
    cc.class.module_eval { attr_accessor :session_attributes_encoded}
    cc.session_attributes_encoded = session_attributes_encoded
  elsif session_attributes_hash != nil
    # Add new attribute to click conversion object
    cc.class.module_eval { attr_accessor :session_attributes_key_value_pairs}
    cc.session_attributes_key_value_pairs = ::Google::Ads::GoogleAds::V19::Services::SessionAttributesKeyValuePairs.new

    # Loop thru inputted session_attributes_hash to populate session_attributes_key_value_pairs
    session_attributes_hash.each do |key, value|
      pair = ::Google::Ads::GoogleAds::V19::Services::SessionAttributeKeyValuePair.new
      pair.session_attribute_key = key
      pair.session_attribute_value = value
      cc.session_attributes_key_value_pairs.key_value_pairs << pair
    end
  end    

  # Creates a user identifier using the hashed email address, using the
  # normalize and hash method specifically for email addresses.
  # If using a phone number, use the normalize_and_hash method instead.
  cc.user_identifiers << client.resource.user_identifier do |ui|
    ui.hashed_email = normalize_and_hash_email(raw_record["email"])
    # Optional: Specifies the user identifier source.
    ui.user_identifier_source = :FIRST_PARTY
  end

  # Checks if the record has a phone number, and if so, adds a UserIdentifier
  # for it.
  unless raw_record["phone"].nil?
    cc.user_identifiers << client.resource.user_identifier do |ui|
      ui.hashed_phone_number = normalize_and_hash(raw_record["phone"])
    end
  end
end
upload_enhanced_conversions_for_leads.rb
      

Perl

# Create an empty click conversion.
my $click_conversion =
  Google::Ads::GoogleAds::V20::Services::ConversionUploadService::ClickConversion
  ->new({});

# Extract user email and phone from the raw data, normalize and hash it,
# then wrap it in UserIdentifier objects. Create a separate UserIdentifier
# object for each.
# The data in this example is hardcoded, but in your application
# you might read the raw data from an input file.
#
# IMPORTANT: Since the identifier attribute of UserIdentifier
# (https://developers.google.com/google-ads/api/reference/rpc/latest/UserIdentifier)
# is a oneof
# (https://protobuf.dev/programming-guides/proto3/#oneof-features), you must set
# only ONE of hashed_email, hashed_phone_number, mobile_id, third_party_user_id,
# or address-info. Setting more than one of these attributes on the same UserIdentifier
# will clear all the other members of the oneof. For example, the following code is
# INCORRECT and will result in a UserIdentifier with ONLY a hashed_phone_number:
#
# my $incorrect_user_identifier = Google::Ads::GoogleAds::V20::Common::UserIdentifier->new({
#   hashedEmail => '...',
#   hashedPhoneNumber => '...',
# });
my $raw_record = {
  # Email address that includes a period (.) before the Gmail domain.
  email => '[e-mail]',
  # Phone number to be converted to E.164 format, with a leading '+' as
  # required.
  phone => '[phone]',
  # This example lets you input conversion details as arguments,
  # but in reality you might store this data alongside other user data,
  # so we include it in this sample user record.
  orderId            => $order_id,
  gclid              => $gclid,
  conversionActionId => $conversion_action_id,
  conversionDateTime => $conversion_date_time,
  conversionValue    => $conversion_value,
  currencyCode       => "USD",
  adUserDataConsent  => $ad_user_data_consent
};
my $user_identifiers = [];

# Create a user identifier using the hashed email address, using the normalize
# and hash method specifically for email addresses.
my $hashed_email = normalize_and_hash_email_address($raw_record->{email});
push(
  @$user_identifiers,
  Google::Ads::GoogleAds::V20::Common::UserIdentifier->new({
      hashedEmail => $hashed_email,
      # Optional: Specify the user identifier source.
      userIdentifierSource => FIRST_PARTY
    }));

# Create a user identifier using normalized and hashed phone info.
my $hashed_phone = normalize_and_hash($raw_record->{phone});
push(
  @$user_identifiers,
  Google::Ads::GoogleAds::V20::Common::UserIdentifier->new({
      hashedPhone => $hashed_phone,
      # Optional: Specify the user identifier source.
      userIdentifierSource => FIRST_PARTY
    }));

# Add the user identifiers to the conversion.
$click_conversion->{userIdentifiers} = $user_identifiers;
upload_enhanced_conversions_for_leads.pl
      

ตัวอย่างนี้แสดงวิธีตั้งค่าฟิลด์อื่นๆ ที่จำเป็นในClickConversion ออบเจ็กต์

Java

// Adds details of the conversion.
clickConversionBuilder.setConversionAction(
    ResourceNames.conversionAction(
        customerId, Long.parseLong(rawRecord.get("conversionActionId"))));
clickConversionBuilder.setConversionDateTime(rawRecord.get("conversionDateTime"));
clickConversionBuilder.setConversionValue(Double.parseDouble(rawRecord.get("conversionValue")));
clickConversionBuilder.setCurrencyCode(rawRecord.get("currencyCode"));

// Sets the order ID if provided.
if (rawRecord.containsKey("orderId")) {
  clickConversionBuilder.setOrderId(rawRecord.get("orderId"));
}

// Sets the Google click ID (gclid) if provided.
if (rawRecord.containsKey("gclid")) {
  clickConversionBuilder.setGclid(rawRecord.get("gclid"));
}

// Sets the consent information, if provided.
if (rawRecord.containsKey("adUserDataConsent")) {
  // Specifies whether user consent was obtained for the data you are uploading. See
  // https://www.google.com/about/company/user-consent-policy for details.
  clickConversionBuilder.setConsent(
      Consent.newBuilder()
          .setAdUserData(ConsentStatus.valueOf(rawRecord.get("adUserDataConsent"))));
}

// Sets one of the sessionAttributesEncoded or sessionAttributesKeyValuePairs if either is
// provided.
if (rawRecord.containsKey("sessionAttributesEncoded")) {
  clickConversionBuilder.setSessionAttributesEncoded(
      ByteString.copyFromUtf8(rawRecord.get("sessionAttributesEncoded")));
} else if (rawRecord.containsKey("sessionAttributesMap")) {
  List<String> pairings =
      Arrays.stream(rawRecord.get("sessionAttributesMap").split(" "))
          .map(String::trim)
          .collect(Collectors.toList());
  SessionAttributesKeyValuePairs.Builder sessionAttributePairs =
      SessionAttributesKeyValuePairs.newBuilder();
  for (String pair : pairings) {
    String[] parts = pair.split("=", 2);
    if (parts.length != 2) {
      throw new IllegalArgumentException(
          "Failed to read the sessionAttributesMap. SessionAttributesMap must use a "
              + "space-delimited list of session attribute key value pairs. Each pair should be"
              + " separated by an equal sign, for example: 'gad_campaignid=12345 gad_source=1'");
    }
    sessionAttributePairs.addKeyValuePairs(
        SessionAttributeKeyValuePair.newBuilder()
            .setSessionAttributeKey(parts[0])
            .setSessionAttributeValue(parts[1])
            .build());
  }
  clickConversionBuilder.setSessionAttributesKeyValuePairs(sessionAttributePairs.build());
}

// Calls build to build the conversion.
ClickConversion clickConversion = clickConversionBuilder.build();
UploadEnhancedConversionsForLeads.java
      

C#

// Adds details of the conversion.
clickConversion.ConversionAction =
    ResourceNames.ConversionAction(customerId, conversionActionId);
clickConversion.ConversionDateTime = conversionDateTime;
clickConversion.ConversionValue = conversionValue;
clickConversion.CurrencyCode = "USD";

// Sets the order ID if provided.
if (!string.IsNullOrEmpty(orderId))
{
    clickConversion.OrderId = orderId;
}

// Sets the Google click ID (gclid) if provided.
if (!string.IsNullOrEmpty(gclid))
{
    clickConversion.Gclid = gclid;
}

if (!string.IsNullOrEmpty(sessionAttributesEncoded))
{
    clickConversion.SessionAttributesEncoded =
        ByteString.CopyFrom(sessionAttributesEncoded, Encoding.Unicode);
}
else if (!string.IsNullOrEmpty(sessionAttributes))
{
    IEnumerable<SessionAttributeKeyValuePair> parsedSessionAttributes =
        sessionAttributes.Split(';').Select(pair => {
            string[] split = pair.Split('=');
            return new SessionAttributeKeyValuePair()
            {
                SessionAttributeKey = split[0],
                SessionAttributeValue = split[1]
            };
        });

    clickConversion.SessionAttributesKeyValuePairs =
        new SessionAttributesKeyValuePairs();
    clickConversion.SessionAttributesKeyValuePairs.KeyValuePairs
        .AddRange(parsedSessionAttributes);
}
UploadEnhancedConversionsForLeads.cs
      

PHP

// Adds details of the conversion.
$clickConversion->setConversionAction(
    ResourceNames::forConversionAction($customerId, $rawRecord['conversionActionId'])
);
$clickConversion->setConversionDateTime($rawRecord['conversionDateTime']);
$clickConversion->setConversionValue($rawRecord['conversionValue']);
$clickConversion->setCurrencyCode($rawRecord['currencyCode']);

// Sets the order ID if provided.
if (!empty($rawRecord['orderId'])) {
    $clickConversion->setOrderId($rawRecord['orderId']);
}

// Sets the Google click ID (gclid) if provided.
if (!empty($rawRecord['gclid'])) {
    $clickConversion->setGclid($rawRecord['gclid']);
}

// Sets the ad user data consent if provided.
if (!empty($rawRecord['adUserDataConsent'])) {
    // Specifies whether user consent was obtained for the data you are uploading. See
    // https://www.google.com/about/company/user-consent-policy for details.
    $clickConversion->setConsent(
        new Consent(['ad_user_data' => $rawRecord['adUserDataConsent']])
    );
}

// Set one of the sessionAttributesEncoded or
// SessionAttributeKeyValuePair fields if either are provided.
if (!empty($sessionAttributesEncoded)) {
    $clickConversion->setSessionAttributesEncoded($sessionAttributesEncoded);
} elseif (!empty($sessionAttributesDict)) {
    // Create a new container object to hold key-value pairs.
    $sessionAttributesKeyValuePairs = new SessionAttributesKeyValuePairs();
    // Initialize an array to hold individual key-value pair messages.
    $keyValuePairs = [];
    // Append each key-value pair provided to the $keyValuePairs array
    foreach ($sessionAttributesDict as $key => $value) {
        $pair = new SessionAttributeKeyValuePair();
        $pair->setSessionAttributeKey($key);
        $pair->setSessionAttributeValue($value);
        $keyValuePairs[] = $pair;
    }
    // Set the the full list of key-value pairs on the container object.
    $sessionAttributesKeyValuePairs->setKeyValuePairs($keyValuePairs);
    // Attach the container of key-value pairs to the ClickConversion object.
    $clickConversion->setSessionAttributesKeyValuePairs($sessionAttributesKeyValuePairs);
}
UploadEnhancedConversionsForLeads.php
      

Python

# Add details of the conversion.
# Gets the conversion action resource name.
conversion_action_service = client.get_service("ConversionActionService")
click_conversion.conversion_action = (
    conversion_action_service.conversion_action_path(
        customer_id, raw_record["conversion_action_id"]
    )
)
click_conversion.conversion_date_time = raw_record["conversion_date_time"]
click_conversion.conversion_value = raw_record["conversion_value"]
click_conversion.currency_code = raw_record["currency_code"]

# Sets the order ID if provided.
if raw_record.get("order_id"):
    click_conversion.order_id = raw_record["order_id"]

# Sets the gclid if provided.
if raw_record.get("gclid"):
    click_conversion.gclid = raw_record["gclid"]

# Specifies whether user consent was obtained for the data you are
# uploading. For more details, see:
# https://www.google.com/about/company/user-consent-policy
if raw_record["ad_user_data_consent"]:
    click_conversion.consent.ad_user_data = client.enums.ConsentStatusEnum[
        raw_record["ad_user_data_consent"]
    ]

# Set one of the session_attributes_encoded or
# session_attributes_key_value_pairs fields if either are provided.
if session_attributes_encoded:
    click_conversion.session_attributes_encoded = session_attributes_encoded
elif session_attributes_dict:
    for key, value in session_attributes_dict.items():
        pair = client.get_type("SessionAttributeKeyValuePair")
        pair.session_attribute_key = key
        pair.session_attribute_value = value
        click_conversion.session_attributes_key_value_pairs.key_value_pairs.append(
            pair
        )
upload_enhanced_conversions_for_leads.py
      

Ruby

cc.conversion_action = client.path.conversion_action(customer_id, conversion_action_id)
cc.conversion_date_time = conversion_date_time
cc.conversion_value = conversion_value.to_f
cc.currency_code = 'USD'

unless order_id.nil?
  cc.order_id = order_id
end

unless raw_record["gclid"].nil?
  cc.gclid = gclid
end

# Specifies whether user consent was obtained for the data you are
# uploading. For more details, see:
# https://www.google.com/about/company/user-consent-policy
unless raw_record["ad_user_data_consent"].nil?
  cc.consent = client.resource.consent do |c|
    c.ad_user_data = ad_user_data_consent
  end
end

# Set one of the session_attributes_encoded or
# session_attributes_key_value_pairs fields if either are provided.
if session_attributes_encoded != nil
  cc.class.module_eval { attr_accessor :session_attributes_encoded}
  cc.session_attributes_encoded = session_attributes_encoded
elsif session_attributes_hash != nil
  # Add new attribute to click conversion object
  cc.class.module_eval { attr_accessor :session_attributes_key_value_pairs}
  cc.session_attributes_key_value_pairs = ::Google::Ads::GoogleAds::V19::Services::SessionAttributesKeyValuePairs.new

  # Loop thru inputted session_attributes_hash to populate session_attributes_key_value_pairs
  session_attributes_hash.each do |key, value|
    pair = ::Google::Ads::GoogleAds::V19::Services::SessionAttributeKeyValuePair.new
    pair.session_attribute_key = key
    pair.session_attribute_value = value
    cc.session_attributes_key_value_pairs.key_value_pairs << pair
  end
end    
upload_enhanced_conversions_for_leads.rb
      

Perl

# Add details of the conversion.
$click_conversion->{conversionAction} =
  Google::Ads::GoogleAds::V20::Utils::ResourceNames::conversion_action(
  $customer_id, $raw_record->{conversionActionId});
$click_conversion->{conversionDateTime} = $raw_record->{conversionDateTime};
$click_conversion->{conversionValue}    = $raw_record->{conversionValue};
$click_conversion->{currencyCode}       = $raw_record->{currencyCode};

# Set the order ID if provided.
if (defined $raw_record->{orderId}) {
  $click_conversion->{orderId} = $raw_record->{orderId};
}

# Set the Google click ID (gclid) if provided.
if (defined $raw_record->{gclid}) {
  $click_conversion->{gclid} = $raw_record->{gclid};
}

# Set the consent information, if provided.
if (defined $raw_record->{adUserDataConsent}) {
  $click_conversion->{consent} =
    Google::Ads::GoogleAds::V20::Common::Consent->new({
      adUserData => $raw_record->{adUserDataConsent}});
}

# Set one of the session_attributes_encoded or session_attributes_key_value_pairs
# fields if either are provided.
if (defined $session_attributes_encoded) {
  $click_conversion->{sessionAttributesEncoded} = $session_attributes_encoded;
} elsif (defined $session_attributes_hash) {
  while (my ($key, $value) = each %$session_attributes_hash) {
    my $pair =
      Google::Ads::GoogleAds::V20::Services::ConversionUploadService::SessionAttributeKeyValuePair
      ->new({sessionAttributeKey => $key, sessionAttributeValue => $value});
    push @{$click_conversion->{sessionAttributesKeyValuePairs}{keyValuePairs}
    }, $pair;
  }
}
upload_enhanced_conversions_for_leads.pl
      

สร้างคำขอ

เมื่อกำหนดค่าและเพิ่มออบเจ็กต์ ClickConversion ลงในช่อง conversions ของออบเจ็กต์ UploadClickConversionRequest แล้ว ให้ตั้งค่าช่องต่อไปนี้และส่งคำขอไปยังเมธอด UploadClickConversions ใน ConversionUploadService

customer_id

ตั้งค่านี้เป็นลูกค้า Conversion ของ Google Ads ของบัญชีที่เป็น แหล่งที่มาของการคลิก หากไม่แน่ใจว่าบัญชีใดถูกต้อง ให้ดูcustomer.conversion_tracking_setting.google_ads_conversion_customer ฟิลด์ในคำค้นหาตัวอย่างในส่วนการเริ่มต้นใช้งาน

job_id

มีกลไกในการเชื่อมโยงคำขอการนำเข้ากับข้อมูลต่องานในการวินิจฉัยข้อมูลออฟไลน์

หากคุณไม่ตั้งค่าฟิลด์นี้ Google Ads API จะกำหนดค่าที่ไม่ซ้ำกันให้กับคำขอแต่ละรายการ ในช่วง [2^31, 2^63) หากต้องการจัดกลุ่มคำขอหลายรายการ เป็นงานเชิงตรรกะเดียว ให้ตั้งค่าฟิลด์นี้เป็นค่าเดียวกันในช่วง [0, 2^31) ในทุกคำขอในงาน

job_id ใน response มีรหัสงานสำหรับคำขอ ไม่ว่าคุณจะระบุค่า หรือปล่อยให้ Google Ads API กำหนดค่าก็ตาม

partial_failure

ต้องตั้งค่าฟิลด์นี้เป็น true เมื่อนำเข้า Conversion ปฏิบัติตามหลักเกณฑ์การล้มเหลวบางส่วนเมื่อ ประมวลผลการตอบกลับ

นำเข้าคำขอ

เมื่อป้อนข้อมูลออบเจ็กต์ ClickConversion และสร้างคำขอแล้ว คุณจะส่งการนำเข้าได้

Java

// Creates the conversion upload service client.
try (ConversionUploadServiceClient conversionUploadServiceClient =
    googleAdsClient.getLatestVersion().createConversionUploadServiceClient()) {
  // Uploads the click conversion. Partial failure should always be set to true.

  // NOTE: This request contains a single conversion as a demonstration.  However, if you have
  // multiple conversions to upload, it's best to upload multiple conversions per request
  // instead of sending a separate request per conversion. See the following for per-request
  // limits:
  // https://developers.google.com/google-ads/api/docs/best-practices/quotas#conversion_upload_service
  UploadClickConversionsResponse response =
      conversionUploadServiceClient.uploadClickConversions(
          UploadClickConversionsRequest.newBuilder()
              .setCustomerId(Long.toString(customerId))
              .addConversions(clickConversion)
              // Enables partial failure (must be true).
              .setPartialFailure(true)
              .build());
UploadEnhancedConversionsForLeads.java
      

C#

// Uploads the click conversion. Partial failure should always be set to true.
// NOTE: This request contains a single conversion as a demonstration.
// However, if you have multiple conversions to upload, it's best to upload multiple
// conversions per request instead of sending a separate request per conversion.
// See the following for per-request limits:
// https://developers.google.com/google-ads/api/docs/best-practices/quotas#conversion_upload
UploadClickConversionsResponse response =
    conversionUploadService.UploadClickConversions(
        new UploadClickConversionsRequest()
        {
            CustomerId = customerId.ToString(),
            Conversions = { clickConversion },
            // Enables partial failure (must be true).
            PartialFailure = true
        });
UploadEnhancedConversionsForLeads.cs
      

PHP

// Issues a request to upload the click conversion.
$conversionUploadServiceClient = $googleAdsClient->getConversionUploadServiceClient();
// NOTE: This request contains a single conversion as a demonstration.  However, if you have
// multiple conversions to upload, it's best to upload multiple conversions per request
// instead of sending a separate request per conversion. See the following for per-request
// limits:
// https://developers.google.com/google-ads/api/docs/best-practices/quotas#conversion_upload_service
$response = $conversionUploadServiceClient->uploadClickConversions(
    // Enables partial failure (must be true).
    UploadClickConversionsRequest::build($customerId, [$clickConversion], true)
);
UploadEnhancedConversionsForLeads.php
      

Python

# Creates the conversion upload service client.
conversion_upload_service = client.get_service("ConversionUploadService")
# Uploads the click conversion. Partial failure should always be set to
# True.
# NOTE: This request only uploads a single conversion, but if you have
# multiple conversions to upload, it's most efficient to upload them in a
# single request. See the following for per-request limits for reference:
# https://developers.google.com/google-ads/api/docs/best-practices/quotas#conversion_upload_service
response = conversion_upload_service.upload_click_conversions(
    customer_id=customer_id,
    conversions=[click_conversion],
    # Enables partial failure (must be true).
    partial_failure=True,
)
upload_enhanced_conversions_for_leads.py
      

Ruby

response = client.service.conversion_upload.upload_click_conversions(
  customer_id: customer_id,
  conversions: [click_conversion],
  # Partial failure must be true.
  partial_failure: true,
)

if response.partial_failure_error
  puts "Partial failure encountered: #{response.partial_failure_error.message}"
else
  result = response.results.first
  puts "Uploaded click conversion that happened at #{result.conversion_date_time} " \
    "to #{result.conversion_action}."
end
upload_enhanced_conversions_for_leads.rb
      

Perl

# Upload the click conversion. Partial failure should always be set to true.
#
# NOTE: This request contains a single conversion as a demonstration.
# However, if you have multiple conversions to upload, it's best to
# upload multiple conversions per request instead of sending a separate
# request per conversion. See the following for per-request limits:
# https://developers.google.com/google-ads/api/docs/best-practices/quotas#conversion_upload_service
my $response =
  $api_client->ConversionUploadService()->upload_click_conversions({
    customerId  => $customer_id,
    conversions => [$click_conversion],
    # Enable partial failure (must be true).
    partialFailure => "true"
  });
upload_enhanced_conversions_for_leads.pl
      

ตรวจสอบการนำเข้า

ใช้รายงานการวินิจฉัย Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย เพื่อตรวจสอบประสิทธิภาพโดยรวมของการนำเข้าล่าสุด

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

Conversion ที่นําเข้าจะแสดงในรายงานสําหรับวันที่การแสดงผลของ การคลิกเดิม ไม่ใช่วันที่ของคําขอนําเข้าหรือวันที่ของconversion_date_timeของ ClickConversion

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

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

แนวทางปฏิบัติแนะนำ

โปรดคำนึงถึงแนวทางปฏิบัติแนะนำต่อไปนี้เมื่อติดตั้งใช้งาน Conversion ที่ปรับปรุงแล้ว สำหรับโอกาสในการขาย

ส่งข้อมูล Conversion ทั้งหมดไม่ว่าจะสมบูรณ์หรือไม่ก็ตาม

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

หากคุณกําหนด order_id ให้กับ Conversion เราขอแนะนําให้ใส่ order_id นั้น หากมี GCLID สำหรับ Conversion เราขอแนะนำให้ส่ง GCLID นอกเหนือจาก user_identifiers เพื่อให้ได้ประสิทธิภาพที่ดียิ่งขึ้น นอกจากนี้ หากคุณมี UserIdentifier มากกว่า 1 รายการสําหรับ Conversion ให้รวมทั้งหมดไว้ในออบเจ็กต์ ClickConversion เพื่อเพิ่มโอกาสในการจับคู่

ส่ง Conversion หลายรายการเป็นกลุ่มในคำขอเดียว

หากมี Conversion หลายรายการที่ต้องการนําเข้า ให้จัดกลุ่ม Conversion เป็นไฟล์เดียว UploadClickConversionsRequest แทนที่จะส่งคําขอนําเข้าต่อ Conversion

ดูโควต้าคำแนะนำ เพื่อดูขีดจำกัดจำนวน Conversion ต่อคำขอ

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

อย่าใช้ข้อมูลการระบุแหล่งที่มาภายนอก

เมื่อใช้ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย อย่าตั้งค่า external_attribution_data ใน ClickConversion หรือระบุ conversion_action ที่ใช้รูปแบบการระบุแหล่งที่มาภายนอก Google Ads ไม่รองรับ Conversion ที่มาจากภายนอกสำหรับการนำเข้าโดยใช้ข้อมูลที่ได้จากผู้ใช้

อย่าใส่ตัวแปรที่กำหนดเอง

เมื่อใช้ Conversion ที่ปรับปรุงแล้วสำหรับโอกาสในการขาย โปรดอย่าใส่ custom_variables Google Ads ไม่รองรับการใช้ตัวแปรที่กําหนดเองกับข้อมูลที่ได้จากผู้ใช้ในการนําเข้า Conversion หากมีตัวแปรที่กําหนดเองรวมอยู่ใน Conversion ที่มีข้อมูลที่ได้จากผู้ใช้ ระบบจะถือว่า Conversion เหล่านั้นไม่ถูกต้องและจะทิ้ง Conversion ดังกล่าว

การแก้ปัญหา

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

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

แก้ไขข้อผิดพลาดที่พบบ่อย

ข้อผิดพลาด
NO_CONVERSION_ACTION_FOUND	การกระทำที่ถือเป็น Conversion ที่ระบุไม่ได้เปิดใช้งาน หรือไคลเอ็นต์ บัญชีที่ระบุโดยฟิลด์ `client_id` ในคำขอเข้าถึงไม่ได้ ตรวจสอบว่าได้เปิดใช้การกระทำที่ถือเป็น Conversion ในการอัปโหลดแล้ว และลูกค้าที่ส่งคำขออัปโหลดเป็นเจ้าของการกระทำดังกล่าว ข้อผิดพลาดนี้อาจเกิดขึ้นได้เช่นกันหาก GCLID ในคำขอเป็นของบัญชีลูกค้าที่ไม่มีสิทธิ์เข้าถึงการกระทำที่ถือเป็น Conversion ที่ระบุไว้ในคำขอ คุณสามารถตรวจสอบว่า GCLID เป็นของบัญชีลูกค้าหรือไม่โดยใช้แหล่งข้อมูล click_view โดยส่งคำค้นหาที่กรองตาม click_view.gclid และ segments.date โดยที่วันที่คือวันที่เกิดการคลิก
INVALID_CONVERSION_ACTION_TYPE	การกระทำที่ถือเป็น Conversion ที่ระบุมีประเภทที่ไม่ถูกต้องสําหรับ Conversion ที่ปรับปรุงแล้วสําหรับโอกาสในการขาย ตรวจสอบว่า ConversionAction ที่ระบุใน คำขออัปโหลดมีประเภทเป็น UPLOAD_CLICKS
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS	ตรวจสอบว่าคุณได้เปิดใช้ Conversion ที่ปรับปรุงแล้วสําหรับโอกาสในการขายในการตั้งค่า Conversion แล้ว ดูวิธีการสำหรับขั้นตอนนี้ได้ในคู่มือข้อกำหนดเบื้องต้น
DUPLICATE_ORDER_ID	เหตุการณ์ที่นําเข้ามี Conversion หลายรายการที่มีรหัสคําสั่งซื้อเดียวกัน และไม่ได้รับการประมวลผล ตรวจสอบว่ารหัสคําสั่งซื้อไม่ซ้ำกัน แล้วลองอีกครั้ง
CLICK_NOT_FOUND	ไม่พบการคลิกที่ตรงกับตัวระบุผู้ใช้ที่ระบุ Google Ads API จะแสดงข้อผิดพลาดนี้ก็ต่อเมื่อ debug_enabled เป็น true ใน UploadClickConversionsRequest เท่านั้น หมายเหตุ: ถือว่าข้อผิดพลาดนี้เป็นคำเตือน เว้นแต่จะเกิดขึ้นกับ Conversion ส่วนใหญ่ หาก Conversion พบคำเตือนนี้ Google Ads API จะรวมไว้ใน successful_event_count ของการวินิจฉัยข้อมูลออฟไลน์ Google Ads API มีรายการสำหรับ CLICK_NOT_FOUND ในคอลเล็กชัน alerts เพื่อให้คุณตรวจสอบความถี่ของคำเตือนนี้ได้ ข้อผิดพลาดนี้เป็นเรื่องปกติหากการคลิกไม่ได้มาจากแคมเปญ Google Ads เช่น อาจมาจาก SA360 หรือ DV360 สาเหตุอื่นๆ ที่เป็นไปได้มีดังนี้ ลูกค้าที่อัปโหลดแตกต่างจากลูกค้าที่ทำ Conversion ของ Google Ads การติดแท็ก ได้รับการกำหนดค่าไม่ถูกต้องสำหรับ Lead Form ข้อมูลที่อัปโหลด ไม่ได้ทําการแปลงข้อมูลและแฮชอย่างถูกต้อง ในกรณีที่ผู้ที่อัปโหลดเป็นคนละคนกับลูกค้า Conversion ของ Google Ads ซึ่งเกิดขึ้นไม่บ่อย ข้อผิดพลาดนี้อาจหมายความว่าผู้ที่อัปโหลดยอมรับข้อกำหนดด้านข้อมูลลูกค้าแล้ว แต่ลูกค้าที่แสดงโฆษณายังไม่ได้ยอมรับ คุณสามารถตรวจสอบว่าบัญชีได้ยอมรับข้อกำหนดสำหรับข้อมูลลูกค้าหรือไม่โดยการค้นหาแหล่งข้อมูล customer และตรวจสอบช่อง customer.offline_conversion_tracking_info.accepted_customer_data_terms