オンライン クリック コンバージョンを管理する

Google Ads API を使用して、Google 広告のオンライン クリック コンバージョンを管理できます。オンライン クリック コンバージョンを使用すると、ウェブサイトなどのオンラインで売り上げにつながった広告をトラッキングできます。

オンライン コンバージョンは Google タグを使用してトラッキングされますが、Google Ads API を使用して調整または拡張できます。

すでに Google タグを設定していて、オンライン コンバージョンを調整する場合は、コンバージョンの調整ページをご覧ください。Google タグを設定済みで、ユーザー提供データ（拡張コンバージョン（ウェブ向け）とも呼ばれます）を使用してオンライン コンバージョンを強化したい場合は、このままお読みください。

拡張コンバージョン（ウェブ向け）

次のセクションでは、オンライン クリック コンバージョンを強化する方法（拡張コンバージョン（ウェブ向け）とも呼ばれます）について説明します。

拡張コンバージョン（ウェブ向け）では、ユーザーがコンバージョンしたときに、クリック ID（GCLID など）とオーダー ID を Google 広告に自動的に送信するタグを設定する必要があります。拡張コンバージョンは、Google タグ マネージャー、Google タグ、Google Ads API のいずれかを使って設定できます。Google Ads API を使用すると、コンバージョン イベントと同時にではなく、コンバージョン イベントから 24 時間以内にファーストパーティのコンバージョン データを送信できるというメリットがあります。これにより、顧客データベースや CRM システムなど、さまざまなソースから自社データを見つけることができます。

拡張コンバージョン（ウェブ向け）の仕組み

Google Ads API の拡張コンバージョン（ウェブ向け）は、次のフローのステップ 3 を補完します。

ユーザーがコンバージョンに至ったときにハッシュ化されたユーザー情報を送信する代わりに、タグは GCLID と注文 ID のみを送信し、ハッシュ化されたユーザー情報は、ハッシュ化されたデータとともに注文 ID をインポートすることで後から送信します。拡張コンバージョン（ウェブ向け）について詳しくは、ヘルプセンターをご覧ください。

拡張コンバージョン（ウェブ向け）

前提条件

拡張コンバージョン（ウェブ向け）を使用するには、顧客データに関する規約に同意していただく必要があります。顧客データに関する規約に同意しているかどうかは、Google 広告のコンバージョン顧客に次のクエリを発行することで確認できます。

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

accepted_customer_data_terms が false の場合は、ヘルプセンターの手順に沿って対応します。

この前提条件を満たす必要があります。

タグ付けを設定する

ウェブサイトのタグ設定は、ヘルプセンターの手順に沿って行います。コンバージョンの照合を支援するため、コンバージョン トラッキング タグにトランザクション ID（オーダー ID）を追加することもおすすめします。

API の実装

Google Ads API で拡張コンバージョン（ウェブ向け）をインポートする全体的なフローは次のとおりです。

  1. メールアドレス、電話番号、住所などのユーザー提供データを正規化してハッシュ化します。

  2. 正規化およびハッシュ化されたユーザー提供のデータで ConversionAdjustment オブジェクトを入力します。

  3. ConversionAdjustment オブジェクトを ConversionAdjustmentUploadService にインポートします。

  4. インポートを確認する。

ユーザー提供データを正規化してハッシュ化する

プライバシー保護の観点から、次のデータはインポートする前に SHA-256 を使用してハッシュ化する必要があります。

  • メールアドレス
  • 電話番号
  • 名
  • 姓
  • 番地

次のデータはハッシュ化しないでください。

  • 国
  • 都道府県
  • 市区郡
  • 郵便番号

ハッシュ結果を標準化するには、値をハッシュ化する前に次の操作を行います。

  • 先頭と末尾の空白文字を削除する。
  • テキストを小文字に変換する。
  • 電話番号を E164 規格の形式にする。

拡張コンバージョンのメールアドレスの形式

拡張コンバージョンのマッチ率を最大限に高めるには、ハッシュ化する前にメールアドレスを適切にフォーマットする必要があります。手順は次のとおりです。

  1. 標準の正規化を適用する（すべてのメールアドレス）:

    • 先頭または末尾の空白文字を削除します。
    • メールアドレス全体を小文字に変換します。

  2. 該当する場合は、Gmail/Googlemail 固有の正規化を適用します。

    • この手順は、ドメインが gmail.com と googlemail.com のメールアドレスにのみ適用されます。
    • ピリオド（.）を削除する: ユーザー名部分（@ の前）から、すべてのピリオド文字を削除します。

    • プラス接尾辞（+）を削除する: ユーザー名部分から、プラス記号（+）とそれに続くすべての文字を削除します。

      • 例: Jane.Doe+Shopping@googlemail.com は最初に jane.doe+shopping@googlemail.com（小文字）になり、次に janedoe@googlemail.com（Gmail/Googlemail 固有のルール）になります。

    • その他のドメイン: gmail.com または googlemail.com 以外のドメインのメールアドレスでは、ユーザー名からピリオドやプラスの接尾辞を削除してはなりません。これらのアドレスには標準の正規化（小文字化、空白の削除）のみを適用します。

      • 例: user.name+NYC@Example.com は user.name+nyc@example.com に正規化されます。

  3. 正規化されたメールアドレスをハッシュ化します。

    • 適切な正規化手順を適用した後、SHA-256 アルゴリズムを使用して結果のメールアドレスをハッシュ化します。

Java

