Weryfikacja tożsamości reklamodawcy

W trosce o zapewnienie użytkownikom bezpiecznego i opartego na zaufaniu ekosystemu reklamowego oraz zapewnienie zgodności z nowymi przepisami Google wymaga teraz od reklamodawców przejścia co najmniej jednego procesu weryfikacji.

Jeśli musisz przejść proces weryfikacji, możemy ustalić jego termin. Jeśli upłynie termin i nie zakończy się weryfikacja, Twoje konto może zostać wstrzymane.

Możesz też przejść weryfikację bez konieczności przeprowadzania wcześniejszej weryfikacji. IdentityVerificationService oferuje następujące metody:

• Pobieranie stanu procesu weryfikacji konta klienta, w tym wszystkich terminów
• Rozpoczynanie procesu weryfikacji

Pobierz stan weryfikacji

Aby sprawdzić stan procesu weryfikacji tożsamości reklamodawcy na koncie klienta, wywołaj metodę GetIdentityVerification:

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

private static IdentityVerification GetIdentityVerification(
        GoogleAdsClient client, long customerId)
{
    IdentityVerificationServiceClient identityVerificationService =
        client.GetService(Services.V16.IdentityVerificationService);

    try {
        GetIdentityVerificationResponse response =
            identityVerificationService.GetIdentityVerification(
                new GetIdentityVerificationRequest()
                {
                    CustomerId = customerId.ToString()
                }
            );

            if (response.IdentityVerification.Count == 0)
            {
                return null;
            }

            IdentityVerification identityVerification = response.IdentityVerification[0];
            string deadline =
                identityVerification.IdentityVerificationRequirement.VerificationCompletionDeadlineTime;
             IdentityVerificationProgress identityVerificationProgress =
                identityVerification.VerificationProgress;
            Console.WriteLine($"Account {customerId} has a verification completion " +
                $"deadline of {deadline} and status " +
                $"{identityVerificationProgress.ProgramStatus} for advertiser identity " +
                "verification.");

            return identityVerification;
    } catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }


}
VerifyAdvertiserIdentity.cs
      

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

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

def get_identity_verification(client, customer_id)
  response = client.service.identity_verification.get_identity_verification(
    customer_id: customer_id
  )

  return nil if response.nil? || response.identity_verification.empty?

  identity_verification = response.identity_verification.first
  deadline = identity_verification.
    identity_verification_requirement.
    verification_completion_deadline_time
  progress = identity_verification.verification_progress
  puts "Account #{customer_id} has a verification completion deadline " \
    "of #{deadline} and status #{progress.program_status} for advertiser " \
    "identity verification."

  identity_verification
end
verify_advertiser_identity.rb
      

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

  my $response = $api_client->IdentityVerificationService()->get({
    customerId => $customer_id
  });

  if (!defined $response->{identityVerification}) {
    printf "Account %s does not require advertiser identity verification.",
      $customer_id;
    return;
  }

  my $identity_verification = $response->{identityVerification}[0];
  my $deadline = $identity_verification->{identityVerificationRequirement}
    {verificationCompletionDeadlineTime};
  my $identity_verification_progress =
    $identity_verification->{verificationProgress};

  printf "Account %s has a verification completion deadline of %s and status " .
    "%s for advertiser identity verification.", $customer_id, $deadline,
    $identity_verification_progress->{programStatus};
  return $identity_verification;
}
verify_advertiser_identity.pl
      

Jeśli konto klienta jest zarejestrowane w programie obowiązkowej weryfikacji tożsamości reklamodawcy, usługa zwraca niepustą odpowiedź zawierającą listę obiektów IdentityVerification. Pusta odpowiedź oznacza, że konto klienta nie musi przechodzić weryfikacji tożsamości reklamodawcy.

Od wersji 16 interfejs Google Ads API obsługuje tylko program ADVERTISER_IDENTITY_VERIFICATION, więc będzie to jedyny element na liście.

Obiekt IdentityVerification ma następujące właściwości:

• IdentityVerificationRequirement opisujący termin rozpoczęcia i zakończenia procesu weryfikacji

• IdentityVerificationProgress opisujący obecny stan procesu weryfikacji. Może też zawierać adres URL działania, którego użytkownik potrzebuje, aby ukończyć proces weryfikacji.

Rozpocznij proces weryfikacji

Jeśli konto klienta jest zarejestrowane w obowiązkowym programie weryfikacji tożsamości reklamodawcy – GetIdentityVerification zwrócił niepustą odpowiedź z terminem zakończenia procesu weryfikacji, możesz rozpocząć sesję weryfikacji, dzwoniąc pod numer StartIdentityVerification:

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

private static void StartIdentityVerification(GoogleAdsClient client, long customerId)
{
    IdentityVerificationServiceClient identityVerificationService =
        client.GetService(Services.V16.IdentityVerificationService);

    StartIdentityVerificationRequest request = new StartIdentityVerificationRequest()
    {
        CustomerId = customerId.ToString(),
        VerificationProgram = IdentityVerificationProgram.AdvertiserIdentityVerification
    };

    try {
        identityVerificationService.StartIdentityVerification(request);
    } catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}
VerifyAdvertiserIdentity.cs
      

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

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

def start_identity_verification(client, customer_id)
  client.service.identity_verification.start_identity_verification(
    customer_id: customer_id,
    verification_program: :ADVERTISER_IDENTITY_VERIFICATION,
  )
end
verify_advertiser_identity.rb
      

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

  my $request =
    Google::Ads::GoogleAds::V16::Services::IdentityVerificationService::StartIdentityVerificationRequest
    ->new({
      customerId          => $customer_id,
      verificationProgram => ADVERTISER_IDENTITY_VERIFICATION
    });

  $api_client->AdvertiserIdentityVerificationService()
    ->start_identity_verification($request);
}
verify_advertiser_identity.pl
      

Jest to skuteczne tylko wtedy, gdy nie trwa żadna sesja weryfikacji. Po rozpoczęciu sesji weryfikacji kolejne wywołania GetIdentityVerification zwracają adres URL działania, który umożliwia użytkownikowi ukończenie procesu weryfikacji, oraz czas wygaśnięcia adresu URL działania.

Po upływie tego czasu możesz ponownie zadzwonić pod numer StartIdentityVerification, aby rozpocząć nową sesję weryfikacji.