Verifica dell'identità dell'inserzionista

Per offrire agli utenti un ecosistema sicuro e affidabile e conformità alle normative emergenti, Google ora richiede agli inserzionisti di completare uno o più programmi di verifica.

Se ti viene chiesto di completare un programma di verifica, potrebbe essere impostata una scadenza per la procedura. Se la scadenza viene superata senza il completamento della verifica, il tuo account potrebbe essere messo in pausa.

Puoi anche sottoporti alla verifica in modo proattivo senza necessità di farlo. Il IdentityVerificationService offre metodi per:

  • Recuperare lo stato della procedura di verifica per un account cliente, incluse eventuali scadenze
  • Avviare una procedura di verifica

Recuperare lo stato della verifica

Per recuperare lo stato della procedura di verifica dell'identità dell'inserzionista per un account cliente, chiama il metodo GetIdentityVerification:

Java

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

C#

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

PHP

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

Python

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

Ruby

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

Perl

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

Se l'account del cliente è registrato al programma obbligatorio di verifica dell'identità dell'inserzionista, il servizio restituisce una risposta non vuota contenente un elenco di oggetti IdentityVerification. Una risposta vuota indica che l'account cliente non deve sottoporsi alla verifica dell'identità dell'inserzionista.

A partire dalla versione 16, l'API Google Ads supporta solo il programma ADVERTISER_IDENTITY_VERIFICATION, quindi sarebbe l'unico elemento nell'elenco.

Un oggetto IdentityVerification contiene le seguenti proprietà:

  • Una IdentityVerificationRequirement che descrive le scadenze per iniziare e completare la procedura di verifica

  • Un elemento IdentityVerificationProgress che descrive lo stato attuale della procedura di verifica: può includere anche l'URL di azione che consente all'utente di completare la procedura.

Avvia il processo di verifica

Se un account cliente è registrato al programma obbligatorio di verifica dell'identità dell'inserzionista: GetIdentityVerification ha restituito una risposta non vuota con una scadenza per il completamento della procedura di verifica, puoi avviare una sessione di verifica chiamando il numero StartIdentityVerification:

Java

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

C#

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

PHP

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

Python

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

Ruby

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

Perl

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

Questa operazione avrà esito positivo solo se non è in corso un'altra sessione di verifica. Una volta avviata una sessione di verifica, le chiamate successive a GetIdentityVerification restituiranno all'utente l'URL di azione per completare la procedura di verifica e la data e l'ora di scadenza dell'URL di azione.

Una volta trascorsa la scadenza, puoi chiamare di nuovo StartIdentityVerification per avviare una nuova sessione di verifica.

Indietro
Modifica evento