private String normalizeAndHash(MessageDigest digest, String s, boolean trimIntermediateSpaces)
    throws UnsupportedEncodingException {
  // Normalizes by first converting all characters to lowercase, then trimming spaces.
  String normalized = s.toLowerCase();
  if (trimIntermediateSpaces) {
    // Removes leading, trailing, and intermediate spaces.
    normalized = normalized.replaceAll("\\s+", "");
  } else {
    // Removes only leading and trailing spaces.
    normalized = normalized.trim();
  }
  // 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 = norm>ali&&zedEmail.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], emailPart
s[1]);
  }
  return normalizeAndHash(digest, normalizedEmail, true);
}UploadEnhancedConversionsForWeb.java

C#

/// <summary>
/// Normalizes the email address and hashes it. For this use case, Google Ads requires
/// removal of any '.' characters pr<eced>ing codeg<mail.>com/code< or<>/span>
/// codegoogle<mail.>com/co<de.
/// >/summ<ary
/// param name=">emailAddress"<The em>ail a<ddress.>/param
/// ret<urnsThe >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]<}@{emai>lParts[1]}";
    }
    return NormalizeAnd<Hash(nor>maliz<edEmail);
}

/// s>ummary
/// Normalizes and hashes< a str>ing v<alue.
/>// /summary
/// param name="<;value&q>uot;The value to normalize and hash./param
/// returnsThe normalized and hashed value./returns
private static string Normali<zeAndHa>sh(string value)
{
    return ToSha256String(digest, ToNormali<zedValue>(valu<e));
}

/// summary>
/// Hash a string value using SHA-<256 ha>shing< algorithm.
/// /s>ummary
/// param name="digest"Provides <the al>gorit<hm for >SHA-256./param
//</ param >name="value"The string value (e.g. an email address) to hash./param
/// returnsThe 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 <unhyphe>nated hexadecimal string.
    return BitConverter.ToString(digestBytes).Replace("-", s<tring.Em>pty);<
}

/// summary
//>/ Removes leading and t<railin>g whi<tespace> and converts all cha<racters >to
/// lower case.
/// /summary
/// param name="value"The value to normalize./param

/// returnsThe normalized value./
returns
private static string ToNormalizedValue(string value)
{
    return value.Trim().ToLower();
}UploadEnhancedConversionsForWeb.cs

PHP

private static function normalizeAndHash(
    string $hashAlgorithm,
    string $value,
    bool $trimIntermediateSpaces
): string {
    // Normalizes by first converting all characters to lowercase, then trimming spaces.
    $normalized = strtolower($value);
    if ($trimIntermediateSpaces === true) {
        // Removes leading, trailing, and intermediate spaces.
        $normalized = str_replace(' ', '', $normalized);
    } else {
        // Removes only leading and trailing spaces.
        $normalized = trim($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("@", $>normalizedE&&mail);
    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 se
lf::normalizeAndHash($hashAlgorithm, $normalizedEmail, true);
}UploadEnhancedConversionsForWeb.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:
        # Removes any '.' and '+' characters from the portion of the email address
        # before the domain
        chars_to_remove = ".+"
        translation_table = str.maketrans('', '', chars_to_remove)
        email_parts[0] = email_parts[0].translate(translation_table)
        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/9888656

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

    Returns:
        A normaliz
ed (lowercase, removed whitespace) and
 SHA-256 hashed string.
    """
    return hashlib.sha256(s.strip().lower().encode()).hexdigest()upload_enhanced_conversions_for_web.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/9888656.
def normalize_and_hash(str)
  # Remove leading and trailing whitespace and ensure all letters are lowercase
  # before hasing.
  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('.', '&#
39;)
  end
  normalize_and_hash(email_
parts.join('@'))
endupload_enhanced_conversions_for_web.rb

Perl

sub normalize_and_hash {
  my $value                    = shift;
  my $trim_intermediate_spaces = shift;

  if ($trim_intermediate_spaces) {
    $value =~ s/\s+//g;
  } else {
    $value =~ s/^\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_em>ail);
 && 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_pa
rts[1];
  }
  return normalize_and_has
h($normalized_email, 1);
}upload_enhanced_conversions_for_web.pl

ConversionAdjustment オブジェクトを入力する

次のセクションでは、必要に応じて正規化とハッシュ化が適用された注文 ID、メールアドレス、電話番号、住所の識別子を含む場合に、拡張の調整を行う方法について説明します。可能な場合は、調整に gclid を含めることをおすすめします。

この手順は、コンバージョン調整のインポート ガイドとほぼ同じですが、いくつかの注意点があります。

  • 正規化およびハッシュ化されたユーザーデータを user_identifiers に入力します。複数のユーザー識別子を使用できる場合は、識別子ごとに別々の UserIdentifier を作成します（最大 5 つの識別子）。

Java

// Creates a builder for constructing the enhancement adjustment.
ConversionAdjustment.Builder enhancementBuilder =
    ConversionAdjustment.newBuilder().setAdjustmentType(ConversionAdjustmentType.ENHANCEMENT);

// Extracts user email, phone, and address info 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.B>uilderString, String rawRecordBuilder< =
    Immutab>leMap.String, Stringbuilder()
        .put("email", "alex.2@example.com")
        // Email address that includes a period (.) before the Gmail domain.
        .put("email", "alex.2@example.com")
        // Address that includes all four required elements: first name, last name, country
        // code, and postal code.
        .put("firstName", "Alex")
        .put("lastName", "Quinn")
        .put("countryCode", "US")
        .put("postalCode", "94045")
        // Phone number to be converted to E.164 format, with a leading '+' as required.
        .put("phone", "+1 800 5550102")
        // 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("orderId", orderId)
        .put("conversionActionId", Long.toString(conversionActionId))
        .put("currencyCode", "USD");

// Adds entries for the optional fields.
if (conversionDa<teTime != null>) {
  rawRecordBuilder.put("conversionDateTime", conversionDateTime);
}
if (userAgent != null) {
  rawRecordBuilder.put("userAgent", userAgent);
}

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

// Creates a SHA256 message digest for hashing u<ser identifier>s in a privacy-safe way, as
// d<>escribed at https://support.google.com/google-ads/answer/9888656.
MessageDigest sha256Digest = MessageDigest.getInstance("SHA-256");

// Creates a list for the user identifiers.
ListUserIdentifier 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);

// Checks if the record has a phone number, and if so, adds a UserIdentifier for it.
if (rawRecord.containsKey("phone")) {
  UserIdentifier hashedPhoneNumberIdentifier =
      UserIdentifier.newBuilder()
          .setHashedPhoneNumber(normalizeAndHash(sha256Digest, rawRecord.get("phone"), true))
          .build();
  // Adds the hashed phone number identifier to the UserData object's list.
  userIdentifiers.add(hashedPhoneNumberIdentifier);<
}

//> Checks if the record has all the<> required mailing address elements, and if so, adds a
// UserIdentifier for the mailing address.
if (rawRecord.containsKey("firstName")) {
  // Checks if the record contains all the other required elements of a mailing address.
  SetString missingAddressKeys = new HashSet();
  for (String addressKey : new String[] {"lastName", "countryCode", "postalCode"}) {
    if (!rawRecord.containsKey(addressKey)) {
      missingAddressKeys.add(addressKey);
    }
  }

  if (!missingAddressKeys.isEmpty()) {
    System.out.printf(
        "Skipping addition of mailing address information because the following required keys"
            + " are missing: %s%n",
        missingAddressKeys);
  } else {
    // Creates an OfflineUserAddressInfo object that contains all the required elements of a
    // mailing address.
    OfflineUserAddressInfo addressInfo =
        OfflineUserAddressInfo.newBuilder()
            .setHashedFirstName(
                normalizeAndHash(sha256Digest, rawRecord.get("firstName"), false))
            .setHashedLastName(normalizeAndHash(sha256Digest, rawRecord.get("lastName"), false))
            .setCountryCode(rawRecord.get("countryCode"))
            .setPostalCode(rawRecord.get("postalCode"
))
            .build();
    UserIde
ntifier addressIdentifier =
        UserIdentifier.newBuilder().setAddressInfo(addressInfo).build();
    // Adds the address identifier to the UserData object's list.
    userIdentifiers.add(addressIdentifier);
  }
}

// Adds the user identifiers to the enhancement adjustment.
enhancementBuilder.addAllUserIdentifiers(userIdentifiers);UploadEnhancedConversionsForWeb.java

C#

// Normalize and hash the raw data, 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:
// UserIdentifier incorrectlyPopulatedUserIdentifier = new UserIdentifier()
// {
//         HashedEmail = "..."
//         HashedPhoneNumber = "..."
// }
UserIdentifier addressIdentifier = new UserIdentifier()
{
    AddressInfo = new OfflineUserAddressInfo()
    {
        HashedFirstName = NormalizeAndHash("Dana"),
        HashedLastName = NormalizeAndHash("Quinn"),
        HashedStreetAddress = NormalizeAndHash("1600 Amphitheatre Pkwy"),
        City = "Mountain View",
        State = "CA",
        PostalCode = "94043",
        CountryCode = "US"
    },
    // Optional: Specifies the user identifier source.
    UserIdentifierSource = UserIdentifierSource.FirstParty
};

// Creates a user identifier using the hashed email address.
UserIdentifier emailIdentifier = new UserIdentifier()
{
    UserIdentifierSource = UserIdentifierSource.FirstParty,
    // Uses the normalize and hash method specifically for email addresses.
    HashedEmail = NormalizeAndHashEmailAddress("dana@example.com")
};

// Adds the user identifiers to the enhance
ment adjustment.
enhancement.UserI
dentifiers.AddRange(new[] { addressIdentifier, emailIdentifier });UploadEnhancedConversionsForWeb.cs

PHP

// Creates the conversion enhancement.
$enhancement =
    new ConversionAdjustment(['adjustment_typ>e' = ConversionAdjustmentType::ENHANCEMENT]);

// Extracts user email, phone, and address info 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.
//
// $incorrectlyPopulatedUserIdentifier = new UserIdentifier([
//    'has>hed_email' = '...',
//   > 'hashed_phone_number' = '...'
// ]);

$rawRecord = [
    // Email address that includes a period (.>) before the Gmail domain.
    'email' = 'alex.2@example.com',
    // Address that includes all four required elements: first name, last name,> country
    // code, and> postal code.
    'firstN>ame' = 'Alex'>,
    'lastName' = 'Quinn',
    'countryCode' = 'US',
    'postalCode>9; = '94045',
    // Phone number to be converted to E.164 format, with a leading '+' as required.
    'phone' = '+1 800 5550102',
    // This example lets you input conversion details as arguments>, but in reality you might
    // sto>re this data alongside other user data, so we in>clude it in this sample user
    // record>.
    'orderId' = $orderId,
    'conversionActionId' = $conversionActionId,
    'conversionDateTime' = $conversionDateTime,
    'currencyCode' = 'USD'
];

// 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 norma>lize and hash
// method specifically for email addresses.
$emailIdentifier = new UserIdentifier([
    // Uses the normalize and hash method specifically for email addresses.
    >9;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;
}

// Checks if the record has all the required mailing address elements, and if so, adds a
// UserIdentifier for the mailing address.
if (array_key_exists('firstName', $rawRecord)) {
    // Checks if the record contains all the other required elements of a mailing
    // address.
    $missingAddressKeys = [];
    foreach (['lastName', 'countryCode', 'postalCode'] as $addressKey) {
        if (!array_key_exists($addressKey, $rawRecord)) {
            $missingAddressKeys[] = $addressKey;
        }
    }
    if (!empty($missingAddressKeys)) {
        printf(
            "Skipping addition of mailing address information because the "
            . "following required keys are missing: %s%s",>
            json_encode($missingAddressKeys),
            PHP_EOL
>        );
    } else {
        // Creates an OfflineUserAddressInfo object that contains all the required
        // elements of a mailing address.
        $addressIdentifier = new UserI>dentifier([
            'address_info' = new OfflineUserAddressInfo([
                'hashed_first_name' = self::normalizeAndHash(
                    $hashAlgorithm>,
                    $rawRecord['firstName'],
    >                false
                ),
                'hashed_last_name' = self::normalizeAndHash(
                    $hashAlgorithm,
                    $rawRecord['lastName'],
                    false
                )>,
                'country_code&#
39; = $rawRecord['countryCode&#
39;],
                'postal_code' = $rawRecord['postalCode']
            ])
        ]);
        // Adds the address identifier to the user identifiers list.
        $userIdentifiers[] = $addressIdentifier;
    }
}

// Adds the user identifiers to the conversion.
$enhancement-setUserIdentifiers($userIdentifiers);UploadEnhancedConversionsForWeb.php

Python

# Extracts user email, phone, and address info 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 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": "alex.2@example.com",
    # Address that includes all four required elements: first name, last
    # name, country code, and postal code.
    "first_name": "Alex",
    "last_name": "Quinn",
    "country_code": "US",
    "postal_code": "94045",
    # Phone number to be converted to E.164 format, with a leading '+' as
    # required.
    "phone": "+1 800 5550102",
    # 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,
    "conversion_action_id": conversion_action_id,
    "conversion_date_time": conversion_date_time,
    "currency_code": "USD",
    "user_agent": user_agent,
}

# Constructs the enhancement adjustment.
conversion_adjustment = client.get_type("ConversionAdjustment")
conversion_adjustment.adjustment_type = (
    client.enums.ConversionAdjustmentTypeEnum.ENHANCEMENT
)

# 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 email identifier to the conversion adjustment.
conversion_adjustment.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.
    conversion_adjustment.user_identifiers.append(phone_identifier)

# Checks if the record has all the required mailing address elements, and if
# so, adds a UserIdentifier for the mailing address.
if raw_record.get("first_name") is not None:
    # Checks if the record contains all the other required elements o>f a
    # mailing address.
    required_keys = ["last_name", "country_code", "postal_code"]
    # Builds a new list of the required keys that are missing from
    # raw_record.
    missing_keys = [
        key for key in required_keys if key not in raw_record.keys()
    ]
    if len(missing_keys)  0:
        print(
            "Skipping addition of mailing address information because the"
            f"following required keys are missing: {missing_keys}"
        )
    else:
        # Creates a user identifier using sample values for the user address,
        # hashing where required.
        address_identifier = client.get_type("UserIdentifier")
        address_info = address_identifier.address_info
        address_info.hashed_first_name = normalize_and_hash(
            raw_record["first_name"]
        )
   
     address_info.hashed_last_name = n
ormalize_and_hash(
            raw_record["last_name"]
        )
        address_info.country_code = raw_record["country_code"]
        address_info.postal_code = raw_record["postal_code"]
        # Adds the address identifier to the conversion adjustment.
        conversion_adjustment.user_identifiers.append(address_identifier)upload_enhanced_conversions_for_web.py

Ruby

# Extracts user email, phone, and address info 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 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 t>he Gmail domain.
    "email" = "alex.2@example.com",
    # Address that includes all four required elements: first name, last
    # name,> country code, and postal >code.
    "first_name&quo>t; = "Alex",
   > "last_name" = "Quinn",
    "country_code" = "US",
    "postal_code&>quot; = "94045",
    # Phone number to be converted to E.164 format, with a leading '+' as
    # required.
    "phone" = "+1 800 5550102",
    # This example lets you input conversion detai>ls as arguments, but in
    # reality y>ou might store this data alongside other user data,> so we
    # include it in this sample user >record.
    "order_id>" = order_id,
    "conversion_action_id" = conversion_action_id,
    "conversion_date_time" = conversion_date_time,
    "currency_code" = "USD",
    "user_agent" = user_agent,
}

enhancement = client.resource.conversion_adjustment do |ca|
  ca.conversion_action = client.path.conversion_action(customer_id, conversion_action_id)
  ca.adjustment_type = :ENHANCEMENT
  ca.order_id = order_id

  # Sets the conversion date and time if provided. Providing this value is
  # optional but recommended.
  unless conversion_date_time.nil?
    ca.gclid_date_time_pair = client.resource.gclid_date_time_pair do |pair|
      pair<<.conversion_date_time = conversion_date_time
    end
  end

  # Creates a user identifier using the hashed email address, using the
  # normalize and hash method specifically for email addresses.
  ca.user_identifiers  client.resource.user_identifier do |ui|
    # Uses the normalize and hash method specifically for email addresses.
    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?
    ca.user_identifiers  client.resource.user_identifier do |ui|
      ui.hashed_phone_number = normalize_and_hash_email(raw_record["phone"])
    end
  end

  # Checks if the record has all the required mailing address elements, and if
  # so, adds a UserIdentifier for the mailing address.
  unless raw_record["first_name"].nil?
    # Checks if the record contains all the other required elements of a
    # mailing address.
    required_keys = ["last_name", "country_code", "postal_code"]
    # Builds a new list of the required keys that are missing from
    <<# raw_record.
    missing_keys = required_keys - raw_record.keys
    if missing_keys
        puts(
            "Skipping addition of mailing address information because the" \
            "following required keys are missing: #{missing_keys}"
        )
    else
      ca.user_identifiers  client.resource.user_identifier do |ui|
        ui.address_info = client.resource.offline_user_address_info do |info|
          # Certain fields must be hashed using SHA256 in order to handle
          # identifiers in a privacy-safe way, as described at
          # https://support.google.com/google-ads/answer/9888656.
          info.hashed_first_name = norm
alize_and_hash( raw_record["first
_name"])
          info.hashed_last_name = normalize_and_hash( raw_record["last_name"])
          info.postal_code = normalize_and_hash(raw_record["country_code"])
          info.country_code = normalize_and_hash(raw_record["postal_code"])
        end
      end
    end
  endupload_enhanced_conversions_for_web.rb

Perl

# Construct the enhancement adjustment.
my $enhancement =
  Google::Ads::GoogleAds::V23::Services::ConversionAdjustmentUploadService::ConversionAdjustment
  ->new({
    adjustmentType => ENHANCEMENT
  });

# Extract user email, phone, and address info 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::V23::Common::UserIdentifier->new({
#   hashedEmail => '...',
#   hashedPhone>Number = '...',
# });
my $raw_record = {
  # Email address that includes a period (.) before the Gmail d>omain.
  email = 'alex.2@example.com',
  # Address that includes all four required elements: first name, last
  # name, country code, and post>al code.
  firstName   => 'Alex',
  lastNa>me    = 'Quinn'>;,
  countryCode = 'US',
  postalCode  = '94045',
  # Phone number to be converted to E.1>64 format, with a leading '+' as
  # required.
  phone = '+1 800 5550102',
  # 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 samp>le user record.
  orderId            = $order_>id,
  conversionActionId = $conversion_action_>id,
  conversionDateTime = $co>nversion_date_time,
  currencyCode       = "USD",
  userAgent          = $user_agent,
};
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_identifier>s,
  Google::Ads::GoogleAds::V23::Common::UserIdentifier-new({
      hashedEmail = $hashed_email,
>      # Optional: Specify the user identifier source.
      userIdentifierSource = FIRST_PARTY
    }));

# Check if the record ha>s a phone number, and if so, add a UserIdentifier for it.
if (defined $raw_record-{phone}) {
  # Add the hashed phone number identifier to the list of UserIdentifiers.
  push>(
    @$user_identifiers,
    Goo>gle::Ads::GoogleAds::V23::Common>::UserIdentifier-new({
        hashedPhoneNumber = normalize_and_hash($raw_record-{phone}, 1)}));
}

# Confirm the record has all the required mailing address elements, a>nd if so, add
# a UserIdentifier for the mailing address.
if (defined $raw_record-{firstName}) {
  my $required_keys = ["lastName", "countryCode", "p>ostalCode"];
  my $missing_keys  = [];

  foreach my $key (@$required_keys) {
    if (!defined $raw_record-{$key}) {
      push(@$missing_keys, $key);
    }
  }

  if (@$missing_keys) {
    print
      "Skipping addition of mailing address information because the following"
      . "keys are missing: "
      . >join(",", @$missing>_keys);
  } else {
    push(
      @$user_identifiers,
      Google::Ads:>:GoogleAds::V23::Common::UserIdentifier-new({
          addressInfo =
            Google::Ads::GoogleAds>::V23::Common::OfflineUserAddres>sInfo-new({
              # First and last na>me must be normalized and hashed>.
              hashedFirstName = normalize_and_hash($raw_record-{firstName}),
              hashedLastNam>e  = normaliz>e_and_hash($raw_record-{lastName}),
      >        # Cou>ntry code and zip code are sent in plain text.
              countryCode = $raw_record-{countryCode},
         >     postalCode  = $raw_record-{postal
Code},
            })}));
  }
}

# Add
 the user identifiers to the enhancement adjustment.
$enhancement-{userIdentifiers} = $user_identifiers;upload_enhanced_conversions_for_web.pl

  • order_id は、調整するコンバージョンのオーダー ID に設定してください。これは、タグによって送信されたオーダー ID と一致する必要があります。

  • adjustment_type を ENHANCEMENT に設定します。

  • conversion_action を、type が WEBPAGE の ConversionAction のリソース名に設定します。

  • （省略可）可能な場合は、gclid_date_time_pair に値を入力して、測定精度を高めます。conversion_date_time に、指定された order_id のコンバージョンが発生した日時を設定します。タイムゾーン オフセットを含め、yyyy-mm-dd HH:mm:ss+|-HH:mm 形式を使用します（例: 2022-01-01 19:32:45-05:00（夏時間を無視））。

  • （省略可）user_agent を、元のコンバージョンを送信したリクエストのユーザー エージェントに設定します。これにより、コンバージョンとその拡張機能の両方が同一デバイス アトリビューションまたはクロスデバイス アトリビューションのいずれかとして扱われます。

Java

// Sets the conversion action.
enhancementBuilder.setConversionAction(
    ResourceNames.conversionAction(
        customerId, Long.parseLong(rawRecord.get("conversionActionId"))));

// Sets the order ID. Enhancements MUST use order ID instead of GCLID date/time pair.
enhancementBuilder.setOrderId(rawRecord.get("orderId"));

// Sets the conversion date and time if provided. Providing this value is optional but
// recommended.
if (rawRecord.containsKey("conversionDateTime")) {
  enhancementBuilder.setGclidDateTimePair(
      GclidDateTimePair.newBuilder()
          .setConversionDateTime(rawRecord.get("conversionDateTime")));
}

// Sets the user agent if provided. This should match the user agent of the request that sent
// the original conversion so the conversion and its enhancement are either both attributed as
// same-device or both attributed as cross-device.
if (rawRecord.containsKey("userAgent")) {
  enhancementB
uilder.setUserAgent(rawRecord.get(&q
uot;userAgent"));
}UploadEnhancedConversionsForWeb.java

C#

// Set the conversion action.
enhancement.ConversionAction =
    ResourceNames.ConversionAction(customerId, conversionActionId);

// Set the order ID. Enhancements MUST use order ID instead of GCLID date/time pair.
enhancement.OrderId = orderId;

// Sets the conversion date and time if provided. Providing this value is optional but
// recommended.
if (string.IsNullOrEmpty(conversionDateTime))
{
    enhancement.GclidDateTimePair = new GclidDateTimePair()
    {
        ConversionDateTime = conversionDateTime
    };
}

// Sets optional fields where a value was provided.
if (!string.IsNullOrEmpty(userAgent))
{
    // Sets the user agent. This should match the user agent of the request that
    // sent the original conversion so the conversion and its enhancement are either
    // both attributed as same-device or both attributed as cross-device.
    enhancement.UserAgent = userAgent;
}

UploadEnhancedConversionsForWeb.cs

PHP

// Sets the conversion action.
$enhancement->setConversionAction(
    ResourceNames::forConversionAction($customerId, $rawRecord['conversionActionId'])
);

// Sets the order ID. Enhancements MUST use order ID instead of GCLID date/time pair.
if (!empty($rawRecord['orderId'])) {
 >   $enhancement-setOrderId($rawRecord['orderId']);
}

// Sets the conversion date and time if provided. Providing this value is optional but
// recommended.
if (!empty($rawRecord['conversionDateTime'])) {
    // Sets the conversion date and time if provided. Providing this value is optional but
    />/ recommended.
    $enhancement-setGclidDateTimePair(new GclidDateTimePair([
>        'conversion_date_time' = $rawRecord['conversionDateTime']
    ]));
}

// Sets the user agent if provided. This should match the user agent of the request that
// sent the original conversion so the conversion and its enhancement are either both
// attributed as same-device or both attributed as cross-device.
if (!emp>ty($rawRecord['userAgent'])) {
 
   $enhancement-setUserAgent($rawRe
cord['userAgent']);
}UploadEnhancedConversionsForWeb.php

Python

conversion_action_service = client.get_service("ConversionActionService")
# Sets the conversion action.
conversion_adjustment.conversion_action = (
    conversion_action_service.conversion_action_path(
        customer_id, raw_record["conversion_action_id"]
    )
)

# Sets the order ID. Enhancements MUST use order ID instead of GCLID
# date/time pair.
conversion_adjustment.order_id = order_id

# Sets the conversion date and time if provided. Providing this value is
# optional but recommended.
if raw_record.get("conversion_date_time"):
    conversion_adjustment.gclid_date_time_pair.conversion_date_time = (
        raw_record["conversion_date_time"]
    )

# Sets optional fields where a value was provided
if raw_record.get("user_agent"):
    # Sets the user agent. This should match the user agent of the request
    # that sent the original conversion so the conversion and its
    # enhancement are either both attributed as same-device or both
    # attributed as cross-device.

    conversion_adjustment.user_agent 
= user_agentupload_enhanced_conversions_for_web.py

Ruby

ca.conversion_action = client.path.conversion_action(customer_id, conversion_action_id)
ca.adjustment_type = :ENHANCEMENT
ca.order_id = order_id

# Sets the conversion date and time if provided. Providing this value is
# optional but recommended.
unless conversion_date_time.nil?
  ca.gclid_date_time_pair = client.resource.gclid_date_time_pair do |pair|
    pair.conversion_date_time = conversion_date_time
  end
end

# Creates a user identifier using the hashed email address, using the
# normalize and hash method specifically for email addresses.
ca.user_identifiers << client.resource.user_identifier do |ui|
  # Uses the normalize and hash method specifically for email addresses.
  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?
  <<ca.user_identifiers  client.resource.user_identifier do |ui|
    ui.hashed_phone_number = normalize_and_hash_email(raw_record["phone"])
  end
end

# Checks if the record has all the required mailing address elements, and if
# so, adds a UserIdentifier for the mailing address.
unless raw_record["first_name"].nil?
  # Checks if the record contains all the other required elements of a
  # mailing address.
  required_keys = ["last_name", "country_code", "postal_code"]
  # Builds a new list of the required keys that are missing from
  # raw_record.
  missing_keys = required_keys - raw_record.keys
  if missing_keys
      puts(
          "Skipping addition of mailing address information because the" \
          "followin<<g required keys are missing: #{missing_keys}"
      )
  else
    ca.user_identifiers  client.resource.user_identifier do |ui|
      ui.address_info = client.resource.offline_user_address_info do |info|
        # Certain fields must be hashed using SHA256 in order to handle
        # identifiers in a privacy-safe way, as described at
        # https://support.google.com/google-ads/answer/9888656.
        info.hashed_first_name = normalize_and_hash( raw_record["first_name"])
        info.hashed_last_name = normalize_and_hash( raw_record["last_name"])
        info.postal_code = normalize_and_hash(raw_record["country_code"])
        info.country_code = normalize_and_hash(raw_record["postal_code"])
      end
    end
  end
end

# Sets optional fields where a value was provided.
unless user_agent.nil?
  # Sets the user agent. This should match the user agent of the request
  # that sent the original conversion so the conversion and its 
enhancement
  # are either both attrib
uted as same-device or both attributed as
  # cross-device.
  ca.user_agent = user_agent
endupload_enhanced_conversions_for_web.rb

Perl

# Set the conversion action.
$enhancement->{conversionAction} =
  Google::Ads::GoogleAds::V23::Utils::ResourceNames::conversion_action(
  $customer_id, $raw_record->{conversionActionId});

# Set the order ID. Enhancements MUST use order ID instead of GCLID date/time pair.
$enhancement->{orderId} = $raw_record->{orderId};

# Set the conversion date and time if provided. Providing this value is optional
# but recommended.
if (defined $raw_record->{conversionDateTime}) {
  $enhancement->{gclidDateTimePair} =
    Google::Ads::GoogleAds::V23::Services::ConversionAdjustmentUploadService::GclidDateTimePair
    ->new({
      conversionDateTime => $raw_record->{conversionDateTime}});
}

# Set the user agent if provided. This should match the user agent of the
# request that sent the original conversion so the conversion and its enhancement
# are either both attributed as same-device or both attributed as cross-device.
if (defined $raw_record->{userAgent}) {
  $enhancement->{userAgent} = $raw_record->{userAgent};
}
upload_enhanced_conversions_for_web.pl

コンバージョン インポートの機能強化

Java

// Creates the conversion adjustment upload service client.
try (ConversionAdjustmentUploadServiceClient conversionUploadServiceClient =
    googleAdsClient.getLatestVersion().createConversionAdjustmentUploadServiceClient()) {
  // Uploads the enhancement adjustment. Partial failure should always be set to true.

  // NOTE: This request contains a single adjustment as a demonstration. However, if you have
  // multiple adjustments to upload, it's best to upload multiple adjustments per request
  // instead of sending a separate request per adjustment. See the following for per-request
  // limits:
  // https://developers.google.com/google-ads/api/docs/best-practices/quotas#conversion_adjustment_upload_service
  UploadConversionAdjustmentsResponse response =
      conversionUploadServiceClient.uploadConversionAdjustments(
          UploadConversionAdjustmentsRequest.newBuilder()
              .setCustomerId(Long.toString(customerId))
              .addConversionAdjustments(enhancementBuilder)
              // Enables partial failure (must be true).
              .setPartialFailure(true)
              .build
());UploadEnhancedConversionsForWeb.
java

C#

// Uploads the enhancement adjustment. Partial failure should always be set to true.
//
// NOTE: This request contains a single adjustment as a demonstration.
// However, if you have multiple adjustments to upload, it's best to upload
// multiple adjustmenst per request instead of sending a separate request per
// adjustment. See the following for per-request limits:
// https://developers.google.com/google-ads/api/docs/best-practices/quotas#conversion_adjust
UploadConversionAdjustmentsResponse response =
    conversionAdjustmentUploadService.UploadConversionAdjustments(
        new UploadConversionAdjustmentsRequest()
        {
            CustomerId = customerId.ToString(),
            ConversionAdjustments = { enhancement },
            // Enables partial failure (must be true).
            PartialFailure = true,
       
 });UploadEnhancedConversionsForWe
b.cs

PHP

// Issues a request to upload the conversion enhancement.
$conversionAdjustmentUploadServiceClient =
    $googleAdsClient->getConversionAdjustmentUploadServiceClient();
// NOTE: This request contains a single adjustment as a demonstration. However, if you have
// multiple adjustments to upload, it's best to upload multiple adjustments per request
// instead of sending a separate request per adjustment. See the following for per-request
// limits:
// https://developers.google.com/google-ads/api/docs/best-practices/quotas#conversion_adjustment_upload_service
$response = $conversionAdjustmentUploadServiceCli>ent-uploadConversionAdjustments(
    // Enables partial failure (must be true).
    UploadConversionAdjustmentsRequest::build($customerId, [$enhancement], true
)
);UploadEnhancedConversionsForWeb
.php

Python

# Creates the conversion adjustment upload service client.
conversion_adjustment_upload_service = client.get_service(
    "ConversionAdjustmentUploadService"
)
# Uploads the enhancement adjustment. 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 still best 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_adjustment_upload_service.upload_conversion_adjustments(
    customer_id=customer_id,
    conversion_adjustments=[conversion_adjustment],
    # Enables partial failure (must be true).
    partial_f
ailure=True,
)upload_enhanced_conversi
ons_for_web.py

Ruby

response = client.service.conversion_adjustment_upload.upload_conversion_adjustments(
  customer_id: customer_id,
  # NOTE: This request only uploads a single conversion, but if you have
  # multiple conversions to upload, it's still best 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
  conversion_adjustments: [enhancement],
  # Partial failure must be set to true.
  partial_failure: tru
e,
)upload_enhanced_conversions_for_we
b.rb

Perl

# Upload the enhancement adjustment. Partial failure should always be set to true.
#
# NOTE: This request contains a single adjustment as a demonstration.
# However, if you have multiple adjustments to upload, it's best to
# upload multiple adjustments per request instead of sending a separate
# request per adjustment. See the following for per-request limits:
# https://developers.google.com/google-ads/api/docs/best-practices/quotas#conversion_adjustment_upload_service
my $response =
  $api_cli>ent-ConversionAdjustmentUploadService()>
  -upload_conversion_adjustments({
    customerId         >   = $customer_id,
    conversionAdjustmen>ts = [$enhancement],
    # Enable partial failure (must be true).
    partialFailu>re = "tr
ue"
  });upload_enhanced_conversi
ons_for_web.pl

インポートを確認する

拡張コンバージョン（ウェブ向け）が適切に動作していることを確認し、設定の問題を診断するには、拡張コンバージョン API の診断レポートを使用します。

オフライン データ診断を使用して、最近のインポートの全体的な健全性を確認します。

キャンペーンのコンバージョン指標をレポートする際は、ユーザー インターフェースの指標のマッピングを参照して、Google 広告の UI 指標と Google Ads API のレポート フィールドを関連付けます。conversion_action リソースをクエリして、特定のコンバージョン アクションの合計コンバージョン数と合計コンバージョン値を確認することもできます。

ベスト プラクティス

ウェブサイトの拡張コンバージョンを実装する際は、次のベスト プラクティスを念頭に置いてください。

顧客 ID を確認する

コンバージョンをインポートする際は、コンバージョン アクションが含まれており、コンバージョン トラッキングを行うアカウントに顧客 ID を設定する必要があります。この設定を確認するには、サービング Google 広告の Customer リソースに ConversionTrackingSetting をクエリします。GoogleAdsService.SearchStream を使用して次のクエリを発行し、customer.conversion_tracking_setting.google_ads_conversion_customer の値を取得します。

SELECT
  customer.conversion_tracking_setting.google_ads_conversion_customer,
  customer.conversion_tracking_setting.conversion_tracking_status,
  customer.conversion_tracking_setting.conversion_tracking_id,
  customer.conversion_tracking_setting.cross_account_conversion_tracking_id
FROM customer

コンバージョンをインポートするリクエストで、customer_id を google_ads_conversion_customer 値に設定します。

複数の識別子がある場合は、それらを含める

コンバージョンの gclid がある場合は、パフォーマンスを向上させるために user_identifiers に加えて送信することをおすすめします。また、コンバージョンに複数の UserIdentifier がある場合は、それらをすべて含めることで、一致する可能性が高まります。すべての識別子を同じ ConversionAdjustment に含めます。

統合の設定時に部分的な障害エラーを確認する

拡張コンバージョン（ウェブ向け）の統合を初めて設定する場合は、レスポンスの partial_failure_error フィールドで部分的なエラーを確認し、対処します。設定に問題がある場合は、このフィールドを調べて問題を調査し、解決できます。部分的な障害のエラー処理に関する詳細と例については、専用の部分的な障害に関するガイドをご覧ください。

部分的な失敗エラーで明らかになった問題を解決し、統合が完了したら、オフライン データ診断を使用して、コンバージョンの健全性を定期的に確認します。

1 つのリクエストで複数の調整をバッチ処理する

インポートする調整が複数ある場合は、調整ごとにインポート リクエストを送信するのではなく、オペレーションを 1 つの UploadConversionAdjustmentsRequest にバッチ処理します。

リクエストあたりの調整数の上限については、割り当てガイドをご覧ください。オフライン データ診断で一連のリクエストを同じ論理ジョブにグループ化する場合は、すべてのリクエストの job_id を同じ値に設定します。

トラブルシューティング

拡張コンバージョン（ウェブ向け）が適切に動作していることを確認し、設定の問題を診断するには、拡張コンバージョン API の診断レポートを使用します。

一般的なエラーをデバッグする

エラー
CONVERSION_NOT_FOUND 指定されたコンバージョン アクションとコンバージョン ID のペアのコンバージョンが見つかりませんでした。order_idリクエストの customer_id で指定された Google 広告のコンバージョン顧客の Google 広告コンバージョンであることを確認します。
また、コンバージョンが gclid ではなく gbraid または wbraid が設定されたクリックによるものではないことを確認します。Google 広告では、これらのコンバージョンに対する拡張コンバージョン（ウェブ向け）はサポートされていません。
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS リクエストの customer_id に対して、顧客データに関する利用規約が同意されていません。この手順については、前提条件ガイドをご覧ください。
CONVERSION_ALREADY_ENHANCED このコンバージョンには、指定された order_id と conversion_action を使用した調整がすでに適用されています。コンバージョンごとに一意の order_id を指定してください。
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT 指定された conversion_action は、拡張コンバージョン（ウェブ向け）の対象外です。Google 広告の管理画面で、リクエストで参照されているコンバージョン アクションの [拡張コンバージョンを有効にする] チェックボックスがオンになっていることを確認します。手順については、ヘルプセンターをご覧ください。
前へ
オフライン コンバージョンを管理する
次へ
通話コンバージョンを管理する